Re: LilyPond Odd Jobs (mostly docs)

[Valentin Villenave]

2007/7/13, Graham Percival <address@hidden>:

> Lilypond Odd Jobs
> -----------------

Thank you Graham.

> - create example for automatic accidental examples that demonstrates
> everything

OK, I'll take this one.

> - special markup command examples (note head styles, rotation, etc:
> complicated stuff to show off some possibilities).  Maybe as LSR instead
> of manual.

To everyone who would like to take it: please check
http://lsr.dsi.unimi.it/LSR/Search?q=%5Cmarkup
first, and improve existing snippets if necessary
(for example check if they are located in the relevant category).

> - document (manual or LSR) adding command-line arguments to lilypond scores:
> http://www.mail-archive.com/address@hidden/msg16042.html
> http://lists.gnu.org/archive/html/lilypond-user/2006-10/msg00271.html

> - document (manual or LSR) adding arguments to \include:
> http://lists.gnu.org/archive/html/lilypond-user/2006-12/msg00642.html

> - document (manual or LSR) first/last page header commands:
> http://www.mail-archive.com/address@hidden/msg24949.html

> - document (manual or LSR) multiple tags:
> http://lists.gnu.org/archive/html/lilypond-user/2007-01/msg00635.html

> - prettify the main "snippets" page of the docs.
> input/lsr/LSR.ly
> http://lilypond.org/doc/v2.11/input/lsr/collated-files

> GENERAL EDITING / JANITORIAL:
> - check manual for current correctness (does it make sense, is the info
> up-to-date, etc)

Absolutely! This is a (crucial) task everyone can do!

> - verify anything in the "bugs" sections
> - standardize # signs
> http://lists.gnu.org/archive/html/lilypond-devel/2006-10/msg00180.html

> - avoid future tense
> http://lists.gnu.org/archive/html/lilypond-devel/2006-01/msg00076.html

[OMG... I think I've used it many times in the French translation... :-( ]

> ADVANCED
> - go through ly/music-functions-init.ly and add a doc string to every
> function listed.
> - Some type of doc that outlined the lexical construction of Lilypond

This seems to be a quite complete list.
Graham: Since you haven't pasted the link (yet) in this thread, let me
do it for you:
http://lilypond.org/web/devel/participating/documentation-adding

Everyone:
Anyone can add new snippets to the LSR, but it requires special rights
to modify existing snippets. In such a case, please send me your
corrected snippet,
or if you prefer, assuming the snippet you corrected was

Writing music with LilyPond

copy it and post it as a new snippet, entitled:

Writing music with LilyPond [corrected]

I check for new snippets everyday, so the first one will soon be
replaced with yours.

Suggesting concrete Documentation improvements is very easy, and this
will make LilyPond an even better software, so please help us!

Regards,
Valentin