diff --git a/libs/libc/unistd/lib_getopt.c b/libs/libc/unistd/lib_getopt.c
index 8fdff8a4f94..bdd34564c21 100644
--- a/libs/libc/unistd/lib_getopt.c
+++ b/libs/libc/unistd/lib_getopt.c
@@ -64,7 +64,10 @@
  *      -1 is returned.  As a result, your command line parsing loops
  *      must call getopt() repeatedly and continue to parse if other
  *      errors are returned ('?' or ':') until getopt() finally returns -1.
- *     (You can also set optind to -1 to force a reset).
+ *      (You can also set optind to -1 to force a reset).
+ *   4. Standard getopt() permutes the contents of argv as it scans, so that
+ *      eventually all the nonoptions are at the end.  This implementation
+ *      does not do this.
  *
  * Returned Value:
  *   If an option was successfully found, then getopt() returns the option
diff --git a/libs/libc/unistd/lib_getopt_common.c b/libs/libc/unistd/lib_getopt_common.c
index 5c89b49ca50..750a596f730 100644
--- a/libs/libc/unistd/lib_getopt_common.c
+++ b/libs/libc/unistd/lib_getopt_common.c
@@ -327,6 +327,9 @@ errout:
  *      must call getopt() repeatedly and continue to parse if other
  *      errors are returned ('?' or ':') until getopt() finally returns -1.
  *     (You can also set optind to -1 to force a reset).
+ *   4. Standard getopt() permutes the contents of argv as it scans, so that
+ *      eventually all the nonoptions are at the end.  This implementation
+ *      does not do this.
  *
  * Returned Value:
  *   If an option was successfully found, then getopt() returns the option