Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
REFDB-MS(1)			  RefDB Manual			     REFDB-MS(1)

NAME
     refdb-ms - a console-based style generator for RefDB

SYNOPSIS
     refdb-ms

DESCRIPTION
     refdb-ms is a console-based style generator for RefDB.

     In short, this utility consists of a loop in which you are asked to:

     *	select	an  element  from a list of elements allowed in that part of the
	style,

     *	enter or select appropriate values for mandatory attributes,

     *	select optional attributes for that element and enter their values,

     *	select an element from a list of elements ...

     This process ends when you have exhausted the DTD.

     Every time you are presented with a list of elements you have the option of
     selecting help. Doing so will present a screen with a summary of each  ele-
     ment on the list. The same thing happens when you are presented with a list
     of attributes.

     When  an  attribute or element is required by the DTD this utility will se-
     lect it automatically. For some objects you will not need to provide  input
     and  so  this  utility will create the object(s) automatically. This can be
     disconcerting at first. Please read the console feedback carefully.

     Whenever you are asked to enter or select a value for an attribute or  ele-
     ment, you are given a brief prompt explaining the purpose of the element or
     attribute.  After each element is added to the style you are presented with
     a "progress report" showing the (major) elements.	It  may  take  a  little
     while  to	understand  this  feedback. As you add elements they will be ap-
     pended to the report. When you complete a major element, such as a  PUBTYPE
     or  AUTHORLIST, however, its subsidiary elements are no longer displayed --
     they are "folded". This saves space and makes it easier to  quickly  under-
     stand  where in the style you are at that point in time. As you become more
     familiar with the structure of the style DTD this display will  become  in-
     creasingly useful.

     At  certain  times  within PUBTYPE, AUTHORONLY, YEARONLY and INTEXTDEF ele-
     ments you are able to delete the previous "major" element. "Major" elements
     are those corresponding to ris fields. These elements may contain other el-
     ements. For example, deleting an AUTHORLIST element  will	delete	all  the
     children elements of that author list style. You can view the complete ele-
     ment before deletion occurs.

     When  you	select	some  elements	(in  general, those corresponding to ris
     fields) you will be given an opportunity to copy the most recently  entered
     element  of  that	type. If you choose to copy, all attributes and sub-ele-
     ments will be copied. This can save you a lot of time if, for example, your
     author lists will always have the same formatting.

     After you have created your style this utility will save it to a disk file.
     It will also generate a brief summary of it in html  format.  This  summary
     can be of great help when entering references in your reference database.

     This  utility  will  then	offer  to upload the style to RefDB. There is no
     foreseeable way in which this operation could damage your	reference  data,
     but you use it at your own risk.

FILES
     RefDB::Makestyle

     This module is required by refdb-ms. It is available as a tar.gz archive or
     a Debian package from the RefDB website <refdb.sourceforge.net>.

SEE ALSO
     RefDB::Makestyle (3).

     RefDB  manual  (local  copy)  <prefix>/share/doc/refdb-<version>/refdb-man-
     ual/index.html

     RefDB manual (web) <[1]http://refdb.sourceforge.net/manual/index.html>

     RefDB on the web <[2]http://refdb.sourceforge.net/>

AUTHOR
     refdb-ms was written by David Nebauer <david@nebauer.org>.

     This manual page was written by David Nebauer <david@nebauer.org>	for  the
     Debian project (but may be used by others).

REFERENCES
     1. http://refdb.sourceforge.net/manual/index.html
	http://refdb.sourceforge.net/manual/index.html

     2. http://refdb.sourceforge.net/
	http://refdb.sourceforge.net/

2005-07-17			   2005-07-17			     REFDB-MS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=refdb-ms&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help