From c15ac2c0aa45c59aee6d36c2d6d5210290dc601c Mon Sep 17 00:00:00 2001 From: Jon Layton Date: Wed, 18 Sep 2019 18:54:20 -0400 Subject: doc: Move doxygen intro to file for USE_MDFILE_AS_MANPAGE doc: Change header to notitle --- doc/Doxyfile.in | 4 ++-- doc/README_doxygen.md | 15 +++++++++++++++ src/bitcoind.cpp | 18 ------------------ 3 files changed, 17 insertions(+), 20 deletions(-) create mode 100644 doc/README_doxygen.md diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in index 399d54eb85..cd7ccf80ab 100644 --- a/doc/Doxyfile.in +++ b/doc/Doxyfile.in @@ -790,7 +790,7 @@ WARN_LOGFILE = # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING # Note: If this tag is empty the current directory is searched. -INPUT = src +INPUT = src doc/README_doxygen.md # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses @@ -974,7 +974,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 = +USE_MDFILE_AS_MAINPAGE = doc/README_doxygen.md #--------------------------------------------------------------------------- # Configuration options related to source browsing diff --git a/doc/README_doxygen.md b/doc/README_doxygen.md new file mode 100644 index 0000000000..608680ad3e --- /dev/null +++ b/doc/README_doxygen.md @@ -0,0 +1,15 @@ +\mainpage notitle + +\section intro_sec Introduction + +This is the developer documentation of the reference client for an experimental new digital currency called Bitcoin, +which enables instant payments to anyone, anywhere in the world. Bitcoin uses peer-to-peer technology to operate +with no central authority: managing transactions and issuing money are carried out collectively by the network. + +The software is a community-driven open source project, released under the MIT license. + +See https://github.com/bitcoin/bitcoin and https://bitcoincore.org/ for further information about the project. + +\section Navigation +Use the buttons Namespaces, Classes or Files at the top of the page to start navigating the code. + diff --git a/src/bitcoind.cpp b/src/bitcoind.cpp index 83de684a2b..615b955f6e 100644 --- a/src/bitcoind.cpp +++ b/src/bitcoind.cpp @@ -25,24 +25,6 @@ const std::function G_TRANSLATION_FUN = nullptr; -/* Introduction text for doxygen: */ - -/*! \mainpage Developer documentation - * - * \section intro_sec Introduction - * - * This is the developer documentation of the reference client for an experimental new digital currency called Bitcoin, - * which enables instant payments to anyone, anywhere in the world. Bitcoin uses peer-to-peer technology to operate - * with no central authority: managing transactions and issuing money are carried out collectively by the network. - * - * The software is a community-driven open source project, released under the MIT license. - * - * See https://github.com/bitcoin/bitcoin and https://bitcoincore.org/ for further information about the project. - * - * \section Navigation - * Use the buttons Namespaces, Classes or Files at the top of the page to start navigating the code. - */ - static void WaitForShutdown() { while (!ShutdownRequested()) -- cgit v1.2.3 From dbdc758c27cfdda9d255742b6c6ff4d1b7be82df Mon Sep 17 00:00:00 2001 From: Jon Layton Date: Wed, 18 Sep 2019 19:03:02 -0400 Subject: doc: Improve doxygen readme navigation section --- doc/README_doxygen.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/README_doxygen.md b/doc/README_doxygen.md index 608680ad3e..6888383a98 100644 --- a/doc/README_doxygen.md +++ b/doc/README_doxygen.md @@ -11,5 +11,5 @@ The software is a community-driven open source project, released under the MIT l See https://github.com/bitcoin/bitcoin and https://bitcoincore.org/ for further information about the project. \section Navigation -Use the buttons Namespaces, Classes or Files at the top of the page to start navigating the code. +Use Modules, Namespaces, Classes, or Files at the top of the page to start navigating the code. -- cgit v1.2.3