doc: Fixing Zoomin workflow

Minor fixes to doc build:
- Fixed typo in workflow (zooomin -> zoomin)
- Rename Makefile.txt to Makefile for local doc build on Linux
- Doxygen config modified to point explicitly to correct mainpage
- sm_host.h doxygen warning about extra return statement removed
- Removed sphinxcontrib-mscgen from sphinx conf because it's not
  used in the docs.

Signed-off-by: Tommi Rantanen <tommi.rantanen@nordicsemi.no>

Author: trantanen

.github/workflows/doc-on-push-zoomin-publish.yml

@@ -12,7 +12,7 @@ jobs:
   deploy:
     permissions:
       contents: write
-    uses: ./.github/workflows/doc-build-and-publish-zooomin.yml
+    uses: ./.github/workflows/doc-build-and-publish-zoomin.yml
     with:
       documentation_tag: "latest"
       publish_to_prod: true

doc/Doxyfile

@@ -1089,7 +1089,7 @@ FILTER_SOURCE_PATTERNS =
 # (index.html). This can be useful if you have a project on for instance GitHub
 # and want to reuse the introduction page also for the doxygen output.
 
-USE_MDFILE_AS_MAINPAGE = main.md
+USE_MDFILE_AS_MAINPAGE = _doxygen/main.md
 
 # The Fortran standard specifies that for fixed formatted Fortran code all
 # characters from position 72 are to be considered as comment. A common

doc/Makefile.txt doc/Makefiledoc/Makefile.txt renamed to doc/Makefile

@@ -25,7 +25,6 @@
 
 extensions = [
     'breathe',
-    'sphinxcontrib.mscgen',
     'sphinx_tabs.tabs',
     'sphinx_togglebutton',
 ]

doc/conf.py

@@ -96,8 +96,6 @@ int sm_host_register_ri_handler(sm_ri_handler_t handler);
  * @param automatic If true, DTR UART is automatically managed by the library.
  * @param inactivity Inactivity timeout for DTR UART disablement. Only used if @p
  * automatic is true.
- *
- * @return Zero on success, non-zero otherwise.
  */
 void sm_host_configure_dtr_uart(bool automatic, k_timeout_t inactivity);