Documentation

1 files changed, 62 insertions, 0 deletions

diff --git a/man/bib-util.1 b/man/bib-util.1
new file mode 100644
index 0000000..57b4572
--- /dev/null
+++ b/man/bib-util.1
@@ -0,0 +1,62 @@
+.TH BIB-UTIL 1 "June 2026" "bibutils" "User Commands"
+.SH NAME
+bib-util \- wrapper for the bibutils bibtex tools
+.SH SYNOPSIS
+.B bib-util
+.I command
+.RI [ args " ...]"
+.SH DESCRIPTION
+.B bib-util
+dispatches to the individual bibutils scripts, so that the whole suite
+can be driven through a single entry point.
+The
+.I command
+is one of the following; all remaining arguments are passed through
+unchanged.
+.TP
+.B add
+insert entries into a database; see
+.BR bib-add (1)
+.TP
+.B check
+lint a database; see
+.BR bib-check (1)
+.TP
+.B convert
+convert between bibtex and refer formats; see
+.BR bib-convert (1)
+.TP
+.B extract
+filter a database down to the entries cited in a document; see
+.BR bib-extract (1)
+.TP
+.B fetch
+fetch an entry for a pdf by DOI or arXiv id; see
+.BR bib-fetch (1)
+.TP
+.B gen
+generate an entry from user input; see
+.BR bib-gen (1)
+.TP
+.B key
+generate citation keys for entries; see
+.BR bib-key (1)
+.TP
+.B ls
+list the entries in a database; see
+.BR bib-ls (1)
+.SH EXIT STATUS
+That of the dispatched command, or 2 if the command is unknown.
+.SH EXAMPLES
+.nf
+bib-util fetch paper.pdf | bib-util add refs.bib
+.fi
+.SH SEE ALSO
+.BR bib-add (1),
+.BR bib-check (1),
+.BR bib-convert (1),
+.BR bib-extract (1),
+.BR bib-fetch (1),
+.BR bib-gen (1),
+.BR bib-key (1),
+.BR bib-ls (1)