[PATCH] stat.2: tweak description of AT_EMPTY_PATH

[PATCH] stat.2: tweak description of AT_EMPTY_PATH

[Marcin Ślusarz]

Currently it says when dirfd is AT_FDCWD it can be something
other than directory, which doesn't make much sense. Just swap
the order of sentences.

Signed-off-by: Marcin Ślusarz <marcin.slusarz-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
---
 man2/stat.2 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/man2/stat.2 b/man2/stat.2
index 1d838a9..7ec2593 100644
--- a/man2/stat.2
+++ b/man2/stat.2
@@ -506,14 +506,14 @@ is an empty string, operate on the file referred to by
 .BR open (2)
 .B O_PATH
 flag).
+In this case,
+.I dirfd
+can refer to any type of file, not just a directory.
 If
 .I dirfd
 is
 .BR AT_FDCWD ,
 the call operates on the current working directory.
-In this case,
-.I dirfd
-can refer to any type of file, not just a directory.
 This flag is Linux-specific; define
 .B _GNU_SOURCE
 .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
-- 
2.9.3
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] stat.2: tweak description of AT_EMPTY_PATH

[Michael Kerrisk (man-pages)]

Hello Marcin

On 04/01/2017 09:23 PM, Marcin Ślusarz wrote:
> Currently it says when dirfd is AT_FDCWD it can be something
> other than directory, which doesn't make much sense. Just swap
> the order of sentences.
> 
> Signed-off-by: Marcin Ślusarz <marcin.slusarz-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
> ---
>  man2/stat.2 | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/man2/stat.2 b/man2/stat.2
> index 1d838a9..7ec2593 100644
> --- a/man2/stat.2
> +++ b/man2/stat.2
> @@ -506,14 +506,14 @@ is an empty string, operate on the file referred to by
>  .BR open (2)
>  .B O_PATH
>  flag).
> +In this case,
> +.I dirfd
> +can refer to any type of file, not just a directory.
>  If
>  .I dirfd
>  is
>  .BR AT_FDCWD ,
>  the call operates on the current working directory.
> -In this case,
> -.I dirfd
> -can refer to any type of file, not just a directory.
>  This flag is Linux-specific; define
>  .B _GNU_SOURCE
>  .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed

Thanks! Patch applied.

Cheers,

Michael



-- 
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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] stat.2: tweak description of AT_EMPTY_PATH

[Marcin Ślusarz]

2017-04-10 17:21 GMT+02:00 Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>:
> Hello Marcin
>
> On 04/01/2017 09:23 PM, Marcin Ślusarz wrote:
>> Currently it says when dirfd is AT_FDCWD it can be something
>> other than directory, which doesn't make much sense. Just swap
>> the order of sentences.
>>
>> Signed-off-by: Marcin Ślusarz <marcin.slusarz-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
>> ---
>>  man2/stat.2 | 6 +++---
>>  1 file changed, 3 insertions(+), 3 deletions(-)
>>
>> diff --git a/man2/stat.2 b/man2/stat.2
>> index 1d838a9..7ec2593 100644
>> --- a/man2/stat.2
>> +++ b/man2/stat.2
>> @@ -506,14 +506,14 @@ is an empty string, operate on the file referred to by
>>  .BR open (2)
>>  .B O_PATH
>>  flag).
>> +In this case,
>> +.I dirfd
>> +can refer to any type of file, not just a directory.
>>  If
>>  .I dirfd
>>  is
>>  .BR AT_FDCWD ,
>>  the call operates on the current working directory.
>> -In this case,
>> -.I dirfd
>> -can refer to any type of file, not just a directory.
>>  This flag is Linux-specific; define
>>  .B _GNU_SOURCE
>>  .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
>
> Thanks! Patch applied.

I'm not seeing it in any of these trees:
https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
https://github.com/mkerrisk/man-pages

Some secret repo? ;)

Marcin
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] stat.2: tweak description of AT_EMPTY_PATH

[Michael Kerrisk (man-pages)]

On 04/12/2017 08:35 PM, Marcin Ślusarz wrote:
> 2017-04-10 17:21 GMT+02:00 Michael Kerrisk (man-pages) <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>:
>> Hello Marcin
>>
>> On 04/01/2017 09:23 PM, Marcin Ślusarz wrote:
>>> Currently it says when dirfd is AT_FDCWD it can be something
>>> other than directory, which doesn't make much sense. Just swap
>>> the order of sentences.
>>>
>>> Signed-off-by: Marcin Ślusarz <marcin.slusarz-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
>>> ---
>>>  man2/stat.2 | 6 +++---
>>>  1 file changed, 3 insertions(+), 3 deletions(-)
>>>
>>> diff --git a/man2/stat.2 b/man2/stat.2
>>> index 1d838a9..7ec2593 100644
>>> --- a/man2/stat.2
>>> +++ b/man2/stat.2
>>> @@ -506,14 +506,14 @@ is an empty string, operate on the file referred to by
>>>  .BR open (2)
>>>  .B O_PATH
>>>  flag).
>>> +In this case,
>>> +.I dirfd
>>> +can refer to any type of file, not just a directory.
>>>  If
>>>  .I dirfd
>>>  is
>>>  .BR AT_FDCWD ,
>>>  the call operates on the current working directory.
>>> -In this case,
>>> -.I dirfd
>>> -can refer to any type of file, not just a directory.
>>>  This flag is Linux-specific; define
>>>  .B _GNU_SOURCE
>>>  .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
>>
>> Thanks! Patch applied.
> 
> I'm not seeing it in any of these trees:
> https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
> https://github.com/mkerrisk/man-pages
> 
> Some secret repo? ;)

No, I just hadn't pushed yet. Should be visible 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/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html