/usr/share/doc/refdb/refdb-manual/ch02s03.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>Perl modules</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="ch02.html" title="Chapter 2. System requirements" /><link rel="prev" href="ch02s02.html" title="Libraries necessary to build and run refdb" /><link rel="next" href="ch02s04.html" title="External applications" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Perl modules</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><th width="60%" align="center">Chapter 2. System requirements</th><td width="20%" align="right"> <a accesskey="n" href="ch02s04.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp66186688"></a>Perl modules</h2></div></div></div><p>Some import filters and the SRU servers are implemented as Perl scripts or Perl modules. These require a couple of external Perl modules in order to run properly. Some of the modules are available at <a class="ulink" href="http://www.cpan.org" target="_top">CPAN</a>, the comprehensive Perl archive network, which allows you to search and download the modules by name. The refdb-specific modules are available as the refdb-perlmod and the refdb-perlsru packages on the <a class="ulink" href="http://sourceforge.net/projects/refdb" target="_top">refdb project page</a>.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>If you're not familiar with Perl modules, here's how almost all of them can be installed: After unpacking the archive, change into the top-level directory of the extracted module. First run <span class="command"><strong>perl Makefile.PL</strong></span> which will create a system-specific <code class="filename">Makefile</code>. Then run <span class="command"><strong>make</strong></span>, optionally followed by <span class="command"><strong>make test</strong></span> to check the functionality. Finally, run <span class="command"><strong>make install</strong></span> as root.</p></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">marc2ris</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>MARC::Record (CPAN)</p></li><li class="listitem"><p>MARC::Charset (CPAN)</p></li><li class="listitem"><p>refdb-perlmod</p></li></ul></div></dd><dt><span class="term">med2ris</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>XML::Parser (CPAN)</p></li><li class="listitem"><p>Text::Iconv (CPAN)</p></li><li class="listitem"><p>refdb-perlmod</p></li></ul></div></dd><dt><span class="term">en2ris</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Text::Iconv (CPAN)</p></li><li class="listitem"><p>refdb-perlmod</p></li></ul></div></dd><dt><span class="term">refdbsru</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>CQL (CPAN)</p></li><li class="listitem"><p>CGI (CPAN)</p></li><li class="listitem"><p>XML::Writer (CPAN)</p></li><li class="listitem"><p>refdb-perlsru</p></li><li class="listitem"><p>refdb-perlmod</p></li></ul></div></dd><dt><span class="term">refdb-sruserver</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>CQL (CPAN)</p></li><li class="listitem"><p>CGI (CPAN)</p></li><li class="listitem"><p>XML::Writer (CPAN)</p></li><li class="listitem"><p>HTTP::Server::Simple (CPAN)</p></li><li class="listitem"><p>refdb-perlsru</p></li><li class="listitem"><p>refdb-perlmod</p></li></ul></div></dd></dl></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The <span class="command"><strong>configure</strong></span> script tests for the existence of the required Perl modules. If your system lacks some of the required scripts, you'll get a warning, but you'll still be able to make and make install refdb. You can install the modules at a later time without rebuilding refdb. In any case, the missing modules will only affect the Perl import filters, but not the core functionality of refdb. That is, if you don't require the Perl scripts, you don't have to install the modules either.</p></div><p>refdb also provides some support for Perl programmers. The RefDBClient module, also available at the <a class="ulink" href="http://sourceforge.net/projects/refdb" target="_top">refdb project page</a>, implements Perl classes to directly communicate with refdbd. This allows to write custom clients that access the refdb databases and use the whole functionality implemented in refdbd. The <code class="filename">test.pl</code> script shipped with the module gives a basic idea how to write a custom client. See also the <a class="link" href="ch20.html" title="Chapter 20. The Perl client module">chapter</a> about this module in the programmer's manual.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Libraries necessary to build and run refdb </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> External applications</td></tr></table></div></body></html>
|