casaroli commented on code in PR #20747:
URL: https://github.com/apache/nuttx/pull/20747#discussion_r4306737121


##########
Documentation/os/libs/libc/index.rst:
##########
@@ -70,6 +70,26 @@ directory::
 
   misc      - Nonstandard "glue" logic, nuttx/debug.h, crc32.h, dirent.h
 
+Non-standard Names in the Headers
+=================================
+
+Some headers define names for the OS that C and POSIX do not reserve.
+A portable program that uses such a name for its own purpose can define
+one of these macros before its first ``#include``:
+
+``NUTTX_NO_GETOPT_MACROS``

Review Comment:
   I felt to keep `NUTTX_NO_GETOPT_MACROS` separate because it is for specific 
posix names, while `NUTTX_NO_EXTENSIONS` would be for any generic names.
   
   If you prefer we can either:
   1. keep `NUTTX_NO_GETOPT_MACROS` separate
   2. gate `geotopt` on `NUTTX_NO_EXTENSIONS` instead
   3. set `NUTTX_NO_GETOPT_MACROS` if `NUTTX_NO_EXTENSIONS` is set.
   
   I prefer 1, but it is your call.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to