.\" 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.