/usr/share/doc/refdb/refdb-manual/re21.html is in refdb-doc 1.0.2-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>refdbnd</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="RefDB handbook" /><link rel="up" href="ch15.html" title="Chapter 15. Tools for bibliographies" /><link rel="prev" href="re20.html" title="refdbib" /><link rel="next" href="re22.html" title="runbib" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">refdbnd</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re20.html">Prev</a> </td><th width="60%" align="center">Chapter 15. Tools for bibliographies</th><td width="20%" align="right"> <a accesskey="n" href="re22.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="refentry-refdbnd"></a><div class="titlepage"></div><div class="refnamediv"><a id="refdbnd-name"></a><h2>Name</h2><p>refdbnd — creates a skeleton document and a Makefile for RefDB</p></div><div class="refsynopsisdiv"><a id="refdbnd-synopsis"></a><h2>Synopsis</h2><p>Interactive mode:</p><div class="cmdsynopsis"><p><code class="command">refdbnd</code> </p></div><p>Non-interactive mode:</p><div class="cmdsynopsis"><p><code class="command">refdbnd</code> <em class="replaceable"><code>basename</code></em> <em class="replaceable"><code>doctype</code></em> <em class="replaceable"><code>pubtype</code></em> <em class="replaceable"><code>database</code></em> <em class="replaceable"><code>style</code></em> <em class="replaceable"><code>encoding</code></em> [<em class="replaceable"><code>css-file</code></em>] [<em class="replaceable"><code>fo-driver</code></em>] [<em class="replaceable"><code>html-driver</code></em>] [<em class="replaceable"><code>xhtml-driver</code></em>]</p></div></div><div class="refsect1"><a id="refdbnd-description"></a><h2>Description</h2><p>This script should be the first choice for novices for creating new SGML,XML, or RTF documents for use with RefDB(7). If called without arguments, the script runs in a novice-friendly interactive mode and collects a few answers about the new document. Based on these answers it will create a skeleton document as well as a custom-tailored Makefile that performs all necessary steps to create formatted output from the document.</p><p>Alternatively you can call this script from a directory that contains an existing SGML, XML, or RTF file. Pass the full name to the script when it asks for a filename, and the script will try to guess some of the settings from the existing file.</p><p>The script can create the following document types:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="emphasis"><em>DocBook SGML</em></span></span></dt><dd><p>Versions 3.1, 4.0, 4.1</p></dd><dt><span class="term"><span class="emphasis"><em>DocBook XML</em></span></span></dt><dd><p>Versions 4.1.2, 4.2, 4.3, 5.0</p></dd><dt><span class="term"><span class="emphasis"><em>TEI XML</em></span></span></dt><dd><p>Versions P4, P5</p></dd><dt><span class="term"><span class="emphasis"><em>Rich Text Format (RTF)</em></span></span></dt><dd><p>Version 1.9 (M$ Word 2007 and earlier, OpenOffice, AbiWord, and most other contemporary word processors)</p></dd></dl></div><p>The skeleton documents created by the script contain the appropriate prolog for the selected document type. If required (SGML, DTD-based XML), an external entity is declared in the internal subset in order to include the bibliography.</p></div><div class="refsect1"><a id="refdbnd-options"></a><h2>Options</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="emphasis"><em>basename</em></span></span></dt><dd><p>The basename of the document, i.e. sans extension. If you want to end up with <span class="emphasis"><em>foo.pdf</em></span>, use <span class="emphasis"><em>foo</em></span></p></dd><dt><span class="term"><span class="emphasis"><em>doctype</em></span></span></dt><dd><p>Available options are <span class="emphasis"><em>db31</em></span>, <span class="emphasis"><em>db40</em></span>, and <span class="emphasis"><em>db41</em></span> for DocBook SGML; <span class="emphasis"><em>db41x</em></span>, <span class="emphasis"><em>db42x</em></span>, and <span class="emphasis"><em>db43x</em></span> for DocBook XML; <span class="emphasis"><em>teix</em></span> for TEI XML; <span class="emphasis"><em>rtf</em></span> for RTF</p></dd><dt><span class="term"><span class="emphasis"><em>pubtype</em></span></span></dt><dd><p>This is one of <span class="emphasis"><em>set</em></span>, <span class="emphasis"><em>book</em></span>, or <span class="emphasis"><em>article</em></span> for DocBook, and <span class="emphasis"><em>TEI.2</em></span> for TEI. This argument is ignored by the other document types, but must be present nonetheless (pass "foo" or "bar", depending on your mood).</p></dd><dt><span class="term"><span class="emphasis"><em>database</em></span></span></dt><dd><p>The name of the database that contains your references.</p></dd><dt><span class="term"><span class="emphasis"><em>style</em></span></span></dt><dd><p>The name of the bibliography style.</p></dd><dt><span class="term"><span class="emphasis"><em>encoding</em></span></span></dt><dd><p>The character encoding of the document.</p></dd><dt><span class="term"><span class="emphasis"><em>css-file</em></span></span></dt><dd><p>The name of a CSS file for the HTML output. This option is meaningless for RTF documents and can be left out.</p></dd><dt><span class="term"><span class="emphasis"><em>fo-driver</em></span></span></dt><dd><p>A custom driver file for fo output. Please consult the manual for the requirements of such a driver. This option is meaningless for RTF documents and can be left out.</p></dd><dt><span class="term"><span class="emphasis"><em>html-driver</em></span></span></dt><dd><p>A custom driver file for html output. Please consult the manual for the requirements of such a driver. This option is meaningless for RTF documents and can be left out.</p></dd><dt><span class="term"><span class="emphasis"><em>xhtml-driver</em></span></span></dt><dd><p>A custom driver file for xhtml output. Please consult the manual for the requirements of such a driver. This option is meaningless for RTF documents and can be left out.</p></dd></dl></div></div><div class="refsect1"><a id="refdbnd-makefile-targets"></a><h2>Makefile Targets</h2><p>The Makefile is set up to process your document properly depending on its type. The following targets are available for SGML and XML documents:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="emphasis"><em>html</em></span></span></dt><dd><p>Creates a set of HTML files.</p></dd><dt><span class="term"><span class="emphasis"><em>pdf</em></span></span></dt><dd><p>Creates a PDF file.</p></dd><dt><span class="term"><span class="emphasis"><em>ps</em></span></span></dt><dd><p>Creates a Postscript file (SGML documents only).</p></dd><dt><span class="term"><span class="emphasis"><em>rtf</em></span></span></dt><dd><p>Creates a RTF file. The Rich Text Format can be edited by most Word Processors.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Not all FO processors offer RTF output, so this target may not work for XML documents with your setup.</p></div></dd><dt><span class="term"><span class="emphasis"><em>all</em></span></span></dt><dd><p>This is the default if you call <span class="command"><strong>make</strong></span> without specifying a target. It will build all of the above targets.</p></dd><dt><span class="term"><span class="emphasis"><em>htmldist</em></span></span></dt><dd><p>Creates a <code class="filename">.tar.gz</code> archive of the HTML files.</p></dd><dt><span class="term"><span class="emphasis"><em>pdfdist</em></span></span></dt><dd><p>Creates a <code class="filename">.tar.gz</code> archive of the PDF file.</p></dd><dt><span class="term"><span class="emphasis"><em>ps</em></span></span></dt><dd><p>Creates a <code class="filename">.tar.gz</code> archive of the Postscript file (SGML documents only).</p></dd><dt><span class="term"><span class="emphasis"><em>rtf</em></span></span></dt><dd><p>Creates a <code class="filename">.tar.gz</code> archive of the RTF file.</p></dd><dt><span class="term"><span class="emphasis"><em>dist</em></span></span></dt><dd><p>This will build all of the above archives.</p></dd><dt><span class="term"><span class="emphasis"><em>clean</em></span></span></dt><dd><p>This will remove all built files, except for the source document using the full citation format.</p></dd><dt><span class="term"><span class="emphasis"><em>shortclean</em></span></span></dt><dd><p>This will remove all built files, including the source document using the full citation format.</p></dd></dl></div><p>For RTF output there is only a default target which you can invoke by running <span class="command"><strong>make</strong></span> without an argument, and the "clean" target which removes generated files.</p></div><div class="refsect1"><a id="refdbnd-files"></a><h2>Files</h2><p><code class="filename">PREFIX/share/refdb/db/examples/Makefile.template</code></p><p><code class="filename">PREFIX/share/refdb/db/examples/Makefile.rtf.template</code></p><p>The templates used to create the Makefile.</p></div><div class="refsect1"><a id="refdbnd-see_also"></a><h2>See also</h2><p><span class="emphasis"><em>RefDB</em></span> (7).</p><p><span class="emphasis"><em>RefDB manual (local copy) </em></span> PREFIX/share/doc/refdb-<version>/refdb-manual/index.html</p><p><span class="emphasis"><em>RefDB manual (web) </em></span> <<a class="ulink" href="http://refdb.sourceforge.net/manual/index.html" target="_top">http://refdb.sourceforge.net/manual/index.html</a>></p><p><span class="emphasis"><em>RefDB on the web </em></span> <<a class="ulink" href="http://refdb.sourceforge.net/" target="_top">http://refdb.sourceforge.net/</a>></p></div><div class="refsect1"><a id="refdbnd-author"></a><h2>Author</h2><p>refdbnd was written by Markus Hoenicka <markus@mhoenicka.de>.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re20.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch15.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re22.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">refdbib </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> runbib</td></tr></table></div></body></html>
|