1 files changed, 47 insertions, 0 deletions
diff --git a/biblio/bibtex/utils/lookbibtex/bibdestringify.1 b/biblio/bibtex/utils/lookbibtex/bibdestringify.1
new file mode 100644
index 0000000000..daf8413dae
--- /dev/null
+++ b/biblio/bibtex/utils/lookbibtex/bibdestringify.1
@@ -0,0 +1,47 @@
+.\" bibdestringify.1
+.TH BIBDESTRINGIFY 1 "26 August 1991"
+
+.SH NAME
+bibdestringify \- replace string substitutions in a bibtex database
+
+.SH SYNOPSIS
+.B bibdestringify
+
+.SH DESCRIPTION
+bibdestringify reads a bibtex file from standard input.
+It produces the same file, but with all string substitutions
+(@string{foo = "bar"}) replaced in the text.
+
+For example, to tell your friend about your favorite new
+breakfast cereal, you might use the command:
+.IP
+.B
+lookbibtex -s kellogg | bibdestringify | mail lk
+.LP
+Lookbibtex -s passes string defintions through;
+"kellogg" is the search regular expression.
+bibdestringify expands these definitons, so that when
+Leonard (lk) gets your mail,
+there will be no references to unknown strings.
+
+.SH AUTHOR
+John Heidemann <johnh@cs.ucla.edu>
+
+.SH SEE ALSO
+.BR bibtex (1),
+.BR lookbibtex (1),
+.BR perl (1).
+
+.SH BUGS
+Like lookbibtex, 
+bibdestringify is written in Perl, so it will not run on machines
+which do not have perl installed.
+
+Although previous versions of bibdestringify (0.9) were quite
+slow, this version is reasonably fast.
+.\" Its speed is O(nm) where
+.\" n is the number of defined strings 
+.\" and m is the number of lines with potential replacement.
+
+
+