summaryrefslogtreecommitdiff
path: root/biblio/bibtex/utils/bibtool/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'biblio/bibtex/utils/bibtool/README.md')
-rw-r--r--biblio/bibtex/utils/bibtool/README.md125
1 files changed, 125 insertions, 0 deletions
diff --git a/biblio/bibtex/utils/bibtool/README.md b/biblio/bibtex/utils/bibtool/README.md
new file mode 100644
index 0000000000..c52f777fb7
--- /dev/null
+++ b/biblio/bibtex/utils/bibtool/README.md
@@ -0,0 +1,125 @@
+----------------------------------------------------------------------
+
+ ###### ############
+ ####### ############
+ ## ## ##
+ ## ## ## ##### ## #### #### ##
+ ####### ## ###### ## ###### ###### ##
+ ####### ## ## ## ## ## ## ## ## ##
+ ## ## ## ###### ## ## ## ## ## ##
+ ## ## ## ## ## ## ## ## ## ## ##
+ ## ## ## ## ## ## ## ## ## ## ##
+ ####### ## ###### ## ###### ###### #######
+ ###### ## ##### ## #### #### #######
+
+----------------------------------------------------------------------
+
+ BibTool: A Tool for Manipulating BibTeX Data Bases
+
+
+BibTeX provides an easy to use means to integrate citations and
+bibliographies into LaTeX documents. But the user is left alone with
+the management of the BibTeX files. The program BibTool is intended to
+fill this gap. BibTool allows the manipulation of BibTeX files which
+goes beyond the possibilities --- and intentions --- of BibTeX. The
+possibilities of BibTool include
+
+* Pretty-printing BibTeX data bases adjustable by lots of parameters.
+
+* Syntactic checks with error recovery superior to BibTeX and helpful
+ error messages.
+
+* Semantic checks can be specified by the user.
+
+* Sorting and merging of BibTeX data bases according to a free
+ definable sort key.
+
+* Generation of uniform reference keys according to predefined rules
+ or according to an own specification.
+
+* Selecting references used in one publication which are found by
+ analyzing an .aux file.
+
+* Selecting references by a set of criteria (regular expressions).
+
+* Controlled rewriting of fields utilizing regular expressions to
+ specify the rewriting rules.
+
+* Macro (String) expansion to eliminate the need of extra string
+ definitions.
+
+* Collecting statistics about one or more BibTeX data bases.
+
+
+BibTool contains a documentation written in LaTeX of more than 80
+pages (and still growing).
+
+BibTool is written in C and has been compiled on various operating
+systems like flavors of Unix and MSDOG machines. It is distributed in
+source code. No compiled versions are available from the author
+(Useless to ask!).
+
+
+# Binary Distributions
+
+
+There exist binary distributions of BibTool for several operating
+systems. For instance users of Debian based Linux systems can access
+BibTool via their native package manager.
+
+Before installing from the sources you might want to check whether the
+package manager of your system provides a sufficiently recent version
+of BibTool.
+
+
+# CTAN Download
+
+
+BibTool can be obtained from the CTAN archives:
+
+* https://www.ctan.org/tex-archive/biblio/bibtex/utils/bibtool
+
+or via the BibTool home page
+
+* http://www.gerd-neugebauer.de/software/TeX/BibTool
+
+Get the file BibTool-x.xx.tar.gz where x.xx is the version number.
+Unpack it with the command (on Unix)
+
+ gunzip < BibTool-x.xx.tar.gz | tar -xvf -
+
+It will create a directory named BibTool which contains the
+installation instructions in the file install.tex.
+
+A signature for the source bundle is provided as well. My public key
+can be found on http://pgp.mit.edu/. You should search for my email
+address.
+
+
+# Licenses
+
+
+The sources of BibTool are distributed under the GNU General Public
+License version 2 or later.
+
+The documentation is distributed under the Creative Commons
+Attributation-Share Alike 3.0 License.
+
+The distribution of BibTool contains the following third-party
+software which is released under their own licenses:
+
+* GNU regex library 0.12 is located in the directory regex-0.12. It is
+ distributed under the GNU General Public License version 2 or later.
+
+* mkdirchain consists of the file mkdirchain. It is in the public
+ domain.
+
+* install-sh consists of the file install-sh. It is distributed under
+ the MIT license contained in this file.
+
+----------------------------------------------------------------------
+Enjoy it!
+
+Gerd Neugebauer
+mailto:gene@gerd-neugebauer.de
+