]> git.donarmstrong.com Git - lilypond.git/commitdiff
Build: move shared .itexi files into included/
authorGraham Percival <graham@percival-music.ca>
Sat, 30 Jan 2010 00:38:02 +0000 (00:38 +0000)
committerGraham Percival <graham@percival-music.ca>
Sat, 30 Jan 2010 00:50:22 +0000 (00:50 +0000)
Documentation/contributor/basic-compile.itexi [deleted file]
Documentation/contributor/compiling.itexi
Documentation/de/web/community.itexi
Documentation/es/web/community.itexi
Documentation/hu/web/community.itexi
Documentation/included/authors.itexi [new file with mode: 0644]
Documentation/included/compile.itexi [new file with mode: 0644]
Documentation/topdocs/AUTHORS.texi
Documentation/topdocs/INSTALL.texi
Documentation/web/basic-authors.itexi [deleted file]
Documentation/web/community.itexi

diff --git a/Documentation/contributor/basic-compile.itexi b/Documentation/contributor/basic-compile.itexi
deleted file mode 100644 (file)
index 9a47a9e..0000000
+++ /dev/null
@@ -1,609 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-
-
-@c DO NOT TRANSLATE THIS FILE
-
-@c include any node/sections from the higher-level *texi file.
-@c   @n ode Compiling from source
-@c   @s ection Compiling from source
-
-@menu
-* Downloading source code::
-* Requirements::
-* Building LilyPond::
-* Building documentation::
-* Testing LilyPond::
-* Problems::
-@end menu
-
-@node Downloading source code
-@subsection Downloading source code
-
-Download source
-
-@itemize
-@item tarballs from
-@uref{http://lilypond.org/download/} by HTTP.
-@item tarballs from
-@uref{http://download.linuxaudio.org/lilypond/} by HTTP.
-@item
-GIT from @uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=summary,git.sv.gnu.org}
-
-@example
-git clone git://git.sv.gnu.org/lilypond.git
-@end example
-
-The repository does not contain generated files.  To create
-@file{configure}, run
-@example
-./autogen.sh
-@end example
-@end itemize
-
-For information on packaging, see @uref{http://lilypond.org/devel}.
-
-
-@node Requirements
-@subsection Requirements
-
-@unnumberedsubsubsec Compilation
-
-In addition to the packages needed for running LilyPond (see below), you
-need the following extra packages for building.
-
-Below is a full list of packages needed to build LilyPond.  However, for
-most common distributions there is an easy way of installing most all
-build dependencies in one go
-
-@multitable @columnfractions .5 .5
-@headitem Distribution
-@tab Command
-
-@item Debian, Ubuntu
-@tab @code{sudo apt-get build-dep lilypond}
-
-@item Fedora, RHEL
-@tab @code{sudo yum-builddep lilypond}
-
-@item openSUSE, SLED
-@c sorry for the idiosyncratic command, I really asked and argued
-@c for "zypper build-dep" :-(
-@tab @code{sudo zypper --build-deps-only source-install lilypond}
-
-@end multitable
-
-When installing a binary package FOO, you may need to install the
-FOO-devel, libFOO-dev or FOO-dev package too.
-
-@itemize
-
-@item @uref{http://fontforge.sf.net/,FontForge} 20060125 or newer.
-
-@item @uref{http://metafont.tutorial.free.fr/,MetaFont} (mf-nowin, mf, mfw or
-mfont binaries) and @uref{http://cm.bell-labs.com/who/hobby/MetaPost.html,MetaPost}
-(mpost binary), usually packaged with a @LaTeX{} distribution like
-tetex or texlive.
-
-@item @uref{http://www.lcdf.org/~eddietwo/type/#t1utils,t1utils}
-(version 1.33 or newer recommended).
-
-@item New Century Schoolbook fonts, as PFB files.  These are shipped with
-X11 and Ghostscript, and are named @file{c059033l.pfb}
-@file{c059036l.pfb}, @file{c059013l.pfb} and @file{c059016l.pfb}.
-
-@item @uref{http://www.gnu.org/software/guile/guile.html,GUILE} (version
-1.8.2 or newer).  If you are installing binary packages, you may need to
-install guile-devel or guile-dev or libguile-dev too.
-
-@item @uref{ftp://ftp.gnu.org/gnu/texinfo/,Texinfo} (version 4.11 or newer).
-
-@item @uref{http://gcc.gnu.org/, The GNU c++ compiler} (version 3.4 or
-newer.  4.x is strongly recommended).
-
-@item @uref{http://www.python.org,Python} (version 2.4 or newer)
-
-@item @uref{ftp://ftp.gnu.org/gnu/make/,GNU Make} (version 3.78 or newer).
-
-@item @uref{http://www.gnu.org/software/gettext/gettext.html,gettext}
-(version 0.17 or newer).
-
-@item @uref{http://www.gnu.org/software/flex/,Flex}.
-
-@item @uref{http://www.perl.org/,Perl}.
-
-@item @uref{http://www.gnu.org/software/bison/,GNU Bison}.
-
-@item All packages required for running, including development packages with
-header files and libraries.
-
-@end itemize
-
-
-@unnumberedsubsubsec Running requirements
-
-Running LilyPond requires proper installation of the following software
-
-@itemize
-
-@item @uref{http://www.freetype.org/,Freetype} (version 2.1.10 or newer).
-@item @uref{http://fontconfig.org/,FontConfig} (version 2.2 or newer).
-@item @uref{http://www.pango.org/,Pango} (version 1.12 or newer).
-@item @uref{http://www.gnu.org/software/guile/guile.html,GUILE}
-(version 1.8.2 or newer)
-@item @uref{http://www.python.org,Python} (version 2.4 or newer).
-@item @uref{http://www.ghostscript.com,Ghostscript} (version 8.60 or
-newer).
-@item Dejaview.  (This is normally installed by default)
-@end itemize
-
-International fonts are required to create music with international text
-or lyrics.
-
-
-@unnumberedsubsubsec Requirements for building documentation
-
-You can view the documentation online at
-@uref{http://lilypond.org/doc/}, but you can also build it locally.
-This process requires a successful compile of LilyPond, and some
-additional tools and packages:
-
-@itemize
-@item The @uref{http://netpbm.sourceforge.net/,netpbm utilities}
-@item ImageMagick
-@item International fonts (see input/regression/utf-8.ly for hints
-about which font packages are necessary for your platform)
-@item Ghostscript 8.60 or newer
-@item @uref{http://www.nongnu.org/texi2html/,Texi2HTML} 1.82
-@item rsync
-@end itemize
-
-
-@node Building LilyPond
-@subsection Building LilyPond
-
-@unnumberedsubsubsec Compiling
-
-To install GNU LilyPond, type
-
-@example
-gunzip -c lilypond-x.y.z | tar xf -
-cd lilypond-x.y.z
-./configure            # run with --help for applicable options
-make
-su -c 'make install'
-@end example
-
-@noindent
-If you are not root, you should choose a @code{--prefix} argument that
-points into your home directory, e.g.
-
-@example
-./configure --prefix=$HOME/usr
-@end example
-
-If you encounter any problems, please see @ref{Problems}.
-
-
-@unnumberedsubsubsec Compiling for multiple platforms
-
-If you want to build multiple versions of LilyPond with different
-configuration settings, you can use the @code{--enable-config=CONF}
-option of @command{configure}.  You should use @code{make conf=CONF}
-to generate the output in @file{out-CONF}.  For example, suppose you
-want to build with and without profiling, then use the following for
-the normal build
-
-@example
-./configure --prefix=$HOME/usr/ --enable-checking
-make
-make install
-@end example
-
-and for the profiling version, specify a different configuration
-
-@example
-./configure --prefix=$HOME/usr/ --enable-profiling --enable-config=prof --disable-checking
-make conf=prof
-make conf=prof install
-@end example
-
-
-@unnumberedsubsubsec Compiling outside the source tree
-
-It is possible to compile LilyPond in a build tree different from the
-source tree, with @code{--srcdir} option of @command{configure}:
-
-@example
-mkdir lily-build && cd lily-build
-@var{sourcedir}/configure --srcdir=@var{sourcedir}
-
-@end example
-
-
-@unnumberedsubsubsec Useful @command{make} variables
-
-If a less verbose build output if desired, the variable
-@code{QUIET_BUILD} may be set to @code{1} on @command{make} command
-line, or in @file{local.make} at top of the build tree.
-
-
-@node Building documentation
-@subsection Building documentation
-
-This requires a successful compile of LilyPond, or using an external
-LilyPond binary.
-
-@menu
-* Commands for building documentation:: Compiling and installing the documentation.
-* Building documentation without compiling LilyPond:: Using a LilyPond binary already installed.
-@end menu
-
-@node Commands for building documentation
-@unnumberedsubsubsec Commands for building documentation
-
-The documentation is built by issuing
-
-@example
-make doc
-@end example
-
-After compilation, the HTML documentation tree is available in
-@file{out-www/offline-root/}, and can be browsed locally.  Various
-portions of the documentation can be found by looking in
-@file{out/} and @file{out-www} subdirectories in other places in
-the source tree, but these are only @emph{portions} of the docs.
-Please do not complain about anything which is broken in those
-places; the only complete set of documentation is in
-@file{out-www/offline-root/} from the top of the source tree.
-
-The HTML, PDF and if available Info files can be installed into the
-standard documentation path by issuing
-
-@example
-make install-doc
-@end example
-
-@noindent
-This also installs Info documentation with images if the installation
-prefix is properly set; otherwise, instructions to complete proper
-installation of Info documentation are printed on standard output.
-
-Compilation of documentation in Info format with images can be done
-separately by issuing
-
-@example
-make info
-@end example
-
-@noindent
-Separate installation of this documentation is done by issuing
-
-@example
-make install-info
-@end example
-
-@noindent
-Note that to get the images in Info documentation, @code{install-doc}
-target creates symbolic links to HTML and PDF installed documentation
-tree in @file{@var{prefix}/share/info}, in order to save disk space,
-whereas @code{install-info} copies images in
-@file{@var{prefix}/share/info} subdirectories.
-
-It is possible to build a documentation tree in
-@file{out-www/online-root/}, with special processing, so it can be
-used on a website with content negotiation for automatic language
-selection; this can be achieved by issuing
-
-@example
-make WEB_TARGETS=online doc
-@end example
-
-@noindent
-and both @q{offline} and @q{online} targets can be generated by issuing
-
-@example
-make WEB_TARGETS="offline online" doc
-@end example
-
-Several targets are available to clean the documentation build and
-help with maintaining documentation; an overview of these targets is
-available with
-
-@example
-make help
-@end example
-
-@noindent
-from every directory in the build tree.  Most targets for
-documentation maintenance are available from @file{Documentation/};
-@c FIXME: xref to CG
-for more information, see the Contributor's Guide, section
-@emph{Documentation work}.
-
-The makefile variable @code{QUIET_BUILD} may be set to @code{1} for a
-less verbose build output, just like for building the programs.
-
-
-@knownissues
-
-The most time consuming task for building the documentation is running
-LilyPond to build images of music, and there cannot be several
-simultaneously running @command{lilypond-book} instances, so @code{-j}
-@command{make} option does not significantly speed up the build process.
-To help speed it up, the makefile variable @var{CPU_COUNT} may be set
-in @file{local.make} or on the command line to the number of
-@code{.ly} files that LilyPond should process simultaneously, e.g. on
-a bi-processor or dual core machine
-
-@example
-make -j3 CPU_COUNT=3 doc
-@end example
-
-@noindent
-The recommended value of @var{CPU_COUNT} is one plus the number of
-cores or processors, but it is advisable to set it to a smaller value
-if your system has not enough RAM to run that many simultaneous
-LilyPond instances.
-
-If source files have changed since last documentation build, output
-files that need to be rebuilt are normally rebuilt, even if you do not
-run @code{make doc-clean} first.  However, building dependencies in the
-documentation are so complex that rebuilding of some targets may not
-be triggered as they should be; a workaround is to force rebuilding
-by touching appropriate files, e.g.
-
-@example
-touch Documentation/extend.texi
-touch Documentation/*te??
-touch Documentation/snippets/*.te??
-@end example
-
-
-@node Building documentation without compiling LilyPond
-@unnumberedsubsubsec Building documentation without compiling LilyPond
-
-The documentation can be built locally without compiling LilyPond
-binary, if LilyPond is already installed on your system.
-
-From a fresh Git checkout, do
-
-@example
-./autogen.sh   # ignore any warning messages
-cp GNUmakefile.in GNUmakefile
-make -C scripts && make -C python
-nice make LILYPOND_EXTERNAL_BINARY=/path/to/bin/lilypond doc
-@end example
-
-Please note that this may break sometimes -- for example, if a new
-feature is added with a test file in input/regression, even the latest
-development release of LilyPond will fail to build the docs.
-
-You may build the manual without building all the @file{input/*} stuff
-(i.e. mostly regression tests): change directory, for example to
-@file{Documentation/}, issue @code{make doc}, which will build
-documentation in a subdirectory @file{out-www} from the source files in
-current directory.  In this case, if you also want to browse the
-documentation in its post-processed form, change back to top directory
-and issue
-
-@example
-make out=www WWW-post
-@end example
-
-@knownissues
-
-You may also need to create a script for @command{pngtopnm} and
-@code{pnmtopng}.  On GNU/Linux, I use this:
-
-@verbatim
-export LD_LIBRARY_PATH=/usr/lib
-exec /usr/bin/pngtopnm "$@"
-@end verbatim
-
-On MacOS X with fink, I use this:
-
-@verbatim
-export DYLD_LIBRARY_PATH=/sw/lib
-exec /sw/bin/pngtopnm "$@"
-@end verbatim
-
-On MacOS X with macports, you should use this:
-
-@verbatim
-export DYLD_LIBRARY_PATH=/opt/local/lib
-exec /opt/local/bin/pngtopnm "$@"
-@end verbatim
-
-
-
-@node Testing LilyPond
-@subsection Testing LilyPond
-
-@html
-<a name="testing"></a>
-@end html
-
-LilyPond comes with an extensive suite that exercises the entire
-program.  This suite can be used to automatically check the impact of a
-change.  This is done as follows
-
-@example
-make test-baseline
-@emph{## apply your changes, compile}
-make check
-@end example
-
-This will leave an HTML page @file{out/test-results/index.html}.  This
-page shows all the important differences that your change introduced,
-whether in the layout, MIDI, performance or error reporting.
-
-To rerun tests, use
-
-@example
-make test-redo           @emph{## redo files differing from baseline}
-make test-clean          @emph{## remove all test results}
-@end example
-
-@noindent
-and then run @code{make check} again.
-
-For tracking memory usage as part of this test, you will need GUILE
-CVS; especially the following patch:
-@uref{http://lilypond.org/vc/gub.darcs/patches/guile-1.9-gcstats.patch}.
-
-For checking the coverage of the test suite, do the following
-
-@example
-./scripts/auxiliar/build-coverage.sh
-@emph{# uncovered files, least covered first}
-./scripts/auxiliar/coverage.py  --summary out-cov/*.cc
-@emph{# consecutive uncovered lines, longest first}
-./scripts/auxiliar/coverage.py  --uncovered out-cov/*.cc
-@end example
-
-
-@node Problems
-@subsection Problems
-
-For help and questions use @email{lilypond-user@@gnu.org}.  Send
-bug reports to @email{bug-lilypond@@gnu.org}.
-
-Bugs that are not fault of LilyPond are documented here.
-
-@unnumberedsubsubsec Bison 1.875
-
-There is a bug in bison-1.875: compilation fails with "parse error
-before `goto'" in line 4922 due to a bug in bison.  To fix, please
-recompile bison 1.875 with the following fix
-
-@example
-$ cd lily; make out/parser.cc
-$ vi +4919 out/parser.cc
-# append a semicolon to the line containing "__attribute__ ((__unused__))
-# save
-$ make
-@end example
-
-
-@unnumberedsubsubsec Compiling on MacOS@tie{}X
-
-Here are special instructions for compiling under MacOS@tie{}X.
-These instructions assume that dependencies are installed using
-@uref{http://www.macports.org/, MacPorts.} The instructions have
-been tested using OS X 10.5 (Leopard).
-
-First, install the relevant dependencies using MacPorts.
-
-Next, add the following to your relevant shell initialization
-files. This is @code{~/.profile} by default. You should create
-this file if it does not exist.
-
-@example
-export PATH=/opt/local/bin:/opt/local/sbin:$PATH
-export DYLD_LIBRARY_PATH=/System/Library/Frameworks/ApplicationServices.framework/Versions/A/Frameworks/ImageIO.framework/Versions/A/Resources:\
-/opt/local/lib:$DYLD_LIBRARY_PATH
-@end example
-
-Now you must edit the generated @code{config.make} file.  Change
-
-@example
-FLEXLEXER_FILE = /usr/include/FlexLexer.h
-@end example
-
-@noindent
-to:
-
-@example
-FLEXLEXER_FILE = /opt/local/include/FlexLexer.h
-@end example
-
-At this point, you should verify that you have the appropriate
-fonts installed with your ghostscript installation. Check @code{ls
-/opt/local/share/ghostscript/fonts} for: 'c0590*' files (.pfb,
-.pfb and .afm).  If you don't have them, run the following
-commands to grab them from the ghostscript SVN server and install
-them in the appropriate location:
-
-@example
-svn export http://svn.ghostscript.com/ghostscript/tags/urw-fonts-1.0.7pre44/
-sudo mv urw-fonts-1.0.7pre44/* /opt/local/share/ghostscript/fonts/
-rm -rf urw-fonts-1.07pre44
-@end example
-
-Now run the @code{./configure} script. To avoid complications with
-automatic font detection, add
-
-@example
---with-ncsb-dir=/opt/local/share/ghostscript/fonts
-@end example
-
-
-@unnumberedsubsubsec Solaris
-
-Solaris7, ./configure
-
-@file{./configure} needs a POSIX compliant shell.  On Solaris7,
-@file{/bin/sh} is not yet POSIX compliant, but @file{/bin/ksh} or bash
-is.  Run configure like
-
-@example
-CONFIG_SHELL=/bin/ksh ksh -c ./configure
-@end example
-
-@noindent
-or
-
-@example
-CONFIG_SHELL=/bin/bash bash -c ./configure
-@end example
-
-@unnumberedsubsubsec FreeBSD
-
-To use system fonts, dejaview must be installed.  With the default
-port, the fonts are installed in @file{usr/X11R6/lib/X11/fonts/dejavu}.
-
-Open the file @file{$LILYPONDBASE/usr/etc/fonts/local.conf} and add the
-following line just after the @code{<fontconfig>} line.  (Adjust as necessary
-for your hierarchy.)
-
-@example
-<dir>/usr/X11R6/lib/X11/fonts</dir>
-@end example
-
-
-@unnumberedsubsubsec International fonts
-
-On Mac OS X, all fonts are installed by default.  However, finding all
-system fonts requires a bit of configuration; see
-@uref{http://lists.gnu.org/archive/html/lilypond-user/2007-03/msg00472.html,
-this post} on the @code{lilypond-user} mailing list.
-
-On Linux, international fonts are installed by different means on
-every distribution.  We cannot list the exact commands or packages
-that are necessary, as each distribution is different, and the exact
-package names within each distribution changes.  Here are some
-hints, though:
-
-@verbatim
-Red Hat Fedora
-
-    taipeifonts fonts-xorg-truetype ttfonts-ja fonts-arabic \
-         ttfonts-zh_CN fonts-ja fonts-hebrew
-
-Debian GNU/Linux
-
-   apt-get install emacs-intl-fonts xfonts-intl-.* \
-        ttf-kochi-gothic ttf-kochi-mincho \
-        xfonts-bolkhov-75dpi xfonts-cronyx-100dpi xfonts-cronyx-75dpi
-@end verbatim
-
-
-@unnumberedsubsubsec Using lilypond python libraries
-
-If you want to use lilypond's python libraries (either running
-certain build scripts manually, or using them in other programs),
-set @code{PYTHONPATH} to @file{python/out} in your build
-directory, or @file{.../usr/lib/lilypond/current/python} in the
-installation directory structure.
-
-
index dc1c15628d3fa2cf7af414601667528bfd301a90..da88b1dfd61eda86f502b369f6c33bd22eb91757 100644 (file)
@@ -13,7 +13,7 @@
 @node Compiling from source
 @section Compiling from source
 
-@include contributor/basic-compile.itexi
+@include included/compile.itexi
 
 
 @node Concurrent Stable and Development Versions
index ad94c26fdc5fd103a63b2cbd4dbb717ed34789e9..f4e84dbf95b16bd93cb2b6310c531b5c5c5de537 100644 (file)
@@ -6,7 +6,7 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@include web/basic-authors.itexi
+@include included/authors.itexi
 
 @node Gemeinschaft
 @unnumbered Gemeinschaft
index 368473976a75237ecf9eb12c9d7d61056149b4ba..a60867499851a6937c4e6119588be010ee59ecef 100644 (file)
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@include web/basic-authors.itexi
+@include included/authors.itexi
 
 @node Comunidad
 @unnumbered Comunidad
index 9ca08302073d2c71bd3e679f4b8e612bd93e705f..e37abc2963aa557465bc29d92158dc4dde91942a 100644 (file)
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@include web/basic-authors.itexi
+@include included/authors.itexi
 
 @node Közösség
 @unnumbered Közösség
diff --git a/Documentation/included/authors.itexi b/Documentation/included/authors.itexi
new file mode 100644 (file)
index 0000000..17d1767
--- /dev/null
@@ -0,0 +1,387 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@c This file is part of community.itexi and ../topdocs/AUTHORS.itexi
+
+@ignore
+
+  This file lists authors of LilyPond, and what they wrote.  Each
+  list is sorted alphabetically by surname.  This file lists people
+  that have contributed more than a few hours of work.
+
+  Developers are people who are (or have been) listed under the
+  "Development Team" in the THANKS, and can choose their own
+  titles.  Contributors are everybody else, and simply list their
+  contributions.  All lists are sorted alphabetically.
+
+  Anybody who has finished doing a "main devel team" task should
+  list it under developersPrevious, even if they're still doing
+  other "main devel team" stuff.  See "Graham Percival" for an
+  example.
+
+  Contributors are also split between Current and Previous, and
+  each category contains:
+    core...     (programming)
+    font...     (duh)
+    doc...      (documentation and examples)
+    support...  (building, distributions, editors,
+                 lilypond-book, LSR, but *not* answering emails)
+    translations... (duh)
+  We might add a "general" or "other" if there's something else.
+
+@end ignore
+
+
+@macro developersCurrent
+
+@itemize
+
+@item Mats Bengtsson:
+@email{mats.bengtsson@@ee.kth.se},
+@uref{http://www.s3.kth.se/~mabe/},
+Support guru
+
+@item Trevor Daniels:
+Assistant documentation editor
+
+@item Reinhold Kainhofer:
+@email{reinhold@@kainhofer.com},
+@uref{http://reinhold.kainhofer.com},
+Music2xml wrangler, bug squasher
+
+@item Jonathan Kulp:
+Assistant documentation editor
+
+@item Werner Lemberg,
+@email{wl@@gnu.org},
+Fonts, bug squasher
+
+@item John Mandereau:
+@email{john.mandereau@@free.fr},
+Translation meister
+
+@item Patrick McCarty:
+SVG guru, bug squasher, text handling
+
+@item Joe Neeman:
+Core developer
+
+@item Han-Wen Nienhuys:
+@email{hanwen@@xs4all.nl},
+@uref{http://www.xs4all.nl/~hanwen/},
+Main author
+
+@item Jan Nieuwenhuizen:
+@email{janneke@@gnu.org},
+@uref{http://www.xs4all.nl/~jantien/},
+Main author
+
+@item Graham Percival:
+@uref{http://percival-music.ca},
+Project manager, Documentation Editor
+
+@item Mark Polesky:
+Assistant documentation editor, Code cleanup
+
+@item Neil Puttock:
+Core developer
+
+@item Nicolas Sceaux:
+Core developer, Schemer extraordinaire
+
+@item Carl Sorensen:
+@email{c_sorensen@@byu.edu},
+Core developer, Frog meister
+
+@item Francisco Vila:
+Translations
+
+@item Valentin Villenave:
+LSR editor and Bug meister
+
+@end itemize
+@end macro
+
+
+
+@macro developersPrevious
+
+@itemize
+
+@c use colons not commas for @item entries.
+
+@item Pedro Kroeger:
+Build meister
+
+@item Graham Percival:
+@uref{http://percival-music.ca},
+Bug meister, Grand Documentation Project leader
+
+@item Jürgen Reuter:
+@email{reuter_j@@web.de},
+@uref{http://www.juergen-reuter.de},
+Ancient notation
+
+@item Erik Sandberg:
+Bug meister
+
+@end itemize
+@end macro
+
+
+@c  *****************  current contributors
+
+@macro coreCurrent
+
+@c use commas not colons
+
+Frédéric Bron,
+Hajo Dezelski,
+Andrew Hawryluk,
+Ian Hulin,
+Michael Käppler,
+Marek Klein,
+Kieren MacMillan,
+Andrew Wilson
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro fontCurrent
+
+@c use commas not colons
+
+@c ** nobody listed yet
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro docCurrent
+
+@c use commas not colons
+
+James Lowe,
+Ralph Palmer,
+Patrick Schmidt
+
+@c no comma for last entry
+
+@end macro
+
+
+@macro supportCurrent
+
+@c use commas not colons
+
+James E. Bailey,
+Christian Hitz
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro translationsCurrent
+
+@c use commas not colons
+
+Jean-Charles Malahieude,
+@c @email{lolyfan@@wanadoo.fr},
+Till Rettig,
+Yoshiki Sawada
+
+@c no comma for last entry
+
+@end macro
+
+
+@c  *****************  previous contributors
+
+@macro corePrevious
+
+@c use commas not colons
+
+Erlend Aasland,
+Maximilian Albert,
+Guido Amoruso,
+Kristof Bastiaensen,
+Pal Benko,
+@c @email{benkop@@freestart.hu},
+Juliusz Chroboczek,
+@c @email{jch@@pps.jussieu.fr},
+Angelo Contardi,
+David Feuer,
+@c @email{david.feuer@@gmail.com},
+Bertalan Fodor,
+Mathieu Giraud,
+Yuval Harel,
+Bernard Hurley,
+@c @email{bernard@@fong-hurley.org.uk},
+Yoshinobu Ishizaki,
+Chris Jackson,
+@c @email{chris@@fluffhouse.org.uk},
+David Jedlinsky,
+Heikki Junes,
+@c @email{heikki.junes@@hut.fi},
+Michael Krause,
+@c @email{m.krause@@tu-harburg.de},
+Jean-Baptiste Lamy,
+@c @email{jiba@@tuxfamily.org},
+Jonatan Liljedahl,
+Peter Lutek,
+Hendrik Maryns,
+Joe Neeman,
+@c @email{joeneeman@@gmail.com},
+Matthias Neeracher,
+Tatsuya Ono,
+Lisa Opus Goldstein,
+Guy Gascoigne-Piggford,
+Stan Sanderson,
+Edward Sanford Sutton,
+Andreas Scherer,
+Johannes Schindelin,
+Kim Shrier,
+Vicente Solsona Della,
+David Svoboda,
+Sebastiano Vigna,
+Arno Waschk,
+Michael Welsh Duggan,
+John Williams,
+Milan Zamazal,
+Rune Zedeler
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro fontPrevious
+
+@c use commas not colons
+
+Tom Cato Amundsen,
+@c @email{tca@@gnu.org},
+Chris Jackson,
+@c @email{chris@@fluffhouse.org.uk},
+Arno Waschk,
+@c @email{arno@@arnowaschk.de},
+Rune Zedeler
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro docPrevious
+
+@c use commas not colons
+
+Erlend Aasland,
+Trevor Bača,
+Alard de Boer,
+Jay Hamilton,
+Andrew Hawryluk,
+Joseph Harfouch,
+Cameron Horsburgh,
+Geoff Horton,
+Ian Hulin,
+Heikki Junes,
+@c @email{heikki.junes@@hut.fi},
+Kurtis Kroon,
+Dave Luttinen,
+Kieren MacMillan,
+Christian Mondrup,
+@c @email{scancm@@biobase.dk},
+Eyolf Østrem,
+Ralph Palmer,
+François Pinard,
+@c @email{pinard@@iro.umontreal.ca},
+@c @uref{http://pinard.progiciels-bpi.ca/},
+Eduardo Vieira,
+Michael Rasmussen,
+Till Rettig,
+Carl D. Sorensen,
+Anh Hai Trinh,
+Rune Zedeler
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro supportPrevious
+
+@c use commas not colons
+
+Anthony Fok,
+@c @email{foka@@debian.org},
+Chris Jackson,
+@c @email{chris@@fluffhouse.org.uk},
+Heikki Junes,
+@c @email{heikki.junes@@hut.fi},
+David Svoboda
+@c @email{svoboda@@cmu.edu}
+
+@c no comma for last entry
+
+@end macro
+
+
+
+@macro translationsPrevious
+
+@c use commas not colons
+
+Frédéric Chiasson,
+Abel Cheung,
+Alard de Boer,
+Simon Dahlbacka,
+Orm Finnendahl,
+David González,
+Nicolas Grandclaude,
+@c @email{ngclaude@@123mail.org},
+Damien Heurtebise,
+Matthieu Jacquot,
+Bjoern Jacke,
+@c @email{bjoern.jacke@@gmx.de},
+Neil Jerram,
+@c @email{nj104@@cus.cam.ac.uk},
+Heikki Junes,
+@c @email{heikki.junes@@hut.fi},
+Nicolas Klutchnikoff,
+Jean-Charles Malahieude,
+@c @email{lolyfan@@wanadoo.fr},
+Adrian Mariano,
+Christian Mondrup,
+Tineke de Munnik,
+@c @email{tdm@@dds.nl},
+Steven Michael Murphy,
+François Pinard,
+Gauvain Pocentek,
+@c @email{gauvainpocentek@@yahoo.fr},
+Till Rettig,
+Ludovic Sardain,
+@c @email{ludovicsardain@@gmail.com},
+Yoshiki Sawada,
+Thomas Scharkowski,
+Clytie Siddall,
+August S. Sigov,
+@c @email{august@@infran.ru},
+Roland Stigge,
+Risto Vääräniemi,
+Andrea Valle,
+Olcay Yıldırım
+
+@c no comma for last entry
+
+@end macro
+
+
diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi
new file mode 100644 (file)
index 0000000..9a47a9e
--- /dev/null
@@ -0,0 +1,609 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+
+
+@c DO NOT TRANSLATE THIS FILE
+
+@c include any node/sections from the higher-level *texi file.
+@c   @n ode Compiling from source
+@c   @s ection Compiling from source
+
+@menu
+* Downloading source code::
+* Requirements::
+* Building LilyPond::
+* Building documentation::
+* Testing LilyPond::
+* Problems::
+@end menu
+
+@node Downloading source code
+@subsection Downloading source code
+
+Download source
+
+@itemize
+@item tarballs from
+@uref{http://lilypond.org/download/} by HTTP.
+@item tarballs from
+@uref{http://download.linuxaudio.org/lilypond/} by HTTP.
+@item
+GIT from @uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=summary,git.sv.gnu.org}
+
+@example
+git clone git://git.sv.gnu.org/lilypond.git
+@end example
+
+The repository does not contain generated files.  To create
+@file{configure}, run
+@example
+./autogen.sh
+@end example
+@end itemize
+
+For information on packaging, see @uref{http://lilypond.org/devel}.
+
+
+@node Requirements
+@subsection Requirements
+
+@unnumberedsubsubsec Compilation
+
+In addition to the packages needed for running LilyPond (see below), you
+need the following extra packages for building.
+
+Below is a full list of packages needed to build LilyPond.  However, for
+most common distributions there is an easy way of installing most all
+build dependencies in one go
+
+@multitable @columnfractions .5 .5
+@headitem Distribution
+@tab Command
+
+@item Debian, Ubuntu
+@tab @code{sudo apt-get build-dep lilypond}
+
+@item Fedora, RHEL
+@tab @code{sudo yum-builddep lilypond}
+
+@item openSUSE, SLED
+@c sorry for the idiosyncratic command, I really asked and argued
+@c for "zypper build-dep" :-(
+@tab @code{sudo zypper --build-deps-only source-install lilypond}
+
+@end multitable
+
+When installing a binary package FOO, you may need to install the
+FOO-devel, libFOO-dev or FOO-dev package too.
+
+@itemize
+
+@item @uref{http://fontforge.sf.net/,FontForge} 20060125 or newer.
+
+@item @uref{http://metafont.tutorial.free.fr/,MetaFont} (mf-nowin, mf, mfw or
+mfont binaries) and @uref{http://cm.bell-labs.com/who/hobby/MetaPost.html,MetaPost}
+(mpost binary), usually packaged with a @LaTeX{} distribution like
+tetex or texlive.
+
+@item @uref{http://www.lcdf.org/~eddietwo/type/#t1utils,t1utils}
+(version 1.33 or newer recommended).
+
+@item New Century Schoolbook fonts, as PFB files.  These are shipped with
+X11 and Ghostscript, and are named @file{c059033l.pfb}
+@file{c059036l.pfb}, @file{c059013l.pfb} and @file{c059016l.pfb}.
+
+@item @uref{http://www.gnu.org/software/guile/guile.html,GUILE} (version
+1.8.2 or newer).  If you are installing binary packages, you may need to
+install guile-devel or guile-dev or libguile-dev too.
+
+@item @uref{ftp://ftp.gnu.org/gnu/texinfo/,Texinfo} (version 4.11 or newer).
+
+@item @uref{http://gcc.gnu.org/, The GNU c++ compiler} (version 3.4 or
+newer.  4.x is strongly recommended).
+
+@item @uref{http://www.python.org,Python} (version 2.4 or newer)
+
+@item @uref{ftp://ftp.gnu.org/gnu/make/,GNU Make} (version 3.78 or newer).
+
+@item @uref{http://www.gnu.org/software/gettext/gettext.html,gettext}
+(version 0.17 or newer).
+
+@item @uref{http://www.gnu.org/software/flex/,Flex}.
+
+@item @uref{http://www.perl.org/,Perl}.
+
+@item @uref{http://www.gnu.org/software/bison/,GNU Bison}.
+
+@item All packages required for running, including development packages with
+header files and libraries.
+
+@end itemize
+
+
+@unnumberedsubsubsec Running requirements
+
+Running LilyPond requires proper installation of the following software
+
+@itemize
+
+@item @uref{http://www.freetype.org/,Freetype} (version 2.1.10 or newer).
+@item @uref{http://fontconfig.org/,FontConfig} (version 2.2 or newer).
+@item @uref{http://www.pango.org/,Pango} (version 1.12 or newer).
+@item @uref{http://www.gnu.org/software/guile/guile.html,GUILE}
+(version 1.8.2 or newer)
+@item @uref{http://www.python.org,Python} (version 2.4 or newer).
+@item @uref{http://www.ghostscript.com,Ghostscript} (version 8.60 or
+newer).
+@item Dejaview.  (This is normally installed by default)
+@end itemize
+
+International fonts are required to create music with international text
+or lyrics.
+
+
+@unnumberedsubsubsec Requirements for building documentation
+
+You can view the documentation online at
+@uref{http://lilypond.org/doc/}, but you can also build it locally.
+This process requires a successful compile of LilyPond, and some
+additional tools and packages:
+
+@itemize
+@item The @uref{http://netpbm.sourceforge.net/,netpbm utilities}
+@item ImageMagick
+@item International fonts (see input/regression/utf-8.ly for hints
+about which font packages are necessary for your platform)
+@item Ghostscript 8.60 or newer
+@item @uref{http://www.nongnu.org/texi2html/,Texi2HTML} 1.82
+@item rsync
+@end itemize
+
+
+@node Building LilyPond
+@subsection Building LilyPond
+
+@unnumberedsubsubsec Compiling
+
+To install GNU LilyPond, type
+
+@example
+gunzip -c lilypond-x.y.z | tar xf -
+cd lilypond-x.y.z
+./configure            # run with --help for applicable options
+make
+su -c 'make install'
+@end example
+
+@noindent
+If you are not root, you should choose a @code{--prefix} argument that
+points into your home directory, e.g.
+
+@example
+./configure --prefix=$HOME/usr
+@end example
+
+If you encounter any problems, please see @ref{Problems}.
+
+
+@unnumberedsubsubsec Compiling for multiple platforms
+
+If you want to build multiple versions of LilyPond with different
+configuration settings, you can use the @code{--enable-config=CONF}
+option of @command{configure}.  You should use @code{make conf=CONF}
+to generate the output in @file{out-CONF}.  For example, suppose you
+want to build with and without profiling, then use the following for
+the normal build
+
+@example
+./configure --prefix=$HOME/usr/ --enable-checking
+make
+make install
+@end example
+
+and for the profiling version, specify a different configuration
+
+@example
+./configure --prefix=$HOME/usr/ --enable-profiling --enable-config=prof --disable-checking
+make conf=prof
+make conf=prof install
+@end example
+
+
+@unnumberedsubsubsec Compiling outside the source tree
+
+It is possible to compile LilyPond in a build tree different from the
+source tree, with @code{--srcdir} option of @command{configure}:
+
+@example
+mkdir lily-build && cd lily-build
+@var{sourcedir}/configure --srcdir=@var{sourcedir}
+
+@end example
+
+
+@unnumberedsubsubsec Useful @command{make} variables
+
+If a less verbose build output if desired, the variable
+@code{QUIET_BUILD} may be set to @code{1} on @command{make} command
+line, or in @file{local.make} at top of the build tree.
+
+
+@node Building documentation
+@subsection Building documentation
+
+This requires a successful compile of LilyPond, or using an external
+LilyPond binary.
+
+@menu
+* Commands for building documentation:: Compiling and installing the documentation.
+* Building documentation without compiling LilyPond:: Using a LilyPond binary already installed.
+@end menu
+
+@node Commands for building documentation
+@unnumberedsubsubsec Commands for building documentation
+
+The documentation is built by issuing
+
+@example
+make doc
+@end example
+
+After compilation, the HTML documentation tree is available in
+@file{out-www/offline-root/}, and can be browsed locally.  Various
+portions of the documentation can be found by looking in
+@file{out/} and @file{out-www} subdirectories in other places in
+the source tree, but these are only @emph{portions} of the docs.
+Please do not complain about anything which is broken in those
+places; the only complete set of documentation is in
+@file{out-www/offline-root/} from the top of the source tree.
+
+The HTML, PDF and if available Info files can be installed into the
+standard documentation path by issuing
+
+@example
+make install-doc
+@end example
+
+@noindent
+This also installs Info documentation with images if the installation
+prefix is properly set; otherwise, instructions to complete proper
+installation of Info documentation are printed on standard output.
+
+Compilation of documentation in Info format with images can be done
+separately by issuing
+
+@example
+make info
+@end example
+
+@noindent
+Separate installation of this documentation is done by issuing
+
+@example
+make install-info
+@end example
+
+@noindent
+Note that to get the images in Info documentation, @code{install-doc}
+target creates symbolic links to HTML and PDF installed documentation
+tree in @file{@var{prefix}/share/info}, in order to save disk space,
+whereas @code{install-info} copies images in
+@file{@var{prefix}/share/info} subdirectories.
+
+It is possible to build a documentation tree in
+@file{out-www/online-root/}, with special processing, so it can be
+used on a website with content negotiation for automatic language
+selection; this can be achieved by issuing
+
+@example
+make WEB_TARGETS=online doc
+@end example
+
+@noindent
+and both @q{offline} and @q{online} targets can be generated by issuing
+
+@example
+make WEB_TARGETS="offline online" doc
+@end example
+
+Several targets are available to clean the documentation build and
+help with maintaining documentation; an overview of these targets is
+available with
+
+@example
+make help
+@end example
+
+@noindent
+from every directory in the build tree.  Most targets for
+documentation maintenance are available from @file{Documentation/};
+@c FIXME: xref to CG
+for more information, see the Contributor's Guide, section
+@emph{Documentation work}.
+
+The makefile variable @code{QUIET_BUILD} may be set to @code{1} for a
+less verbose build output, just like for building the programs.
+
+
+@knownissues
+
+The most time consuming task for building the documentation is running
+LilyPond to build images of music, and there cannot be several
+simultaneously running @command{lilypond-book} instances, so @code{-j}
+@command{make} option does not significantly speed up the build process.
+To help speed it up, the makefile variable @var{CPU_COUNT} may be set
+in @file{local.make} or on the command line to the number of
+@code{.ly} files that LilyPond should process simultaneously, e.g. on
+a bi-processor or dual core machine
+
+@example
+make -j3 CPU_COUNT=3 doc
+@end example
+
+@noindent
+The recommended value of @var{CPU_COUNT} is one plus the number of
+cores or processors, but it is advisable to set it to a smaller value
+if your system has not enough RAM to run that many simultaneous
+LilyPond instances.
+
+If source files have changed since last documentation build, output
+files that need to be rebuilt are normally rebuilt, even if you do not
+run @code{make doc-clean} first.  However, building dependencies in the
+documentation are so complex that rebuilding of some targets may not
+be triggered as they should be; a workaround is to force rebuilding
+by touching appropriate files, e.g.
+
+@example
+touch Documentation/extend.texi
+touch Documentation/*te??
+touch Documentation/snippets/*.te??
+@end example
+
+
+@node Building documentation without compiling LilyPond
+@unnumberedsubsubsec Building documentation without compiling LilyPond
+
+The documentation can be built locally without compiling LilyPond
+binary, if LilyPond is already installed on your system.
+
+From a fresh Git checkout, do
+
+@example
+./autogen.sh   # ignore any warning messages
+cp GNUmakefile.in GNUmakefile
+make -C scripts && make -C python
+nice make LILYPOND_EXTERNAL_BINARY=/path/to/bin/lilypond doc
+@end example
+
+Please note that this may break sometimes -- for example, if a new
+feature is added with a test file in input/regression, even the latest
+development release of LilyPond will fail to build the docs.
+
+You may build the manual without building all the @file{input/*} stuff
+(i.e. mostly regression tests): change directory, for example to
+@file{Documentation/}, issue @code{make doc}, which will build
+documentation in a subdirectory @file{out-www} from the source files in
+current directory.  In this case, if you also want to browse the
+documentation in its post-processed form, change back to top directory
+and issue
+
+@example
+make out=www WWW-post
+@end example
+
+@knownissues
+
+You may also need to create a script for @command{pngtopnm} and
+@code{pnmtopng}.  On GNU/Linux, I use this:
+
+@verbatim
+export LD_LIBRARY_PATH=/usr/lib
+exec /usr/bin/pngtopnm "$@"
+@end verbatim
+
+On MacOS X with fink, I use this:
+
+@verbatim
+export DYLD_LIBRARY_PATH=/sw/lib
+exec /sw/bin/pngtopnm "$@"
+@end verbatim
+
+On MacOS X with macports, you should use this:
+
+@verbatim
+export DYLD_LIBRARY_PATH=/opt/local/lib
+exec /opt/local/bin/pngtopnm "$@"
+@end verbatim
+
+
+
+@node Testing LilyPond
+@subsection Testing LilyPond
+
+@html
+<a name="testing"></a>
+@end html
+
+LilyPond comes with an extensive suite that exercises the entire
+program.  This suite can be used to automatically check the impact of a
+change.  This is done as follows
+
+@example
+make test-baseline
+@emph{## apply your changes, compile}
+make check
+@end example
+
+This will leave an HTML page @file{out/test-results/index.html}.  This
+page shows all the important differences that your change introduced,
+whether in the layout, MIDI, performance or error reporting.
+
+To rerun tests, use
+
+@example
+make test-redo           @emph{## redo files differing from baseline}
+make test-clean          @emph{## remove all test results}
+@end example
+
+@noindent
+and then run @code{make check} again.
+
+For tracking memory usage as part of this test, you will need GUILE
+CVS; especially the following patch:
+@uref{http://lilypond.org/vc/gub.darcs/patches/guile-1.9-gcstats.patch}.
+
+For checking the coverage of the test suite, do the following
+
+@example
+./scripts/auxiliar/build-coverage.sh
+@emph{# uncovered files, least covered first}
+./scripts/auxiliar/coverage.py  --summary out-cov/*.cc
+@emph{# consecutive uncovered lines, longest first}
+./scripts/auxiliar/coverage.py  --uncovered out-cov/*.cc
+@end example
+
+
+@node Problems
+@subsection Problems
+
+For help and questions use @email{lilypond-user@@gnu.org}.  Send
+bug reports to @email{bug-lilypond@@gnu.org}.
+
+Bugs that are not fault of LilyPond are documented here.
+
+@unnumberedsubsubsec Bison 1.875
+
+There is a bug in bison-1.875: compilation fails with "parse error
+before `goto'" in line 4922 due to a bug in bison.  To fix, please
+recompile bison 1.875 with the following fix
+
+@example
+$ cd lily; make out/parser.cc
+$ vi +4919 out/parser.cc
+# append a semicolon to the line containing "__attribute__ ((__unused__))
+# save
+$ make
+@end example
+
+
+@unnumberedsubsubsec Compiling on MacOS@tie{}X
+
+Here are special instructions for compiling under MacOS@tie{}X.
+These instructions assume that dependencies are installed using
+@uref{http://www.macports.org/, MacPorts.} The instructions have
+been tested using OS X 10.5 (Leopard).
+
+First, install the relevant dependencies using MacPorts.
+
+Next, add the following to your relevant shell initialization
+files. This is @code{~/.profile} by default. You should create
+this file if it does not exist.
+
+@example
+export PATH=/opt/local/bin:/opt/local/sbin:$PATH
+export DYLD_LIBRARY_PATH=/System/Library/Frameworks/ApplicationServices.framework/Versions/A/Frameworks/ImageIO.framework/Versions/A/Resources:\
+/opt/local/lib:$DYLD_LIBRARY_PATH
+@end example
+
+Now you must edit the generated @code{config.make} file.  Change
+
+@example
+FLEXLEXER_FILE = /usr/include/FlexLexer.h
+@end example
+
+@noindent
+to:
+
+@example
+FLEXLEXER_FILE = /opt/local/include/FlexLexer.h
+@end example
+
+At this point, you should verify that you have the appropriate
+fonts installed with your ghostscript installation. Check @code{ls
+/opt/local/share/ghostscript/fonts} for: 'c0590*' files (.pfb,
+.pfb and .afm).  If you don't have them, run the following
+commands to grab them from the ghostscript SVN server and install
+them in the appropriate location:
+
+@example
+svn export http://svn.ghostscript.com/ghostscript/tags/urw-fonts-1.0.7pre44/
+sudo mv urw-fonts-1.0.7pre44/* /opt/local/share/ghostscript/fonts/
+rm -rf urw-fonts-1.07pre44
+@end example
+
+Now run the @code{./configure} script. To avoid complications with
+automatic font detection, add
+
+@example
+--with-ncsb-dir=/opt/local/share/ghostscript/fonts
+@end example
+
+
+@unnumberedsubsubsec Solaris
+
+Solaris7, ./configure
+
+@file{./configure} needs a POSIX compliant shell.  On Solaris7,
+@file{/bin/sh} is not yet POSIX compliant, but @file{/bin/ksh} or bash
+is.  Run configure like
+
+@example
+CONFIG_SHELL=/bin/ksh ksh -c ./configure
+@end example
+
+@noindent
+or
+
+@example
+CONFIG_SHELL=/bin/bash bash -c ./configure
+@end example
+
+@unnumberedsubsubsec FreeBSD
+
+To use system fonts, dejaview must be installed.  With the default
+port, the fonts are installed in @file{usr/X11R6/lib/X11/fonts/dejavu}.
+
+Open the file @file{$LILYPONDBASE/usr/etc/fonts/local.conf} and add the
+following line just after the @code{<fontconfig>} line.  (Adjust as necessary
+for your hierarchy.)
+
+@example
+<dir>/usr/X11R6/lib/X11/fonts</dir>
+@end example
+
+
+@unnumberedsubsubsec International fonts
+
+On Mac OS X, all fonts are installed by default.  However, finding all
+system fonts requires a bit of configuration; see
+@uref{http://lists.gnu.org/archive/html/lilypond-user/2007-03/msg00472.html,
+this post} on the @code{lilypond-user} mailing list.
+
+On Linux, international fonts are installed by different means on
+every distribution.  We cannot list the exact commands or packages
+that are necessary, as each distribution is different, and the exact
+package names within each distribution changes.  Here are some
+hints, though:
+
+@verbatim
+Red Hat Fedora
+
+    taipeifonts fonts-xorg-truetype ttfonts-ja fonts-arabic \
+         ttfonts-zh_CN fonts-ja fonts-hebrew
+
+Debian GNU/Linux
+
+   apt-get install emacs-intl-fonts xfonts-intl-.* \
+        ttf-kochi-gothic ttf-kochi-mincho \
+        xfonts-bolkhov-75dpi xfonts-cronyx-100dpi xfonts-cronyx-75dpi
+@end verbatim
+
+
+@unnumberedsubsubsec Using lilypond python libraries
+
+If you want to use lilypond's python libraries (either running
+certain build scripts manually, or using them in other programs),
+set @code{PYTHONPATH} to @file{python/out} in your build
+directory, or @file{.../usr/lib/lilypond/current/python} in the
+installation directory structure.
+
+
index 6591677da0d12634f48d58d98250204b09b64723..069dcd4699ed9854bfccd47be0bd20e00d06b1f2 100644 (file)
@@ -11,7 +11,7 @@
 @contents
 
 @include macros.itexi
-@include web/basic-authors.itexi
+@include included/authors.itexi
 
 
 This file lists authors of LilyPond, and what they wrote.  This list
index 79a9b4e97f693971bbe899115b188d1bce9adf09..47f0a7070361123d6db15700fcef074960b3b2c8 100644 (file)
@@ -13,7 +13,7 @@
 @contents
 
 @include macros.itexi
-@include contributor/basic-compile.itexi
+@include included/compile.itexi
 
 @bye
 
diff --git a/Documentation/web/basic-authors.itexi b/Documentation/web/basic-authors.itexi
deleted file mode 100644 (file)
index 17d1767..0000000
+++ /dev/null
@@ -1,387 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of community.itexi and ../topdocs/AUTHORS.itexi
-
-@ignore
-
-  This file lists authors of LilyPond, and what they wrote.  Each
-  list is sorted alphabetically by surname.  This file lists people
-  that have contributed more than a few hours of work.
-
-  Developers are people who are (or have been) listed under the
-  "Development Team" in the THANKS, and can choose their own
-  titles.  Contributors are everybody else, and simply list their
-  contributions.  All lists are sorted alphabetically.
-
-  Anybody who has finished doing a "main devel team" task should
-  list it under developersPrevious, even if they're still doing
-  other "main devel team" stuff.  See "Graham Percival" for an
-  example.
-
-  Contributors are also split between Current and Previous, and
-  each category contains:
-    core...     (programming)
-    font...     (duh)
-    doc...      (documentation and examples)
-    support...  (building, distributions, editors,
-                 lilypond-book, LSR, but *not* answering emails)
-    translations... (duh)
-  We might add a "general" or "other" if there's something else.
-
-@end ignore
-
-
-@macro developersCurrent
-
-@itemize
-
-@item Mats Bengtsson:
-@email{mats.bengtsson@@ee.kth.se},
-@uref{http://www.s3.kth.se/~mabe/},
-Support guru
-
-@item Trevor Daniels:
-Assistant documentation editor
-
-@item Reinhold Kainhofer:
-@email{reinhold@@kainhofer.com},
-@uref{http://reinhold.kainhofer.com},
-Music2xml wrangler, bug squasher
-
-@item Jonathan Kulp:
-Assistant documentation editor
-
-@item Werner Lemberg,
-@email{wl@@gnu.org},
-Fonts, bug squasher
-
-@item John Mandereau:
-@email{john.mandereau@@free.fr},
-Translation meister
-
-@item Patrick McCarty:
-SVG guru, bug squasher, text handling
-
-@item Joe Neeman:
-Core developer
-
-@item Han-Wen Nienhuys:
-@email{hanwen@@xs4all.nl},
-@uref{http://www.xs4all.nl/~hanwen/},
-Main author
-
-@item Jan Nieuwenhuizen:
-@email{janneke@@gnu.org},
-@uref{http://www.xs4all.nl/~jantien/},
-Main author
-
-@item Graham Percival:
-@uref{http://percival-music.ca},
-Project manager, Documentation Editor
-
-@item Mark Polesky:
-Assistant documentation editor, Code cleanup
-
-@item Neil Puttock:
-Core developer
-
-@item Nicolas Sceaux:
-Core developer, Schemer extraordinaire
-
-@item Carl Sorensen:
-@email{c_sorensen@@byu.edu},
-Core developer, Frog meister
-
-@item Francisco Vila:
-Translations
-
-@item Valentin Villenave:
-LSR editor and Bug meister
-
-@end itemize
-@end macro
-
-
-
-@macro developersPrevious
-
-@itemize
-
-@c use colons not commas for @item entries.
-
-@item Pedro Kroeger:
-Build meister
-
-@item Graham Percival:
-@uref{http://percival-music.ca},
-Bug meister, Grand Documentation Project leader
-
-@item Jürgen Reuter:
-@email{reuter_j@@web.de},
-@uref{http://www.juergen-reuter.de},
-Ancient notation
-
-@item Erik Sandberg:
-Bug meister
-
-@end itemize
-@end macro
-
-
-@c  *****************  current contributors
-
-@macro coreCurrent
-
-@c use commas not colons
-
-Frédéric Bron,
-Hajo Dezelski,
-Andrew Hawryluk,
-Ian Hulin,
-Michael Käppler,
-Marek Klein,
-Kieren MacMillan,
-Andrew Wilson
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro fontCurrent
-
-@c use commas not colons
-
-@c ** nobody listed yet
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro docCurrent
-
-@c use commas not colons
-
-James Lowe,
-Ralph Palmer,
-Patrick Schmidt
-
-@c no comma for last entry
-
-@end macro
-
-
-@macro supportCurrent
-
-@c use commas not colons
-
-James E. Bailey,
-Christian Hitz
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro translationsCurrent
-
-@c use commas not colons
-
-Jean-Charles Malahieude,
-@c @email{lolyfan@@wanadoo.fr},
-Till Rettig,
-Yoshiki Sawada
-
-@c no comma for last entry
-
-@end macro
-
-
-@c  *****************  previous contributors
-
-@macro corePrevious
-
-@c use commas not colons
-
-Erlend Aasland,
-Maximilian Albert,
-Guido Amoruso,
-Kristof Bastiaensen,
-Pal Benko,
-@c @email{benkop@@freestart.hu},
-Juliusz Chroboczek,
-@c @email{jch@@pps.jussieu.fr},
-Angelo Contardi,
-David Feuer,
-@c @email{david.feuer@@gmail.com},
-Bertalan Fodor,
-Mathieu Giraud,
-Yuval Harel,
-Bernard Hurley,
-@c @email{bernard@@fong-hurley.org.uk},
-Yoshinobu Ishizaki,
-Chris Jackson,
-@c @email{chris@@fluffhouse.org.uk},
-David Jedlinsky,
-Heikki Junes,
-@c @email{heikki.junes@@hut.fi},
-Michael Krause,
-@c @email{m.krause@@tu-harburg.de},
-Jean-Baptiste Lamy,
-@c @email{jiba@@tuxfamily.org},
-Jonatan Liljedahl,
-Peter Lutek,
-Hendrik Maryns,
-Joe Neeman,
-@c @email{joeneeman@@gmail.com},
-Matthias Neeracher,
-Tatsuya Ono,
-Lisa Opus Goldstein,
-Guy Gascoigne-Piggford,
-Stan Sanderson,
-Edward Sanford Sutton,
-Andreas Scherer,
-Johannes Schindelin,
-Kim Shrier,
-Vicente Solsona Della,
-David Svoboda,
-Sebastiano Vigna,
-Arno Waschk,
-Michael Welsh Duggan,
-John Williams,
-Milan Zamazal,
-Rune Zedeler
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro fontPrevious
-
-@c use commas not colons
-
-Tom Cato Amundsen,
-@c @email{tca@@gnu.org},
-Chris Jackson,
-@c @email{chris@@fluffhouse.org.uk},
-Arno Waschk,
-@c @email{arno@@arnowaschk.de},
-Rune Zedeler
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro docPrevious
-
-@c use commas not colons
-
-Erlend Aasland,
-Trevor Bača,
-Alard de Boer,
-Jay Hamilton,
-Andrew Hawryluk,
-Joseph Harfouch,
-Cameron Horsburgh,
-Geoff Horton,
-Ian Hulin,
-Heikki Junes,
-@c @email{heikki.junes@@hut.fi},
-Kurtis Kroon,
-Dave Luttinen,
-Kieren MacMillan,
-Christian Mondrup,
-@c @email{scancm@@biobase.dk},
-Eyolf Østrem,
-Ralph Palmer,
-François Pinard,
-@c @email{pinard@@iro.umontreal.ca},
-@c @uref{http://pinard.progiciels-bpi.ca/},
-Eduardo Vieira,
-Michael Rasmussen,
-Till Rettig,
-Carl D. Sorensen,
-Anh Hai Trinh,
-Rune Zedeler
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro supportPrevious
-
-@c use commas not colons
-
-Anthony Fok,
-@c @email{foka@@debian.org},
-Chris Jackson,
-@c @email{chris@@fluffhouse.org.uk},
-Heikki Junes,
-@c @email{heikki.junes@@hut.fi},
-David Svoboda
-@c @email{svoboda@@cmu.edu}
-
-@c no comma for last entry
-
-@end macro
-
-
-
-@macro translationsPrevious
-
-@c use commas not colons
-
-Frédéric Chiasson,
-Abel Cheung,
-Alard de Boer,
-Simon Dahlbacka,
-Orm Finnendahl,
-David González,
-Nicolas Grandclaude,
-@c @email{ngclaude@@123mail.org},
-Damien Heurtebise,
-Matthieu Jacquot,
-Bjoern Jacke,
-@c @email{bjoern.jacke@@gmx.de},
-Neil Jerram,
-@c @email{nj104@@cus.cam.ac.uk},
-Heikki Junes,
-@c @email{heikki.junes@@hut.fi},
-Nicolas Klutchnikoff,
-Jean-Charles Malahieude,
-@c @email{lolyfan@@wanadoo.fr},
-Adrian Mariano,
-Christian Mondrup,
-Tineke de Munnik,
-@c @email{tdm@@dds.nl},
-Steven Michael Murphy,
-François Pinard,
-Gauvain Pocentek,
-@c @email{gauvainpocentek@@yahoo.fr},
-Till Rettig,
-Ludovic Sardain,
-@c @email{ludovicsardain@@gmail.com},
-Yoshiki Sawada,
-Thomas Scharkowski,
-Clytie Siddall,
-August S. Sigov,
-@c @email{august@@infran.ru},
-Roland Stigge,
-Risto Vääräniemi,
-Andrea Valle,
-Olcay Yıldırım
-
-@c no comma for last entry
-
-@end macro
-
-
index 8eeb2ce46ddff27510f8b93d2932bd7db6ff35a0..62448a7cec37d421a336a839255983095d49f78a 100644 (file)
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@include web/basic-authors.itexi
+@include included/authors.itexi
 
 @node Community
 @unnumbered Community