Re: SIGNAL(7): Still "calling process" instead of "calling thread".

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Robin,

On 05/15/2018 10:13 PM, Robin Kuzmin wrote:
> Michael,
> Thank you for releasing man-pages-4.16!
>
> More feedback:
> 1. http://man7.org/linux/man-pages/man7/signal.7.html
> I see:
> "suspend execution of the calling process or thread".
> I suspect it should be:
> "suspend execution of the calling thread".

Agreed, and fixed. Thanks for the report.

> 2. I recommend reviewing the whole set of man pages, in some cases the
> phrase "calling process" needs to be replaced by "calling thread" (or
> removed).

Yes, but who do you recommend shall do this work? (It's a rhetorical
question, but I hope you take the point.)[*]

Thanks,

Michael

[*] I did also fix two or three other pages.

> Robin Kuzmin
> kuzmin.robin@xxxxxxxxx
>
>
> On Thu, Apr 5, 2018 at 10:34 AM, Michael Kerrisk (man-pages)
> <mtk.manpages@xxxxxxxxx> wrote:
>> Helo Robin,
>>
>> On 04/04/2018 08:26 PM, Robin Kuzmin wrote:
>>> Michael,
>>> I'm going to http://man7.org/linux/man-pages/man2/waitpid.2.html
>>> and after the word "calling"
>>> I see the word "process"
>>
>> That HTML rendering is updates about once every 10 weeks, after each
>> man-pages release. (You can see when the rendering was created by
>> looking at the COLOPHON at the bottom of the page.)
>>
>> You need to look in the git repo to see the latest changes.
>>
>> Thanks,
>>
>> Michael
>>
>>
>>> but I expected to see the word "thread"
>>> in the following sentences:
>>> * The wait() system call suspends execution of the calling process
>>>        until one of its children terminates.
>>> * The waitpid() system call suspends execution of the calling process
>>>        until a child specified by pid argument has changed state.
>>>
>>> Robin Kuzmin
>>> kuzmin.robin@xxxxxxxxx
>>>
>>>
>>> On Sat, Mar 31, 2018 at 8:08 PM, Michael Kerrisk (man-pages)
>>> <mtk.manpages@xxxxxxxxx> wrote:
>>>> Hello Robin,
>>>>
>>>> On 30 March 2018 at 01:37, Robin Kuzmin <kuzmin.robin@xxxxxxxxx> wrote:
>>>>> I still see "the calling process" and no any occurrence of "the calling
>>>>> thread".
>>>>
>>>> I did make changes to the page! Can you please quote the text that
>>>> still seems wrong to you.
>>>>
>>>> Thanks,
>>>>
>>>> Michael
>>>>
>>>>> Robin Kuzmin
>>>>> kuzmin.robin@xxxxxxxxx
>>>>>
>>>>> On Tue, Mar 27, 2018 at 1:14 PM, Michael Kerrisk (man-pages)
>>>>> <mtk.manpages@xxxxxxxxx> wrote:
>>>>>>
>>>>>> Hello Robin,
>>>>>>
>>>>>> On 03/20/2018 10:07 PM, Robin Kuzmin wrote:
>>>>>>> I again see "the calling process" instead of "the calling thread".
>>>>>>> Is there anything I need to know?
>>>>>>
>>>>>> The change was made, but perhaps I had not yet pushed it. Please
>>>>>> check again.
>>>>>>
>>>>>> Thanks,
>>>>>>
>>>>>> Michael
>>>>>>
>>>>>>> Robin Kuzmin
>>>>>>> kuzmin.robin@xxxxxxxxx
>>>>>>>
>>>>>>>
>>>>>>> On Sat, Feb 24, 2018 at 11:49 AM, Michael Kerrisk (man-opages)
>>>>>>> <mtk.manpages@xxxxxxxxx> wrote:
>>>>>>>> Hello Robin,
>>>>>>>>
>>>>>>>>
>>>>>>>> On 02/13/2018 01:51 AM, Robin Kuzmin wrote:
>>>>>>>>>
>>>>>>>>> http://man7.org/linux/man-pages/man2/waitpid.2.html
>>>>>>>>> 1.
>>>>>>>>> I see: "The wait() system call suspends execution of the calling
>>>>>>>>> process...".
>>>>>>>>> I expected: "The wait() system call suspends execution of the calling
>>>>>>>>> thread...".
>>>>>>>>> 2.
>>>>>>>>> I see: "The waitpid() system call suspends execution of the calling
>>>>>>>>> process...".
>>>>>>>>> I expected: "The waitpid() system call suspends execution of the
>>>>>>>>> calling thread...".
>>>>>>>>
>>>>>>>>
>>>>>>>> Thanks. Fixed now.
>>>>>>>>
>>>>>>>> Cheers,
>>>>>>>>
>>>>>>>> Michael
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>
>>>>>>
>>>>>> --
>>>>>> Michael Kerrisk
>>>>>> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
>>>>>> Linux/UNIX System Programming Training: http://man7.org/training/
>>>>>
>>>>>
>>>>
>>>>
>>>>
>>>> --
>>>> Michael Kerrisk
>>>> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
>>>> Linux/UNIX System Programming Training: http://man7.org/training/
>>>
>>
>>
>> --
>> Michael Kerrisk
>> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
>> Linux/UNIX System Programming Training: http://man7.org/training/
>

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux