Issue in man page hostname.7

Issue in man page hostname.7

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    B<nsswitch.conf> → I<nsswitch.conf>

"Hostnames are resolved by the NSS framework in glibc according to the "
"B<hosts> configuration in B<nsswitch.conf>.  The DNS-based name resolver (in "
"the B<dns> NSS service module) resolves them in the following fashion."

Re: Issue in man page hostname.7

[Alejandro Colomar]

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

On Wed, Nov 01, 2023 at 02:02:11PM +0000, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    B<nsswitch.conf> → I<nsswitch.conf>

Please explain why.

Thanks,
Alex

> 
> "Hostnames are resolved by the NSS framework in glibc according to the "
> "B<hosts> configuration in B<nsswitch.conf>.  The DNS-based name resolver (in "
> "the B<dns> NSS service module) resolves them in the following fashion."

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

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

Re: Issue in man page hostname.7

[Helge Kreutzmann]

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

Hello Alejandro,
Am Wed, Nov 01, 2023 at 04:41:19PM +0100 schrieb Alejandro Colomar:
> On Wed, Nov 01, 2023 at 02:02:11PM +0000, Helge Kreutzmann wrote:
> > Without further ado, the following was found:
> > 
> > Issue:    B<nsswitch.conf> → I<nsswitch.conf>
> 
> Please explain why.

Filenames are usually in italics, not bold.

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 hostname.7

[Alejandro Colomar]

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

Hello Helge,

On Wed, Nov 01, 2023 at 03:46:38PM +0000, Helge Kreutzmann wrote:
> Hello Alejandro,
> Am Wed, Nov 01, 2023 at 04:41:19PM +0100 schrieb Alejandro Colomar:
> > On Wed, Nov 01, 2023 at 02:02:11PM +0000, Helge Kreutzmann wrote:
> > > Without further ado, the following was found:
> > > 
> > > Issue:    B<nsswitch.conf> → I<nsswitch.conf>
> > 
> > Please explain why.
> 
> Filenames are usually in italics, not bold.

If it's a filename, I think the full path would be better.  It could
also be a manual page reference, in which case, it's lacking the section.

I think the manual page reference would be better, but I'm not sure.
What do you think?

Cheers,
Alex

> 
> 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/



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

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

Re: Issue in man page hostname.7

[Helge Kreutzmann]

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

Hello Alejandro,
Am Wed, Nov 01, 2023 at 05:59:51PM +0100 schrieb Alejandro Colomar:
> On Wed, Nov 01, 2023 at 03:46:38PM +0000, Helge Kreutzmann wrote:
> > Hello Alejandro,
> > Am Wed, Nov 01, 2023 at 04:41:19PM +0100 schrieb Alejandro Colomar:
> > > On Wed, Nov 01, 2023 at 02:02:11PM +0000, Helge Kreutzmann wrote:
> > > > Without further ado, the following was found:
> > > > 
> > > > Issue:    B<nsswitch.conf> → I<nsswitch.conf>
> > > 
> > > Please explain why.
> > 
> > Filenames are usually in italics, not bold.
> 
> If it's a filename, I think the full path would be better.  It could
> also be a manual page reference, in which case, it's lacking the section.
> 
> I think the manual page reference would be better, but I'm not sure.
> What do you think?

Yes.

I'd prefer the latter, i.e. with section.

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 hostname.7

[Alejandro Colomar]

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

Hi Helge,

On Wed, Nov 01, 2023 at 05:05:27PM +0000, Helge Kreutzmann wrote:
> Hello Alejandro,
> Am Wed, Nov 01, 2023 at 05:59:51PM +0100 schrieb Alejandro Colomar:
> > On Wed, Nov 01, 2023 at 03:46:38PM +0000, Helge Kreutzmann wrote:
> > > Hello Alejandro,
> > > Am Wed, Nov 01, 2023 at 04:41:19PM +0100 schrieb Alejandro Colomar:
> > > > On Wed, Nov 01, 2023 at 02:02:11PM +0000, Helge Kreutzmann wrote:
> > > > > Without further ado, the following was found:
> > > > > 
> > > > > Issue:    B<nsswitch.conf> → I<nsswitch.conf>
> > > > 
> > > > Please explain why.
> > > 
> > > Filenames are usually in italics, not bold.
> > 
> > If it's a filename, I think the full path would be better.  It could
> > also be a manual page reference, in which case, it's lacking the section.
> > 
> > I think the manual page reference would be better, but I'm not sure.
> > What do you think?
> 
> Yes.
> 
> I'd prefer the latter, i.e. with section.

Fixed:
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=c4eed0a0374ae69dd785f6f35c62256705cfadfc>

Thanks,
Alex

> 
> 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/



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

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