From 9ea8443f1336c67e7daa6eb2a6903312115a9082 Mon Sep 17 00:00:00 2001
From: kiryph <kiryph@users.noreply.github.com>
Date: Thu, 24 Oct 2024 15:20:56 +0200
Subject: [PATCH] Add Admonition Boxes

see issue #74
---
 doc/refdtd.xml      |  42 ++++++++
 example/example.xml | 226 +++++++++++++++++++++++++++++++++++++++++++-
 gapdoc.dtd          |   9 +-
 lib/GAPDoc.gi       |   1 +
 lib/GAPDoc2HTML.gi  |  33 ++++++-
 lib/GAPDoc2LaTeX.gi |  59 +++++++++++-
 lib/GAPDoc2Text.gi  |  59 +++++++++++-
 lib/gapdocdtdinfo.g |   2 +-
 lib/getdtd.g        |   2 +-
 lib/latexhead.tex   |   8 ++
 styles/manual.css   |  72 +++++++++++++-
 11 files changed, 499 insertions(+), 14 deletions(-)

diff --git a/doc/refdtd.xml b/doc/refdtd.xml
index 3bc9298..954481f 100644
--- a/doc/refdtd.xml
+++ b/doc/refdtd.xml
@@ -1338,6 +1338,48 @@ It may appear in the output.
 
 </Subsection>
 
+<Subsection Label="Admonition"><Heading><C>&lt;Admonition></C></Heading>
+<Index Key="Admonition"><C>Admonition</C></Index>
+
+<Listing Type="From gapdoc.dtd">
+<![CDATA[<!ELEMENT Admonition (%Text;| Caption)*>
+<!ATTLIST Admonition Type CDATA #REQUIRED
+                Label CDATA #IMPLIED>]]>
+</Listing>
+
+Five types of admonition boxes
+<Log><![CDATA[
+<Admonition Type="Note">
+  Useful information that users should know, even when skimming content.
+</Admonition>
+
+<Admonition Type="Tip">
+  Helpful advice for doing things better or more easily.
+</Admonition>
+
+<Admonition Type="Important">
+  Key information users need to know to achieve their goal.
+</Admonition>
+
+<Admonition Type="Warning">
+  Urgent info that needs immediate user attention to avoid problems.
+</Admonition>
+
+<Admonition Type="Caution">
+  Advises about risks or negative outcomes of certain actions.
+</Admonition>
+]]></Log>
+
+It is possible to customize the caption:
+
+<Log><![CDATA[
+<Admonition Type="Important">
+  <Caption>Important: Custom Caption</Caption>
+  This is important.
+</Admonition>
+]]></Log>
+
+</Subsection>
 
 <Subsection Label="Log"><Heading><C>&lt;Log></C> and
                                  <C>&lt;Example></C></Heading>
diff --git a/example/example.xml b/example/example.xml
index efbe103..0388626 100644
--- a/example/example.xml
+++ b/example/example.xml
@@ -512,15 +512,120 @@ And some more for mathematical symbols:
 
 </Section>
 
+<Section><Heading>Admonition Boxes</Heading>
+<Label Name="ElevenBack"/>
+
+[&see; <Ref Sect="Eleven"/>]<P/>
+
+Five types of admonition boxes:<P/>
+
+<Admonition Type="Note">
+Useful information that users should know, even when skimming content.
+</Admonition>
+
+<Admonition Type="Tip">
+Helpful advice for doing things better or more easily.
+</Admonition>
+
+<Admonition Type="Important">
+Key information users need to know to achieve their goal.
+</Admonition>
+
+<Admonition Type="Warning">
+Urgent info that needs immediate user attention to avoid problems.
+</Admonition>
+
+<Admonition Type="Caution">
+Advises about risks or negative outcomes of certain actions.
+</Admonition>
+
+Custom captions:<P/>
+
+<Admonition Type="Important">
+<Caption>Important: Custom Caption</Caption>
+Key information users need to know to achieve their goal.
+</Admonition>
+
+Other <Package>GAPDoc</Package> elements within admonition boxes are allowed:<P/>
+
+<Admonition Type="Note">
+<Caption>A note with <C>Log</C></Caption>
+An example with syntax highlighting:
+<Br/><Ignore> manually fixing space</Ignore>
+<Log>
+gap&gt; Sieve(100);
+[ 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61,
+  67, 71, 73, 79, 83, 89, 97 ]
+gap&gt; Length(last);
+25
+</Log>
+</Admonition>
+
+<Admonition Type="Note">
+<Caption>A note with various <Package>GAPDoc</Package> elements</Caption>
+
+A word with quotation marks: <Q>hello</Q>.
+
+Display Math:
+
+<Display>
+   \Longrightarrow \quad \left(\sum_{i=1}^d x_i b_i \right) \cdot
+   \left(\sum_{j=1}^d y_j b_j \right) =
+   \sum_{k=1}^d \left( \sum_{i,j} x_i y_j h_{ijk} \right) b_k 
+</Display>
+
+Tables can be used within admonition boxes:
+<Br/><Ignore> manually fixing space</Ignore>
+<Table Align="|l|l|">
+<Caption>Predefined Entities in the &GAPDoc; system</Caption>
+<HorLine/>
+<Row> <Item><C>&amp;GAP;</C></Item>       <Item>&GAP;</Item> </Row>
+<HorLine/>
+<Row> <Item><C>&amp;GAPDoc;</C></Item>    <Item>&GAPDoc;</Item> </Row>
+<HorLine/>
+<Row> <Item><C>&amp;TeX;</C></Item>       <Item>&TeX;</Item> </Row>
+<HorLine/>
+<Row> <Item><C>&amp;LaTeX;</C></Item>     <Item>&LaTeX;</Item> </Row>
+<HorLine/>
+</Table>
+
+Lists or enumerations can be used within admonition boxes
+<List>
+  <Item>
+    <Emph>This</Emph> is <E>emphasized</E>.
+  </Item>
+  <Item>
+   <E>Keywords</E> are typeset like <Keyword>this</Keyword> and <K>that</K>.
+  </Item>
+</List>
+
+<List>
+ <Mark>lists:</Mark><Item> not numbered</Item>
+ <Mark>enumerations:</Mark><Item> numbered</Item>
+ <Mark>tables:</Mark><Item> two-dimensional</Item>
+</List>
+
+<Enum>
+  <Item>
+    <Emph>This</Emph> is <E>emphasized</E>.
+  </Item>
+  <Item>
+   <E>Keywords</E> are typeset like <Keyword>this</Keyword> and <K>that</K>.
+  </Item>
+</Enum>
+</Admonition>
+
+</Section>
+
 </Chapter>
 
 </Body>
 
 <Appendix Label="Appendix">
 <Heading>An Appendix</Heading>
-<Label Name="ElevenBack"/>
+<Label Name="TwelveBack"/>
 
-[&see; <Ref Sect="Eleven"/>]<P/>
+[&see; <Ref Sect="Twelve"/>]<P/>
 
 This is an appendix. 
 </Appendix>
@@ -1078,6 +1183,119 @@ And here are the predefined entities in &GAPDoc;:
 And some more for mathematical symbols: 
 &CC;, &ZZ;, &NN;, &PP;, &QQ;, &HH;, &RR;.
 
+</Section>]]>
+</Listing>
+
+</Section>
+
+<Section Label="Eleven"><Heading>Admonition Boxes (Source)</Heading>
+
+[<Ref Label="ElevenBack"/>]
+
+<Listing>
+<![CDATA[<Section><Heading>Admonition Boxes</Heading>
+<Label Name="ElevenBack"/>
+
+[&see; <Ref Sect="Eleven"/>]<P/>
+
+Five types of admonition boxes:<P/>
+
+<Admonition Type="Note">
+Useful information that users should know, even when skimming content.
+</Admonition>
+
+<Admonition Type="Tip">
+Helpful advice for doing things better or more easily.
+</Admonition>
+
+<Admonition Type="Important">
+Key information users need to know to achieve their goal.
+</Admonition>
+
+<Admonition Type="Warning">
+Urgent info that needs immediate user attention to avoid problems.
+</Admonition>
+
+<Admonition Type="Caution">
+Advises about risks or negative outcomes of certain actions.
+</Admonition>
+
+Custom captions:<P/>
+
+<Admonition Type="Important">
+<Caption>Important: Custom Caption</Caption>
+Key information users need to know to achieve their goal.
+</Admonition>
+
+Other <Package>GAPDoc</Package> elements within admonition boxes are allowed:<P/>
+
+<Admonition Type="Note">
+<Caption>A note with <C>Log</C></Caption>
+An example with syntax highlighting:
+<Br/><Ignore> manually fixing space</Ignore>
+<Log>
+gap&gt; Sieve(100);
+[ 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61,
+  67, 71, 73, 79, 83, 89, 97 ]
+gap&gt; Length(last);
+25
+</Log>
+</Admonition>
+
+<Admonition Type="Note">
+<Caption>A note with various <Package>GAPDoc</Package> elements</Caption>
+
+A word with quotation marks: <Q>hello</Q>.
+
+Display Math:
+
+<Display>
+   \Longrightarrow \quad \left(\sum_{i=1}^d x_i b_i \right) \cdot
+   \left(\sum_{j=1}^d y_j b_j \right) =
+   \sum_{k=1}^d \left( \sum_{i,j} x_i y_j h_{ijk} \right) b_k 
+</Display>
+
+Tables can be used within admonition boxes:
+<Br/><Ignore> manually fixing space</Ignore>
+<Table Align="|l|l|">
+<Caption>Predefined Entities in the &GAPDoc; system</Caption>
+<HorLine/>
+<Row> <Item><C>&amp;GAP;</C></Item>       <Item>&GAP;</Item> </Row>
+<HorLine/>
+<Row> <Item><C>&amp;GAPDoc;</C></Item>    <Item>&GAPDoc;</Item> </Row>
+<HorLine/>
+<Row> <Item><C>&amp;TeX;</C></Item>       <Item>&TeX;</Item> </Row>
+<HorLine/>
+<Row> <Item><C>&amp;LaTeX;</C></Item>     <Item>&LaTeX;</Item> </Row>
+<HorLine/>
+</Table>
+
+Lists or enumerations can be used within admonition boxes
+<List>
+  <Item>
+    <Emph>This</Emph> is <E>emphasized</E>.
+  </Item>
+  <Item>
+   <E>Keywords</E> are typeset like <Keyword>this</Keyword> and <K>that</K>.
+  </Item>
+</List>
+
+<List>
+ <Mark>lists:</Mark><Item> not numbered</Item>
+ <Mark>enumerations:</Mark><Item> numbered</Item>
+ <Mark>tables:</Mark><Item> two-dimensional</Item>
+</List>
+
+<Enum>
+  <Item>
+    <Emph>This</Emph> is <E>emphasized</E>.
+  </Item>
+  <Item>
+   <E>Keywords</E> are typeset like <Keyword>this</Keyword> and <K>that</K>.
+  </Item>
+</Enum>
+</Admonition>
+
 </Section>
 
 </Chapter>
@@ -1088,9 +1306,9 @@ And some more for mathematical symbols:
 </Section>
 
 
-<Section Label="Eleven"><Heading>Appendix (Source)</Heading>
+<Section Label="Twelve"><Heading>Appendix (Source)</Heading>
 
-[<Ref Label="ElevenBack"/>]
+[<Ref Label="TwelveBack"/>]
 
 <Listing Type="GAPDoc source">
 <![CDATA[<Appendix><Heading>An Appendix</Heading>
diff --git a/gapdoc.dtd b/gapdoc.dtd
index 7275c44..02a59a0 100644
--- a/gapdoc.dtd
+++ b/gapdoc.dtd
@@ -243,7 +243,7 @@
      environments like enumerations, lists, and such.
      ================================================================== -->
 
-<!ENTITY % Text "%InnerText; | List | Enum | Table">
+<!ENTITY % Text "%InnerText; | List | Enum | Table | Admonition">
 
 <!ELEMENT Item ( %Text;)*>
 <!ELEMENT Mark ( %InnerText;)*>
@@ -265,6 +265,13 @@
 <!ELEMENT HorLine EMPTY>
 <!ELEMENT Caption ( %InnerText;)*>
 
+<!ELEMENT Admonition (%Text;| Caption)*>
+<!--<!ATTLIST Admonition Type (Note|Tip|Important|Warning|Caution|Quote) #REQUIRED
+  GAP/GAPDoc does not have a proper dtd parser which understands "enumerated attribute values"
+      -->
+<!ATTLIST Admonition Type CDATA #REQUIRED
+                     Label CDATA #IMPLIED>    <!-- For reference purposes -->
+
 <!-- ==================================================================
      We start defining some things within the overall structure:
      ================================================================== -->
diff --git a/lib/GAPDoc.gi b/lib/GAPDoc.gi
index c8e7122..692e8da 100644
--- a/lib/GAPDoc.gi
+++ b/lib/GAPDoc.gi
@@ -95,6 +95,7 @@ InstallGlobalFunction(CheckAndCleanGapDocTree, function(arg)
                  = "XML") or c.name in 
               GAPDOCDTDINFO[pos].content);
     if false in l then
+      Print(GAPDOCDTDINFO[pos].content);
       ParseError(str, r.start, Concatenation("Wrong element in ", 
                       name, ": ", r.content[Position(l, false)].name));
     fi;
diff --git a/lib/GAPDoc2HTML.gi b/lib/GAPDoc2HTML.gi
index ccfadf3..3988ce4 100644
--- a/lib/GAPDoc2HTML.gi
+++ b/lib/GAPDoc2HTML.gi
@@ -92,7 +92,7 @@ GAPDoc2HTMLProcs.TextAttr.GAPinput :=
 
 # like in Text converter, but a heading and an address are not a paragraph here
 GAPDoc2HTMLProcs.ParEls := 
-[ "Display", "Example", "Log", "Listing", "List", "Enum", "Item", "Table", 
+[ "Display", "Example", "Log", "Listing", "List", "Enum", "Item", "Table", "Admonition",
   "TitlePage", "Abstract", "Copyright", "Acknowledgements",
   "Colophon", "TableOfContents", "Bibliography", "TheIndex",
   "Subsection", "ManSection", "Description", "Returns", "Section",
@@ -2124,6 +2124,37 @@ GAPDoc2HTMLProcs.Row := function(r, str, al)
   Append(str, "</tr>\n");
 end;
 
+GAPDoc2HTMLProcs.Admonition := function(r, par)
+  local str, cap, tmp, pars, i;
+
+  str := "\n<aside class=\"admonition ";
+  Append(str, LowercaseString(r.attributes.Type));
+  Append(str, "\">");
+
+  # Title
+  Append(str, "\n<p class=\"admonition-title\">");
+  # Optional custom title
+  cap := Filtered(r.content, a-> a.name = "Caption");
+  if Length(cap) > 0 then
+    tmp := "";
+    GAPDoc2HTMLContent(cap[1], tmp);
+    Append(str, tmp);
+  else
+    Append(str, r.attributes.Type);
+  fi;
+  Append(str, "</p>\n");
+
+  pars := "";
+  GAPDoc2HTMLContent(r, pars);
+  for i in [1..Length(pars)/2] do
+    Append(str, pars[i*2]);
+  od;
+
+  Append(str, "</aside>\n\n");
+
+  Add(par, r.count);
+  Add(par, str);
+end;
 
 ##  
 ##  <#GAPDoc Label="GAPDoc2HTMLPrintHTMLFiles">
diff --git a/lib/GAPDoc2LaTeX.gi b/lib/GAPDoc2LaTeX.gi
index a1371bc..f7998a0 100644
--- a/lib/GAPDoc2LaTeX.gi
+++ b/lib/GAPDoc2LaTeX.gi
@@ -245,7 +245,12 @@ GAPDoc2LaTeXProcs.DefaultOptions := rec(
              gapinput := "0.589,0.0,0.0",
              gapoutput := "0.0,0.0,0.0",
              funcdefs := "0.0,0.0,0.0",
-             chapter := "0.0,0.0,0.0"
+             chapter := "0.0,0.0,0.0",
+             admonition_note := "0.204,0.596,0.859", # blue
+             admonition_tip := "0.275,0.667,0.388", # green
+             admonition_important := "0.447,0.0,0.639", # magenta
+             admonition_warning := "0.902,0.494,0.133", # orange
+             admonition_caution := "0.906,0.298,0.235" # red
              ),
   MoreColors := "\\definecolor{DarkOlive}{rgb}{0.1047,0.2412,0.0064}\n",
   FontPackages := "\\usepackage{mathptmx,helvet}\n\\usepackage[T1]{fontenc}\n\
@@ -312,8 +317,13 @@ SetGapDocLaTeXOptions := function(arg)
              gapinput := "0.0,0.0,0.0",
              gapoutput := "0.0,0.0,0.0",
              funcdefs := "0.0,0.0,0.0",
-             chapter := "0.0,0.0,0.0"
-                        ) ) );
+             chapter := "0.0,0.0,0.0",
+             admonition_note := "0.0,0.0,0.0",
+             admonition_tip := "0.0,0.0,0.0",
+             admonition_important := "0.0,0.0,0.0",
+             admonition_warning := "0.0,0.0,0.0",
+             admonition_caution := "0.0,0.0,0.0"
+    ) ) );
   fi;
   if "utf8" in arg then
     Add(recs, rec(InputEncoding := "utf8"));
@@ -1531,6 +1541,49 @@ GAPDoc2LaTeXProcs.Alt := function(r, str)
   GAPDoc2LaTeXProcs.verbatimPCDATA := false;
 end;
 
+GAPDoc2LaTeXProcs.Admonition := function(r, str)
+  local color, cap, tmp;
+  color := Concatenation("admonition", r.attributes.Type);
+
+  # Start center environment \fcolorbox{linecolor}{fillcolor} and
+  # \parbox{width}{paragraph}
+  Append(str, "\n\n\\begin{center}\n");
+  Append(str, "\\setlength\\fboxsep{8pt}\n");
+  Append(str, "\\setlength\\fboxrule{1pt}\n");
+  Append(str, "\\VerbBox{\\fcolorbox{");
+  Append(str, color);
+  Append(str, "}{white}}{%\n");
+  # Append(str, "\\parbox{\\dimexpr\\linewidth-3\\fboxsep}{");
+  Append(str, "\\begin{minipage}{\\dimexpr\\linewidth-2.2\\fboxsep}\n");
+
+  # Title
+  Append(str, "\\textcolor{");
+  Append(str, color);
+  Append(str, "}{\\textbf{");
+  cap := Filtered(r.content, a-> a.name = "Caption");
+  if Length(cap) > 0 then
+    tmp := "";
+    GAPDoc2LaTeXContent(cap[1], tmp);
+    Append(str, tmp);
+  else
+    Append(str, r.attributes.Type);
+  fi;
+  Append(str, "}}\\\\[1ex]\n");
+
+  # Body
+  Append(str, "\\setlength\\fboxrule{0.4pt}\n"); # reset to default for innner boxes
+  # TODO handle nested verbatims like Example, Log
+  # iterate over paragraphs and handle verbcontent
+  # Requires a boxing which allows verbatim:
+  # fancybox, realboxes, mdframed, tcolorbox
+  # GAPDoc2LaTeXProcs.verbcontent(r, true); % special case
+  # Append(str, "\\fvset{vspace=3ex,listparameters=\\setlength{\\topsep}{3ex}\\setlength{\\parsep}{3ex}}"); # default of vspace is \topsep
+  GAPDoc2LaTeXContent(r, str);
+
+  # Close \VerbBox\fcolorbox, minipage/\parbox and center environment
+  Append(str, "\\end{minipage}}\\end{center}");
+end;
+
 # copy a few entries with two element names
 GAPDoc2LaTeXProcs.E := GAPDoc2LaTeXProcs.Emph;
 GAPDoc2LaTeXProcs.Keyword := GAPDoc2LaTeXProcs.K;
diff --git a/lib/GAPDoc2Text.gi b/lib/GAPDoc2Text.gi
index 4112cda..2b5c162 100644
--- a/lib/GAPDoc2Text.gi
+++ b/lib/GAPDoc2Text.gi
@@ -152,7 +152,7 @@ GAPDoc2TextProcs.TextAttr.f();
 Unbind(GAPDoc2TextProcs.TextAttr.f);
 
 GAPDoc2TextProcs.ParEls := 
-[ "Display", "Example", "Log", "Listing", "List", "Enum", "Item", "Table",
+[ "Display", "Example", "Log", "Listing", "List", "Enum", "Item", "Table", "Admonition",
 "TitlePage", "Address", "TitleComment", "Abstract", "Copyright",
 "Acknowledgements", "Colophon", "TableOfContents", "Bibliography", "TheIndex",
 "Subsection", "ManSection", "Description", "Returns", "Section", "Chapter",
@@ -1986,6 +1986,63 @@ GAPDoc2TextProcs.Caption1 := function(r, str)
                                 "both", ["     ", ""], WidthUTF8String));
 end;
 
+GAPDoc2TextProcs.Admonition := function(r, s)
+  local str, cap, tmp, color;
+
+  if UserPreference("UseColorsInTerminal") then
+    # TODO define and use TextThemes
+    # Using ANSI Colors
+    if r.attributes.Type = "Note" then
+      color := TextAttr.4; # Blue
+    elif  r.attributes.Type = "Tip" then
+      color := TextAttr.2; # Green
+    elif  r.attributes.Type = "Important" then
+      color := TextAttr.5; # Magenta
+    elif  r.attributes.Type = "Warning" then
+      color := TextAttr.3; # Yellow
+    elif  r.attributes.Type = "Caution" then
+      color := TextAttr.1; # Red
+    fi;
+  else
+    color := "";
+  fi;
+
+  # Title
+  # with optional custom caption
+  tmp := Filtered(r.content, a -> a.name = "Caption");
+  if Length(tmp) > 0 then
+    cap := "";
+    GAPDoc2TextContent(tmp[1], cap);
+  else
+    cap := r.attributes.Type; # default
+  fi;
+
+  str := Concatenation(r.root.indent,
+                       GAPDoc2TextProcs.TextAttr.FillString[1],
+                       "  ", cap, "  ",
+                       GAPDoc2TextProcs.TextAttr.FillString[1]);
+  str := WrapTextAttribute(str, color);
+  Add(str, '\n');
+
+  # Body
+  GAPDoc2TextContent(r, str);
+
+  # Following does not help to avoid an additional line:
+  # the addition of the empty line happens within most likely in
+  # GAPDoc2TextContent
+  # str := StripBeginEnd(str, WHITESPACE);
+  # str := Chomp(str);
+
+  # Finish
+  Append(str, Concatenation(r.root.indent,
+                 WrapTextAttribute(GAPDoc2TextProcs.TextAttr.FillString[1], 
+                 color), 
+                 "\n\n"));
+
+  Add(s, r.count);
+  Add(s, str);
+end;
+
 ##  
 ##  <#GAPDoc Label="GAPDoc2TextPrintTextFiles">
 ##  <ManSection >
diff --git a/lib/gapdocdtdinfo.g b/lib/gapdocdtdinfo.g
index 0ffa35c..c1d5be5 100644
--- a/lib/gapdocdtdinfo.g
+++ b/lib/gapdocdtdinfo.g
@@ -1 +1 @@
-GAPDOCDTDINFO:=[rec(attr:=["Not","Only"],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Alt",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Emph",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="E",reqattr:=[],type:="mixed"),rec(attr:=[],name:="Par",reqattr:=[],type:="empty"),rec(attr:=[],name:="P",reqattr:=[],type:="empty"),rec(attr:=[],name:="Br",reqattr:=[],type:="empty"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Keyword",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="K",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Arg",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="A",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="Code",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="C",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="File",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="F",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Button",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="B",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Package",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Quoted",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Q",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="M",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="Math",reqattr:=[],type:="mixed"),rec(attr:=["Mode"],content:=["A","Alt","Arg","PCDATA"],name:="Display",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA"],name:="Example",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA"],name:="Log",reqattr:=[],type:="mixed"),rec(attr:=["Type"],content:=["PCDATA"],name:="Listing",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA"],name:="Verb",reqattr:=[],type:="mixed"),rec(attr:=["Text"],content:=["Alt","Link","LinkText","PCDATA"],name:="URL",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Link",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="LinkText",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","Link","LinkText","PCDATA"],name:="Email",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","Link","LinkText","PCDATA"],name:="Homepage",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","Br","PCDATA"],name:="Address",reqattr:=[],type:="mixed"),rec(attr:=["Key","Where"],name:="Cite",reqattr:=["Key"],type:="empty"),rec(attr:=["Name"],name:="Label",reqattr:=["Name"],type:="empty"),rec(attr:=["Appendix","Attr","BookName","Chap","Constr","Fam","Filt","Func","InfoClass","Label","Meth","Oper","Prop","Sect","Style","Subsect","Text","Var"],name:="Ref",reqattr:=[],type:="empty"),rec(attr:=["Key","Subkey"],content:=["Subkey","PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Index",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Subkey",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Item",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Mark",reqattr:=[],type:="mixed"),rec(attr:=["Not","Only"],content:=["Item","Mark"],name:="List",reqattr:=[],type:="elements"),rec(attr:=["Not","Only"],content:=["Item"],name:="Enum",reqattr:=[],type:="elements"),rec(attr:=["Align","Label","Not","Only"],content:=["Caption","HorLine","Row"],name:="Table",reqattr:=["Align"],type:="elements"),rec(attr:=[],content:=["Item"],name:="Row",reqattr:=[],type:="elements"),rec(attr:=[],name:="HorLine",reqattr:=[],type:="empty"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Caption",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Abstract","Acknowledgements","Address","Author","Colophon","Copyright","Date","Subtitle","Title","TitleComment","Version"],name:="TitlePage",reqattr:=[],type:="elements"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Title",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Subtitle",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Version",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="TitleComment",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Author",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Date",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Abstract",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Copyright",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Acknowledgements",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Colophon",reqattr:=[],type:="mixed"),rec(attr:=[],name:="TableOfContents",reqattr:=[],type:="empty"),rec(attr:=["Databases","Style"],name:="Bibliography",reqattr:=["Databases"],type:="empty"),rec(attr:=[],name:="TheIndex",reqattr:=[],type:="empty"),rec(attr:=["Remark"],content:=["A","Address","Alt","Arg","B","Br","Button","C","Chapter","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","ManSection","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Subsection","Table","URL","Verb"],name:="Ignore",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Subsection",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["Attr","Constr","Description","Fam","Filt","Func","Heading","InfoClass","Meth","Oper","Prop","Returns","Var"],name:="ManSection",reqattr:=[],type:="elements"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Returns",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Description",reqattr:=[],type:="mixed"),rec(attr:=["Arg","Comm","Label","Name"],name:="Func",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Oper",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Constr",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Meth",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name","Type"],name:="Filt",reqattr:=["Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Prop",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Attr",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Comm","Label","Name"],name:="Var",reqattr:=["Name"],type:="empty"),rec(attr:=["Comm","Label","Name"],name:="Fam",reqattr:=["Name"],type:="empty"),rec(attr:=["Comm","Label","Name"],name:="InfoClass",reqattr:=["Name"],type:="empty"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Heading",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","ManSection","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Subsection","Table","URL","Verb"],name:="Section",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Table","URL","Verb"],name:="Chapter",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Table","URL","Verb"],name:="Appendix",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Alt","Arg","B","Br","Button","C","Chapter","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Table","URL","Verb"],name:="Body",reqattr:=[],type:="mixed"),rec(attr:=["Name"],content:=["Appendix","Bibliography","Body","TableOfContents","TheIndex","TitlePage"],name:="Book",reqattr:=["Name"],type:="elements")];
+GAPDOCDTDINFO:=[rec(attr:=["Not","Only"],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Alt",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Emph",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="E",reqattr:=[],type:="mixed"),rec(attr:=[],name:="Par",reqattr:=[],type:="empty"),rec(attr:=[],name:="P",reqattr:=[],type:="empty"),rec(attr:=[],name:="Br",reqattr:=[],type:="empty"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Keyword",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="K",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Arg",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="A",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="Code",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="C",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="File",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="F",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Button",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="B",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","PCDATA"],name:="Package",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Quoted",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Q",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="M",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Alt","Arg","PCDATA"],name:="Math",reqattr:=[],type:="mixed"),rec(attr:=["Mode"],content:=["A","Alt","Arg","PCDATA"],name:="Display",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA"],name:="Example",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA"],name:="Log",reqattr:=[],type:="mixed"),rec(attr:=["Type"],content:=["PCDATA"],name:="Listing",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA"],name:="Verb",reqattr:=[],type:="mixed"),rec(attr:=["Text"],content:=["Alt","Link","LinkText","PCDATA"],name:="URL",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Link",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="LinkText",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","Link","LinkText","PCDATA"],name:="Email",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","Link","LinkText","PCDATA"],name:="Homepage",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["Alt","Br","PCDATA"],name:="Address",reqattr:=[],type:="mixed"),rec(attr:=["Key","Where"],name:="Cite",reqattr:=["Key"],type:="empty"),rec(attr:=["Name"],name:="Label",reqattr:=["Name"],type:="empty"),rec(attr:=["Appendix","Attr","BookName","Chap","Constr","Fam","Filt","Func","InfoClass","Label","Meth","Oper","Prop","Sect","Style","Subsect","Text","Var"],name:="Ref",reqattr:=[],type:="empty"),rec(attr:=["Key","Subkey"],content:=["Subkey","PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Index",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Subkey",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Item",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Mark",reqattr:=[],type:="mixed"),rec(attr:=["Not","Only"],content:=["Item","Mark"],name:="List",reqattr:=[],type:="elements"),rec(attr:=["Not","Only"],content:=["Item"],name:="Enum",reqattr:=[],type:="elements"),rec(attr:=["Align","Label","Not","Only"],content:=["Caption","HorLine","Row"],name:="Table",reqattr:=["Align"],type:="elements"),rec(attr:=[],content:=["Item"],name:="Row",reqattr:=[],type:="elements"),rec(attr:=[],name:="HorLine",reqattr:=[],type:="empty"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Caption",reqattr:=[],type:="mixed"),rec(attr:=["Label","Type"],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Caption","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Admonition",reqattr:=["Type"],type:="mixed"),rec(attr:=[],content:=["Abstract","Acknowledgements","Address","Author","Colophon","Copyright","Date","Subtitle","Title","TitleComment","Version"],name:="TitlePage",reqattr:=[],type:="elements"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Title",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Subtitle",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Version",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="TitleComment",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Author",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Date",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Abstract",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Copyright",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Acknowledgements",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Colophon",reqattr:=[],type:="mixed"),rec(attr:=[],name:="TableOfContents",reqattr:=[],type:="empty"),rec(attr:=["Databases","Style"],name:="Bibliography",reqattr:=["Databases"],type:="empty"),rec(attr:=[],name:="TheIndex",reqattr:=[],type:="empty"),rec(attr:=["Remark"],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Chapter","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","ManSection","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Subsection","Table","URL","Verb"],name:="Ignore",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Subsection",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["Attr","Constr","Description","Fam","Filt","Func","Heading","InfoClass","Meth","Oper","Prop","Returns","Var"],name:="ManSection",reqattr:=[],type:="elements"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Returns",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Table","URL","Verb"],name:="Description",reqattr:=[],type:="mixed"),rec(attr:=["Arg","Comm","Label","Name"],name:="Func",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Oper",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Constr",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Meth",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name","Type"],name:="Filt",reqattr:=["Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Prop",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Arg","Comm","Label","Name"],name:="Attr",reqattr:=["Arg","Name"],type:="empty"),rec(attr:=["Comm","Label","Name"],name:="Var",reqattr:=["Name"],type:="empty"),rec(attr:=["Comm","Label","Name"],name:="Fam",reqattr:=["Name"],type:="empty"),rec(attr:=["Comm","Label","Name"],name:="InfoClass",reqattr:=["Name"],type:="empty"),rec(attr:=[],content:=["PCDATA","Alt","Emph","E","Par","P","Br","Keyword","K","Arg","A","Quoted","Q","Code","C","File","F","Button","B","Package","M","Math","Display","Example","Listing","Log","Verb","URL","Email","Homepage","Address","Cite","Label","Ref","Index","Ignore"],name:="Heading",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","ManSection","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Subsection","Table","URL","Verb"],name:="Section",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Table","URL","Verb"],name:="Chapter",reqattr:=[],type:="mixed"),rec(attr:=["Label"],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Heading","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Table","URL","Verb"],name:="Appendix",reqattr:=[],type:="mixed"),rec(attr:=[],content:=["A","Address","Admonition","Alt","Arg","B","Br","Button","C","Chapter","Cite","Code","Display","E","Email","Emph","Enum","Example","F","File","Homepage","Ignore","Index","K","Keyword","Label","List","Listing","Log","M","Math","P","PCDATA","Package","Par","Q","Quoted","Ref","Section","Table","URL","Verb"],name:="Body",reqattr:=[],type:="mixed"),rec(attr:=["Name"],content:=["Appendix","Bibliography","Body","TableOfContents","TheIndex","TitlePage"],name:="Book",reqattr:=["Name"],type:="elements")];
diff --git a/lib/getdtd.g b/lib/getdtd.g
index f65f658..3e7754a 100644
--- a/lib/getdtd.g
+++ b/lib/getdtd.g
@@ -41,7 +41,7 @@ od;
 pos := PositionSublist(dtd, "% InnerText");
 pos2 := Position(dtd, '>', pos);
 innertxt := WordsString(dtd{[pos+13..pos2]});
-txt := Concatenation(innertxt, [ "Enum", "List", "Table" ]);
+txt := Concatenation(innertxt, [ "Enum", "List", "Table", "Admonition" ]);
 ssent := [ "Subsection", "ManSection" ];
 
 for x in elements do 
diff --git a/lib/latexhead.tex b/lib/latexhead.tex
index 48450cb..fd0dc51 100644
--- a/lib/latexhead.tex
+++ b/lib/latexhead.tex
@@ -30,8 +30,16 @@
 \definecolor{FuncColor}{rgb}{CONFIGCOLORfuncdefs}
 %% strange name because of pdflatex bug:
 \definecolor{Chapter }{rgb}{CONFIGCOLORchapter}
+
+\definecolor{admonitionNote}{rgb}{CONFIGCOLORadmonition_note}
+\definecolor{admonitionTip}{rgb}{CONFIGCOLORadmonition_tip}
+\definecolor{admonitionImportant}{rgb}{CONFIGCOLORadmonition_important}
+\definecolor{admonitionWarning}{rgb}{CONFIGCOLORadmonition_warning}
+\definecolor{admonitionCaution}{rgb}{CONFIGCOLORadmonition_caution}
+
 CONFIGMoreColors
 
+\usepackage{fancybox}
 \usepackage{fancyvrb}
 
 CONFIGFontPackages
diff --git a/styles/manual.css b/styles/manual.css
index a320794..cb1c7ce 100644
--- a/styles/manual.css
+++ b/styles/manual.css
@@ -477,6 +477,74 @@ span.BibNote {
 span.BibHowpublished {
 }
 
+/* Originally from a SASS file using @mixin, @include, nesting &, darken/lighten, variables*/
+.admonition {
+  padding: 0 15px;
+  margin-bottom: 20px;
+  border: 2px solid transparent;
+  border-radius: 4px;
+  text-align: left;
+}
 
-
-
+.admonition > div.example {
+  margin-bottom: 20px;
+}
+.admonition-title {
+  font-weight: bold;
+  text-align: left;
+}
+.admonition.note {
+  --base-blue: #3498db;
+  /* background-color: #cce5f6; */
+  border-color: #3498db;
+}
+.admonition.note > .admonition-title {
+  color: #1d6fa5;
+}
+.admonition.note > .admonition-title > code {
+  color: #1d6fa5;
+}
+.admonition.tip {
+  --base-green: #46aa63;
+  /* background-color: #bee4c9; */
+  border-color: #46aa63;
+}
+.admonition.tip > .admonition-title {
+  color: #307443;
+}
+.admonition.tip > .admonition-title > code {
+  color: #307443;
+}
+.admonition.warning {
+  --base-carrot: #e67e22;
+  /* background-color: #f8dcc2; */
+  border-color: #e67e22;
+}
+.admonition.warning > .admonition-title {
+  color: #a85913;
+}
+.admonition.warning > .admonition-title > code {
+  color: #a85913;
+}
+.admonition.important {
+  --base-violet: #7200a3;
+  /* background-color: #cc57ff; */
+  border-color: #7200a3;
+}
+.admonition.important > .admonition-title {
+  color: #3c0057;
+}
+.admonition.important > .admonition-title > code {
+  color: #3c0057;
+}
+.admonition.caution {
+  --base-alizarin: #e74c3c;
+  /* background-color: #fbdedb; */
+  border-color: #e74c3c;
+}
+.admonition.caution > .admonition-title {
+  color: #bf2718;
+}
+.admonition.caution > .admonition-title > code {
+  color: #bf2718;
+}