#5286 Better description of -dcrop in Usage chapter 1.2

[Federico Bruni]

See discussion here: https://lists.gnu.org/archive/html/bug-lilypond/2018-02/msg00069.html

In 1.2, Advanced command line options for LilyPond

While updating the italian Usage manual I found this new option:

@item @code{crop}
@tab @code{#f}
@tab Match the size of the normal output to the typeset image.

The description is quite blurry and I can't come up with a good translation (unless I change the words completely). What is "normal output"? I know you mean the actual content, without margins or tagline. Then I would just say that it crops the margins and tagline (while title is kept).

[...]

Suggested description: "Compress all the music and headers in a single-page output file without margins."

Try a simple example like:

$ cat test.ly 
\version "2.19.80"

\header { title = "Crop test" }
\relative {
  \repeat unfold 100 { c1*4 }
}

Run lilypond -dcrop test.ly and you'll get three files:

• test.pdf is the regular PDF file (two pages, with margins and page numbers)
• test.cropped.pdf and test.cropped.png are the single-page output files without margins

[Anonymous]

Doc: Usage - Better description of -dcrop in Usage chapter 1.2

Issue 5286
Better description of
-dcrop in Usage
chapter 1.2

http://codereview.appspot.com/572600047

[Anonymous]

Passes make, make check and a full make doc.

[Anonymous]

fix nit

http://codereview.appspot.com/572600047

[Anonymous]

Patch on countdown for April 15th.

[Anonymous]

Patch counted down, please push to staging.

[Anonymous]

Doc: Usage - Better description of -dcrop in Usage chapter 1.2 staging
author  James Lowe <pkx166h@runbox.com> 
    Mon, 15 Apr 2019 20:37:48 +0100 (20:37 +0100)
committer   James Lowe <pkx166h@runbox.com> 
    Mon, 15 Apr 2019 20:37:48 +0100 (20:37 +0100)
commit  f4e30857e1bd5155a01773f2a4c297cb62bf3742