Skip to content

Commit

Permalink
Added man pages for daps-xmlformat and daps-check-deps
Browse files Browse the repository at this point in the history
Fixes issue #491
  • Loading branch information
fsundermeyer committed Feb 12, 2019
1 parent 11761df commit 873b2ad
Show file tree
Hide file tree
Showing 3 changed files with 137 additions and 1 deletion.
7 changes: 6 additions & 1 deletion man/xml/MAIN.daps_manpages.xml
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,10 @@
<xi:include href="ccecho.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="daps.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="daps-init.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="daps-autobuild.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="daps-autobuild.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="daps-xmlformat.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
<xi:include href="daps-check-deps.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</article>
63 changes: 63 additions & 0 deletions man/xml/daps-check-deps.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.docbook.org/xml/4.5/docbookx.dtd"
[
<!ENTITY daps_check "daps-check-deps">
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>
<refentry lang="en" id="daps_check">
<refentryinfo>
<productname>&dapsacr;</productname>
<authorgroup>
<author>
<contrib>Developer</contrib>
<firstname>Frank</firstname>
<surname>Sundermeyer</surname>
<email>[email protected]</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta>
<refentrytitle>&dapsacr;</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="date"><?dbtimestamp format="Y B d"?></refmiscinfo>
<refmiscinfo class="version">&dapsversion;</refmiscinfo>
<refmiscinfo class="manual">&daps;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>&daps_check;</refname>
<refpurpose>
Checks the availability of external programs used by &dapsacr;.
</refpurpose>
</refnamediv>
<refsynopsisdiv id="daps_check.synopsis">
<title>Synopsis</title>
<cmdsynopsis>
<command>&daps_check;</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
&dapsacr; depends on a large number of external programs. Without some of
them, &dapsacr; will not run at all. Other programs are only used for
certain functions and are not critical. Use this script to check for the
availability of all external programs used by &dapsacr;.
</para>
</refsect1>
<refsect1 id="daps_check.moreinfo">
<title>See Also</title>
<variablelist>
<varlistentry>
<term>
&dapsurl;
</term>
<listitem>
<para>DAPS project homepage</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
</refentry>
68 changes: 68 additions & 0 deletions man/xml/daps-xmlformat.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.docbook.org/xml/4.5/docbookx.dtd"
[
<!ENTITY daps_xmlf "daps-xmlformat">
<!ENTITY % entities SYSTEM "entity-decl.ent">
%entities;
]>
<refentry lang="en" id="daps_xmlf">
<refentryinfo>
<productname>&dapsacr;</productname>
<authorgroup>
<author>
<contrib>Developer</contrib>
<firstname>Frank</firstname>
<surname>Sundermeyer</surname>
<email>[email protected]</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta>
<refentrytitle>&dapsacr;</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="date"><?dbtimestamp format="Y B d"?></refmiscinfo>
<refmiscinfo class="version">&dapsversion;</refmiscinfo>
<refmiscinfo class="manual">&daps;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>&daps_xmlf;</refname>
<refpurpose>
A wrapper script for xmlformat.pl/xmlformat.rb that calls a DAPS-specific
configuration file.
</refpurpose>
</refnamediv>
<refsynopsisdiv id="daps_xmlf.synopsis">
<title>Synopsis</title>
<cmdsynopsis>
<command>&daps_xmlf;</command>
<arg choice="opt"><replaceable>OPTIONS</replaceable></arg>
<arg choice="plain"><replaceable>FILE(S)</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
&daps_xmlf; calls xmlformat.pl/xmlformat.rb with a DAPS-specific
configuration file located at
<filename>@sysconfdir@/docbook-xmlformat.conf</filename>. Options are the
same as for xmlformat.pl/xmlformat.rb. See <command>xmlformat.pl
--help</command> or <command>xmlformat.rb --help</command> for more
information.
</para>
</refsect1>
<refsect1 id="daps_xmlf.moreinfo">
<title>See Also</title>
<variablelist>
<varlistentry>
<term>
&dapsurl;
</term>
<listitem>
<para>DAPS project homepage</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
</refentry>

0 comments on commit 873b2ad

Please sign in to comment.