docs: use glob pattern to match source code docs (#1918)

docs/source/source_code/source_code.rst

@@ -0,0 +1,91 @@
+Source Code
+===========
+We are in process of improving the source code documentation. Code should be documented using Doxygen syntax.
+Some examples exist in `main.h` and `main.cpp`. In order for documentation within the code to appear in the
+rendered docs, the definition of the object must be in a header file, although the documentation itself can (and
+should) be in the source file.
+
+Example Documentation Blocks
+----------------------------
+
+**file.h**
+
+.. code-block:: c
+
+   // functions
+   int main(int argc, char *argv[]);
+
+**file.cpp** (with markdown)
+
+.. code-block:: cpp
+
+   /**
+    * @brief Main application entry point.
+    * @param argc The number of arguments.
+    * @param argv The arguments.
+    *
+    * EXAMPLES:
+    * ```cpp
+    * main(1, const char* args[] = {"hello", "markdown", nullptr});
+    * ```
+    */
+   int main(int argc, char *argv[]) {
+     // do stuff
+   }
+
+**file.cpp** (with ReStructuredText)
+
+.. code-block:: cpp
+
+   /**
+    * @brief Main application entry point.
+    * @param argc The number of arguments.
+    * @param argv The arguments.
+    * @rst
+    * EXAMPLES:
+    *
+    * .. code-block:: cpp
+    *    main(1, const char* args[] = {"hello", "rst", nullptr});
+    * @endrst
+    */
+   int main(int argc, char *argv[]) {
+     // do stuff
+   }
+
+Source
+------
+
+.. toctree::
+   :caption: src
+   :maxdepth: 1
+   :glob:
+
+   src/*
+
+.. toctree::
+   :caption: src/platform
+   :maxdepth: 1
+   :glob:
+
+   src/platform/*
+
+.. toctree::
+   :caption: src/platform/linux
+   :maxdepth: 1
+   :glob:
+
+   src/platform/linux/*
+
+.. toctree::
+   :caption: src/platform/macos
+   :maxdepth: 1
+   :glob:
+
+   src/platform/macos/*
+
+.. toctree::
+   :caption: src/platform/windows
+   :maxdepth: 1
+   :glob:
+
+   src/platform/windows/*

docs/source/source_code/src/audio.rst

@@ -0,0 +1,5 @@
+audio
+=====
+
+.. doxygenfile:: audio.h
+   :allow-dot-graphs:

docs/source/source_code/src/cbs.rst

@@ -0,0 +1,5 @@
+cbs
+===
+
+.. doxygenfile:: cbs.h
+   :allow-dot-graphs:

docs/source/source_code/src/config.rst

@@ -0,0 +1,5 @@
+config
+======
+
+.. doxygenfile:: config.h
+   :allow-dot-graphs:

docs/source/source_code/src/confighttp.rst

@@ -0,0 +1,5 @@
+confighttp
+==========
+
+.. doxygenfile:: confighttp.h
+   :allow-dot-graphs:

docs/source/source_code/src/crypto.rst

@@ -0,0 +1,5 @@
+crypto
+======
+
+.. doxygenfile:: crypto.h
+   :allow-dot-graphs:

docs/source/source_code/src/httpcommon.rst

@@ -0,0 +1,5 @@
+httpcommon
+==========
+
+.. doxygenfile:: httpcommon.h
+   :allow-dot-graphs:

docs/source/source_code/src/input.rst

@@ -0,0 +1,5 @@
+input
+=====
+
+.. doxygenfile:: input.h
+   :allow-dot-graphs:

docs/source/source_code/src/main.rst

@@ -0,0 +1,5 @@
+main
+====
+
+.. doxygenfile:: main.h
+   :allow-dot-graphs:

docs/source/source_code/src/move_by_copy.rst

@@ -0,0 +1,5 @@
+move_by_copy
+============
+
+.. doxygenfile:: move_by_copy.h
+   :allow-dot-graphs:

docs/source/source_code/src/network.rst

@@ -0,0 +1,5 @@
+network
+=======
+
+.. doxygenfile:: network.h
+   :allow-dot-graphs:

docs/source/source_code/src/nvhttp.rst

@@ -0,0 +1,5 @@
+nvhttp
+======
+
+.. doxygenfile:: nvhttp.h
+   :allow-dot-graphs:

docs/source/source_code/src/platform/common.rst

@@ -0,0 +1,4 @@
+common
+======
+
+.. Todo:: Add common.h

docs/source/source_code/src/platform/linux/cuda.rst

@@ -0,0 +1,5 @@
+cuda
+====
+
+.. doxygenfile:: platform/linux/cuda.h
+   :allow-dot-graphs:

docs/source/source_code/src/platform/linux/graphics.rst

@@ -0,0 +1,4 @@
+graphics
+========
+
+.. Todo:: Add graphics.h

docs/source/source_code/src/platform/linux/misc.rst

@@ -0,0 +1,4 @@
+misc
+====
+
+.. Todo:: Add misc.h

docs/source/source_code/src/platform/linux/vaapi.rst

@@ -0,0 +1,5 @@
+vaapi
+=====
+
+.. doxygenfile:: platform/linux/vaapi.h
+   :allow-dot-graphs:

docs/source/source_code/src/platform/linux/wayland.rst

@@ -0,0 +1,5 @@
+wayland
+=======
+
+.. doxygenfile:: platform/linux/wayland.h
+   :allow-dot-graphs:

docs/source/source_code/src/platform/linux/x11grab.rst

@@ -0,0 +1,4 @@
+x11grab
+=======
+
+.. Todo:: Add x11grab.h

docs/source/source_code/src/platform/macos/av_audio.rst

@@ -0,0 +1,4 @@
+av_audio
+========
+
+.. Todo:: Add av_audio.h

docs/source/source_code/src/platform/macos/av_img_t.rst

@@ -0,0 +1,4 @@
+av_img_t
+========
+
+.. Todo:: Add av_img_t.h

docs/source/source_code/src/platform/macos/av_video.rst

@@ -0,0 +1,4 @@
+av_video
+========
+
+.. Todo:: Add av_video.h

docs/source/source_code/src/platform/macos/misc.rst

@@ -0,0 +1,5 @@
+misc
+====
+
+.. doxygenfile:: platform/macos/misc.h
+   :allow-dot-graphs:

docs/source/source_code/src/platform/macos/nv12_zero_device.rst

@@ -0,0 +1,4 @@
+nv12_zero_device
+================
+
+.. Todo:: Add nv12_zero_device.h

docs/source/source_code/src/platform/windows/PolicyConfig.rst

@@ -0,0 +1,4 @@
+PolicyConfig
+============
+
+.. Todo:: Add PolicyConfig.h

docs/source/source_code/src/platform/windows/display.rst

@@ -0,0 +1,4 @@
+display
+=======
+
+.. Todo:: Add display.h

docs/source/source_code/src/platform/windows/misc.rst

@@ -0,0 +1,5 @@
+misc
+====
+
+.. doxygenfile:: platform/windows/misc.h
+   :allow-dot-graphs:

docs/source/source_code/src/process.rst

@@ -0,0 +1,5 @@
+process
+=======
+
+.. doxygenfile:: process.h
+   :allow-dot-graphs:

docs/source/source_code/src/round_robin.rst

@@ -0,0 +1,5 @@
+round_robin
+===========
+
+.. doxygenfile:: round_robin.h
+   :allow-dot-graphs:

docs/source/source_code/src/rtsp.rst

@@ -0,0 +1,5 @@
+rtsp
+====
+
+.. doxygenfile:: rtsp.h
+   :allow-dot-graphs:

docs/source/source_code/src/stream.rst

@@ -0,0 +1,5 @@
+stream
+======
+
+.. doxygenfile:: stream.h
+   :allow-dot-graphs:

docs/source/source_code/src/sync.rst

@@ -0,0 +1,5 @@
+sync
+====
+
+.. doxygenfile:: sync.h
+   :allow-dot-graphs:

docs/source/source_code/src/system_tray.rst

@@ -0,0 +1,5 @@
+system_tray
+===========
+
+.. doxygenfile:: system_tray.h
+   :allow-dot-graphs:

docs/source/source_code/src/task_pool.rst

@@ -0,0 +1,5 @@
+task_pool
+=========
+
+.. doxygenfile:: task_pool.h
+   :allow-dot-graphs:

docs/source/source_code/src/thread_pool.rst

@@ -0,0 +1,5 @@
+thread_pool
+===========
+
+.. doxygenfile:: thread_pool.h
+   :allow-dot-graphs:

docs/source/source_code/src/thread_safe.rst

@@ -0,0 +1,5 @@
+thread_safe
+===========
+
+.. doxygenfile:: thread_safe.h
+   :allow-dot-graphs:

docs/source/source_code/src/upnp.rst

@@ -0,0 +1,5 @@
+upnp
+====
+
+.. doxygenfile:: upnp.h
+   :allow-dot-graphs:

docs/source/source_code/src/utility.rst

@@ -0,0 +1,4 @@
+utility
+=======
+
+.. Todo:: Add utility.h

docs/source/source_code/src/uuid.rst

@@ -0,0 +1,5 @@
+uuid
+====
+
+.. doxygenfile:: uuid.h
+   :allow-dot-graphs:

docs/source/source_code/src/video.rst

@@ -0,0 +1,5 @@
+video
+=====
+
+.. doxygenfile:: video.h
+   :allow-dot-graphs: