/usr/share/doc/refdb/refdb-manual/ch19.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 | <?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>Chapter 19. Using RefDB in your programs</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="pt05.html" title="Part V. Programmer's manual" /><link rel="prev" href="ch18s02.html" title="The risx DTD" /><link rel="next" href="ch19s02.html" title="Interfaces" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 19. Using RefDB in your programs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch18s02.html">Prev</a> </td><th width="60%" align="center">Part V. Programmer's manual</th><td width="20%" align="right"> <a accesskey="n" href="ch19s02.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="chapter-programming"></a>Chapter 19. Using RefDB in your programs</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="ch19.html#idp71413184">General thoughts</a></span></dt><dt><span class="sect1"><a href="ch19s02.html">Interfaces</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch19s02.html#idp68257184">Call the C clients from your program</a></span></dt><dt><span class="sect2"><a href="ch19s02.html#idp69931680">Directly talk to refdbd</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch19s03.html">Tips and tricks</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch19s03.html#idp68498400">Paging output</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp71413184"></a>General thoughts</h2></div></div></div><p>RefDB provides command-line clients to access the application server refdbd. This makes it easy to automate tasks through shell scripts or Makefiles. RefDB uses both possibilities for its own purposes. The prime example for a shell script is <a class="link" href="re22.html" title="runbib">runbib</a>, which transform your XML documents by invoking, among others, the RefDB bibliography client. Makefiles are more appropriate in other contexts. The Makefile created by <a class="link" href="re21.html" title="refdbnd">refdbnd</a> is just one example.</p><p>However, if you want more than that, you'll want to access refdbd from your own programs. Need RefDB support for your favourite editor? It is doable, as you can see from the RefDB integration in <a class="ulink" href="http://refdb.sourceforge.net/emacs.html" target="_top">Emacs</a> and in <a class="ulink" href="http://refdb.sourceforge.net/vim.html" target="_top">Vim</a>. Want to access RefDB through the web? There is a PHP implementation of a web front-end in the RefDB sources with plenty of room for improvements, and there is also a SRU interface. Want to have a pointy-clicky frontend so you'll no longer have to envy the Mac and Windoze users of EndNote? Well, this is a challenge that no one has tried yet. Before you fire up your favourite IDE and start coding, please consider the following:</p><p><strong>Do not even think about fiddling with the SQL database! </strong>Most languages offer a simple way to access SQL databases, and the database engines often provide client libraries for a variety of languages. However, RefDB is more than just a thin layer on top of a SQL database. RefDB normalizes data. RefDB takes data apart and reassembles them when needed. RefDB takes care of character encoding conversions. Even worse, the SQL table schemas may change from one RefDB version to the next. Therefore you should never attempt to access RefDB data from your own programs on the SQL level. Instead, you should rely on the interfaces that RefDB offers.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch18s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch19s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The risx DTD </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Interfaces</td></tr></table></div></body></html>
|