Docs: reorganize documentation directory structure

* rename manuals by stripping "lilypond-" prefix from all source file names
  and HTML and PDF output (it is kept in Info output, where it is necessary),

* move manuals in Documentation/user one directory higher, in addition
  rename lilypond-program to application, and put .itely files in
  subdirectories,

* move Documentation/topdocs/NEWS.tely to Documentation,

* move Documentation/devel/contrib-guide.texi to
  Documentation/contributor.texi,

* move input/lsr/lilypond-snippets.tely to Documentation/, move the
  rest input/lsr to Documentation/snippets,

* move input/new to Documentation/snippets/new,

* move input/texidocs contents to
  Documentation/<language_codes>/texidocs, splitting texidocs by
  language,

* do the same changes in all translations when applicable,

* move Documentation/devel/index.html.in back to Documentation/deve.html.in.

'make all', 'make doc' and 'make dist' have been tested, although tons
of broken HTML and PDF links and Info cross-references are expected.

Maintenance makefiles (Documentation/GNUmakefile) and scripts
(scripts/auxiliar) are known to be broken, they will be updated in a
future commit.

TODO: Documentation/GNUmakefile is still a bit of a mess.

lilypond-book robustness: ensure EOL at the end of @verbatim

Also honor NOGETTEXT fragment option for snippets-files.

Ignore Emacs CEDET cache file

Add script to split texidocs translations

Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

Correct \displayLilyMusic output for single-note harmonics.

* since \harmonic only works inside chords, ensure \displayLilyMusic
  interprets a single-note harmonic as a note_chord_element
* remove trailing spaces

Doc: CG: improve release steps.

Docs: IR 2 Translation: Auto-sort various elements.

     Fix wrongly nested sort/ref-ify calls:
       (sort (map ref-ify lst)) --> (map ref-ify (sort lst)).
     Auto-sort various unsorted elements.

Docs: IR 1 Music definitions: Auto-sort various elements.

documentation-lib.scm: Clarify ref-ify docstring.

Docs: IR 3.2 Graphical Object Interfaces: Sort interfaces.

Full update and new translation status.

Docs: NR B.6 The Feta font: Rename nodes, fix whitespace.

Socket backend: reorganize and alphabetize

Auto-sort all-grob-properties alist for docs.

- add auto-sorting code to top of document-backend.scm
- remove calls to (sort ...) that are now redundant

Add new file lily-sort.scm; improve sorting in docs.

- add new file lily-sort.scm
- add "lily-sort.scm" to the ly:load list in documentation-generate.scm
- "string<?" --> "ly:string-ci<?" etc. in the document-*.scm files

Merge branch 'master' of carldsorensen@git.sv.gnu.org:/srv/git/lilypond

define-stencil-commands.scm: Finish alphabetizing

- also fix the indentation

Add information about snippets and translations

Docs: update translations status

Docs: convert French PO back to UTF-8

Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

Conflicts:
Documentation/po/fr.po

Docs makefiles: get rid of unconditional translations postprocessing

Docs: prepare direct translation of node names in Texinfo sources

- fix nits in texi-gettext.py,
- update tely-gettext.py and extract_texi_filenames.py,
- use --master-map-file option of extract_texi_filenames.py added in
this commit,
- remove embarrassing node translations in French and Spanish doc POs.

All these updates have been tested with a few makefiles hooks (not
included in this commit), an apparently successful execution of
tely-gettext.py on all translations followed by 'make doc' and a quick
check of HTML and PDF output.

Docs: do not attempt a build of Japanese docs in PDF

Make Perl treat all I/O streams as UTF-8

This is necessary to the upcoming translation of node names in Texinfo
source.

Docs: move common files and factorize Texinfo macros

- move macros.itexi to Documentation/ to anticipate the possible move
of all Texinfo documentation to the same directory,

- move Texinfo init file from top of the source tree,

- factorize macros common to all languages into common-macros.itexi.

SVG backend: alphabetize the stencil expressions

Make -dwarning-as-error more general

* The following calls now issue errors
  with the option -dwarning-as-error:

  Grob::warning ()
  Grob::programming_error ()
  Input::warning ()
  Input::programming_error ()

  ly:warning
  ly:programming-error

Only assign warning values for stencil commands

- Since the expressions in ly:all-output-backend-commands
  are not intended to be defined in output-*.scm,
  only assign warnings for ly:all-stencil-commands.

scm/define-stencil-commands.scm: cleanup

- Create a new procedure for stencil "commands",
  the subset of stencil expressions that can be
  defined in output-*.scm.

- Add the missing `setrotation' and `resetrotation'
  expressions.

- Use ly:all-output-backend-commands for the rest
  of the stencil expressions; thus,
  `delay-stencil-evaluation' belongs here, and
  add the missing `rotate-stencil' expression.

- Document the differences between the two procedures.

- Register all of the expressions in "one go".

Check for a null string before using `placebox'

- This is most important for output-svg, due to
  the regular expression matching, but the other
  output backends can benefit from the removal of
  the superfluous `placebox' expressions.

Return a null string after calling ly:warning

- This is needed to ensure a sane value for
an undefined stencil expression.

Remove obsolete backend code

- Remove obsolete code from lily.scm that was
used before the output backends took their current
form.

- Remove exported bindings from output-ps.scm; the
output backends no longer use a `public interface',
since all work is done with ly:outputter-dump-stencil,
which uses the modules directly.

- Remove the "catch-all" routines from the svg and socket
output backends; these are covered by the new procedure
in backend-library.scm

Add a new program option: -dwarning-as-error

(Thanks to Han-Wen and Jan for the initial idea)

- If a valid stencil expression is found, but is
undefined in the current backend, issue a warning
for every occurrence.

- The option -dwarning-as-error will cause LilyPond
to output an error and exit upon the first warning
encountered.

Doc: add Font to all font nodes (avoids potential confusion).

Docs: NR B.6 The Feta font: Add menu; separate into nodes.

Doc-fr: rhythm chapter nitpicks

* thanks to François Martin and Xavier Scheuer for their proof-reading

SVG output nitpick: use well-formed SGML comments

Fix compile (again)

Docs: IR: correct (de)crescendo syntax.

Fix compile

Docs: IR: remove references to \property command

We might want to junk all of the "Syntax:" lines in the IR eventually,
but for now, make sure the information is accurate, at least.

Docs: NR Tweak command: can't be used to modify stems,
      beams or accidentals *directly*

Laissez_vibrer_engraver: avoid duplicate self_scm () calls

- Also, remove trailing whitespace

Eliminate unix-specific -u flags from internationalization build

Docs: CG: add feature update checklist

Docs: NR 5.5 Clarify placement of Bézier override

Docs: LM: Follow-ups to suggestions from Jonathan Wilkes

Suggestions for improving the LM by Jonathan Wilkes

Docs: NR 5: index bezier curves for slurs and ties

Add a new stencil expression: embedded-svg

* This can only be used with the SVG backend.

Docs: IR: Remove unneeded arpeggio description

Docs: IR: Improve grob interface docstrings

Use hashlib instead of deprecated md5 module if Python >= 2.5 is present

Add NEWS entry about automatic deletion of intermediate files

Delete intermediate ps files by default

grace-engraver.cc: improve programming error formatting.

Docs: NR B.6 The Feta font: Organize glyph list.

Docs: LM 1.1 Typo

Use the correct generic font-family names

* Replace "Mono" with "monospace", and replace "Sans"
  with "sans-serif".  This corresponds to the W3C
  recommendations and is compatible with FontConfig/Pango.

* A serif font should be chosen if the user removes
  "Century Schoolbook L" from their LilyPond
  installation.  In the case of the SVG backend,
  fallback to a serif font if Century Schoolbook L
  is not installed.

* Remove trailing whitespace

SVG backend: Fix font matching

* Only match the elements of a PangoFontDescription
  that LilyPond is capable of matching.

* Store the attributes for a PangoFontDescription
  in an alist in order to filter unwanted attributes.

* Ignore the "style" of a font smob; it cannot be used
  to match the correct embedded SVG font.

* The fill of "round-filled-box" should be "currentColor"

Signed-off-by: Patrick McCarty <pnorcks@gmail.com>

SVG backend: Fix dimensions of SVG document

* Use ly:format instead for rounding page dimensions;
  it gives more accurate results.

* Use the "viewBox" attribute for <svg> to scale the
  output instead of <g scale="">...</g>

* Remove other superfluous grouping tags

Signed-off-by: Patrick McCarty <pnorcks@gmail.com>

Doc-fr: completed rhythm chapter

* rhythms.itely fully updated
* associated texidocs files

Doc: standardize direction commands.

Doc: CG: add items to Release list.

Docs: AU: Slight correction to SVG description

Doc: CG: add the magic command to solve all conflicts.

Revert "Doc: move essay into its own manual."

This reverts commit 1af68220c260b8d17484dc283489541b1f9c74d3.

Docs: IR: Fix docstring for ly:paper-book-paper

Docs: IR: Document the `class' music property

Correct docs for grob properties using ly:grob-array.

Fix #741 from Nicolas.

- set option direction-required to #f so hyphens aren't inserted

stepmake/aclocal.m4: --srcdir tarball build fix: include <src-dir>/lily/out.

Our tarballs ship lily/out/parser.hh, which cannot be found when doing
a srcdir build.  We never found out, because GUB only built from GIT,
apparently.

Merge branch 'master' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

Docs: CG: Fix ./configure option name

Docs: CG: Add more content for `git push'

Docs: CG: Minor correction about editing SSH keys

Docs: CG: Add more info about applying patches

Doc: move essay into its own manual.

Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

Doc-es: update of PO.

Doc-es: Updates and new status.

Doc: tiny wordage suggestion by James Bailey, thanks!

Docs: update PO msgids

Docs: update translations status

Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond

Translated docs: fix 'cp' error about multiple CSS files copying

Also split some long lines.

Doc: slightly increase example readibility.

Docs: LM 5.2.2: typos and minor improvement to text

Typo fix

Doc: add missing clef entries.

Docs: NR: Revise last ossia example

- Thanks to Mats for the suggestion

  http://lists.gnu.org/archive/html/lilypond-user/2008-10/msg00890.html

Docs: LM 5.2: Add new section Common errors

DOCS: new section in CG--compiling on virtual machines

CG: release instructions.

Bump version.

Docs: AU 3.4.3: Triple quotes not required on output file

Add guile debugging information

CG: add stub for linux-on-windows.