.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.12.
.TH LILYPOND-BOOK "1" "August 2020" "lilypond-book 2.18.2" "User Commands"
.SH NAME
lilypond-book \- manual page for lilypond-book 2.18.2
.SH SYNOPSIS
.B lilypond-book
[\fIOPTION\fR]... \fIFILE\fR
.SH DESCRIPTION
Process LilyPond snippets in hybrid HTML, LaTeX, texinfo or DocBook document.
.SH OPTIONS
.TP
\fB\-F\fR, \fB\-\-filter\fR=\fIFILTER\fR
pipe snippets through FILTER [default: `convert\-ly \fB\-n\fR
\-']
.TP
\fB\-f\fR, \fB\-\-format\fR=\fIFORMAT\fR
use output format FORMAT (texi [default], texi\-html,
latex, html, docbook)
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help and exit
.TP
\fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR
add DIR to include path
.TP
\fB\-\-info\-images\-dir\fR=\fIDIR\fR
format Texinfo output so that Info will look for
images of music in DIR
.TP
\fB\-\-left\-padding\fR=\fIPAD\fR
pad left side of music to align music inspite of
uneven bar numbers (in mm)
.TP
\fB\-\-lily\-loglevel\fR=\fILOGLEVEL\fR
Print lilypond log messages according to LOGLEVEL
.TP
\fB\-\-lily\-output\-dir\fR=\fIDIR\fR
write lily\-XXX files to DIR, link into \fB\-\-output\fR dir
.TP
\fB\-\-load\-custom\-package\fR=\fIPACKAGE\fR
Load the additional python PACKAGE (containing e.g. a
custom output format)
.TP
\fB\-l\fR, \fB\-\-loglevel\fR=\fILOGLEVEL\fR
Print log messages according to LOGLEVEL (NONE, ERROR,
WARNING, PROGRESS (default), DEBUG)
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIDIR\fR
write output to DIR
.TP
\fB\-P\fR, \fB\-\-process\fR=\fICOMMAND\fR
process ly_files using COMMAND FILE...
.TP
\fB\-\-redirect\-lilypond\-output\fR
Redirect the lilypond output
.TP
\fB\-s\fR, \fB\-\-safe\fR
Compile snippets in safe mode
.TP
\fB\-\-skip\-lily\-check\fR
do not fail if no lilypond output is found
.TP
\fB\-\-skip\-png\-check\fR
do not fail if no PNG images are found for EPS files
.TP
\fB\-\-use\-source\-file\-names\fR
write snippet output files with the same base name as
their source file
.TP
\fB\-V\fR, \fB\-\-verbose\fR
be verbose
.TP
\fB\-\-version\fR
show version number and exit
.TP
\fB\-w\fR, \fB\-\-warranty\fR
show warranty and copyright
.SS "Options only for the latex and texinfo backends:"
.TP
\fB\-\-latex\-program\fR=\fIPROG\fR
run executable PROG instead of latex, or in case \fB\-\-pdf\fR
option is set instead of pdflatex
.TP
\fB\-\-texinfo\-program\fR=\fIPROG\fR
run executable PROG instead of texi2pdf
.TP
\fB\-\-pdf\fR
create PDF files for use with PDFTeX
.SH EXAMPLES
.IP
\f(CW$ lilypond-book --filter="tr '[a-z]' '[A-Z]'" BOOK\fR
.br
\f(CW$ lilypond-book -F "convert-ly --no-version --from=2.0.0 -" BOOK\fR
.br
\f(CW$ lilypond-book --process='lilypond -I include' BOOK\fR
.SH "REPORTING BUGS"
Report bugs via  http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs
.SH "SEE ALSO"
The full documentation for
.B lilypond-book
is maintained as a Texinfo manual.  If the
.B info
and
.B lilypond-book
programs are properly installed at your site, the command
.IP
.B info lilypond-book
.PP
should give you access to the complete manual.