diff options
author | Chris Johns <chrisj@rtems.org> | 2014-02-17 18:04:46 +1100 |
---|---|---|
committer | Chris Johns <chrisj@rtems.org> | 2014-02-17 18:04:46 +1100 |
commit | f91e023fc4c68867e8ef9476ae28226feaa9929e (patch) | |
tree | c7daa4f99352fc45e27c5f5fa53d07b51292c14f /doc/asciidoc/docbook45.conf | |
parent | 11d4b8976e9c5fa13c77faecc197cc9d1bc1ddfc (diff) |
Add the documentation.
Diffstat (limited to 'doc/asciidoc/docbook45.conf')
-rw-r--r-- | doc/asciidoc/docbook45.conf | 802 |
1 files changed, 802 insertions, 0 deletions
diff --git a/doc/asciidoc/docbook45.conf b/doc/asciidoc/docbook45.conf new file mode 100644 index 0000000..76cbd0f --- /dev/null +++ b/doc/asciidoc/docbook45.conf @@ -0,0 +1,802 @@ +# +# docbook45.conf +# +# Asciidoc DocBook 4.5 configuration file. +# + +[miscellaneous] +outfilesuffix=.xml +# Printable page width and units. +# Used to calculate DocBook CALS tables absolute column and table widths. +pagewidth=425 +pageunits=* + +[attributes] +basebackend=docbook +basebackend-docbook= +basebackend-docbook45= +# For backward compatibility (docbook backend was renamed to docbook45 at 8.6.2) +backend-docbook= +# toc and numbered are set to maintain original default behavior. +toc= +numbered= + +[replacements2] +# Line break markup. Custom processing instruction in fo.xsl. +(?m)^(.*)\s\+$=\1<?asciidoc-br?> + +[replacements] +ifdef::asciidoc7compatible[] +# Superscripts. +\^(.+?)\^=<superscript>\1</superscript> +# Subscripts. +~(.+?)~=<subscript>\1</subscript> +endif::asciidoc7compatible[] + +[ruler-blockmacro] +# Uses custom processing instructions in fo.xsl and asciidoc-dblatex.xsl. +<simpara><?asciidoc-hr?></simpara> + +[pagebreak-blockmacro] +# Uses custom processing instructions in fo.xsl and asciidoc-dblatex.xsl. +<simpara><?asciidoc-pagebreak?></simpara> + +[blockdef-pass] +latexmath-style=template="latexmathblock",subs=() + +[macros] +# math macros. +(?su)[\\]?(?P<name>latexmath):(?P<subslist>\S*?)\[(?P<passtext>.*?)(?<!\\)\]=[] +(?u)^(?P<name>latexmath)::(?P<subslist>\S*?)(\[(?P<passtext>.*?)\])$=#[] + +[latexmath-inlinemacro] +<inlineequation> +<alt><![CDATA[{passtext}]]></alt> +<inlinemediaobject><textobject><phrase></phrase></textobject></inlinemediaobject> +</inlineequation> + +[latexmath-blockmacro] +<informalequation> +<alt><![CDATA[{passtext}]]></alt> +<mediaobject><textobject><phrase></phrase></textobject></mediaobject> +</informalequation> + +[latexmathblock] +<equation{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}><title>{title}</title> +{title%}<informalequation{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<alt><![CDATA[|]]></alt> +<mediaobject><textobject><phrase></phrase></textobject></mediaobject> +{title#}</equation> +{title%}</informalequation> + +[image-inlinemacro] +<inlinemediaobject> + <imageobject> + <imagedata fileref="{imagesdir=}{imagesdir?/}{target}"{width? contentwidth="{width}"}{height? contentdepth="{height}"}{scale? scale="{scale}"}/> + </imageobject> + <textobject><phrase>{alt={target}}</phrase></textobject> +</inlinemediaobject> + +[image-blockmacro] +<figure{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}{pgwide-option? pgwide="1"}><title>{title}</title> +{title%}<informalfigure{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}>{pgwide-option?<?dbfo pgwide="1"?>} +# DocBook XSL Stylesheets custom processing instructions. +<?dbfo keep-together="{breakable-option#auto}"?> +<?dbfo keep-together="{unbreakable-option#always}"?> +<mediaobject> + <imageobject> + <imagedata fileref="{imagesdir=}{imagesdir?/}{target}"{width? contentwidth="{width}"}{height? contentdepth="{height}"}{scale? scale="{scale}"}{scaledwidth? width="{scaledwidth}" scalefit="1"}{align? align="{align}"}/> + </imageobject> + <textobject><phrase>{alt={target}}</phrase></textobject> +</mediaobject> +{title#}</figure> +{title%}</informalfigure> + +[indexterm-inlinemacro] +# Index term. +# Generate separate index entries for primary, secondary and tertiary +# descriptions. +# Primary only. +{2%}<indexterm> +{2%} <primary>{1}</primary> +{2%}</indexterm> +# Primary and secondary. +{2#}{3%}<indexterm> +{2#}{3%} <primary>{1}</primary><secondary>{2}</secondary> +{2#}{3%}</indexterm> +{2#}{3%}<indexterm> +{2#}{3%} <primary>{2}</primary> +{2#}{3%}</indexterm> +# Primary, secondary and tertiary. +{3#}<indexterm> + <primary>{1}</primary><secondary>{2}</secondary><tertiary>{3}</tertiary> +{3#}</indexterm> +{3#}<indexterm> + <primary>{2}</primary><secondary>{3}</secondary> +{3#}</indexterm> +{3#}<indexterm> + <primary>{3}</primary> +{3#}</indexterm> + +[indexterm2-inlinemacro] +# Index term. +# Single entry index term that is visible in the primary text flow. +<indexterm><primary>{1}</primary></indexterm>{1} + +[footnote-inlinemacro] +# Footnote. +<footnote><simpara>{0}</simpara></footnote> + +[footnoteref-inlinemacro] +# Footnote reference. +{2#}<footnote id="{1}"><simpara>{2}</simpara></footnote> +{2%}<footnoteref linkend="{1}" /> + +[callout-inlinemacro] +# Callout. +<co id="{coid}"/> + +# List tags. +[listtags-bulleted] +list=<itemizedlist{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}{compact-option? spacing="compact"}>{unbreakable-option? <?dbfo keep-together="always"?>}{title?<title>{title}</title>}|</itemizedlist> +item=<listitem>|</listitem> +text=<simpara>|</simpara> + +[listtags-numbered] +list=<orderedlist{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"} numeration="{style}"{compact-option? spacing="compact"}>{unbreakable-option? <?dbfo keep-together="always"?>}{title?<title>{title}</title>}{start?<?dbfo start="{start}"?><?dbhtml start="{start}"?>}|</orderedlist> +item=<listitem>|</listitem> +text=<simpara>|</simpara> + +[listtags-labeled] +list=<variablelist{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}>{title?<title>{title}</title>}|</variablelist> +entry=<varlistentry>|</varlistentry> +label= +term=<term>|</term> +item=<listitem>|</listitem> +text=<simpara>|</simpara> + +[listtags-horizontal] +# Horizontal labeled list (implemented with two column table). +# Hardwired column widths to 30%,70% because the current crop of PDF +# generators do not auto calculate column widths. + list=<{title?table}{title!informaltable}{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}{style? tabstyle="{style}"}{pgwide-option? pgwide="1"} frame="none" colsep="0" rowsep="0">{title?<title>{title}</title>}<tgroup cols="2"><colspec colwidth="{labelwidth=15}*"/><colspec colwidth="{itemwidth=85}*"/><tbody valign="top">|</tbody></tgroup><{title?/table}{title!/informaltable}> +entry=<row>|</row> +label=<entry>|</entry> +term=<simpara>|</simpara> +item=<entry>|</entry> +text=<simpara>|</simpara> + +[listtags-callout] +list=<calloutlist{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}>{title?<title>{title}</title>}|</calloutlist> +item=<callout arearefs="{coids}">|</callout> +text=<para>|</para> + +[listtags-qanda] +list=<qandaset{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}>{title?<title>{title}</title>}|</qandaset> +entry=<qandaentry>|</qandaentry> +label=<question>|</question> +term=<simpara>|</simpara> +item=<answer>|</answer> +text=<simpara>|</simpara> + +[listtags-bibliography] +list=<bibliodiv{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}>{title?<title>{title}</title>}|</bibliodiv> +item=<bibliomixed>|</bibliomixed> +text=<bibliomisc>|</bibliomisc> + +[listtags-glossary] +list= +entry=<glossentry>|</glossentry> +label= +term=<glossterm>|</glossterm> +item=<glossdef>|</glossdef> +text=<simpara>|</simpara> + +[tags] +# Quoted text +emphasis=<emphasis>{1?<phrase role="{1}">}|{1?</phrase>}</emphasis> +strong=<emphasis role="strong">{1?<phrase role="{1}">}|{1?</phrase>}</emphasis> +monospaced=<literal>{1?<phrase role="{1}">}|{1?</phrase>}</literal> +singlequoted={lsquo}{1?<phrase role="{1}">}|{1?</phrase>}{rsquo} +doublequoted={ldquo}{1?<phrase role="{1}">}|{1?</phrase>}{rdquo} +unquoted={1?<phrase role="{1}">}|{1?</phrase>} +subscript=<subscript>{1?<phrase role="{1}">}|{1?</phrase>}</subscript> +superscript=<superscript>{1?<phrase role="{1}">}|{1?</phrase>}</superscript> + +ifdef::deprecated-quotes[] +# Override with deprecated quote attributes. +emphasis={role?<phrase role="{role}">}<emphasis>|</emphasis>{role?</phrase>} +strong={role?<phrase role="{role}">}<emphasis role="strong">|</emphasis>{role?</phrase>} +monospaced={role?<phrase role="{role}">}<literal>|</literal>{role?</phrase>} +singlequoted={role?<phrase role="{role}">}{amp}#8216;|{amp}#8217;{role?</phrase>} +doublequoted={role?<phrase role="{role}">}{amp}#8220;|{amp}#8221;{role?</phrase>} +unquoted={role?<phrase role="{role}">}|{role?</phrase>} +subscript={role?<phrase role="{role}">}<subscript>|</subscript>{role?</phrase>} +superscript={role?<phrase role="{role}">}<superscript>|</superscript>{role?</phrase>} +endif::deprecated-quotes[] + +# Inline macros +[http-inlinemacro] +<ulink url="{name}:{target}">{0={name}:{target}}</ulink> +[https-inlinemacro] +<ulink url="{name}:{target}">{0={name}:{target}}</ulink> +[ftp-inlinemacro] +<ulink url="{name}:{target}">{0={name}:{target}}</ulink> +[file-inlinemacro] +<ulink url="{name}:{target}">{0={name}:{target}}</ulink> +[irc-inlinemacro] +<ulink url="{name}:{target}">{0={name}:{target}}</ulink> +[mailto-inlinemacro] +<ulink url="mailto:{target}">{0={target}}</ulink> +[callto-inlinemacro] +<ulink url="{name}:{target}">{0={target}}</ulink> +[link-inlinemacro] +<ulink url="{target}">{0={target}}</ulink> +# anchor:id[text] +[anchor-inlinemacro] +<anchor id="{target}" xreflabel="{0=[{target}]}"/> +# [[id,text]] +[anchor2-inlinemacro] +<anchor id="{1}" xreflabel="{2=[{1}]}"/> +# [[[id]]] +[anchor3-inlinemacro] +<anchor id="{1}" xreflabel="[{1}]"/>[{1}] +# xref:id[text] +[xref-inlinemacro] +<link linkend="{target}">{0}</link> +{2%}<xref linkend="{target}"/> +# <<id,text>> +[xref2-inlinemacro] +<link linkend="{1}">{2}</link> +{2%}<xref linkend="{1}"/> +# // comment line +[comment-inlinemacro] +{showcomments#}<remark>{passtext}</remark> + +[comment-blockmacro] +{showcomments#}<remark>{passtext}</remark> + +[literal-inlinemacro] +# Inline literal. +<literal>{passtext}</literal> + +# Special word macros +[emphasizedwords] +<emphasis>{words}</emphasis> +[monospacedwords] +<literal>{words}</literal> +[strongwords] +<emphasis role="strong">{words}</emphasis> + +# Paragraph substitution. +[paragraph] +<formalpara{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}><title>{title}</title><para> +{title%}<simpara{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +| +{title%}</simpara> +{title#}</para></formalpara> +{empty} + +[admonitionparagraph] +<{name}{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}><simpara>|</simpara></{name}> + +# Delimited blocks. +[literalblock] +<formalpara{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}><title>{title}</title><para> +{title#}<literallayout class="monospaced"> +{title%}<literallayout{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"} class="monospaced"> +| +</literallayout> +{title#}</para></formalpara> + +[listingblock] +<formalpara{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}><title>{title}</title><para> +{title#}<screen> +{title%}<screen{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +| +</screen> +{title#}</para></formalpara> + +[sidebarblock-open] +<sidebar{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> + +[sidebarblock-close] +</sidebar> + +[sidebarblock] +template::[sidebarblock-open] +| +template::[sidebarblock-close] + +[sidebarparagraph] +template::[sidebarblock-open] +<simpara>|</simpara> +template::[sidebarblock-close] + +[abstractblock-open] +<abstract{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> + +[abstractblock-close] +</abstract> + +[abstractblock] +template::[abstractblock-open] +| +template::[abstractblock-close] + +[abstractparagraph] +template::[abstractblock-open] +<simpara>|</simpara> +template::[abstractblock-close] + +[openblock] +| + +[partintroblock-open] +<partintro{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> + +[partintroblock-close] +</partintro> + +[partintroblock] +template::[partintroblock-open] +| +template::[partintroblock-close] + +[partintroparagraph] +template::[partintroblock-open] +<simpara>|</simpara> +template::[partintroblock-close] + +[quote-open] +# Common quote and verse element template. +<blockquote{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +# Include attribution only if either {attribution} or {citetitle} is defined. +{attribution#}<attribution> +{attribution%}{citetitle#}<attribution> +{attribution} +<citetitle>{citetitle}</citetitle> +{attribution#}</attribution> +{attribution%}{citetitle#}</attribution> + +[quote-close] +</blockquote> + +[quoteblock] +template::[quote-open] +| +template::[quote-close] + +[verseblock] +template::[quote-open] +<literallayout>|</literallayout> +template::[quote-close] + +[quoteparagraph] +template::[quote-open] +<simpara>|</simpara> +template::[quote-close] + +[exampleblock-open] +<{title?example}{title!informalexample}{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +# DocBook XSL Stylesheets custom processing instructions. +<?dbfo keep-together="{breakable-option#auto}"?> +<?dbfo keep-together="{unbreakable-option#always}"?> +<title>{title}</title> + +[exampleblock-close] +</{title?example}{title!informalexample}> + +[exampleblock] +template::[exampleblock-open] +| +template::[exampleblock-close] + +[exampleparagraph] +template::[exampleblock-open] +<simpara>|</simpara> +template::[exampleblock-close] + +[admonitionblock] +<{name}{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</{name}> + +# Tables. +[tabletags-default] +colspec=<colspec colname="col_{colnumber}" colwidth="{width!{colpcwidth}*}{width?{colabswidth}{pageunits}}"/> +bodyrow=<row>|</row> +headdata=<entry align="{halign}" valign="{valign}"{colspan@1:: namest="col_{colstart}" nameend="col_{colend}"}{morerows@0:: morerows="{morerows}"}>|</entry> +bodydata=<entry align="{halign}" valign="{valign}"{colspan@1:: namest="col_{colstart}" nameend="col_{colend}"}{morerows@0:: morerows="{morerows}"}>|</entry> +paragraph=<simpara>|</simpara> + +[tabletags-emphasis] +paragraph=<simpara><emphasis>|</emphasis></simpara> + +[tabletags-header] +paragraph=<simpara><emphasis role="strong">|</emphasis></simpara> + +[tabletags-strong] +paragraph=<simpara><emphasis role="strong">|</emphasis></simpara> + +[tabletags-monospaced] +paragraph=<simpara><literal>|</literal></simpara> + +[tabletags-verse] +bodydata=<entry align="{halign}" valign="{valign}"{colspan@1:: namest="col_{colstart}" nameend="col_{colend}"}{morerows@0:: morerows="{morerows}"}><literallayout>|</literallayout></entry> +paragraph= + +[tabletags-literal] +bodydata=<entry align="{halign}" valign="{valign}"{colspan@1:: namest="col_{colstart}" nameend="col_{colend}"}{morerows@0:: morerows="{morerows}"}><literallayout class="monospaced">|</literallayout></entry> +paragraph= + +[tabletags-asciidoc] +paragraph= + +[table] +<{title?table}{title!informaltable}{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}{pgwide-option? pgwide="1"} +frame="{frame=all}" +{grid%rowsep="1" colsep="1"} +rowsep="{grid@none|cols:0:1}" colsep="{grid@none|rows:0:1}" +> +<title>{title}</title> +# DocBook XSL Stylesheets custom processing instructions. +<?dbhtml table-width="{width}"?> +<?dbfo table-width="{width}"?> +<?dblatex table-width="{width}"?> +<?dbfo keep-together="{breakable-option#auto}"?> +<?dbfo keep-together="{unbreakable-option#always}"?> +<tgroup cols="{colcount}"> +{colspecs} +{headrows#}<thead> +{headrows} +{headrows#}</thead> +{footrows#}<tfoot> +{footrows} +{footrows#}</tfoot> +<tbody> +{bodyrows} +</tbody> +</tgroup> +</{title?table}{title!informaltable}> + +#-------------------------------------------------------------------- +# Deprecated old table definitions. +# + +[old_tabledef-default] +template=old_table +colspec=<colspec colwidth="{colwidth}{pageunits}" align="{colalign}"/> +bodyrow=<row>|</row> +bodydata=<entry>|</entry> + +[old_table] +<{title?table}{title!informaltable}{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"} pgwide="0" +frame="{frame=topbot}" +{grid%rowsep="0" colsep="0"} +rowsep="{grid@none|cols:0:1}" colsep="{grid@none|rows:0:1}" +> +<title>{title}</title> +<tgroup cols="{cols}"> +{colspecs} +{headrows#}<thead> +{headrows} +{headrows#}</thead> +{footrows#}<tfoot> +{footrows} +{footrows#}</tfoot> +<tbody> +{bodyrows} +</tbody> +</tgroup> +</{title?table}{title!informaltable}> + +# End of deprecated old table definitions. +#-------------------------------------------------------------------- + +# Special sections. +[preface] +<preface{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title=}</title> +| +</preface> + +[index] +<index{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</index> + +[bibliography] +<bibliography{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</bibliography> + +[glossary] +<glossary{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</glossary> + +[appendix] +<appendix{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</appendix> + +[floatingtitle] +<bridgehead{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"} renderas="sect{level}">{title}</bridgehead> + + +[header-declarations] +<?xml version="1.0" encoding="{encoding}"?> +<!DOCTYPE {doctype-article?article}{doctype-book?book}{doctype-manpage?refentry} PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +{toc#}<?asciidoc-toc?> +{numbered#}<?asciidoc-numbered?> + +[+docinfo] +{notitle%} <title>{doctitle}</title> + <date>{revdate}</date> +# To ensure valid articleinfo/bookinfo when there is no AsciiDoc header. + {doctitle%}{revdate%}<date>{docdate}</date> + {authored#}<author> + <firstname>{firstname}</firstname> + <othername>{middlename}</othername> + <surname>{lastname}</surname> + <email>{email}</email> + {authored#}</author> + <authorinitials>{authorinitials}</authorinitials> +<revhistory><revision>{revnumber?<revnumber>{revnumber}</revnumber>}<date>{revdate}</date>{authorinitials?<authorinitials>{authorinitials}</authorinitials>}{revremark?<revremark>{revremark}</revremark>}</revision></revhistory> +{docinfo1,docinfo2#}{include:{docdir}/docinfo.xml} +{docinfo,docinfo2#}{include:{docdir}/{docname}-docinfo.xml} +# DEPRECATED: Use docinfo. +{revisionhistory#}{include:{docdir}/{docname}-revhistory.xml} +# DEPRECATED: Use orgname in preference to companyname. +<orgname>{companyname}</orgname> +# DEPRECATED: Use orgname in preference to corpname. +<orgname>{corpname}</orgname> +<orgname>{orgname}</orgname> + +#------------------------- +# article document type +#------------------------- +ifdef::doctype-article[] + +[header] +template::[header-declarations] + +<article lang="{lang=en}"> +<articleinfo> +template::[docinfo] +</articleinfo> + +[footer] +</article> + +[preamble] +# Untitled elements between header and first section title. +| + +[abstract] +<abstract{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +| +</abstract> + +[sect1] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +[sect2] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +[sect3] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +[sect4] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +endif::doctype-article[] + +#------------------------- +# manpage document type +#------------------------- +ifdef::doctype-manpage[] + +[replacements] +# The roff format does not substitute special characters so just print them as +# text. +\(C\)=(C) +\(TM\)=(TM) + +[header] +template::[header-declarations] +<refentry lang="{lang=en}"> +<refentryinfo> +template::[docinfo] +</refentryinfo> +<refmeta> +<refentrytitle>{mantitle}</refentrytitle> +<manvolnum>{manvolnum}</manvolnum> +# Default source and manual to suppress DocBook XSL warnings. +<refmiscinfo class="source">{mansource= }</refmiscinfo> +<refmiscinfo class="manual">{manmanual= }</refmiscinfo> +<refmiscinfo class="version">{manversion={revnumber}}</refmiscinfo> +</refmeta> +<refnamediv> + <refname>{manname1}</refname> + <refname>{manname2}</refname> + <refname>{manname3}</refname> + <refname>{manname4}</refname> + <refname>{manname5}</refname> + <refname>{manname6}</refname> + <refname>{manname7}</refname> + <refname>{manname8}</refname> + <refname>{manname9}</refname> + <refpurpose>{manpurpose}</refpurpose> +</refnamediv> + +[footer] +</refentry> + +# Section macros +[synopsis] +<refsynopsisdiv{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +| +</refsynopsisdiv> + +[sect1] +<refsect1{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</refsect1> + +[sect2] +<refsect2{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</refsect2> + +[sect3] +<refsect3{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</refsect3> + +endif::doctype-manpage[] + +#------------------------- +# book document type +#------------------------- +ifdef::doctype-book[] + +[header] +template::[header-declarations] + +<book lang="{lang=en}"> +<bookinfo> +template::[docinfo] +</bookinfo> + +[footer] +</book> + +[preamble] +# Preamble is not allowed in DocBook book so wrap it in a preface. +<preface{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title=}</title> +| +</preface> + +[dedication] +<dedication{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</dedication> + +[colophon] +<colophon{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</colophon> + +[sect0] +<part{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</part> + +[sect1] +<chapter{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</chapter> + +[sect2] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +[sect3] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +[sect4] +<section{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}> +<title>{title}</title> +| +</section> + +endif::doctype-book[] + +ifdef::sgml[] +# +# Optional DocBook SGML. +# +# Most of the differences between DocBook XML and DocBook SGML boils +# down to the empty element syntax: SGML does not like the XML empty +# element <.../> syntax, use <...> instead. +# +[miscellaneous] +outfilesuffix=.sgml + +[header-declarations] +<!DOCTYPE {doctype-article?article}{doctype-book?book}{doctype-manpage?refentry} PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> + +[tabledef-default] +colspec=<colspec colwidth="{colabswidth}{pageunits}" align="{colalign}"> + +[image-inlinemacro] +<inlinemediaobject> + <imageobject> + <imagedata fileref="{imagesdir=}{imagesdir?/}{target}"{width? width="{width}"}{height? depth="{height}"}> + </imageobject> + <textobject><phrase>{alt={target}}</phrase></textobject> +</inlinemediaobject> + +[image-blockmacro] +<figure><title>{title}</title> +{title%}<informalfigure> +<mediaobject> + <imageobject> + <imagedata fileref="{imagesdir=}{imagesdir?/}{target}"{width? width="{width}"}{height? depth="{height}"}> + </imageobject> + <textobject><phrase>{alt={target}}</phrase></textobject> +</mediaobject> +{title#}</figure> +{title%}</informalfigure> + +# Inline macros +[xref-inlinemacro] +<link linkend="{target}">{0}</link> +{2%}<xref linkend="{target}"> +[xref2-inlinemacro] +# <<id,text>> +<link linkend="{1}">{2}</link> +{2%}<xref linkend="{1}"> +[anchor-inlinemacro] +<anchor id="{target}" xreflabel="{0=[{target}]}"> +[anchor2-inlinemacro] +# [[id,text]] +<anchor id="{1}" xreflabel="{2=[{1}]}"> + +endif::sgml[] |