Re: Revised keyrings(7) man page for review

From	"Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
Newsgroups	linux.kernel
Subject	Re: Revised keyrings(7) man page for review
Date	2016-12-13 14:50 +0100
Message-ID	<sNVCX-1NI-37@gated-at.bofh.it> (permalink)
References	<sNUGS-1eI-7@gated-at.bofh.it> <szOUF-3Dx-7@gated-at.bofh.it> <sNTB7-CJ-5@gated-at.bofh.it> <sNVtf-1Kh-1@gated-at.bofh.it>
Organization	linux.* mail to news gateway

Show all headers | View raw

Hi David,

On 12/13/2016 02:31 PM, David Howells wrote:
> Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:
> 
>> I use/Linux man-pages uses the "Oxford comma" convention.
> 
> "... an optional comma ..." ;-)
> 
> There's also:
> 
> 	... LSM security checks are still performed, and may filter out
>         further keys that the process is not authorized to view.
> 
> but has two parts and isn't a list... ;-P

Oxford comma doesn't apply there... But, to me, it depends how
you read the text aloud. I'd read it with a pause where the comma is,
and so added a comma there.

> 
>>>>                      D   The key is dead (i.e., has been deleted).  (A
>>>>                          key  may  be  briefly  in  this  state during
>>>>                          garbage collection.)
>>>
>>> No - "dead" in this context means that the key type was unregistered.
>>
>> Okay, so the text should read as:
>>
>>                      D   The key is dead (i.e., the key has been unregis‐
>>                          tered).  (A key may be  briefly  in  this  state
>>                          during garbage collection.)
>>
>> Right?
> 
> Not quite.  The driver for the key type has been unregistered, not the key.

Bother. I meant to write "key type"! Fixed.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Back to linux.kernel | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Re: Revised keyrings(7) man page for review David Howells <dhowells@redhat.com> - 2016-12-13 12:40 +0100
  Re: Revised keyrings(7) man page for review "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-12-13 13:50 +0100
    Re: Revised keyrings(7) man page for review "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-12-13 14:00 +0100
      Re: Revised keyrings(7) man page for review David Howells <dhowells@redhat.com> - 2016-12-13 14:40 +0100
        Re: Revised keyrings(7) man page for review "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-12-13 15:00 +0100
          Re: Revised keyrings(7) man page for review David Howells <dhowells@redhat.com> - 2016-12-13 15:30 +0100
            Re: Revised keyrings(7) man page for review "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-12-14 08:30 +0100
    Re: Revised keyrings(7) man page for review David Howells <dhowells@redhat.com> - 2016-12-13 14:40 +0100
      Re: Revised keyrings(7) man page for review "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-12-13 14:50 +0100

csiph-web