]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.text
release: 0.1.24
[lilypond.git] / INSTALL.text
index 485136c65905b3a8c0c626645e0fbe16b3eb0787..fdf183ed07411c7202d313aa8597862f68d3b8bd 100644 (file)
@@ -25,9 +25,8 @@ A\bA\bA\bAB\bB\bB\bBS\bS\bS\bST\bT\bT\bTR\bR\bR\bRA\bA\bA\bAC\bC\bC\bCT\bT\bT\bT
 P\bP\bP\bPR\bR\bR\bRE\bE\bE\bER\bR\bR\bRE\bE\bE\bEQ\bQ\bQ\bQU\bU\bU\bUI\bI\bI\bIS\bS\bS\bSI\bI\bI\bIT\bT\bT\bTE\bE\bE\bES\bS\bS\bS
        For compilation you need.
 
-       +\bo    A Unix system with GNU tools. GNU LilyPond is known
-            to run on these unices: Linux, AIX, Digital Unix and
-            Solaris.
+       +\bo    A GNU system: GNU LilyPond is known to run on these
+            GNU systems: Linux, AIX, Digital Unix and Solaris.
 
             If you have the Cygnus WINDOWS32 port of the GNU
             utils, it will even work in Windows NT/95, but we
@@ -57,11 +56,12 @@ R\bR\bR\bRU\bU\bU\bUN\bN\bN\bNN\bN\bN\bNI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 
        ftp://ftp.shsu.edu/tex-archive/macros/musixtex/taupin
 
+       ftp://ftp.tex.ac.uk/tex-archive/macros/musixtex/taupin
 
 
 
 
-1/Aug/97                  LilyPond 0.1.0                        1
+20/Oct/97                LilyPond 0.1.24                        1
 
 
 
@@ -70,8 +70,6 @@ R\bR\bR\bRU\bU\bU\bUN\bN\bN\bNN\bN\bN\bNI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 INSTALL(1)            LilyPond documentation           INSTALL(1)
 
 
-       ftp://ftp.tex.ac.uk/tex-archive/macros/musixtex/taupin
-
        ftp://ftp.dante.de/tex-archive/macros/musixtex/taupin
 
                 You only need the contents of the _\bm_\bf_\b/
@@ -89,9 +87,12 @@ R\bR\bR\bRE\bE\bE\bEC\bC\bC\bCO\bO\bO\bOM\bM\bM\bMM\bM\bM\bME\bE\bE\bEN\bN\bN\bND\bD\bD\bDE\bE\bE\bED\bD\bD\bD
        Although not strictly necessary, these are recommended to
        have.
 
-       +\bo         Perl.  Most scripts are written in Perl. Most
-                 documentation was created with the perl's Plain
-                 Old Documentation.
+       +\bo         Perl-5.  Most documentation was created with the
+                 perl's Plain Old Documentation. (I use 5.003)
+
+       +\bo         Python.  Although perl is nice, python is
+                 better.  We will shift towards python for build
+                 scripts
 
        +\bo         GNU find
 
@@ -123,11 +124,10 @@ C\bC\bC\bCO\bO\bO\bON\bN\bN\bNF\bF\bF\bFI\bI\bI\bIG\bG\bG\bGU\bU\bU\bUR\bR\bR\bRI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG a\b
        d\bd\bd\bdi\bi\bi\bir\br\br\br. The above assumes that you are root and have the GNU
        development tools, and your make is GNU make.  If this is
        not the case, you can adjust your environment variables to
-       your taste:
 
 
 
-1/Aug/97                  LilyPond 0.1.0                        2
+20/Oct/97                LilyPond 0.1.24                        2
 
 
 
@@ -136,6 +136,8 @@ C\bC\bC\bCO\bO\bO\bON\bN\bN\bNF\bF\bF\bFI\bI\bI\bIG\bG\bG\bGU\bU\bU\bUR\bR\bR\bRI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG a\b
 INSTALL(1)            LilyPond documentation           INSTALL(1)
 
 
+       your taste:
+
                export CPPFLAGS="-I /home/me/my_include -DWEIRD_FOOBAR"
                configure
 
@@ -186,14 +188,12 @@ INSTALL(1)            LilyPond documentation           INSTALL(1)
                 subdir of tex-prefix)
 
        --enable-mf-dir
-                Set then directory mf input is in (idem)
-                [obsolete]
+                Set the directory mf input is in (idem)
 
-                All options are documented in the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be help
 
 
 
-1/Aug/97                  LilyPond 0.1.0                        3
+20/Oct/97                LilyPond 0.1.24                        3
 
 
 
@@ -202,6 +202,10 @@ INSTALL(1)            LilyPond documentation           INSTALL(1)
 INSTALL(1)            LilyPond documentation           INSTALL(1)
 
 
+       --enable-out-dir
+                Set the directory for machine generated output.
+
+                All options are documented in the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be help
                 The option -\b-\b-\b--\b-\b-\b-e\be\be\ben\bn\bn\bna\ba\ba\bab\bb\bb\bbl\bl\bl\ble\be\be\be-\b-\b-\b-o\bo\bo\bop\bp\bp\bpt\bt\bt\bti\bi\bi\bim\bm\bm\bmi\bi\bi\bis\bs\bs\bse\be\be\be is recommended for
                 Real Life usage.
 
@@ -214,6 +218,35 @@ INSTALL(1)            LilyPond documentation           INSTALL(1)
                 in the subdirectories _\bo_\bu_\bt_\b/ (which contain all
                 files generated during compilation).
 
+       B\bB\bB\bBu\bu\bu\bui\bi\bi\bil\bl\bl\bld\bd\bd\bdi\bi\bi\bin\bn\bn\bng\bg\bg\bg f\bf\bf\bfo\bo\bo\bor\br\br\br m\bm\bm\bmu\bu\bu\bul\bl\bl\blt\bt\bt\bti\bi\bi\bip\bp\bp\bpl\bl\bl\ble\be\be\be h\bh\bh\bho\bo\bo\bos\bs\bs\bst\bt\bt\bts\bs\bs\bs
+
+       LilyPond does not follow the GNU standards when it comes
+       to configuring and making Makefiles. In LilyPond, _\bm_\ba_\bk_\be
+       generates _\ba_\bl_\bl output in output directories (called _\bo_\bu_\bt_\b/,
+       by default).  You can have multiple compiles from the same
+       source-tree, by overriding the setting for the output
+       directory.
+
+       Example: on my system, I do debugging and lots compiling.
+       For this I use the configuration as follows:
+
+               configure --prefix=~ --enable-debugging --enable-printing --enable-checking
+               make all
+
+       and I want to do profiling. For that I use
+
+               configure --prefix=~ --enable-debugging --disable-printing\
+                       --disable-checking --enable-profiling --enable-optimise\
+                       --enable-out-dir=out-profile
+
+               make OUTDIR_NAME=out-profile all
+
+       These two commands build two entirely separate versions of
+       LilyPond. In Real Life, you would probably also want to
+       have two different prefixes. On my machine this is no
+       problem; I never do make install. My prefix dirs are
+       linked back to my source directory.
+
 I\bI\bI\bIN\bN\bN\bNS\bS\bS\bST\bT\bT\bTA\bA\bA\bAL\bL\bL\bLL\bL\bL\bLI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
        If you have done a successful make, then a simple
 
@@ -223,6 +256,18 @@ I\bI\bI\bIN\bN\bN\bNS\bS\bS\bST\bT\bT\bTA\bA\bA\bAL\bL\bL\bLL\bL\bL\bLI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 
        Install the musixtex fonts in a directory which TeX and MF
        knows (if you are root, look for a directory which
+
+
+
+20/Oct/97                LilyPond 0.1.24                        4
+
+
+
+
+
+INSTALL(1)            LilyPond documentation           INSTALL(1)
+
+
        contains the directories with AMS and CM source (*.mf)
        files. Create a subdir lilypond or musixtex and copy the
        fonts into that). Do not forget to rehash TeX (if
@@ -239,6 +284,9 @@ C\bC\bC\bCA\bA\bA\bAV\bV\bV\bVE\bE\bE\bEA\bA\bA\bAT\bT\bT\bTS\bS\bS\bS
                  Alpha in dstream.cc. You should turn off this
                  flag for this file.
 
+       +\bo         Perl5.003 and Perl5.004 use different syntax for
+                 pod2html:
+
 E\bE\bE\bEX\bX\bX\bXA\bA\bA\bAM\bM\bM\bMP\bP\bP\bPL\bL\bL\bLE\bE\bE\bE
        This is what I type in my xterm:
 
@@ -248,26 +296,6 @@ E\bE\bE\bEX\bX\bX\bXA\bA\bA\bAM\bM\bM\bMP\bP\bP\bPL\bL\bL\bLE\bE\bE\bE
 
        This is what the output looks like over here:
 
-
-
-
-
-
-
-
-
-
-
-
-1/Aug/97                  LilyPond 0.1.0                        4
-
-
-
-
-
-INSTALL(1)            LilyPond documentation           INSTALL(1)
-
-
                GNU LilyPond 0.0.78 #4/FlowerLib 1.1.24 #0
                Parsing ... [/home/hw/share/lilypond/init//
                        <..etc..>
@@ -293,17 +321,33 @@ R\bR\bR\bRE\bE\bE\bED\bD\bD\bDH\bH\bH\bHA\bA\bA\bAT\bT\bT\bT L\bL\bL\bLI\bI\bI\bIN\bN\bN\bNU\bU\bU\bUX\bX\bX\bX
        create the RPM as a normal user the permissions will not
        be set correctly, unfortunately)
 
-W\bW\bW\bWI\bI\bI\bIN\bN\bN\bND\bD\bD\bDO\bO\bO\bOZ\bZ\bZ\bZE\bE\bE\bE
-       Windows NT:
 
-       you need the cygnus windows32 gnu port development stuff;
-       have a look at http://www.cygnus.com/gnu-win32.
 
-       to make GNU LilyPond under, brr, aargh, shudder..
+
+
+20/Oct/97                LilyPond 0.1.24                        5
+
+
+
+
+
+INSTALL(1)            LilyPond documentation           INSTALL(1)
+
+
+D\bD\bD\bDE\bE\bE\bEB\bB\bB\bBI\bI\bI\bIA\bA\bA\bAN\bN\bN\bN G\bG\bG\bGN\bN\bN\bNU\bU\bU\bU/\b/\b/\b/L\bL\bL\bLI\bI\bI\bIN\bN\bN\bNU\bU\bU\bUX\bX\bX\bX
+       A Debian package is in the works
+
+W\bW\bW\bWI\bI\bI\bIN\bN\bN\bND\bD\bD\bDO\bO\bO\bOW\bW\bW\bWS\bS\bS\bS N\bN\bN\bNT\bT\bT\bT/\b/\b/\b/9\b9\b9\b95\b5\b5\b5
+       So, you're stuck with Windows, eh?  Well, don't worry, you
+       just need (to get) Cygnus' windows32 port of gnu
+       development stuff; have a look at
+       http://www.cygnus.com/gnu-win32.
+
+       To make GNU LilyPond under, brr, aargh, shudder...
        windows32, well, simply type:
 
                bash configure
-               make windows32
+               make
 
 
 A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bRS\bS\bS\bS
@@ -325,6 +369,28 @@ A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bRS\bS\bS\bS
 
 
 
-1/Aug/97                  LilyPond 0.1.0                        5
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+20/Oct/97                LilyPond 0.1.24                        6