[newlib-cygwin] Cygwin: add short comments to path_conv options

[Corinna Vinschen]

https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=2caaa810a39075cbf0eb857459a2eef95bf4463f

commit 2caaa810a39075cbf0eb857459a2eef95bf4463f
Author: Corinna Vinschen <corinna@vinschen.de>
Date:   Tue Jan 28 16:10:13 2020 +0100

    Cygwin: add short comments to path_conv options
    
    Signed-off-by: Corinna Vinschen <corinna@vinschen.de>

Diff:
---
 winsup/cygwin/path.h | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/winsup/cygwin/path.h b/winsup/cygwin/path.h
index e76157b..72f4bda 100644
--- a/winsup/cygwin/path.h
+++ b/winsup/cygwin/path.h
@@ -44,20 +44,21 @@ extern suffix_info stat_suffixes[];
    below path_types.  Ever. */
 enum pathconv_arg
 {
-  PC_SYM_FOLLOW		 = _BIT ( 0),
-  PC_SYM_NOFOLLOW	 = _BIT ( 1),
-  PC_SYM_NOFOLLOW_REP	 = _BIT ( 2),
-  PC_SYM_CONTENTS	 = _BIT ( 3),
-  PC_NOFULL		 = _BIT ( 4),
-  PC_NULLEMPTY		 = _BIT ( 5),
-  PC_NONULLEMPTY	 = _BIT ( 6),
-  PC_POSIX		 = _BIT ( 7),
-  PC_NOWARN		 = _BIT ( 8),
+  PC_SYM_FOLLOW		 = _BIT ( 0),	/* follow symlinks */
+  PC_SYM_NOFOLLOW	 = _BIT ( 1),	/* don't follow symlinks (but honor
+					   trailing slashes) */
+  PC_SYM_NOFOLLOW_REP	 = _BIT ( 2),	/* don't follow dir reparse point */
+  PC_SYM_CONTENTS	 = _BIT ( 3),	/* don't follow, return content only */
+  PC_NOFULL		 = _BIT ( 4),	/* keep relative path */
+  PC_NULLEMPTY		 = _BIT ( 5),	/* empty path is no error */
+  PC_NONULLEMPTY	 = _BIT ( 6),	/* override PC_NULLEMPTY default */
+  PC_POSIX		 = _BIT ( 7),	/* return normalized posix path */
+  PC_NOWARN		 = _BIT ( 8),	/* don't emit ms-dos path warning */
   PC_OPEN		 = _BIT ( 9),	/* use open semantics */
   PC_CTTY		 = _BIT (10),	/* could later be used as ctty */
-  PC_SYM_NOFOLLOW_PROCFD = _BIT (11),
-  PC_KEEP_HANDLE	 = _BIT (12),
-  PC_NO_ACCESS_CHECK	 = _BIT (13),
+  PC_SYM_NOFOLLOW_PROCFD = _BIT (11),	/* allow /proc/PID/fd redirection */
+  PC_KEEP_HANDLE	 = _BIT (12),	/* keep handle for later stat calls */
+  PC_NO_ACCESS_CHECK	 = _BIT (13),	/* helper flag for error check */
   PC_DONT_USE		 = _BIT (31)	/* conversion to signed happens. */
 };