Help pages of sortref

            sortref-2.3.6


SYNTAX: sortref [-options] 'tex-file' ['ref-file']

USAGE:
[In the following, replace 'tex-file' by the name of your main LaTeX-file]
(1) Put all your \bibitem{} entries to a separate file which you may give
    any name. In the following we will refer to it as 'ref-file'.
(2) Include the following lines in your 'tex-file':
    \begin{thebibliography}{99}
    \input{'tex-file'_ref}
    \end{thebibliography}
(3) Make sure that the file 'tex-file'.aux exists.
    If it doesn't, run LaTeX over your 'tex-file' once.
(4) Call   
         sortref 'tex-file' 'ref-file'
(5) Run LaTeX twice. That's it.


OPTIONS:

-h : help -- display these help pages.

-q : quiet mode -- do not print warnings.

-v : verbose mode -- do not overwrite existing ref-file without confirmation.

-m : missing references -- show missing references in ref-file.tex.

-s : superfluous references -- show superfluous references in ref-file.tex.


DESCRIPTION: finds the references (\cite{...}) in the aux-files
and writes the corresponding entries from 'ref-file.tex' (\bibitem{...}) to
'tex-file_ref.tex' in their order of appearence in 'tex-file.aux'
(removing duplicates).


TIP: it is useful to have a global bibliography file where you collect all
your favorite references. Put the name (and path) of this file into the 
variable @biblist (you have to edit 'sortref') to make this the default.
Starting from version 2.3.6, you may also have several of those files, and
'sortref' will collect the references from all of them.


WARNINGS: 
- Sorting may fail when references occur in floating environments
  (e.g. figure captions)! Check such references by hand!
- only those references which are really cited will be written to 
    'tex-file'_ref.tex.