Re: [PATCH 8/8] Add manual documentation for threads.h

[Rical Jasan <ricaljasan at pacific dot net>]

On 06/27/2017 01:54 PM, Adhemerval Zanella wrote:
> On 27/06/2017 17:52, Rical Jasan wrote:
>> On 06/27/2017 11:31 AM, Adhemerval Zanella wrote:
>>> This patch updates the manual and adds a new chapter to the manual,
>>> explaining types macros, constants and functions defined by ISO C11
>>> threads.h standard.
>>>
>>> 	* manual/Makefile (chapters): Add isothreads.texi.
>>> 	* manual/isothreads.texi: New file. Add new chapter for ISO C11
>>> 	threads documentation.
>>
>> Is there a reason for making this its own chapter and not having POSIX
>> Threads and ISO C11 Threads sections in threads.texi?  IOW, why not have
>> a chapter for Threads?
> 
> No reason in particular, I used the original submission as base for this
> patch.  I do not have a strong opinion here, so a chapter in threads.texi
> should be fine.

I would prefer a Threads chapter, but it would be good to hear if
anybody else had an opinion on the topical organization.

threads.texi is written as a POSIX Threads chapter (@chapter POSIX
Threads), and would need some reorganization to make POSIX Threads a
section.

Rical