/usr/share/doc/refdb/refdb-manual/ch07s02.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>The Emacs helpers</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="ch07.html" title="Chapter 7. Data input" /><link rel="prev" href="ch07.html" title="Chapter 7. Data input" /><link rel="next" href="ch07s03.html" title="Input filters" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The Emacs helpers</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Data input</th><td width="20%" align="right"> <a accesskey="n" href="ch07s03.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp67947648"></a>The Emacs helpers</h2></div></div></div><p>If your editor of choice should be Emacs or XEmacs, the separately available <a class="ulink" href="http://refdb.sourceforge.net/emacs.html" target="_top">refdb-elisp</a> package will come in handy. Please see the installation instructions contained in the source archive. The package consists of a major mode (ris-mode) to edit RIS datasets, and a minor mode (refdb-mode) which provides a general front-end to RefDB. refdb-mode is too powerful to be discussed here in a few lines, please see the separately available <a class="ulink" href="http://refdb.sourceforge.net/doc/elisp/index.html" target="_top">manual</a>. The ris major mode can do the following things for you:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Font-locking will help you to spot syntax errors in the tags. Especially the end tag (ER - ) is prone to lack the trailing space if you're not careful. The ris-mode displays regular tags in blue and the special type (TY - ) and end (ER - ) tags in red. Tags will be displayed in the default foreground color if anything is wrong with them, like invalid specifiers, lowercase specifiers, missing or additional spaces.</p></li><li class="listitem"><p>ris-mode provides three commands to insert datasets ("references") and individual tags as described shortly. All of these commands have in common that they always start a new line after the current line if the cursor is not at the start of a line. Thus you can run these commands from any position of the current line and still get something that makes sense as a RIS dataset.</p></li><li class="listitem"><p>Run the command <span class="command"><strong>insert-set</strong></span> (<span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>c</strong></span> <span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>s</strong></span>) to insert a new skeleton dataset (a "reference"). The function will prompt you to enter the publication type. You can use either the auto-completion feature of the minibuffer to enter a valid type or the history feature to select a previously entered type. The function will create a newline, a type tag with the type you selected, and an end tag.</p></li><li class="listitem"><p>You can insert a new tag at the beginning of a line with the command <span class="command"><strong>insert-tag</strong></span> which is bound to <span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>c</strong></span> <span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>t</strong></span>. Use either the auto-completion feature of the minibuffer to enter a valid tag or the history feature to select a previously entered tag.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Once you have created an empty tag, you can use commands provided by the refdb-mode to enter values from existing entries in the database. This is convenient to avoid spelling errors in author names, or to select keywords which are already used by other references. These commands use minibuffer completion for added convenience.</p></div></li><li class="listitem"><p>You can insert a new line below the current line with the same tag as the current line with the command <span class="command"><strong>duplicate-tag</strong></span>. This is bound to <span class="keycap"><strong>M</strong></span>+<span class="keycap"><strong>RET</strong></span>. This command is convenient if you add multiple keywords or authors, each of which have to go on separate tag lines.</p></li><li class="listitem"><p>You can move between RIS datasets with the commands <span class="command"><strong>backward-set</strong></span> (<span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>x[</strong></span>) and <span class="command"><strong>forward-set</strong></span> (<span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>x]</strong></span>). You can narrow the buffer to the current RIS set with the command <span class="command"><strong>narrow-to-set</strong></span> (<span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>xns</strong></span>). To widen to the full buffer contents again use <span class="keycap"><strong>C</strong></span>+<span class="keycap"><strong>xnw</strong></span>as usual.</p></li></ul></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>ris-mode does not attempt to <span class="emphasis"><em>validate</em></span> the buffer contents. You can create invalid tags, leave out the essential type or end tags, forget about the newline preceeding each dataset and ris-mode will not complain. However, you can spot most errors by looking at the font colors: If the first and the last line of a dataset are not displayed in red, you have a problem (you might be using a monochrome display but that's not what I mean). If any tag (except TY and ER) is displayed in the default foreground color (usually black on X displays), you have a problem as well.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch07.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch07s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Data input </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Input filters</td></tr></table></div></body></html>
|