Directory biblio/bibtex/contrib/abstyles

								-*-Text-*-
This is the BibTeX `adaptable' family of style files, version 1.10 as of
April 1992, derived from the `plain' family by Hans-Hermann Bode. It allows
setting of certain style parameters and definition of phrases without
changing the style files, thus a multiple-language support is provided and
the user may adapt the bibliography layout to his or her requirements within
some limits.

Send suggestions and bug reports to HHBODE@DOSUNI1.BITNET.

This directory contains the following files:

./README	this file
./btxabst.doc	master file for creating the bst files
./aplain.bst	adaptable style, `plain' version
./aabbrv.bst	adaptable style, `abbreviated' version
./aunsrt.bst	adaptable style, `unsorted' version
./aalpha.bst	adaptable style, `alphanumeric' version
./anotit.bst	adaptable style, `no titles' version
./aunsnot.bst	adaptable style, `unsorted/no titles' version
./apreambl.doc	preamble file, documentation
./apreambl.tex	preamble file, to be input at the beginning of the bibliography
./jourabbr.bib	journal names, abbreviated version
./jourfull.bib	journal names, full version
./acompat.bib	compatibility definitions for use with standard styles
./abstdok.tex	documentation of the adaptable family (in German)
./abstdok.bbl	bibliography for abstdok
./a4c.sty	definition of length parameters for DIN-A4 paper, LaTeX version
./a4c.tex	definition of length parameters for DIN-A4 paper, WEB version
./docmac.doc	documentation of documentation macros (indeed!)
./docmac.tex	documentation macros

*** Installation -------------------------------------------------------------

To get a working adaptable-styles system you have to copy the following
files into special directories.

-- Copy all *.bst files into a directory where BibTeX looks for style files.
This will usually be a directory in the TEXINPUT(S) path, i.e., in the same
path where TeX looks for its input files.

-- Copy apreambl.tex into a directory where TeX looks for its input files,
see above.

-- Copy all *.bib files into a directory where BibTeX looks for bibliography
databases. This will usually be a directory in the BIBINPUT(S) path.

Optionally, you may copy a4c.* and docmac.tex into a directory in the
TEXINPUT(S) path. These files will be needed when printing the
documentation; they may be useful, however, for other applications as well.

*** Printing the documentation -----------------------------------------------

The main documentation is a LaTeX source in abstdok.tex. Run LaTeX on this
file twice (for resolving cross references) and make sure that apreambl.tex,
abstdok.bbl, and a4c.sty can be loaded. In addition, the file german.sty is
required; it is not included in this distribution, since you should be able
to get it from every good TeX server (at least in Germany). The style file
a4c.sty will set up length parameters so that the document will come out
centered with margins of 2 cm on each side of a DIN-A4 sheet; if this
doesn't fit to your paper format, you may want to edit this file first.
Unfortunately, this documentation is written in German (which is due to the
fact that European people sometimes get nostalgic and switch to their native
language); if you feel the need to translate this into English, don't
hesitate to do so (and send me the file, so I can include it into the next
distribution).

The definition of the adaptable parameters is discussed in apreambl.doc (in
English, yes). Run this through TeX (not LaTeX, and don't forget the .doc
extension!) and make sure that a4c.tex and docmac.tex can be loaded. The
file a4c.tex corresponds to a4c.sty above, and docmac.tex contains macros
for typesetting a WEB-style documentation. In fact, apreambl.tex is derived
from apreambl.doc by means of Joachim Schrod's MAKEPROG system, which is a
general documentation tool much similar to the WEB system of structured
documentation; docmac.tex is an enhancement of MAKEPROG's macro package
progdoc.tex which makes the documentation layout more ``WEB-like''. If you
want to change some of the adaptable parameters, the best way to do it is to
get MAKEPROG (it should be available from the same source as the adaptable
style files) and write a changefile to apreambl.doc. Then there is a good
chance that you can apply your changes to future versions of this
distribution without major modifications. Moreover, you can use MAKEPROG and
docmac.tex for your own developments, it's worth a try! (In this case you may
want to look at docmac's documentation: just run TeX on docmac.doc and make
sure that docmac.tex is loadable.)

Further documentation is provided in plain-text form in the files
jourabbr.bib, jourfull.bib, and acompat.bib. You may want to edit the first
two of them to add more journal names or other general stuff that should be
defined at the beginning of your bibliographies.

*** Usage hints (VERY brief) -------------------------------------------------

It is assumed that you are familiar with the BibTeX philosophy and the
standard style files, so here is a short description what you have to do in
addition to use the adaptable styles.

Choose one of the styles aplain, aabbrv, aunsrt, aalpha, anotit, or aunsnot
(the first four are the adaptable versions of the corresponding standard
styles, anotit is like aabbrv but omits titles of articles and some other
redundant information, aunsnot is like anotit but doesn't sort the
bibliography) and put a statement like

  \bibliographystyle{aplain}

somewhere into your document.

Make sure that apreambl.tex is input before the \bibliography command is
executed. The easiest way to do so is to include jourfull or jourabbr at the
beginning of your \bibliography list. The file apreambl.tex carries out all
parameter settings and switches between `full' and `abbreviated' as well as
English and German versions of phrases automatically. The version it selects
depends on the bibliography style and on the fact whether german.sty is
loaded or not. The databases jourfull.bib and jourabbr.bib will load
apreambl.tex and, furthermore, will define all strings that are lacking in
the adaptable styles in comparison with the standard styles; hence, with
this files you can use your old databases without changes, and---as
mentioned above---this is the right place to add your own general
definitions. So, a typical \bibliography command should look like

  \bibliography{jourfull,user1,user2,user3}

where user1, user2, and user3 are your private bibliography databases.

If you ever feel the need to use one of the standard styles again, your
databases---due to the use of special features of the adaptable styles---may
not be compatible any more. The compatibility can be restored by means of
acompat.bib, which defines all additional strings of the adaptable styles
and should be included at the very beginning of the \bibliography list, e.g.,

  \bibliography{acompat,jourfull,user1,user2,user3}\bibliographystyle{plain}

Of course, acompat is not required for use with the adaptable styles alone.

*** Correction ---------------------------------------------------------------

In parts of the documentation, the files apreambl.doc and apreambl.tex are
referred to as apreamble.doc and apreamble.tex. The names were shortened to
avoid difficulties with some operating systems with low-length file names.

									--H2B