[PATCH v2 3/5] manual: Document renameat

[Florian Weimer]

* Arjun Shankar:

> ---
>  manual/filesys.texi | 23 ++++++++++++++++++++++-
>  1 file changed, 22 insertions(+), 1 deletion(-)
>
> diff --git a/manual/filesys.texi b/manual/filesys.texi
> index e92730209c..776b98fe7f 100644
> --- a/manual/filesys.texi
> +++ b/manual/filesys.texi
> @@ -1826,6 +1826,28 @@ file systems.
>  @end table
>  @end deftypefun
>  
> +@deftypefun int renameat (int @var{oldfiledes}, const char *@var{oldname}, int @var{newfiledes}, const char *@var{newname})
> +@standards{POSIX.1-2008, stdio.h}
> +@comment Unaudited and therefore marked AC-Unsafe and AS-Unsafe by default
> +@safety{@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@acucorrupt{}}}
> +This function is a descriptor-relative version of the @code{rename}
> +function above.  @xref{Descriptor-Relative Access}.
> +
> +Compared to @code{rename}, the following additional error conditions can
> +occur:
> +
> +@table @code
> +@item EBADF
> +The @var{oldfiledes} and/or @var{newfiledes} arguments are not valid file
> +descriptors.

Should mention AT_FDCWD.  And this apparently only applies when the
corresponding paths are relative (as for all *at functions).

> +@item ENOTDIR
> +The descriptor @var{oldfiledes} is not associated with a directory, and
> +@var{oldname} is a relative file name, or correspondingly similar condition
> +for @var{newfiledes} and @var{newname}.
> +@end table
> +@end deftypefun

Likewise.

Thanks,
Florian