Re: Issue in man page session-keyring.7

[Alejandro Colomar <alx.manpages@gmail.com>]

[-- 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 --]