chapter 12 abstracts

perisage · Sep 18, 2018 · 84b0fd3 · 84b0fd3
1 parent 7be78ac
commit 84b0fd3
Show file tree

Hide file tree

Showing 6 changed files with 31 additions and 3 deletions.
diff --git a/chapter-12/recipe-01/README.md b/chapter-12/recipe-01/README.md
@@ -1,5 +1,10 @@
 # Building documentation using Doxygen
 
-Abstract to be written ...
+[Doxygen](http://www.doxygen.nl) is a popular source code documentation tool in
+the C++ community. Running Doxygen will extract comments which contain
+documentation tags and create the documentation in a format defined in the
+Doxyfile configuration file (HTML, XML, and even LaTeX or PDF). This recipe
+shows how to use CMake to build your Doxygen documentation.
+
 
 - [cxx-example](cxx-example/)
diff --git a/chapter-12/recipe-01/abstract.md b/chapter-12/recipe-01/abstract.md
@@ -0,0 +1,5 @@
+[Doxygen](http://www.doxygen.nl) is a popular source code documentation tool in
+the C++ community. Running Doxygen will extract comments which contain
+documentation tags and create the documentation in a format defined in the
+Doxyfile configuration file (HTML, XML, and even LaTeX or PDF). This recipe
+shows how to use CMake to build your Doxygen documentation.
diff --git a/chapter-12/recipe-02/README.md b/chapter-12/recipe-02/README.md
@@ -1,5 +1,10 @@
 # Building documentation using Sphinx
 
-Abstract to be written ...
+[Sphinx](http://www.sphinx-doc.org) can parse reStructuredText, Markdown
+plain-text files, and generate HTML, ePUB, or PDF documentation. Coupled with the
+online [Read the Docs](https://readthedocs.org) service, it offers a great way to quickly
+get started with writing and deploying documentation. This recipe shows how to
+use CMake to build documentation based on Sphinx.
+
 
 - [cxx-example](cxx-example/)
diff --git a/chapter-12/recipe-02/abstract.md b/chapter-12/recipe-02/abstract.md
@@ -0,0 +1,5 @@
+[Sphinx](http://www.sphinx-doc.org) can parse reStructuredText, Markdown
+plain-text files, and generate HTML, ePUB, or PDF documentation. Coupled with the
+online [Read the Docs](https://readthedocs.org) service, it offers a great way to quickly
+get started with writing and deploying documentation. This recipe shows how to
+use CMake to build documentation based on Sphinx.
diff --git a/chapter-12/recipe-03/README.md b/chapter-12/recipe-03/README.md
@@ -1,5 +1,9 @@
 # Combining Doxygen and Sphinx
 
-Abstract to be written ...
+This recipe illustrates
+how to use the [Breathe](https://breathe.readthedocs.io) plugin in combination with CMake
+to bridge [Doxygen](http://www.doxygen.nl) and
+[Sphinx](http://www.sphinx-doc.org).
+
 
 - [cxx-example](cxx-example/)
diff --git a/chapter-12/recipe-03/abstract.md b/chapter-12/recipe-03/abstract.md
@@ -0,0 +1,4 @@
+This recipe illustrates
+how to use the [Breathe](https://breathe.readthedocs.io) plugin in combination with CMake
+to bridge [Doxygen](http://www.doxygen.nl) and
+[Sphinx](http://www.sphinx-doc.org).