diff --git a/.github/workflows/generate_dev_docs.yml b/.github/workflows/generate_dev_docs.yml index c511aa1afa..e73c6f15c3 100644 --- a/.github/workflows/generate_dev_docs.yml +++ b/.github/workflows/generate_dev_docs.yml @@ -29,7 +29,7 @@ jobs: - name: Generate documentation uses: mattnotmitt/doxygen-action@v1.9.5 with: - doxyfile-path: "doxygen/Doxyfile_test" + doxyfile-path: "doxygen/Doxyfile_gha" # store the documentation files - name: Upload output directory @@ -82,5 +82,5 @@ jobs: - name: Commit changes uses: EndBug/add-and-commit@v9 with: - message: 'Update docs' + message: 'Update dev docs' default_author: github_actions diff --git a/doc/images/mobilitydb-logo-icon.png b/doc/images/mobilitydb-logo-icon.png new file mode 100644 index 0000000000..edb7a95ae8 Binary files /dev/null and b/doc/images/mobilitydb-logo-icon.png differ diff --git a/doxygen/Doxyfile_test b/doxygen/Doxyfile_gha similarity index 99% rename from doxygen/Doxyfile_test rename to doxygen/Doxyfile_gha index 028b5c32b9..37091d7356 100644 --- a/doxygen/Doxyfile_test +++ b/doxygen/Doxyfile_gha @@ -1,5 +1,8 @@ # Doxyfile 1.9.8 +# This Doxygen file is used by a GitHub Action +# to generate the dev docs automatic + # This file describes the settings to be used by the documentation system # doxygen (www.doxygen.org) for a project. # @@ -85,7 +88,7 @@ CREATE_SUBDIRS = NO # level increment doubles the number of directories, resulting in 4096 # directories at level 8 which is the default and also the maximum value. The # sub-directories are organized in 2 levels, the first level always has a fixed -# numer of 16 directories. +# number of 16 directories. # Minimum value: 0, maximum value: 8, default value: 8. # This tag requires that the tag CREATE_SUBDIRS is set to YES. @@ -272,7 +275,8 @@ TAB_SIZE = 4 # with the commands \{ and \} for these it is advised to use the version @{ and # @} or use a double escape (\\{ and \\}) -ALIASES = "sqlfunc=@par SQL Function:^^" \ +ALIASES = "csqlfunc=@par C-SQL Function:^^" \ + "sqlfunc=@par SQL Function:^^" \ "sqlop=@par SQL Operator:^^" \ "pymeosfunc=@par PyMEOS Function:^^" diff --git a/meos/include/general/doxygen_meos.h b/meos/include/general/doxygen_meos.h index dc0be1b498..b44a42fe16 100644 --- a/meos/include/general/doxygen_meos.h +++ b/meos/include/general/doxygen_meos.h @@ -29,7 +29,34 @@ /** * @file - * @brief Sections for the documentation of the MEOS library + * @mainpage MEOS and MobilityDB Developer's Documentation + * + * \htmlonly + *