.\" Manpage for mdoc-extract.
.\" Contact mail@wagnertech.de to correct errors or typos.
.TH MDOC-EXTRACT 1 "08 Dez 2021" Linux "Linux Manual"
.SH NAME
mdoc-extract \- mdoc extraction tool
.SH SYNOPSIS
.B mdoc-extract
INPUT CLASS
.SH DESCRIPTION
.PP
mdoc-extract reads an input xml file and builds an output tex file. Elements in the input file can be
labeled by 
.I include
or
.I exclude
tags. The value of these tags is the class name from which on this advise is valid. Advices are inherited 
to subclasses. Subclasses are named by "base.sub". Advices for "base.sub" are valid for CLASS=base.sub, 
CLASS=base.sub.subsub and so on, but not for CLASS=base. There can also be more than one class in an advice.
These classes are separated by ":".
.TP
\fBINPUT\fR
Input xml file name
.TP
\fBCLASS\fR
Production class name
.SH FILES
Input file is expected with this format:
.nf
<document>
  <text>This text is always used</text>
  <text include="base.sub:otherbase">This text appears only in "base.sub" 
     and its subclasses as well as for "otherbase" and its subclasses.</text>
  <text exclude="base.sub">This text does not appear in "base.sub"
     and its subclasses</text>
</document>
.fi
.SH AUTHOR
Michael Wagner (michael@wagnertech.de)