summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man1/lilypond-book.1
blob: dcc65cd5d909a8d36cc55ff2ea54717b68ff64d9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH LILYPOND-BOOK "1" "January 2024" "lilypond-book 2.24.3" "User Commands"
.SH NAME
lilypond-book \- manual page for lilypond-book 2.24.3
.SH SYNOPSIS
.B lilypond-book
[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR
.SH DESCRIPTION
Process LilyPond snippets in hybrid HTML, LaTeX, texinfo or DocBook document.
.SH OPTIONS
.TP
\fB\-F\fR, \fB\-\-filter\fR=\fI\,FILTER\/\fR
pipe snippets through FILTER [default: `convert\-ly \fB\-n\fR
\-']
.TP
\fB\-f\fR, \fB\-\-format\fR=\fI\,FORMAT\/\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=\fI\,DIR\/\fR
add DIR to include path
.TP
\fB\-\-info\-images\-dir\fR=\fI\,DIR\/\fR
format Texinfo output so that Info will look for
images of music in DIR
.TP
\fB\-\-left\-padding\fR=\fI\,PAD\/\fR
pad left side of music to align music in spite of
uneven bar numbers (in mm) [default: 3.0]
.TP
\fB\-\-lily\-loglevel\fR=\fI\,LOGLEVEL\/\fR
print lilypond log messages according to LOGLEVEL
[default: none]
.TP
\fB\-\-lily\-output\-dir\fR=\fI\,DIR\/\fR
write lily\-XXX files to DIR, link into \fB\-\-output\fR dir
.TP
\fB\-l\fR, \fB\-\-loglevel\fR=\fI\,LOGLEVEL\/\fR
print log messages according to LOGLEVEL (NONE, ERROR,
WARNING, PROGRESS [default], DEBUG)
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,DIR\/\fR
write output to DIR
.TP
\fB\-P\fR, \fB\-\-process\fR=\fI\,COMMAND\/\fR
process ly_files using COMMAND FILE...
.TP
\fB\-\-redirect\-lilypond\-output\fR
redirect the lilypond output
.TP
\fB\-s\fR, \fB\-\-safe\fR
removed; using this option results in an error
.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=\fI\,PROG\/\fR
run executable PROG instead of latex or, in case \fB\-\-pdf\fR
option is set, instead of pdflatex
.TP
\fB\-\-texinfo\-program\fR=\fI\,PROG\/\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 bug\-lilypond@gnu.org
.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.