/usr/share/doc/refdb/refdb-manual/re29.html is in refdb-doc 1.0.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 | <?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>rtfcitations</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.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="re28.html" title="refdb-ms" /><link rel="next" href="pt05.html" title="Part V. Programmer's manual" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">rtfcitations</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re28.html">Prev</a> </td><th width="60%" align="center">Chapter 15. Tools for bibliographies</th><td width="20%" align="right"> <a accesskey="n" href="pt05.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="refentry-rtfcitations"></a><div class="titlepage"></div><div class="refnamediv"><a id="rtfcitations-name"></a><h2>Name</h2><p>rtfcitations — Extracts RefDB citations from a text file and writes them into an XML file using the citationlistx.dtd.</p></div><div class="refsynopsisdiv"><a id="rtfcitations-synopsis"></a><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">rtfcitations</code> [<code class="option">-h</code> ]</p></div></div><div class="refsect1"><a id="rtfcitations-description"></a><h2>Description</h2><p>rtfcitations reads a plain text document (such as the word processor format RTF, hence its name) from stdin and scans it for particular character sequences which denote RefDB citations. The citations are converted to an XML document following the citationlistx.dtd and sent to stdout. The input document may be any structured or non-structured text which sticks to the following conventions:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">Simple citations</span></dt><dd><p>Enclose the RefDB citation key in double square brackets, as in "[[Miller1999]]".</p></dd><dt><span class="term">Multi-head citations</span></dt><dd><p>Enclose each RefDB citation key in square brackets, and surround the entire multi-head citation with another pair of square brackets, as in "[[Miller1999][Doe2001]]".</p></dd></dl></div><p>The resulting XML file can be fed to <a class="link" href="re20.html" title="refdbib">refdbib</a> to generate a bibliography file containing the cited works.</p></div><div class="refsect1"><a id="rtfcitations-options"></a><h2>Options</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code></span></dt><dd><p>Prints a command synopsis on the screen and exits.</p></dd></dl></div></div><div class="refsect1"><a id="rtfcitations-example"></a><h2>Example</h2><p>The following command extracts all citations from foo.rtf and writes them to foo.id.xml:</p><pre class="screen">
<code class="prompt">~$ </code>
<strong class="userinput"><code>rtfcitations < foo.rtf > foo.id.xml</code></strong>
</pre></div><div class="refsect1"><a id="rtfcitations-see_also"></a><h2>See also</h2><p><span class="emphasis"><em>RefDB</em></span> (7),
<span class="emphasis"><em><a class="link" href="re20.html" title="refdbib">refdbib</a></em></span> (1).</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="rtfcitations-author"></a><h2>Author</h2><p>rtfcitations 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="re28.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="pt05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">refdb-ms </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Part V. Programmer's manual</td></tr></table></div></body></html>
|