/usr/share/doc/refdb/refdb-manual/ch08s06.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>Managing personal reference lists</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="ch08.html" title="Chapter 8. Reference management" /><link rel="prev" href="ch08s05.html" title="Print references" /><link rel="next" href="ch08s07.html" title="Global edit references" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Managing personal reference lists</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch08s05.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Reference management</th><td width="20%" align="right"> <a accesskey="n" href="ch08s07.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp65627664"></a>Managing personal reference lists</h2></div></div></div><p>Personal reference lists mainly serve two purposes:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>If you share your reference database with other users, your default personal reference list records which datasets you've added. Coincidentally, the name of this list is identical to your database username.</p></li><li class="listitem"><p>In addition to your default list, you can maintain as many additional lists as you see fit. Use these lists to select references for particular purposes, e.g. when preparing a presentation or if you need to keep track of papers that you still have to read.</p></li></ul></div><p>So personal reference list are essentially a tool to have your own personal information for a dataset and to create personal, selective views of the database.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp65632160"></a>Creating and deleting personal reference lists</h3></div></div></div><p>Actually there are no commands to create or delete personal reference lists. These lists are created automatically as soon as you add references to them. Now the question is, how does a reference get into your personal reference list? There are three ways to accomplish this:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>If you add a new reference to the database with the <a class="link" href="re11.html#app-c-command-addref" title="addref"><span class="command"><strong>addref</strong></span> command</a>, the reference will be automatically added to your default personal reference list.</p></li><li class="listitem"><p>Add an existing reference to your personal reference list with the <a class="link" href="re11.html#app-c-command-pickref" title="pickref"><span class="command"><strong>pickref</strong></span> command</a>. This command will not add personal data to the reference. To add a reference to a list other than your default list, use the <code class="option">-b <em class="replaceable"><code>listname</code></em></code> switch.</p></li><li class="listitem"><p>If you use the <a class="link" href="re11.html#app-c-command-updateref" title="updateref"><span class="command"><strong>updateref</strong></span> command</a> to modify the information in an existing reference, this reference will also appear in your default personal reference list. If you use the <code class="option">-P</code> switch with this command, the data of this reference common to all users will remain untouched, but your personal information (reprint status, availability, notes) will be added.</p></li></ol></div><p>Remember that one user can act on behalf of a different user with the <code class="option">-U</code> switch, that commands like <a class="link" href="re11.html#app-c-command-addref" title="addref"><span class="command"><strong>addref</strong></span></a> support.</p><p>Of course there are also ways to get rid of the references that you once found useful. If you share the database with other users, the first choice should always be the <a class="link" href="re11.html#app-c-command-dumpref" title="dumpref"><span class="command"><strong>dumpref</strong></span> command</a>. This just removes your personal information and your association with the reference, while it leaves the common information untouched for other users of the database. Only if you know that no one else is interested in a reference, you should think about using the <a class="link" href="re11.html#app-c-command-deleteref" title="deleteref"><span class="command"><strong>deleteref</strong></span> command</a>. In both cases personal reference lists will be automatically removed if they are empty.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp65648624"></a>Accessing references in personal reference lists</h3></div></div></div><p>You can limit your database search with the <code class="option">-b <em class="replaceable"><code>listname</code></em></code> switch of the <a class="link" href="re11.html#app-c-command-getref" title="getref">getref</a> command to those references that you added to that particular personal reference list. If you want to access references in your default list, you have to pass your username as an argument to the <code class="option">-b</code> switch.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp65652112"></a>Advanced use of personal reference lists</h3></div></div></div><p>The <a class="link" href="re11.html#app-c-command-pickref" title="pickref">pickref</a> and <a class="link" href="re11.html#app-c-command-dumpref" title="dumpref">dumpref</a> commands mentioned above are actually only simplified interfaces to the <a class="link" href="ch09.html" title="Chapter 9. Notes management">extended notes</a> feature. Each personal reference list corresponds to one extended note with these particular features:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>The note is initially almost empty. Only the title, the username and the key are set.</p></li><li class="listitem"><p>The title and the key are initially identical and have the format <username>-<listname>. The username prefix is used to create a separate namespace for each user.</p></li></ul></div><p>However, you can treat these notes just like any other note. In particular, you can retrieve the note with the <a class="link" href="re11.html#app-c-command-getnote" title="getnote">getnote</a> command, edit it by entering a description as the contents or a couple of keywords, and finally update it with the <a class="link" href="re11.html#app-c-command-updatenote" title="updatenote">updatenote</a> command. Just keep in mind that this information will be lost if you remove all references from this list, as this will cause the note representing the list to be purged automatically.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch08s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch08.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch08s07.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Print references </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Global edit references</td></tr></table></div></body></html>
|