doc: Remove in source documentation and the asciidoc package

The RSB documentation is now in ReST format and part of the RTEMS
Documentation project. See https://docs.rtems.org/.

Remove support for the GPL based asciidoc tool and remove the
asciidoc package from the RSB.

Add the Python Markdown package and update the reporter to use
Markdown for HTML generation. The resuling HTML report is a single
self contained file.

Closes #3047.

1 files changed, 0 insertions, 210 deletions

diff --git a/source-builder/sb/asciidoc/examples/website/epub-notes.txt b/source-builder/sb/asciidoc/examples/website/epub-notes.txt
deleted file mode 100644
index 0b942ba..0000000
--- a/source-builder/sb/asciidoc/examples/website/epub-notes.txt
+++ /dev/null
@@ -1,210 +0,0 @@
-AsciiDoc EPUB Notes
-===================
-
-
-Restrictions
-------------
-- If the date format of the DocBook 'data' element is not formatted like
-  `YYYY[-MM[-DD]]` you will get an error like the following one when
-  validating with `epubcheck(1)`:
-
-  ERROR: doc/article.epub/OEBPS/content.opf(6): date value 'Dec 2003'
-  is not valid, YYYY[-MM[-DD]] expected
-
-- Navigation headers are suppressed by `docbook-xsl/epub.xsl` (see
-  <<X3,bug report>>).
-
-
-DocBook XSL Stylesheets related limitations and bugs
-----------------------------------------------------
-
-=== epub: toc.section.depth parameter ignored
-https://sourceforge.net/tracker/?func=detail&aid=3043393&group_id=21935&atid=373747
-
-epub outputs include every section in the table of contents regardless of the
-toc.section.depth XSL Stylesheets parameter
-(http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.section.depth.html).
-This behavior is specific to epub (xhtml and fo outputs honor
-toc.section.depth).
-
-Environment: DocBook XSL 1.75.2; Xubuntu 10.04
-
-Also epub/docbook.xsl has written a hard-coded illegal dtb:depth value of -1
-into the toc.ncx navigation control file:
-
-   <ncx:meta name="dtb:depth" content="-1"/>
-
-Shouldn't it be a positive integer equal to the depth navPoint nesting in the
-navMap element (see
-http://www.niso.org/workrooms/daisy/Z39-86-2005.html#NavMeta)? Though epubcheck 1.05 doesn't flag it as invalid -- are they both wrong?
-
-
-[[X1]]
-=== epub: untitled DocBook sidebar emits invalid XHTML
-https://sourceforge.net/tracker/index.php?func=detail&aid=2840768&group_id=21935&atid=373747
-
-I get the same problem, but is confined to EPUB outputs (not XHTML)
-and results in the sidebar and all subsequent text on the page
-displayed in bold text in both Firefox 3.6.8 and Google Chrome
-5.0.375.125 (I haven't checked other browsers).
-
-Environment: DocBook XSL 1.75.2; Xubuntu 10.04
-
-If a DocBook sidebar element does not have a title then the emitted
-title is (I haven't checked other browsers).
-set to <b/> instead of <b></b>, for example this DocBook markup:
-
-  <sidebar>
-  <simpara>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.</simpara>
-  </sidebar>
-
-Generates this EPUB XHTML:
-
-  <div class="sidebar"><p class="title"><b/></p><p>Lorem ipsum dolor
-  sit amet, consectetuer adipiscing elit.</p></div>
-
-This problem is not picked up by either the epubcheck or the W3C
-validators.
-
-The problem does not occur generating XHTML which emits the following
-for the above example:
-
-  <div class="sidebar"><p class="title"><b></b></p><p>Lorem ipsum
-  dolor sit amet, consectetuer adipiscing elit.</p></div>
-
-
-=== epub: Unreferenced callout icons in OPF
-NOTE: A workaround  for this problem was added in `a2x(1)` version
-8.6.5.
-
-https://sourceforge.net/tracker/?func=detail&aid=2854075&group_id=21935&atid=373747
-
-Environment: DocBook XSL 1.75.2; Xubuntu 8.04
-
-When callouts are used in a document and callout graphics are disabled
-(callout.graphics=0) the generated 'contents.opf' still contains
-references to all the callout icons even though none are not
-referenced in the generated XHTML content. This results in 10
-epubcheck validation errors like:
-
-  image file OEBPS/images/icons/callouts/1.png is missing
-
-It appears that epub is adding the icons to the OPF without
-first checking the callout.graphics parameter.
-
-
-=== epub: Table grids not generated
-https://sourceforge.net/tracker/?func=detail&aid=2849647&group_id=21935&atid=373747
-
-Environment: DocBook XSL 1.75.2; Xubuntu 8.04
-
-DocBook XSL epub does not appear to process the DocBook table element rowsep
-and colsep attributes -- table grids are not displayed. The DocBook
-<table rowsep="1" colsep="1"> results in:
-
-epub DocBook XSL generates:
-
-  <td style="text-align: left" valign="top">
-
-i.e. epub is not generating CSS borders (same for generated th elements).
-
-Compare this with the (correct) xhtml DocBook XSL generates the correct border
-styles:
-
-  <td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left" valign="top">
-
-
-
-=== epub: htmltoc is not generated
-https://sourceforge.net/tracker/?func=detail&aid=2849686&group_id=21935&atid=373747
-
-Environment: DocBook XSL 1.75.2; Xubuntu 8.04
-
-If DocBook XSL TOC generation is specified the generated
-'contents.opf' contains an 'htmltoc' element but the referenced TOC file
-is not generated by DocBook XSL. For example the contents.opf contains:
-
-  <item id="htmltoc" media-type="application/xhtml+xml" href="ar01-toc.html"/>
-
-but the actual TOC file `OEBPS/ar01-toc.html` is missing and epubcheck
-generates validation errors like:
-
-  ERROR: doc/article.epub: OPS/XHTML file OEBPS/ar01-toc.html is missing
-
-
-=== epub: leading dot in directory name error
-https://sourceforge.net/tracker/?func=detail&aid=2849683&group_id=21935&atid=373747
-
-Environment: DocBook XSL 1.75.2; Xubuntu 8.04
-
-Specifying paths with a leading dot causes problems, for example:
-
-  <xsl:param name="html.stylesheet" select="'./docbook-xsl.css'"/>
-
-This generates validation errors like:
-
-  ERROR: article.epub/OEBPS/index.html(4):
-  'OEBPS/./docbook-xsl.css': referenced resource missing in the package
-
-The file is in the archive at the correct location, just doesn't
-seem to like './' in the path name -- the path needs to be normalized
-before being written to the contents.opf.
-
-It's not just the validator, the file is missing when the EPUB is viewed
-(in bookworm).
-
-This works fine:
-
-  <xsl:param name="html.stylesheet" select="'docbook-xsl.css'"/>
-
-
-[[X2]]
-=== epub: admonition icon images missing from contents.opf
-NOTE: A workaround  for this problem was added in `a2x(1)` version
-8.6.5.
-
-https://sourceforge.net/tracker/?func=detail&aid=2849681&group_id=21935&atid=373747
-
-Environment: DocBook XSL 1.75.2; Xubuntu 8.04
-
-When admonition icons are specified epubcheck generates validation
-errors like:
-
-  ERROR: article.epub/OEBPS/index.html(4):
-  'OEBPS/images/icons/note.png': referenced resource exists,
-  but not declared in the OPF file
-
-i.e. The admonition icon is in the EPUB file but DocBook XSL has not
-been added to the content.opf manifest. Compare this with callout icons
-which are processed correctly.
-
-
-[[X3]]
-=== Table width attribute validation error
-https://sourceforge.net/tracker/?func=detail&aid=2848734&group_id=21935&atid=373747
-
-Environment: DocBook XSL 1.75.2; Xubuntu 8.04
-
-I get the following validation errors when navigation headers are in
-included in the generated XHTML:
-
-  ERROR: article.epub/OEBPS/ix01.html(3): attribute "width" not allowed
-  at this point; ignored
-
-This is because DocBook XSL has emitted invalid XHTML 1.1: tables
-using the 'width' element are generated automatically in navigation
-headers.
-
-Though, admittedly, navigation is redundant if you're reading with an
-EPUB reader. Suppress by setting the suppress.navigation param to 1.
-
-Is this a DocBook XSL bug?
-
-
-The Linux zip(1) command
-------------------------
-If you use the Linux `zip(1)` command to update or create EPUB files
-you must use the `-X`, `--no-extra` command-line option, if you do not
-the platform dependent extra fields will confuse `epubcheck(1)` which
-will emit errors like ``extra field length for first filename must be
-0, but was 28''.