include/debug.h: Move to include/nuttx/debug.h

debug.h is a NuttX-specific, non-POSIX header. Placing it in the
top-level include/ directory creates naming conflicts with external
projects that define their own debug.h.
This commit moves the canonical header to include/nuttx/debug.h,
following the NuttX convention for non-POSIX/non-standard headers,
and updates all in-tree references.

A backward-compatibility shim is left at include/debug.h that
emits a deprecation #warning and re-includes <nuttx/debug.h>,
allowing out-of-tree code to continue building while migrating.

Signed-off-by: Piyush Patle <piyushpatle228@gmail.com>

Documentation/components/drivers/special/syslog.rst

@@ -97,7 +97,7 @@ Debug Interfaces
 
 In NuttX, syslog output is really synonymous to debug output and,
 therefore, the debugging interface macros defined in the header
-file ``include/debug.h`` are also syslogging interfaces. Those
+file ``include/nuttx/debug.h`` are also syslogging interfaces. Those
 macros are simply wrappers around ``syslog()``. The debugging
 interfaces differ from the syslog interfaces in that:
 

Documentation/components/libs/libc/index.rst

@@ -68,7 +68,7 @@ There is also a ``misc/`` subdirectory that contains various internal functions
 and interfaces from header files that are too few to warrant their own sub-
 directory::
 
-  misc      - Nonstandard "glue" logic, debug.h, crc32.h, dirent.h
+  misc      - Nonstandard "glue" logic, nuttx/debug.h, crc32.h, dirent.h
 
 Library Database
 ================

Documentation/guides/porting-case-studies/port_arm_cm4.rst

@@ -936,7 +936,7 @@ Appendix : out-of-tree code
   +
   +#include <nuttx/config.h>
   +
-  +#include <debug.h>
+  +#include <nuttx/debug.h>
   +
   +#include <nuttx/board.h>
   +#include <arch/board/board.h>

Documentation/platforms/arm/stm32f1/boards/stm32_tiny/index.rst

@@ -368,7 +368,7 @@ NOTES:
              for this.
 
            - /dev/console still exists and still refers to the serial port. So
-             you can still use certain kinds of debug output (see include/debug.h, all
+             you can still use certain kinds of debug output (see include/nuttx/debug.h, all
              of the debug output from interrupt handlers will be lost.
 
            - But don't enable USB debug output!  Since USB is console is used for

Documentation/platforms/arm/stm32f4/boards/stm32f429i-disco/index.rst

@@ -504,7 +504,7 @@ NOTES:
       for this.
 
     - /dev/console still exists and still refers to the serial port. So
-      you can still use certain kinds of debug output (see include/debug.h, all
+      you can still use certain kinds of debug output (see include/nuttx/debug.h, all
       debug output from interrupt handlers will be lost.
 
     - But don't enable USB debug output!  Since USB is console is used for

Documentation/platforms/arm/stm32f4/boards/stm32f4discovery/index.rst

@@ -1644,7 +1644,7 @@ NOTES:
         for this.
 
       - /dev/console still exists and still refers to the serial port. So
-        you can still use certain kinds of debug output (see include/debug.h, all
+        you can still use certain kinds of debug output (see include/nuttx/debug.h, all
         of the debug output from interrupt handlers will be lost.
 
       - But don't enable USB debug output!  Since USB is console is used for

Documentation/quickstart/debugging.rst

@@ -27,7 +27,7 @@ following options:
 You can then select from the subsystems that are available, Network, Scheduler, USB, etc. Note that you will need to
 separately enable the subsystem elsewhere in the ``menuconfig`` system. To see the ``CONFIG`` define that is set,
 use the arrow keys to highlight the subsystem (for instance, :menuselection:`Network Debug Features`) and type :kbd:`?`. This will show
-you that the C macro that is set is called ``CONFIG_DEBUG_NET``. ``debug.h`` defines the ``netinfo()`` logging
+you that the C macro that is set is called ``CONFIG_DEBUG_NET``. ``nuttx/debug.h`` defines the ``netinfo()`` logging
 function that will log output if this macro is set. You can search the source code for ``netinfo`` to see how it is
 used.
 
@@ -39,13 +39,13 @@ used.
 Note that enabling all these will produce an incredible amount of logging output. Enable the level you want and
 the area you're interested in, and leave the rest disabled, save the config, and then recompile. You can see the full
 list of debug feature logging functions in the file
-`debug.h <https://github.com/apache/nuttx/blob/master/include/debug.h>`__.
+`debug.h <https://github.com/apache/nuttx/blob/master/include/nuttx/debug.h>`__.
 
 Syslog timestamps can be enabled in the configuration in :menuselection:`Device Drivers --> System Logging --> Prepend
 timestamp to syslog message` (``CONFIG_SYSLOG_TIMESTAMP``).
 
 You may need to do a little bit of experimenting to find the combination of logging settings that work for the problem
-you're trying to solve. See the file `debug.h <https://github.com/apache/nuttx/blob/master/include/debug.h>`_
+you're trying to solve. See the file `debug.h <https://github.com/apache/nuttx/blob/master/include/nuttx/debug.h>`_
 for available debug settings that are available.
 
 There are also subsystems that enable USB trace debugging, and you can log to memory too, if you need the logging to be

arch/arm/src/a1x/a1x_irq.c

@@ -29,8 +29,8 @@
 #include <stdint.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 

arch/arm/src/a1x/a1x_pio.c

@@ -29,8 +29,8 @@
 #include <stdint.h>
 #include <time.h>
 #include <errno.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 #include <arch/board/board.h>

arch/arm/src/a1x/a1x_serial.c

@@ -34,7 +34,7 @@
 #include <string.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #ifdef CONFIG_SERIAL_TERMIOS
 #  include <termios.h>
 #endif

arch/arm/src/am335x/am335x_boot.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/cache.h>
 #ifdef CONFIG_LEGACY_PAGING

arch/arm/src/am335x/am335x_edid.c

@@ -45,7 +45,7 @@
 #include <string.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/video/edid.h>
 

arch/arm/src/am335x/am335x_i2c.c

@@ -33,7 +33,7 @@
 #include <stdbool.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <nuttx/irq.h>

arch/arm/src/am335x/am335x_lcdc.c

@@ -45,7 +45,7 @@
 #include <string.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <nuttx/video/fb.h>

arch/arm/src/am335x/am335x_serial.c

@@ -33,7 +33,7 @@
 #include <string.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #ifdef CONFIG_SERIAL_TERMIOS
 #  include <termios.h>
 #endif

arch/arm/src/arm/arm_allocpage.c

@@ -30,7 +30,7 @@
 #include <stdbool.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 

arch/arm/src/arm/arm_checkmapping.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 #include <nuttx/page.h>

arch/arm/src/arm/arm_dataabort.c

@@ -29,8 +29,8 @@
 #include <inttypes.h>
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 
 #include "sched/sched.h"

arch/arm/src/arm/arm_pginitialize.c

@@ -26,7 +26,7 @@
 
 #include <nuttx/config.h>
 
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 #include <nuttx/page.h>

arch/arm/src/arm/arm_prefetchabort.c

@@ -29,8 +29,8 @@
 #include <inttypes.h>
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #ifdef CONFIG_LEGACY_PAGING
 #  include <nuttx/page.h>

arch/arm/src/arm/arm_schedulesigaction.c

@@ -28,8 +28,8 @@
 
 #include <stdint.h>
 #include <sched.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 

arch/arm/src/arm/arm_sigdeliver.c

@@ -29,8 +29,8 @@
 #include <stdint.h>
 #include <sched.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 #include <nuttx/board.h>

arch/arm/src/arm/arm_syscall.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #include <syscall.h>
 
 #include <nuttx/addrenv.h>

arch/arm/src/arm/arm_undefinedinsn.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <sched/sched.h>

arch/arm/src/arm/arm_va2pte.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 #include <nuttx/page.h>

arch/arm/src/armv6-m/arm_dumpnvic.c

@@ -27,8 +27,8 @@
 #include <nuttx/config.h>
 #include <nuttx/coredump.h>
 #include <sys/types.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 
 #include "arm_internal.h"

arch/arm/src/armv6-m/arm_hardfault.c

@@ -29,7 +29,7 @@
 #include <stdint.h>
 #include <string.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <arch/irq.h>
 

arch/arm/src/armv6-m/arm_ramvec_attach.c

@@ -27,8 +27,8 @@
 #include <nuttx/config.h>
 
 #include <errno.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 #include <nuttx/spinlock.h>

arch/arm/src/armv6-m/arm_ramvec_initialize.c

@@ -27,7 +27,7 @@
 #include <nuttx/config.h>
 
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #include <inttypes.h>
 
 #include <nuttx/arch.h>

arch/arm/src/armv6-m/arm_schedulesigaction.c

@@ -29,8 +29,8 @@
 #include <stdint.h>
 #include <sched.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 

arch/arm/src/armv6-m/arm_sigdeliver.c

@@ -29,8 +29,8 @@
 #include <stdint.h>
 #include <sched.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>
 #include <nuttx/board.h>

arch/arm/src/armv6-m/arm_svcall.c

@@ -30,7 +30,7 @@
 #include <stdint.h>
 #include <string.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #include <syscall.h>
 
 #include <arch/irq.h>

arch/arm/src/armv7-a/arm_addrenv.c

@@ -97,7 +97,7 @@
 
 #include <string.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <nuttx/pgalloc.h>

arch/arm/src/armv7-a/arm_addrenv_kstack.c

@@ -98,7 +98,7 @@
 
 #include <errno.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 #include <nuttx/kmalloc.h>

arch/arm/src/armv7-a/arm_addrenv_ustack.c

@@ -81,7 +81,7 @@
 
 #include <string.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <nuttx/sched.h>

arch/arm/src/armv7-a/arm_addrenv_utils.c

@@ -29,7 +29,7 @@
 #include <string.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/pgalloc.h>
 #include <nuttx/irq.h>

arch/arm/src/armv7-a/arm_allocpage.c

@@ -30,7 +30,7 @@
 #include <stdbool.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 

arch/arm/src/armv7-a/arm_checkmapping.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 #include <nuttx/page.h>

arch/arm/src/armv7-a/arm_cpu_psci.c

@@ -25,7 +25,7 @@
  ***************************************************************************/
 
 #include <nuttx/config.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #include <assert.h>
 #include <nuttx/arch.h>
 #include <arch/irq.h>

arch/arm/src/armv7-a/arm_cpustart.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <nuttx/sched.h>

arch/arm/src/armv7-a/arm_dataabort.c

@@ -28,8 +28,8 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 
 #include "mmu.h"

arch/arm/src/armv7-a/arm_doirq.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/addrenv.h>
 #include <nuttx/irq.h>

arch/arm/src/armv7-a/arm_gicv2_dump.c

@@ -28,7 +28,7 @@
 
 #include <stdint.h>
 #include <syslog.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include "arm_internal.h"
 #include "gic.h"

arch/arm/src/armv7-a/arm_hwdebug.c

@@ -30,7 +30,7 @@
 #include <stdint.h>
 #include <string.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 #include <arch/armv7-a/cp14.h>
 
 /****************************************************************************

arch/arm/src/armv7-a/arm_l2cc_pl310.c

@@ -35,8 +35,8 @@
 #include <stdint.h>
 #include <sys/param.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/spinlock.h>
 

arch/arm/src/armv7-a/arm_pgalloc.c

@@ -29,8 +29,8 @@
 #include <string.h>
 #include <assert.h>
 #include <errno.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/sched.h>
 #include <nuttx/arch.h>

arch/arm/src/armv7-a/arm_pginitialize.c

@@ -26,7 +26,7 @@
 
 #include <nuttx/config.h>
 
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/sched.h>
 #include <nuttx/page.h>

arch/arm/src/armv7-a/arm_physpgaddr.c

@@ -28,7 +28,7 @@
 
 #include <sys/types.h>
 #include <assert.h>
-#include <debug.h>
+#include <nuttx/debug.h>
 
 #include <nuttx/arch.h>
 #include <nuttx/addrenv.h>

arch/arm/src/armv7-a/arm_prefetchabort.c

@@ -28,8 +28,8 @@
 
 #include <stdint.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #ifdef CONFIG_LEGACY_PAGING
 #  include <nuttx/page.h>

arch/arm/src/armv7-a/arm_schedulesigaction.c

@@ -29,8 +29,8 @@
 #include <stdint.h>
 #include <sched.h>
 #include <assert.h>
-#include <debug.h>
 
+#include <nuttx/debug.h>
 #include <nuttx/irq.h>
 #include <nuttx/arch.h>