doc/latex

git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 131 insertions, 0 deletions

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
+
diff --git a/Master/texmf-dist/doc/latex/biblist/biblist.gde b/Master/texmf-dist/doc/latex/biblist/biblist.gde
new file mode 100644
index 00000000000..844fa2d1861
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblist/biblist.gde
@@ -0,0 +1,45 @@
+% $Id: biblist.gde,v 1.1 1991/10/14 14:09:50 schrod Exp schrod $
+%----------------------------------------------------------------------
+
+%
+% $Log: biblist.gde,v $
+% Revision 1.1  1991/10/14  14:09:50  schrod
+% Initial revision
+%
+
+
+
+\subsubsection{The {\tt biblist\/} Style Option}
+\label{sty:biblist}
+
+The |biblist| 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 Big\TeX{} 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. (There is a default bibliography style named |biblist|,
+see~\ref{bst:biblist}.) 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 {\it 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.
+
+
+
+
+\endinput