Document AT_FDCWD path decoding feature

* doc/strace.1.in (-e decode-fds, -y): Mention that current working
directory is printed on AT_FDCWD occurrence in addition to fd path decoding.
* NEWS: Mention it.

Complements: v5.14-199-g48de116c2 "Print cwd path for AT_FDCWD when -y (--decode-fd=path) option is used"

2 files changed, 8 insertions, 1 deletions

diff --git a/NEWS b/NEWS
index 36cc6e1a1..609cfec9a 100644
--- a/NEWS
+++ b/NEWS
@@ -7,6 +7,8 @@ Noteworthy changes in release ?.?? (????-??-??)
   * Implemented --decode-pids=comm option (and its alias -Y) for printing
     command names for PIDs.
   * Implemented --decode-pids=pidns as an alias to --pidns-translation option.
+  * Implemented printing of current working directory when AT_FDCWD constant
+    is used with --decode-fds=path option enabled.
   * Improved printing of syscall names in places where the associated
     AUDIT_ARCH_* value is present (ptrace PTRACE_GET_SYSCALL_INFO request,
     SIGSYS siginfo_t).
diff --git a/doc/strace.1.in b/doc/strace.1.in
index 91a0075ec..b716a06bd 100644
--- a/doc/strace.1.in
+++ b/doc/strace.1.in
@@ -859,6 +859,9 @@ can include the following elements:
 .TP 8
 .B path
 Print file paths.
+Also enables printing of tracee's current working directory when
+.B AT_FDCWD
+constant is used.
 .TQ
 .B socket
 Print socket protocol-specific information,
@@ -1140,7 +1143,9 @@ Output both the raw value and the decoded string (as a comment).
 .B \-\-decode\-fds
 .TQ
 .BR \-\-decode\-fds = path
-Print paths associated with file descriptor arguments.
+Print paths associated with file descriptor arguments and with the
+.B AT_FDCWD
+constant.
 .TP
 .B \-yy
 .TQ