Re: Issue 2112 in lilypond: documentation: precising -dpreview

[-Eluze]

lilypond-4 wrote:
> 
> Updates:
>       Status: Fixed
>       Labels: -Patch-review
> 
small typo: extension is misspelled as extensio



preview

This option is supported by all backends; pdf, png, ps, eps and svg, but not
scm and generates an output file containing the titles and the first system
of music. If \bookpart blocks are used, the titles and first system of every
\bookpart will appear in the output. 

An additional file in the form myFile.preview.extensio is generated, to
avoid this use the additional ‘-dprint-pages’ or ‘-dno-print-pages’ options
according to your requirements.

when reading this text i don't feel comfortable!
wouldn't it be better to 

say what this option does and what the result is. 
mention which backends support it or don't
give a hint on how to suppress the usual output!

this could be:
"This option generates an output file (in the form myFile.preview.extension)
containing the titles and the first system of music. 
If \bookpart blocks are used, the titles and the first system of every
\bookpart will appear in the output.
This option is supported by all backends (pdf, png, ps, eps and svg) but not
scm
By default the usual output is produced - to avoid this  use the additional
-dprint-pages"


just to mention: when you run a -dpreview with --pdf there are 3 files
generated:
preview.pdf
preview.png 
preview.eps
 
isn't that too much?
should this be tracked?

Eluze

-- 
View this message in context: 
http://old.nabble.com/Issue-2112-in-lilypond%3A-documentation%3A-precising--dpreview-tp32989738p33055466.html
Sent from the Gnu - Lilypond - Bugs mailing list archive at Nabble.com.