/usr/share/doc/refdb/refdb-manual/ch19s03.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>Tips and tricks</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="ch19.html" title="Chapter 19. Using RefDB in your programs" /><link rel="prev" href="ch19s02.html" title="Interfaces" /><link rel="next" href="ch20.html" title="Chapter 20. The Perl client module" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Tips and tricks</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch19s02.html">Prev</a> </td><th width="60%" align="center">Chapter 19. Using RefDB in your programs</th><td width="20%" align="right"> <a accesskey="n" href="ch20.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp65975344"></a>Tips and tricks</h2></div></div></div><p>This is currently a ragbag of things to consider. It will hopefully be more structured at a later time.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp65976608"></a>Paging output</h3></div></div></div><p>If you run commands like <a class="link" href="re11.html#app-c-command-getref" title="getref">getref</a> that are likely to return more information than fits on a screen, you can either try to parse the result in your program and then display it chunk-wise. You may have to parse the data anyway for a different reason, so this option may come at no extra cost. However, if you just want to display the data, you can also use the server-side paging which is implemented in all "get*" commands. These commands take an optional limit argument. The general format is <em class="replaceable"><code>limit[:offset]</code></em>. <em class="replaceable"><code>limit</code></em> is the number of datasets to display, and the optional <em class="replaceable"><code>offset</code></em> is the number of references to skip at the beginning. That is, asking refdbd to limit the result set to 5:10 will cause it to ignore the first 10 datasets and send datasets 11 through 15. You can use this in a loop to retrieve the datasets in groups of 5 until no more datasets are available. Server-side paging is preferable in all cases where a query may return lots of data, as you don't have to buffer them locally.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch19s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch19.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch20.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Interfaces </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 20. The Perl client module</td></tr></table></div></body></html>
|