Re: mbind.2 man page patch

[Michael Kerrisk <mtk-manpages@gmx.net>]

Lee Schermerhorn wrote:
> On Thu, 2007-07-26 at 19:19 +0200, Michael Kerrisk wrote:
>> [...]
>>>> +If the specified memory range includes a memory mapped file mapped using
>>>> +.BR mmap (2)
>>>> +with the
>>>> +.B MAP_SHARED
>>>> +flag, the specified policy will be ignored for all page allocations
>>>> +in this range.
>>>> +.\" FIXME Lee / Andi: can you clarify/confirm "the specified policy
>>>> +.\" will be ignored for all page allocations in this range".
>>>> +.\" That text seems to be saying that if the memory range contains
>>>> +.\" (say) some mappings that are allocated with MAP_SHARED
>>>> +.\" and others allocated with MAP_PRIVATE, then the policy
>>>> +.\" will be ignored for all of the mappings, including even
>>>> +.\" the MAP_PRIVATE mappings.  Right?  I just want to be
>>>> +.\" sure that that is what the text is meaning.
>>> I can see from the wording how you might think this.  However, policy
>>> will only be ignored for the SHARED mappings.  
>> So is a better wording something like:
>>
>>     The specified policy will be ignored for any MAP_SHARED
>>     file mappings in the specified memory range.
>>
> 
> Wish I'd written that ;-)

It's just like code.  Simpler is usually better ;0-).

> Seriously, that is correct.

Good.

Cheers,

Michael

-- 
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7

Want to help with man page maintenance?  Grab the latest tarball at
http://www.kernel.org/pub/linux/docs/manpages/
read the HOWTOHELP file and grep the source files for 'FIXME'.

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to majordomo@kvack.org.  For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"dont@kvack.org"> email@kvack.org </a>