From 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:49:07 +0000 Subject: doc/latex git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/biblist/README | 86 ++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/biblist/README (limited to 'Master/texmf-dist/doc/latex/biblist/README') diff --git a/Master/texmf-dist/doc/latex/biblist/README b/Master/texmf-dist/doc/latex/biblist/README new file mode 100644 index 00000000000..7b17dc43d0e --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblist/README @@ -0,0 +1,86 @@ +% $Id: biblist.README,v 1.2 1992/01/13 16:43:03 schrod Exp schrod $ +%------------------------------------------------------------ + +There is an often asked question: `How can I print a listing with all +entries of a BibTeX database?'. The common answer is: `Use +\nocite{*}.' + +Well, but this will not work for large BibTeX databases unless you +use BigTeX. This is because for each entry a TeX macro is declared +and TeX's pool size capacity (where macro names are stored) will be +exceeded soon. + + +This style option is appropriate to create a typeset listing of a +(possibly large) BibTeX input file. With such large files -- +especially, if the cite keys are long -- the needed string space is +often exceeded. Often a BigTeX is available to circumstance this +problem, but with this style option each TeX will do it. + +You have to prepare a LaTeX document which uses the |article| +style and the biblist style option. You may add almost all other +style options, as you wish, e.g., twoside, german (or other +language style options), a4, etc. This style option must be used +with a ragged bottom; this has the effect, that it cannot be used with +twocolumn or multicol. + +You must issue a \bibliography tag which names all BibTeX +databases which you want to print. You may issue a +\bibliographystyle tag to specify how BibTeX will process its +databases. (In fact, you usually must issue it since the default +bibliography style is not available on most installations; see +below.) You may issue \nocite commands if you want to print only +selected entries from the databases. + + +A ``bug'' you may encounter is that \cite tags within +BibTeX entries will not be processed. Instead the cite key itself +will be printed. Note that this is not a bug, this is a feature! You +have to use \nocite tags for *all* entries that shall be +included in the listing. If you do not give any \nocite tag at all, +a listing with all entries is created. + +Note that this style option assumes that you use either LaTeX~2.09 +released after December 1991, ILaTeX, or the babel system. +Particulary, it requires the definition of \refname which is supplied +by these systems. (Of course, you may supply this definition by +yourself.) + + +The entries in the resulting listing are formatted as follows: + +\tt cite key ................................... \sf (Library info) + Author(s). +Title. +Publication info. +Notes. + \footnotesize Annotation + +I.e., an open format is used. Although this needs more space I think +the enhanced legibility pays back. + +Note that you will not get the `Library info' and the `Annotation' in +the above format if your bibliography style does not supply this +information with the assumed markup. The parenthesis around the library +info are produced by this style option, not by BibTeX. + + +Enjoy. btw, this style is supported since I use it myself :-) + +-- +Joachim + +=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= +Joachim Schrod Email: schrod@iti.informatik.th-darmstadt.de +Computer Science Department +Technical University of Darmstadt, Germany + + +$Log: biblist.README,v $ +Revision 1.2 1992/01/13 16:43:03 schrod + Updated documentation, adapted to LaTeX version of Dec 91. + New biblist.bst-dist (itibst.doc version 1.3). + +Revision 1.1 1991/10/14 13:54:15 schrod +Initial revision + -- cgit v1.2.3