Issue in man page session-keyring.7

Issue in man page session-keyring.7

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    PAM → B<PAM>(7)

"The session keyring is a keyring used to anchor keys on behalf of a "
"process.  It is typically created by B<pam_keyinit>(8)  when a user logs in "
"and a link will be added that refers to the B<user-keyring>(7).  Optionally, "
"PAM may revoke the session keyring on logout.  (In typical configurations, "
"PAM does do this revocation.)  The session keyring has the name "
"(description)  I<_ses>."

Re: Issue in man page session-keyring.7

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 884 bytes --]

Hi Helge,

On 3/11/23 18:13, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    PAM → B<PAM>(7)
> 
> "The session keyring is a keyring used to anchor keys on behalf of a "
> "process.  It is typically created by B<pam_keyinit>(8)  when a user logs in "
> "and a link will be added that refers to the B<user-keyring>(7).  Optionally, "
> "PAM may revoke the session keyring on logout.  (In typical configurations, "
> "PAM does do this revocation.)  The session keyring has the name "
> "(description)  I<_ses>."

I think I prefer not doing this change, since we already have a reference
to PAM(7) in the SEE ALSO section, and it would clutter the description
to add more formatting to it.  I'm doubting.

Cheers,

Alex

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page session-keyring.7

[Helge Kreutzmann]

[-- Attachment #1: Type: text/plain, Size: 1474 bytes --]

Hello Alex,
On Sat, Mar 11, 2023 at 11:24:53PM +0100, Alejandro Colomar wrote:
> On 3/11/23 18:13, Helge Kreutzmann wrote:
> > Without further ado, the following was found:
> > 
> > Issue:    PAM → B<PAM>(7)
> > 
> > "The session keyring is a keyring used to anchor keys on behalf of a "
> > "process.  It is typically created by B<pam_keyinit>(8)  when a user logs in "
> > "and a link will be added that refers to the B<user-keyring>(7).  Optionally, "
> > "PAM may revoke the session keyring on logout.  (In typical configurations, "
> > "PAM does do this revocation.)  The session keyring has the name "
> > "(description)  I<_ses>."
> 
> I think I prefer not doing this change, since we already have a reference
> to PAM(7) in the SEE ALSO section, and it would clutter the description
> to add more formatting to it.  I'm doubting.

Ok.

Just that in HTML view, these are often turned into hyperlinks, thus
people could easily continue reading (like in any HTML article). But I
don't know how many people are actually doing this.

(And of course knowing that PAM(7) even exists in the text is not too
bad, either).

Greetings

         Helge


-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page session-keyring.7

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1468 bytes --]

Hi Helge,

On 3/12/23 05:57, Helge Kreutzmann wrote:
> Hello Alex,
> On Sat, Mar 11, 2023 at 11:24:53PM +0100, Alejandro Colomar wrote:
>> On 3/11/23 18:13, Helge Kreutzmann wrote:
>>> Without further ado, the following was found:
>>>
>>> Issue:    PAM → B<PAM>(7)
>>>
>>> "The session keyring is a keyring used to anchor keys on behalf of a "
>>> "process.  It is typically created by B<pam_keyinit>(8)  when a user logs in "
>>> "and a link will be added that refers to the B<user-keyring>(7).  Optionally, "
>>> "PAM may revoke the session keyring on logout.  (In typical configurations, "
>>> "PAM does do this revocation.)  The session keyring has the name "
>>> "(description)  I<_ses>."
>>
>> I think I prefer not doing this change, since we already have a reference
>> to PAM(7) in the SEE ALSO section, and it would clutter the description
>> to add more formatting to it.  I'm doubting.
> 
> Ok.
> 
> Just that in HTML view, these are often turned into hyperlinks, thus
> people could easily continue reading (like in any HTML article). But I
> don't know how many people are actually doing this.
> 
> (And of course knowing that PAM(7) even exists in the text is not too
> bad, either).

I decided to add a man-page reference in the first occurence.

Cheers,

Alex

> 
> Greetings
> 
>          Helge
> 
> 

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Issue in man page session-keyring.7

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    What does "under others" mean? Is this a special hook? Or does this mean "amongst other actions done by this command"?

"If a process doesn't have a session keyring when it is accessed, then, under "
"certain circumstances, the B<user-session-keyring>(7)  will be attached as "
"the session keyring and under others a new session keyring will be created.  "
"(See B<user-session-keyring>(7)  for further details.)"

Re: Issue in man page session-keyring.7

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 729 bytes --]

Hi Helge,

At 2023-01-22T20:31:30+0100, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    What does "under others" mean? Is this a special hook? Or does this mean "amongst other actions done by this command"?
> 
> "If a process doesn't have a session keyring when it is accessed, then, under "
> "certain circumstances, the B<user-session-keyring>(7)  will be attached as "
> "the session keyring and under others a new session keyring will be created.  "
> "(See B<user-session-keyring>(7)  for further details.)"

It seems idiomatic to me.

Under certain circumstances, I wake up in the morning.
Under others [other circumstances], I awaken after noon.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page session-keyring.7

[Helge Kreutzmann]

[-- Attachment #1: Type: text/plain, Size: 1228 bytes --]

Hello Braden,
On Sun, Jan 22, 2023 at 02:08:44PM -0600, G. Branden Robinson wrote:
> At 2023-01-22T20:31:30+0100, Helge Kreutzmann wrote:
> > Without further ado, the following was found:
> > 
> > Issue:    What does "under others" mean? Is this a special hook? Or does this mean "amongst other actions done by this command"?
> > 
> > "If a process doesn't have a session keyring when it is accessed, then, under "
> > "certain circumstances, the B<user-session-keyring>(7)  will be attached as "
> > "the session keyring and under others a new session keyring will be created.  "
> > "(See B<user-session-keyring>(7)  for further details.)"
> 
> It seems idiomatic to me.
> 
> Under certain circumstances, I wake up in the morning.
> Under others [other circumstances], I awaken after noon.

I understand this now.

As a non native speaker, this missing "circumstances" was not clear.

Greetings

        Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page session-keyring.7

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 1159 bytes --]

Hi Branden, Helge:

On 1/22/23 21:08, G. Branden Robinson wrote:
> Hi Helge,
> 
> At 2023-01-22T20:31:30+0100, Helge Kreutzmann wrote:
>> Without further ado, the following was found:
>>
>> Issue:    What does "under others" mean? Is this a special hook? Or does this mean "amongst other actions done by this command"?
>>
>> "If a process doesn't have a session keyring when it is accessed, then, under"
>> "certain circumstances, the B<user-session-keyring>(7)  will be attached as"
>> "the session keyring and under others a new session keyring will be created."
>> "(See B<user-session-keyring>(7)  for further details.)"
> 
> It seems idiomatic to me.
> 
> Under certain circumstances, I wake up in the morning.
> Under others [other circumstances], I awaken after noon.

I believe a semicolon would be a better way to connect both sentences.  "and", 
considering the amount of commans in the context, doesn't help very much parsing 
the sentence.

What do you think?

Cheers,

Alex

P.S.: The colon in the salutation is the standard way in Spanish :)

> 
> Regards,
> Branden

-- 
<http://www.alejandro-colomar.es/>

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page session-keyring.7

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 276 bytes --]

At 2023-01-22T21:52:34+0100, Alejandro Colomar wrote:
> Hi Branden, Helge:
> P.S.: The colon in the salutation is the standard way in Spanish :)

And in English, too, for business correspondence.

For less formal or more collegial contexts, a comma is used.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Issue in man page session-keyring.7

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    PAM → B<PAM>(7)

"The session keyring is a keyring used to anchor keys on behalf of a "
"process.  It is typically created by B<pam_keyinit>(8)  when a user logs in "
"and a link will be added that refers to the B<user-keyring>(7).  Optionally, "
"PAM may revoke the session keyring on logout.  (In typical configurations, "
"PAM does do this revocation.)  The session keyring has the name "
"(description)  I<_ses>."

Re: Issue in man page session-keyring.7

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 686 bytes --]

Hi Helge,

On 1/22/23 20:31, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    PAM → B<PAM>(7)
> 
> "The session keyring is a keyring used to anchor keys on behalf of a"
> "process.  It is typically created by B<pam_keyinit>(8)  when a user logs in"
> "and a link will be added that refers to the B<user-keyring>(7).  Optionally,"
> "PAM may revoke the session keyring on logout.  (In typical configurations,"
> "PAM does do this revocation.)  The session keyring has the name"
> "(description)  I<_ses>."

Instead of doing that, I added PAM(7) to the SEE ALSO section.

Cheers,

Alex

-- 
<http://www.alejandro-colomar.es/>

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]