This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [patch-ish, WIP] Enhance comments in nsswitch.h
- From: DJ Delorie <dj at redhat dot com>
- To: "Carlos O'Donell" <codonell at redhat dot com>
- Cc: libc-alpha at sourceware dot org
- Date: Wed, 08 May 2019 17:39:26 -0400
- Subject: Re: [patch-ish, WIP] Enhance comments in nsswitch.h
"Carlos O'Donell" <codonell@redhat.com> writes:
>> + /* And the link to the next entry. In a typical nsswitch.conf, this
>> + is the passwd->group->hosts link. */
>
> What does this mean? That this is the next entry in the file after
> translating it into a lit of entries (excluding comments)?
It's a link to, essentially, the next non-comment line in nsswitch.conf.
There are a lot of things labelled "next" in this header, keeping track
of next *what* is important.
We also don't have a lot of consistency and well-known terms for things
like "passwd or hosts" vs "dns or files" etc.
>> +/* The rest of this header is not-data. */
>
> Remove this comment.
This is just a hint to me to stop reading the file ;-)