Add reStructuredText (RST) documentation formatter

Temporarily add a RST formatter to convert builtin documentation to .rst
source files.  This will be removed shortly after we use it to convert
documentation.

Teach the RST formatter to:

* Output preformatted blocks as reStructuredText "::" literal blocks.

* Output option lists as bullet lists with option names enclosed in
  reStructuredText ``literal`` quoting.

* Output individual documentation objects (commands, variables, etc.)
  in separate .rst files organized in directories by type.

Replace references to cmVersion::GetCMakeVersion() in builtin
documentation with the literal placeholder "|release|" that will be
defined as a substitution later.

1 files changed, 8 insertions, 0 deletions

diff --git a/Source/cmDocumentation.cxx b/Source/cmDocumentation.cxx
index b0643b0..83be32d 100644
--- a/Source/cmDocumentation.cxx
+++ b/Source/cmDocumentation.cxx
@@ -654,6 +654,11 @@ cmDocumentation::Form cmDocumentation::GetFormFromFilename(
     return cmDocumentation::ManForm;
     }
 
+  if (ext == ".RST")
+    {
+    return cmDocumentation::RSTForm;
+    }
+
   return cmDocumentation::TextForm;
 }
 
@@ -1580,6 +1585,9 @@ void cmDocumentation::SetForm(Form f, int manSection)
       this->ManFormatter.SetManSection(manSection);
       this->CurrentFormatter = &this->ManFormatter;
       break;
+    case RSTForm:
+      this->CurrentFormatter = &this->RSTFormatter;
+      break;
     case TextForm:
       this->CurrentFormatter = &this->TextFormatter;
       break;