From 564c8cd257e0dd1797d94633a0e92ddc5a496540 Mon Sep 17 00:00:00 2001 From: albert-github Date: Fri, 28 Aug 2015 13:00:10 +0200 Subject: Small documentation corrections - syntax correction - cross reference between HTML table and Markdown table - removed reference through "here" (problematic in printed documentation, one does not know where to go). --- doc/docblocks.doc | 6 +++--- doc/markdown.doc | 4 +++- doc/tables.doc | 4 ++-- 3 files changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/docblocks.doc b/doc/docblocks.doc index f073de5..3b42506 100644 --- a/doc/docblocks.doc +++ b/doc/docblocks.doc @@ -601,15 +601,15 @@ Markdown is designed to be very easy to read and write. It's formatting is inspired by plain text mail. Markdown works great for simple, generic formatting, like an introduction page for your project. Doxygen also supports reading of markdown files -directly. See \ref markdown "here" for more details regards Markdown support. +directly. For more details see chapter \ref markdown. For programming language specific formatting doxygen has two forms of additional markup on top of Markdown formatting. 1. Javadoc like markup. - See \ref cmd_intro "here" for a complete overview of all commands supported by doxygen. + See \ref commands for a complete overview of all commands supported by doxygen. 2. XML markup - as specified in the C# standard. See \ref xmlcmds "here" for the XML commands supported by doxygen. + as specified in the C# standard. See \ref xmlcmds for the XML commands supported by doxygen. If this is still not enough doxygen also supports a \ref htmlcmds "subset" of the HTML markup language. diff --git a/doc/markdown.doc b/doc/markdown.doc index 87af3d8..cec2191 100644 --- a/doc/markdown.doc +++ b/doc/markdown.doc @@ -337,6 +337,8 @@ which will look as follows: | 10 | 10 | 10 | | 1000 | 1000 | 1000 | +For more complex tables in doxygen please have a look at: \ref tables + \subsection md_fenced Fenced Code Blocks Another feature defined by "Markdown Extra" is support for @@ -437,7 +439,7 @@ details). By default the name and title of the page are derived from the file name. If the file starts with a level 1 header however, it is used as the title of the page. If you specify a label for the -header (as shown \ref md_header_id "here") doxygen will use that as the +header (as shown in \ref md_header_id) doxygen will use that as the page name. If the label is called `index` or `mainpage` doxygen will put the diff --git a/doc/tables.doc b/doc/tables.doc index 32bd1c0..5dc166d 100644 --- a/doc/tables.doc +++ b/doc/tables.doc @@ -18,7 +18,7 @@ Doxygen supports two ways to put tables in the documentation. -The easiest is to use the Markdown format as shown @ref md_tables "here". +The easiest is to use the Markdown format as shown in @ref markdown_extra section @ref md_tables. Although this format is easy to use and read, it is also rather limited. It supports only a simple grid of cells, while each cell is a @@ -58,7 +58,7 @@ It has a caption, table heading, various row and column spans, a nested table as one of the cells, and a item list in another cell. Note that the end tags (like ``) are left out in the example above. -This is allowed, and in the HTML output doxygen will be add the end tags again. +This is allowed, and in the HTML output doxygen will add the end tags again. The output will look as follows: -- cgit v0.12