Index: /trunk/include/iprt/dir.h
===================================================================
--- /trunk/include/iprt/dir.h	(revision 39640)
+++ /trunk/include/iprt/dir.h	(revision 39641)
@@ -53,5 +53,6 @@
 /** @name RTDirCreate  flags.
  * @{ */
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTDIRCREATE_FLAGS_NO_SYMLINKS  RT_BIT(0)
 /** @} */
@@ -304,5 +305,6 @@
 /** @name RTDirOpenFiltered  flags.
  * @{ */
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTDIROPEN_FLAGS_NO_SYMLINKS  RT_BIT(0)
 /** @} */
Index: /trunk/include/iprt/file.h
===================================================================
--- /trunk/include/iprt/file.h	(revision 39640)
+++ /trunk/include/iprt/file.h	(revision 39641)
@@ -213,5 +213,6 @@
 #define RTFILE_O_NO_CACHE               UINT32_C(0x00080000)
 
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTFILE_O_NO_SYMLINKS            UINT32_C(0x20000000)
 
@@ -565,5 +566,6 @@
 /** Replace destination file if present. */
 #define RTFILEMOVE_FLAGS_REPLACE      0x1
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTFILEMOVE_FLAGS_NO_SYMLINKS  0x2
 /** @} */
Index: /trunk/include/iprt/path.h
===================================================================
--- /trunk/include/iprt/path.h	(revision 39640)
+++ /trunk/include/iprt/path.h	(revision 39641)
@@ -127,5 +127,6 @@
 /** Last component: Follow if link. */
 #define RTPATH_F_FOLLOW_LINK      RT_BIT_32(1)
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTPATH_F_NO_SYMLINKS      RT_BIT_32(2)
 /** @} */
@@ -894,5 +895,6 @@
 /** This will replace attempt any target which isn't a directory. */
 #define RTPATHRENAME_FLAGS_REPLACE      RT_BIT(0)
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTPATHRENAME_FLAGS_NO_SYMLINKS  RT_BIT(1)
 /** @} */
@@ -913,5 +915,6 @@
 /** @name RTPathUnlink flags.
  * @{ */
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTPATHUNLINK_FLAGS_NO_SYMLINKS  RT_BIT(0)
 /** @} */
Index: /trunk/include/iprt/symlink.h
===================================================================
--- /trunk/include/iprt/symlink.h	(revision 39640)
+++ /trunk/include/iprt/symlink.h	(revision 39641)
@@ -88,5 +88,6 @@
 /** @name RTSymlinkCreate flags.
  * @{ */
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTSYMLINKCREATE_FLAGS_NO_SYMLINKS  RT_BIT(0)
 /** @} */
@@ -99,5 +100,5 @@
  * @param   pszSymlink      The name of the symbolic link.
  * @param   pszTarget       The path to the symbolic link target.  This is
- *                          relative to @a pszSymlink.
+ *                          relative to @a pszSymlink or an absolute path.
  * @param   enmType         The symbolic link type.  For Windows compatability
  *                          it is very important to set this correctly.  When
@@ -112,5 +113,6 @@
 /** @name RTSymlinkDelete flags.
  * @{ */
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTSYMLINKDELETE_FLAGS_NO_SYMLINKS  RT_BIT(0)
 /** @} */
@@ -132,5 +134,6 @@
 /** @name RTSymlinkRead  flags.
  * @{ */
-/** Don't allow symbolic links as part of the path. */
+/** Don't allow symbolic links as part of the path.
+ * @remarks this flag is currently not implemented and will be ignored. */
 #define RTSYMLINKREAD_FLAGS_NO_SYMLINKS  RT_BIT(0)
 /** @} */