]> git.donarmstrong.com Git - lilypond.git/commitdiff
* GNUmakefile.in: remove no kpathsea hack.
authorHan-Wen Nienhuys <hanwen@xs4all.nl>
Thu, 17 Jul 2003 21:49:43 +0000 (21:49 +0000)
committerHan-Wen Nienhuys <hanwen@xs4all.nl>
Thu, 17 Jul 2003 21:49:43 +0000 (21:49 +0000)
* Documentation/topdocs/INSTALL.texi (Top): remove web-doc from
doco.

* GNUmakefile.in: remove web-doc target.

* lily/all-font-metrics.cc (find_afm): add message about
buildscripts/clean-fonts.sh

* Documentation/user/refman.itely (Percussion staves): use
set-drum-kit

14 files changed:
ChangeLog
Documentation/topdocs/INSTALL.texi
Documentation/user/introduction.itely
Documentation/user/refman.itely
GNUmakefile.in
input/example-1.ly
input/example-2.ly
input/example-3.ly
lily/all-font-metrics.cc
make/lilypond-vars.make
make/lilypond.mandrake.spec.in
make/lilypond.redhat.spec.in
make/lilypond.suse.spec.in
stepmake/stepmake/www-targets.make

index 6b65895a48650ae326f899ee15a3e01761466d60..d9157147094598dedd1007a18e3b923b51cc10bb 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 2003-07-17  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
 
+       * GNUmakefile.in: remove no kpathsea hack.
+
+       * Documentation/topdocs/INSTALL.texi (Top): remove web-doc from
+       doco.
+
+       * GNUmakefile.in: remove web-doc target.
+
+       * lily/all-font-metrics.cc (find_afm): add message about
+       buildscripts/clean-fonts.sh 
+
        * scm/define-music-properties.scm (figure): use string for 'figure
 
        * lily/parser.yy (bass_number): allow strings for bassfigure too. 
index 136076112f917bf40ea0faa17bfe6a42d895d424..cc64d3221e4a0a903c9ea07b6c27458d419266a0 100644 (file)
@@ -240,7 +240,7 @@ can also build it locally. This process requires a successful compile of
 lilypond. The documentation is built by issuing
 @example 
 
-  make web-doc
+  make web
  
 @end example 
 
index 0f7ac4003a8b56bcf023ac9462452c73459d9f27..d5015cfbcab59c294a357587ffa366b78525b57c 100644 (file)
@@ -1,38 +1,91 @@
 @c -*-texinfo-*-
 
 
+@node Introduction
+@chapter Introduction
 
+There are a lot of programs that let you print sheet music with a
+computer. Unfortunately, most of them do not do good job.  If you
+regularly from both recent and old music, you can probably agree with
+us on that.  Most computer printouts have a bland, mechanical look,
+and are unpleasant to play from.  Musicians are usually more absorbed
+with performing the music than with studying its looks, so they
+usually cannot pinpoint what exactly is so disconcerting about
+computer prints.
 
+However, it only takes a little attention to see for yourself what is
 
 
 
+   oftenmostly itself,
+than studying the looks of , and will so most l playing Since we
+normally don't For normal users, it is difficult If you are familiar
+with this sensation, you will probably not be able to pinpoint what
+exactly causes this feeling.
 
 
 
 
+ Normally, one notices these details only subconsiously. The best way
+to become conscious of these differences is to compare a traditionally
+printed and a computer printed edition of the same piece, preferably
+with a magnifying glass. If you are not sure: traditional engraving is
+photographically reproduced hand-work, and can be recognized by
+slightly irregularities in symbol placement, and small blotches due to
+the reproduction process.
 
 
 
+By contrast, we try to mimick traditional plate engraving in the
+general impression, layout algorithms, and the font
+design. Consequently, our output often beats our competitors when it
+comes to good looks.
 
 
 
 
+LilyPond is an automated music engraving system.
 
+  
+With LilyPond is a program that lets you print sheet music. It is
+certainly not unique in that sense.  
 
 
+it is more than that 
 
+ If you are reading this 
 
+What is LilyPond?
 
+Automatic notation, so that means I can play the music, and then it
+rolls out of the printer?
 
+There are other program that do notation. What's so special about yours?
+What is wrong with other computer printed scores?
 
+What is engraving?
 
+Music notation  vs. Engraving. (vs. composing)
 
+Why do you care about engraving?
 
+Why would I care about engraving?
 
+You say your program is special; you must be trying to sell it?
 
+Freedom
+
+Preserving/reinventing the art of engraving 
+
+Typography in LilyPond.
+
+Input format.  Issue is overrated.
+
+
+
+
+************
 
-@node Introduction
-@chapter Introduction
 
 LilyPond is a program to print sheet music.  If you have used notation
 programs before, then the way to use this program might be surprising
@@ -120,17 +173,22 @@ attached.
 @cindex typography
 
 Making sheet music may seem trivial at first (``you print 5 lines, and
-then put in the notes at different heights''), @emph{music engraving},
-i.e. professional music typography, is in another ballpark.  The term
-`music engraving' derives from the traditional process of music
-printing.  Only a few decades ago, sheet music was made by cutting and
-stamping the music into zinc or pewter plates, mirrored. The plate
-would be inked, and the depressions caused by the cutting and stamping
-would hold ink.  An  image was formed by pressing paper to the
-plate. Stamping and cutting was completely done by hand. Making
-corrections was cumbersome, so engraving had to be done correctly in
-one go. As you can imagine this was a highly specialized skill, much
-more so than the traditional process of printing books.
+then put in the notes at different heights''),
+
+
+Hier over notatie.
+
+@emph{music engraving}, i.e. professional music typography, is in
+another ballpark.  The term `music engraving' derives from the
+traditional process of music printing.  Only a few decades ago, sheet
+music was made by cutting and stamping the music into zinc or pewter
+plates, mirrored. The plate would be inked, and the depressions caused
+by the cutting and stamping would hold ink.  An image was formed by
+pressing paper to the plate. Stamping and cutting was completely done
+by hand. Making corrections was cumbersome, so engraving had to be
+done correctly in one go. As you can imagine this was a highly
+specialized skill, much more so than the traditional process of
+printing books.
 @cindex craftsmanship
 @cindex master
 In the traditional German craftsmanship six years of full-time
index d524ac706c591cbaab5a978a0d26d713168c0bcb..f99c663a6e956ce5bf13ec840463c1cc81337b6d 100644 (file)
@@ -6508,8 +6508,8 @@ In figures input mode, a group of bass figures is delimited by
 \figures { <4 6> }
 @end lilypond
 
-Accidentals are added to the numbers if you alterate them by
-appending @code{-}, @code{!}  and @code{+}.
+Accidentals are added when you append @code{-}, @code{!}  and @code{+}
+to the numbers.
 
 @example
   <4- 6+ 7!>
index 710db8f04c5dd3270da7f122f7e518c7d318ee0a..0af9324cadaaa5f11ab0a1d419842d7b45f4701f 100644 (file)
@@ -44,31 +44,17 @@ web-reqs: run-reqs pfa-fonts
 doc: run-reqs
        $(MAKE) -C Documentation
 
-web-doc: web-reqs
-       $(MAKE) out=www LILYPOND_BOOK_FORMAT=texi-html -C input/regression/ WWW
-       $(MAKE) out=www LILYPOND_BOOK_FORMAT=texi-html -C input/template/ WWW
-       $(MAKE) out=www LILYPOND_BOOK_FORMAT=texi-html -C input/test/ WWW
-       $(MAKE) out=www LILYPOND_BOOK_FORMAT=texi-html -C Documentation WWW
-       $(MAKE) footify
-
 pfa-fonts:
        $(MAKE) MAKE_PFA_FILES=1 -C mf
        (cd $(builddir)/share/lilypond/fonts && \
                tar czvf ../../../$(outbase)/type1.tar.gz type1/*.pfa type1/fonts.* type1/lilypond.* )
 
-install-html-doc: web-doc top-web
+install-html-doc: top-web
        $(INSTALL) -m 755 -d $(local_package_docdir) 
        tar -C $(local_package_docdir)/ -xzf $(outdir)/web.tar.gz
 
-# KPATHSEA=0: Hack for compiling without kpathsea -- not recommended
-my_tfm_path = $(TFM_PATH) /tmp /tmp /tmp /tmp /tmp /tmp 
-
 local-install:
        $(INSTALL) -d $(local_lilypond_datadir)
-ifeq ($(KPATHSEA),0)
-       $(foreach i, 1 2 3 4 5, rm -f $(local_lilypond_datadir)/tfm.$(i); $(LN_S) $(word $(i), $(my_tfm_path)) $(local_lilypond_datadir)/tfm.$(i) ; )
-endif
-
 
 final-install:
        @echo
@@ -88,7 +74,7 @@ lily: lily/$(outdir)/lilypond
 lily/$(outdir)/lilypond:
        $(MAKE) -C lily
 
-local-web: web-doc $(TOP_HTMLS:%.html=%) footify do-top-doc top-web
+local-web: $(TOP_HTMLS:%.html=%) footify do-top-doc top-web
 
 
 web-ext = gz html midi pdf png txt ly
index d2fcede10f6719b8b710558c4ca49bdd4314d703..b3c9599755dc9507e7e3f365a40aa2d5d54d4348 100644 (file)
@@ -7,6 +7,11 @@
 %     xdvi example-1     # or your dvi viewer here
 %
 
+%%
+%% For learning LilyPond, please read the tutorial, included in the
+%% user-manual.
+%% 
+
 \score { 
   \context Voice \notes\relative c {
     c' d e f g a b c
index 1033383cf0b9f8927b7495aeb92183275001845e..76c66e9e6014583b743d13cf2979ab365a9be4ff 100644 (file)
@@ -7,6 +7,11 @@
 %     xdvi example-2     # or your dvi viewer here
 %
 
+%%
+%% For learning LilyPond, please read the tutorial, included in the
+%% user-manual.
+%% 
+
 \score { 
   \context Voice \notes\relative c {
     a''2 ~ c4( [e8 )e] [a,16 a a a]
index 8b5188170ab20c2ff33255b1f341616f03af3c72..b457695f0a5c88a1b769f4c4c3bb7e86f1fe475b 100644 (file)
@@ -24,3 +24,8 @@ two =  \notes\relative c{
 %
 %     ly2dvi example-3
 %     xdvi example-3     # or your dvi viewer here
+
+%%
+%% For learning LilyPond, please read the tutorial, included in the
+%% user-manual.
+%% 
index f0c377c03422e39f0fe5c86d15803f282ff29df2..219b1643c8f102a33d6e46ba2f2b210363193dbe 100644 (file)
@@ -100,7 +100,8 @@ All_font_metrics::find_afm (String name)
              s += " AFM: " + to_string ((int) afm->checksum_);
              s += "\n";
              s += _ (" Rebuild all .afm files, and remove all .pk and .tfm files.  Rerun with -V to show font paths.");
-             
+             s += _("A script for removing font-files is delivered with the source-code,\n"
+                    "in buildscripts/clean-fonts.sh") 
              error (s);
            }
        }
index 68f65a7624a98ce38b8bc8078abd379dc243d3ad..b02bb9ff16354c908c326e22ddf3fd411ab9f22c 100644 (file)
@@ -46,7 +46,9 @@ CONVERT_LY = $(script-dir)/convert-ly.py
 LILYPOND = $(builddir)/lily/$(outconfbase)/lilypond
 LILYPOND_BOOK = $(script-dir)/lilypond-book.py
 LILYPOND_BOOK_INCLUDES = -I $(pwd) -I $(outdir) -I$(input-dir) -I $(input-dir)/tricks/ -I $(input-dir)/regression/ -I $(input-dir)/test/ -I $(input-dir)/tutorial/ -I $(builddir)/mf/$(outconfbase)/  -I $(builddir)/mf/out/
-LILYPOND_BOOK_FORMAT = texi
+
+#texi-html for www only:
+LILYPOND_BOOK_FORMAT=$(if $(subst out-www,,$(notdir $(outdir))),texi,texi-html)
 LY2DVI = $(script-dir)/ly2dvi.py
 LYS_TO_TELY = $(buildscript-dir)/lys-to-tely.py
 
index 80c53fda3a320ecb58df5411a13cae060c9963b0..fff822a4482cc78820f61304464d55fcf94092a1 100644 (file)
@@ -58,7 +58,7 @@ make -C mf/ pfa
 make -C Documentation
 
 # make  html
-make web-doc top-web 
+make web 
 make -C Documentation/user omf
 
 %install
index 8d0dd7b647cc0e4a929817c264a7a6167bf85285..b4821c51b3c5cd1a08d3efa5dcb3a21f17ce4429 100644 (file)
@@ -53,7 +53,7 @@ make -C mf/ pfa
 make -C Documentation
 
 # make  html
-make web-doc top-web 
+make web top-web 
 make -C Documentation/user omf
 
 %install
index 822678420eb00eee214f62f0b6112ff733e2c0b1..5f9175c3d098c7e6a4a265d1505fe3db88d0bab5 100644 (file)
@@ -102,8 +102,7 @@ make LDFLAGS=-s "CFLAGS=$RPM_OPT_FLAGS" all
 # ok, now make sure that lilypond package will succeed,
 # even if documentation fails to build
 
-make -C Documentation  || true
-make web-doc top-web || true
+make web
 
 %install
 
index 259d06fe85067ea06fca1a4d698932241b0292df..8eaa76f7e5789f76bd7908a5372b1a793f15bade 100644 (file)
@@ -11,10 +11,10 @@ endif
 
 #ugh, this is (but whole make web/www/WWW is) lilypond specific
 local-web:
-       $(MAKE) out=www LILYPOND_BOOK_FORMAT=texi-html local-WWW
+       $(MAKE) out=www local-WWW
 
 web:
-       $(MAKE) out=www LILYPOND_BOOK_FORMAT=texi-html WWW
+       $(MAKE) out=www WWW
 
 local-WWW-clean:
        rm -f $(outdir)/*