This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH 2/2] Document LIBC_PTHREAD_DEFAULT_STACKSIZE_NP
- From: Roland McGrath <roland at hack dot frob dot com>
- To: Siddhesh Poyarekar <siddhesh at redhat dot com>
- Cc: libc-alpha at sourceware dot org
- Date: Wed, 16 Jan 2013 15:52:10 -0800 (PST)
- Subject: Re: [PATCH 2/2] Document LIBC_PTHREAD_DEFAULT_STACKSIZE_NP
- References: <20130115100133.GM7894@spoyarek.pnq.redhat.com>
The name "NPTL" is an implementation artifact. The manual describes the
interface for users of the library, not the implementation. The right name
for a chapter about the pthreads interface is "pthreads" or "threads".
A chapter that doesn't actually document the interface and is fully of TODO
markers should not actually be included in the manual. I'm fine with
writing down fragments of documentation that don't yet have a sensible
place to live in the manual. But we won't include them in the manual until
they are part of a sensical whole.
Thanks,
Roland