Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Add a descriptive Main Page to the Doxygen site. #4466

Merged
merged 1 commit into from
Sep 10, 2021

Conversation

direvus
Copy link
Contributor

@direvus direvus commented Sep 10, 2021

Add a new doxygen_index.md file, and use the Doxygen setting
USE_MDFILE_AS_MAINPAGE to include it as the contents of the Main Page.

Fixes #3689.

What does this PR do?

Adds some descriptive content to the "Main Page" of the raw Doxygen output at https://gdal.org/doxygen/index.html so it's not just mysteriously blank.

I've copied the intro paragraph about GDAL from the main website verbatim, and added some words of my own about the Doxygen site and how to use it.

What are related issues/pull requests?

Issue raised in #3689

Tasklist

  • Modify Doxygen build and test locally
  • Add test case(s)
  • Add documentation
  • Review
  • Adjust for comments
  • All CI builds and checks have passed

Environment

Provide environment details, if relevant:

  • OS: MacOS 11.5.2
  • Compiler: Doxygen 1.9.2

Add a new doxygen_index.md file, and use the Doxygen setting
USE_MDFILE_AS_MAINPAGE to include it as the contents of the Main Page.

Fixes OSGeo#3689.
@rouault
Copy link
Member

rouault commented Sep 10, 2021

thanks!

@rouault rouault merged commit 9eb4911 into OSGeo:master Sep 10, 2021
@direvus direvus deleted the doc/doxygen-index-page branch September 12, 2021 07:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Doxygen main documentation page is empty
2 participants