Doc: Usage - Update svg & svg-woff backend text

Doc: Usage - Update svg & svg-woff backend text

Issue 4650

Update explanation so as to
inform the user that they will
need to make sure that the font/
WOFF font file information for
anything other than LP Music glyphs
are not included and need to be
'made available' to the SVG viewer
separately.

[trueroad, 2015-11-03 13:55:02]

https://codereview.appspot.com/274260043/diff/1/Documentation/usage/running.i...
File Documentation/usage/running.itely (right):

https://codereview.appspot.com/274260043/diff/1/Documentation/usage/running.i...
Documentation/usage/running.itely:783: handle them.  For other font format files
use the @code{svg} option.
>For other font format files use the @code{svg} option.

`svg' is not option.
How about this?

For other font format files do not use this option.

[pkx166h, 2015-11-03 14:20:57]

On 2015/11/03 13:55:02, trueroad wrote:
>
https://codereview.appspot.com/274260043/diff/1/Documentation/usage/running.i...
> File Documentation/usage/running.itely (right):
> 
>
https://codereview.appspot.com/274260043/diff/1/Documentation/usage/running.i...
> Documentation/usage/running.itely:783: handle them.  For other font format
files
> use the @code{svg} option.
> >For other font format files use the @code{svg} option.
> 
> `svg' is not option.
> How about this?
> 
> For other font format files do not use this option.

The implication here is that if you want to use WOFF font format files then you
use the svg-woff switch for all other font formats you use the 'svg' only
switch?

Is that right? (Maybe I need to use the word 'switch' instead of 'option').

James

[trueroad, 2015-11-04 13:10:50]

On 2015/11/03 14:20:57, pkx166h wrote:
> On 2015/11/03 13:55:02, trueroad wrote:
> >
>
https://codereview.appspot.com/274260043/diff/1/Documentation/usage/running.i...
> > File Documentation/usage/running.itely (right):
> > 
> >
>
https://codereview.appspot.com/274260043/diff/1/Documentation/usage/running.i...
> > Documentation/usage/running.itely:783: handle them.  For other font format
> files
> > use the @code{svg} option.
> > >For other font format files use the @code{svg} option.
> > 
> > `svg' is not option.
> > How about this?
> > 
> > For other font format files do not use this option.
> 
> The implication here is that if you want to use WOFF font format files then
you
> use the svg-woff switch for all other font formats you use the 'svg' only
> switch?
> 
> Is that right? (Maybe I need to use the word 'switch' instead of 'option').
> 
> James

If I understand correctly,

The following command creates SVG file without WOFF.
$ lilypond -dbackend=svg foo.ly

The following command creates SVG file with WOFF.
$ lilypond -dbackend=svg -dsvg-woff foo.ly

However, the following command creates PDF.
$ lilypond -dsvg-woff foo.ly

And again, option (or switch) `svg' is not exist.

This command
$ lilypond -dsvg foo.ly
shows the following warning.
`warning: no such internal option: svg'

This command
$ lilypond --svg foo.ly
shows the following error.
`lilypond: unrecognized option: `--svg''

[pkx166h, 2015-11-05 17:47:26]

WIth Hosada-san's suggestions and some more tidying up of the section.

[trueroad, 2015-11-06 14:09:16]

https://codereview.appspot.com/274260043/diff/20001/Documentation/usage/runni...
File Documentation/usage/running.itely (right):

https://codereview.appspot.com/274260043/diff/20001/Documentation/usage/runni...
Documentation/usage/running.itely:490: additional additional @code{--svg-woff}
switch is required.
Is `additional' duplicated?

https://codereview.appspot.com/274260043/diff/20001/Documentation/usage/runni...
Documentation/usage/running.itely:498: command you must explicitly define the
default fonts in your output
To define the font is in source files (*.ly) rather than in output files
(*.svg).

[pkx166h, 2015-11-07 17:13:18]

Hosada-san`s corrections.

[pkx166h, 2015-11-07 17:17:36]

On 2015/11/06 14:09:16, trueroad wrote:
>
https://codereview.appspot.com/274260043/diff/20001/Documentation/usage/runni...
> File Documentation/usage/running.itely (right):
> 
>
https://codereview.appspot.com/274260043/diff/20001/Documentation/usage/runni...
> Documentation/usage/running.itely:490: additional additional @code{--svg-woff}
> switch is required.
> Is `additional' duplicated?
> 
>
https://codereview.appspot.com/274260043/diff/20001/Documentation/usage/runni...
> Documentation/usage/running.itely:498: command you must explicitly define the
> default fonts in your output
> To define the font is in source files (*.ly) rather than in output files
> (*.svg).

Thanks, All done.

[trueroad, 2015-11-08 03:13:17]

LGTM
Thank you.

[Trevor Daniels, 2015-11-08 23:08:02]

I can't vouch for the technicalities, but LGTM apart from a few typos.

https://codereview.appspot.com/274260043/diff/40001/Documentation/usage/runni...
File Documentation/usage/running.itely (right):

https://codereview.appspot.com/274260043/diff/40001/Documentation/usage/runni...
Documentation/usage/running.itely:469: as separate encapsulated postscipt files
for each page but without fonts
postscript

https://codereview.appspot.com/274260043/diff/40001/Documentation/usage/runni...
Documentation/usage/running.itely:486: Any SVG viewer will therefore require the
fonts be available to it for
... fonts to be available ...

https://codereview.appspot.com/274260043/diff/40001/Documentation/usage/runni...
Documentation/usage/running.itely:487: the proper rendering of both text and
lyrics.  It is recommended to not
... recommended not to use ...

https://codereview.appspot.com/274260043/diff/40001/Documentation/usage/runni...
Documentation/usage/running.itely:785: require the fonts be available to it for
the proper rendering of both
.. to be available ...

[pkx166h, 2015-11-09 18:03:13]

With Trevor's corrections.

[pkx166h, 2017-03-19 19:08:22]

author James Lowe pkx166h@gmail.com
Sun, 1 Nov 2015 11:34:43 +0000 (11:34 +0000)
committer James Lowe pkx166h@gmail.com
Fri, 13 Nov 2015 10:36:35 +0000 (10:36 +0000)
commit 8706e77a804e412e751fdd47385c8ccfdc28e732