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 element 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 select 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 element, 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 appended 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 understand 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 increasingly useful.

       At certain times within PUBTYPE, AUTHORONLY, YEARONLY and INTEXTDEF elements you are able
       to delete the previous "major" element. "Major" elements are those corresponding to ris
       fields. These elements may contain other elements. For example, deleting an AUTHORLIST
       element will delete all the children elements of that author list style. You can view the
       complete element 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-elements 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-manual/index.html

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

       RefDB on the web <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).