X-Git-Url: https://git.donarmstrong.com/?p=lilypond.git;a=blobdiff_plain;f=ROADMAP;h=2bf571f72d92f725e2bf36ffbab9d3eca1cdd166;hp=4ec2eec4bd5e19185fc4bef1c29e94e059a59637;hb=HEAD;hpb=a6a4b3fc2009f17a1a48cca0c11bfd3f38645937

diff --git a/ROADMAP b/ROADMAP
index 4ec2eec4bd..2bf571f72d 100644
--- a/ROADMAP
+++ b/ROADMAP
@@ -1,48 +1,114 @@
 Prebuilt Documentation and packages are available from:
 
-    http://lilypond.org
+    http://www.lilypond.org
 
 LilyPond development is hosted at:
 
     http://savannah.gnu.org/projects/lilypond
 
-Here is a simple explanation of the directory layout for LilyPond's
-source files.
+Here is a simple explanation of the directory layout for
+LilyPond's source files.
 
-   .                    Toplevel READMEs, ChangeLog, build bootstrapping,
-                          patches for third party programs
-   Documentation/
-       bibliography/    .bib files with references to books and articles
-       misc/            Old announcements, ChangeLogs and NEWS
-       pictures/        The logo
-       topdocs/         Sources for the toplevel READMEs
-                          (README.txt, INSTALL.txt, NEWS.txt etc.)
-       user/            User manuals
-       po/              Translated manual node names
-       fr/ es/ de/      Docs translated to French, Spanish, German, resp.
-   buildscripts/        Scripts for the build process
-   elisp/               Emacs LilyPond mode and syntax coloring
-   flower/              A simple C++ library
-   input/               Music input examples
-       lsr/             Snippets from the LilyPond Snippet Repository
-                          (auto-generated, do not modify!)
-       manual/          Examples from the manual
-       mutopia/         Real music, more at www.mutopiaproject.org
-       new/             Snippets which are too new for LSR
-       regression/      Testing of features, one test per file
-       texidocs/        Translations of texidoc and doctitle fields
-                          (for input/lsr)
-       tutorial/        Examples from the tutorial 
-   lily/                C++ sources for the LilyPond binary
-   ly/                  System music include files
-   make/                Specific make subroutines and packaging for
-                          Red Hat-like distributions (.spec files)
-   mf/                  MetaFont sources for the Emmentaler and Aybabtu fonts
-   po/                  Translations for binaries and end-user scripts
-   ps/                  PostScript library files
-   python/              Python modules, MIDI module
-   scm/                 Scheme sources for LilyPond and subroutine files
-   scripts/             End-user scripts
-   stepmake/            Generic make subroutine files
-   tex/                 TeX and texinfo library files
-   vim/                 Vi(M) LilyPond mode and syntax coloring
+
+.                        Toplevel READMEs, ChangeLog,
+|                          build bootstrapping, patches
+|                          for third party programs
+|
+|-- Documentation/       Top sources for most of the manuals
+|   |
+|   |
+|   |   INDIVIDUAL CHAPTERS FOR EACH MANUAL:
+|   |     Note: "Snippets" and "Internals Reference" are
+|   |     auto-generated during the Documentation Build process.
+|   |
+|   |
+|   |-- contributor/     Contributor's Guide
+|   |-- essay/           Essay on automated music engraving
+|   |-- extending/       Extending the functionality of LilyPond
+|   |-- learning/        Learning Manual
+|   |-- notation/        Notation Reference
+|   |-- usage/           Runnning the programs that come with LilyPond
+|   |-- web/             The website
+|   |
+|   |
+|   |   TRANSLATED MANUALS:
+|   |     Each language's directory can contain...
+|   |       1) translated versions of:
+|   |          * top sources for manuals
+|   |          * individual chapters for each manual
+|   |       2) a texidocs/ directory for snippet translations
+|   |
+|   |-- ca/              Catalan
+|   |-- cs/              Czech
+|   |-- de/              German
+|   |-- es/              Spanish
+|   |-- fr/              French
+|   |-- hu/              Hungarian
+|   |-- it/              Italian
+|   |-- ja/              Japanese
+|   |-- nl/              Dutch
+|   |-- zh/              Chinese
+|   |
+|   |
+|   |   MISCELLANEOUS DOC STUFF:
+|   |
+|   |-- css/             CSS files for HTML docs
+|   |-- included/        .ly files used in the manuals
+|   |-- logo/            Web logo and "note" icon
+|   |-- ly-examples/     .ly files for the "Examples" webpage
+|   |-- misc/            Old announcements, ChangeLogs and NEWS
+|   |-- pictures/        Images used (eps/jpg/png/svg)
+|   |   `-- pdf/         (pdf)
+|   |-- po/              Translated build/maintenance scripts
+|   |-- snippets/        Auto-generated from the LSR and from ./new/
+|   |   `-- new/         Snippets too new for the LSR
+|   `-- topdocs/         AUTHORS, INSTALL, README
+|
+|
+|   C++ SOURCES:
+|
+|-- flower/              A simple C++ library
+|-- lily/                C++ sources for the LilyPond binary
+|
+|
+|   LIBRARIES:
+|
+|-- ly/                  .ly \include files
+|-- mf/                  MetaFont sources for Emmentaler fonts
+|-- ps/                  PostScript library files
+|-- scm/                 Scheme sources for LilyPond and subroutine files
+|-- tex/                 TeX and texinfo library files
+|
+|
+|   SCRIPTS:
+|
+|-- config/              Autoconf helpers for configure script
+|-- python/              Python modules, MIDI module
+|   `-- auxiliar/        Python modules for build/maintenance
+|-- scripts/             End-user scripts (--> lilypond/usr/bin/)
+|   |-- auxiliar/        Maintenance and non-essential build scripts
+|   `-- build/           Essential build scripts
+|
+|
+|   BUILD PROCESS:
+|   (also see SCRIPTS section above)
+|
+|-- make/                Specific make subroutine files
+|-- stepmake/            Generic make subroutine files
+|
+|
+|   REGRESSION TESTS:
+|
+|-- input/
+|   `-- regression/      .ly regression tests
+|       |-- abc2ly/      .abc regression tests
+|       |-- lilypond-book/  lilypond-book regression tests
+|       |-- midi/        midi2ly regression tests
+|       `-- musicxml/    .xml and .itexi regression tests
+|
+|
+|   MISCELLANEOUS:
+|
+|-- elisp/               Emacs LilyPond mode and syntax coloring
+|-- vim/                 Vi(M) LilyPond mode and syntax coloring
+`-- po/                  Translations for binaries and end-user scripts