]> git.donarmstrong.com Git - lilypond.git/commitdiff
* scm/framework-tex.scm (header-end): Don't set \outputscale.
authorWerner Lemberg <wl@gnu.org>
Wed, 20 Oct 2004 06:32:54 +0000 (06:32 +0000)
committerWerner Lemberg <wl@gnu.org>
Wed, 20 Oct 2004 06:32:54 +0000 (06:32 +0000)
(dump-line): Produce prettier output.

* tex/lilyponddefs.tex: Comment all macros extensively.
(\lilypondstart): Set \outputscale.
Define \lilypondpagebreak and \lilypondnopagebreak here.
Don't test for positive \lilypondpaperlinewidth -- this is always
positive in the normal case (LilyPond produces bad output otherwise
so we can safely ignore negative or zero values).
(\lilypondend): Remove useless test for \lilypondbook.
(\fetasixteen, \fetafont, \fetachar): Removed, unused.  We also
don't input `feta20.tex'.

ChangeLog
scm/framework-tex.scm
tex/lilyponddefs.tex

index 40c86cdeae218403ae0813e09b471b6cfd1b9fff..16be619d052ec007a2b80bed5ec1e5eb2bc3b7e3 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,22 @@
+2004-10-20  Werner Lemberg  <wl@gnu.org>
+
+       * scm/framework-tex.scm (header-end): Don't set \outputscale.
+       (dump-line): Produce prettier output.
+
+       * tex/lilyponddefs.tex: Comment all macros extensively.
+       (\lilypondstart): Set \outputscale.
+       Define \lilypondpagebreak and \lilypondnopagebreak here.
+       Don't test for positive \lilypondpaperlinewidth -- this is always
+       positive in the normal case (LilyPond produces bad output otherwise
+       so we can safely ignore negative or zero values).
+       (\lilypondend): Remove useless test for \lilypondbook.
+       (\fetasixteen, \fetafont, \fetachar): Removed, unused.  We also
+       don't input `feta20.tex'.
+
 2004-10-19  Graham Percival  <gperlist@shaw.ca>
 
-       * Documentation/user/examples.itely: added texidoc lilypond-book template.
+       * Documentation/user/examples.itely: added texidoc lilypond-book
+       template.
 
 2004-10-19  Jan Nieuwenhuizen  <janneke@gnu.org>
 
 
        * Documentation/user/examples.itely: added lilypond-book template.
 
-       * Documentation/user/lilypond-book.itely: added filename extension page.
+       * Documentation/user/lilypond-book.itely: added filename extension
+       page.
 
 2004-10-13  Jan Nieuwenhuizen  <janneke@gnu.org>
 
        * lily/slur-scoring.cc (struct Slur_score_state): new
        struct. Collect scoring function arguments.
        (struct Slur_score_state): add musical_dy_
-       (get_extra_encompass_infos): new function. Split off state computations.
+       (get_extra_encompass_infos): new function. Split off state
+       computations.
 
        * scm/part-combiner.scm (determine-split-list): remove playing1
        and playing2.
 
 2004-09-22  Graham Percival  <gperlist@shaw.ca>
 
-       * Documentation/user/tutorial.itely: modified a "future planning" comment.
+       * Documentation/user/tutorial.itely: modified a "future planning"
+       comment.
 
        * Documentation/user/notation.itely: more editing.
 
 
        * input/mutopia/F.Schubert/morgenlied.ly,
        input/mutopia/J.S.Bach/baerenreiter-sarabande.ly,
-       input/mutopia/R.Schumann/romanze-op28-2.ly: Add lifetime and full name.
+       input/mutopia/R.Schumann/romanze-op28-2.ly: Add lifetime and full
+       name.
 
 2004-09-15  Juergen Reuter  <reuter@ipd.uka.de>
 
 
 2004-09-15  Graham Percival  <gperlist@shaw.ca>
 
-       * Documentation/user/introduction.itely: update \stemBoth to \stemNeutral
+       * Documentation/user/introduction.itely: update \stemBoth to
+       \stemNeutral.
 
        * Documentation/user/notation.itely: more editing of the manual.
 
 
        * Documentation/user/notation.itely: fixed Time Signature numbers bug.
 
-       * Documentation/user/invoking.itexi: updated the "reporting bugs" section.
+       * Documentation/user/invoking.itexi: updated the "reporting bugs"
+       section.
 
 2004-09-12  Han-Wen Nienhuys   <hanwen@xs4all.nl>
 
 
 2004-08-26  Graham Percival  <gperlist@shaw.ca>
 
-       * Documentation/user/examples.itely: second, third, fourth, and fifth sections added.
+       * Documentation/user/examples.itely: second, third, fourth, and fifth
+       sections added.
 
        * input/template/{various}: removed files included in examples.itely.
 
        * Documentation/user/notation.itely (Easy Notation note heads):
        revise notation Chapter.
 
-       * ly/music-functions-init.ly (makecluster): add makeClusters music function.
+       * ly/music-functions-init.ly (makecluster): add makeClusters music
+       function.
 
        * lily/part-combine-engraver.cc: rename soloADue ->
        printPartCombineTexts
        xgettext does not recognise scheme yet.  Patch submitted.
 
        * lily/scm-option.cc (LY_DEFINE):
-       * lily/main.cc: The program is now called lilypond (WAS: lilypond-bin).
+       * lily/main.cc: The program is now called lilypond (WAS:
+       lilypond-bin).
 
        * lily/rest-collision.cc (do_shift): Uniformise two too many rests
        messages.
 
        * scm/define-grob-properties.scm: add number-type and label-dir
 
-       * scm/fret-diagrams.scm (label-fret): allow fret label to be on either 
+       * scm/fret-diagrams.scm (label-fret): allow fret label to be on either
        left or right.  Allow choice of upper-case roman, lower-case roman, or
        arabic numerals in fret label
 
 
 2004-08-01  Heikki Junes  <hanwen@xs4all.nl>
 
-       * Documentation/user/{changing-defaults,notation,tutorial}.itely: fixes.
+       * Documentation/user/{changing-defaults,notation,tutorial}.itely:
+       fixes.
 
 2004-08-01  Han-Wen Nienhuys   <hanwen@xs4all.nl>
 
 
        * scm/beam.scm (check-slope-callbacks): check sign of slope. 
 
-       * input/regression/beam-concave.ly (rossFourBeams): add cases from Ross
+       * input/regression/beam-concave.ly (rossFourBeams): add cases from
+       Ross
 
        * scm/script.scm (default-script-alist): marcato should follow
        into staff
 
        * scm/output-ps.scm (white-text): Add scale paramter to allow scaling
 
-       * scm/output-tex.scm (white-text): Add scale parameter to allow font scaling
+       * scm/output-tex.scm (white-text): Add scale parameter to allow font
+       scaling
 
-       * scm/stencil.scm (fontify-text-white) : Adjust to better center, properly
-       scale white text
+       * scm/stencil.scm (fontify-text-white) : Adjust to better center,
+       properly scale white text
 
        * scm/fret-diagrams.scm (make-fret-diagram): change default dot
        position for numbered dots so dot will touch fret.
 
        * scm/document-translation.scm (all-engravers-doc): link to user man
 
-       * scm/page-layout.scm (ly:optimal-page-breaks): use penalty iso. score.
+       * scm/page-layout.scm (ly:optimal-page-breaks): use penalty
+       iso. score.
 
        * Documentation/user/notation.itely (Relative octaves): typo.
 
        * mf/feta-klef.mf: 
        * mf/feta-bolletjes.mf: Oops.  Comment-out canvast test code.
 
-       * Documentation/user/programming-interface.itely: Use @emph (was: @em).
+       * Documentation/user/programming-interface.itely: Use @emph (was:
+       @em).
 
        * Documentation/user/out/tutorial.texi: Untrigger lilypond-book error.
 
index 2906ff106c126b7cee6032e3685f18ce0782b542..6204512aa059ab46b9a93f55fbd6bd829157f45c 100644 (file)
    "\\ifx\\lilypondstart\\undefined\n"
    "  \\input lilyponddefs\n"
    "\\fi\n"
-   "\\outputscale = \\lilypondpaperoutputscale\\lilypondpaperunit\n"
    "\\lilypondstart\n"
    "\\lilypondspecial\n"
    "\\lilypondpostscript\n"))
    putter
    (string-append "\\leavevmode\n\\lybox{0}{0}{0}{"
                  (ly:number->string (interval-length (ly:paper-system-extent line Y)))
-                 "}{"))
+                 "}{%\n"))
 
   (ly:outputter-dump-stencil putter (ly:paper-system-stencil line))
   (ly:outputter-dump-string
index b3c074e87c9d2c57a930e816f6a205aef7b53302..da6386c1dc27a6e491c1b2bac743272757ae568e 100644 (file)
@@ -6,7 +6,9 @@
 %%%                 Han-Wen Nienhuys <hanwen@cs.uu.nl>
 %%%                 Mats Bengtsson <mats.bengtsson@s3.kth.se>
 %%%
+%%
 %% Avoid \par while reading this file.
+%%
 \edef\lilyponddefsELC{\the\endlinechar}%
 \endlinechar -1\relax
 
 %%   <note output>
 %%   \lilypondend
 
+%% A temporary variable.
+%%
 \newdimen\lytempdim
+
+%% The scaling factor for all dimensions.
+%%
 \newdimen\outputscale
 
-%% Handy macros from the LaTeX manual.
 \long\gdef\lilypondfirst#1#2{#1}
 \long\gdef\lilypondsecond#1#2{#2}
+
+%% \lilypondundefined{xxx}{foo}{bar}
+%%
+%%   If `xxx' (without the leading backslash) is an undefined macro,
+%%   execute block `foo'.  Otherwise, execute block `bar'.  Based on
+%%   a similar macro from the LaTeX kernel.
+%%
 \gdef\lilypondifundefined#1{
   \expandafter\ifx\csname#1\endcsname\relax
     \expandafter\lilypondfirst
   \fi
 }
 
-%% Urgh.  Lilypond uses EC fonts, but texinfo is based on CM.  We thus
-%% have to handle T1 font encoding by ourselves.  Note that the following
+%% Urgh.  LilyPond uses EC fonts, but texinfo is based on CM.  We thus
+%% have to handle T1 font encoding by ourselves; all manipulations are
+%% collected in the macro \lilypondECencoding.  Note that the following
 %% code only provides the texinfo interface, not complete access to all
 %% EC glyphs.
-
+%%
+%% All definitions are taken from texinfo or LaTeX (with modifications
+%% if necessary).
+%%
 \begingroup
 \catcode `\@=11\relax
 \gdef\lilypondECencoding{
 }
 \endgroup
 
+%% This macro provides the necessary setup to make the lilypond data
+%% work with plain TeX, LaTeX, and texinfo.
+%%
+%% The reason of using \begingroup and \endgroup is to make the macro \x
+%% immediately disappear after it has been executed.  Since we have \def
+%% within \def within \gdef, four hash signs (`#') are needed for
+%% parameters.
+%%
+%% \lilypondfontencoding is emitted by LilyPond to set the encoding of
+%% text strings.
+%%
 \gdef\lilypondstart{
   \frenchspacing
+  \outputscale \lilypondpaperoutputscale\lilypondpaperunit
+
   \begingroup
   \catcode `\@=11\relax
+
   %% \@nodocument is defined as \relax after `\begin{document}'
   \lilypondifundefined{@nodocument}
-    {%% either plain TeX or texinfo or not at the beginning of LaTeX input
+    {%% Either plain TeX or texinfo or not at the beginning of LaTeX input.
      \def\x{
        \endgroup
+
        \def\lilypondfontencoding####1{
-         \lilypondECencoding}}}
-    {%% FIXME: a4
-     %% provide a proper LaTeX preamble (for A4 paper format)
+         \lilypondECencoding}
+       \def\lilypondpagebreak{
+         \eject}
+       \def\lilypondnopagebreak{
+         \ifvmode
+           \penalty 10000\relax
+         \fi}}}
+
+    {%% LaTeX mode: Provide a complete preamble.
      \def\x{
        \endgroup
+
+       %% Indicate that we shall emit `\end{document}' while executing
+       %% \lilypondend.
        \def\lilyponddocument{}
+
        \def\lilypondfontencoding####1{
          \fontencoding{####1}
          \selectfont}
+       \def\lilypondpagebreak{
+         \newpage}
+       \def\lilypondnopagebreak{
+         \nopagebreak}
+
        \documentclass[\lilyponddocumentclassoptions]{article}
-       %% safe-mode
+
+       %% As a safety guard, don't produce auxiliary files.
        \nofiles
+
        \usepackage[\lilypondpaperinputencoding]{inputenc}
        \pagestyle{empty}
+
        \lilypondifundefined{lilypondclassic}
-         {%% Nullify [La]TeX page layout settings, page layout by LilyPond.
+         {%% If not in `classic' mode, undo LaTeX's page layout settings
+          %% since LilyPond does the layout by itself.
           \topmargin-1in
           \headheight0pt\headsep0pt
           \oddsidemargin-1in
           \evensidemargin\oddsidemargin}
-         {%% Center staves horizontally on page
-          \ifdim\lilypondpaperlinewidth\lilypondpaperunit > 0pt
-            \hsize\lilypondpaperlinewidth\lilypondpaperunit
-            \lytempdim \paperwidth
-            \advance\lytempdim -\the\hsize
-            \lytempdim 0.5\lytempdim
-            \advance\lytempdim -1in
-            \oddsidemargin \lytempdim
-            \evensidemargin \lytempdim
-          \fi}
+
+         {%% Otherwise center output horizontally, without changing the
+          %% vertical positioning.
+          \hsize\lilypondpaperlinewidth\lilypondpaperunit
+          \lytempdim \paperwidth
+          \advance\lytempdim -\the\hsize
+          \lytempdim 0.5\lytempdim
+          \advance\lytempdim -1in
+          \oddsidemargin \lytempdim
+          \evensidemargin \lytempdim}
+
        \parindent 0pt
-       %% TEXINFO workaround: \begin is defined as \outer, use \csname.
+
+       %% We can't directly say `\begin{document}' in this macro since
+       %% older versions of texinfo.tex define \begin as \outer; this
+       %% means that it causes an error if \begin is found within another
+       %% macro (even if the corresponding code will never be executed).
+       %% As a workaround we use \csname to call \begin.
        \csname begin\endcsname{document}}}
   \x}
 
+%% The opposite of \lilypondstart.
+%%
 \gdef\lilypondend{
-  \lilypondifundefined{lilypondbook}
-    {\lilypondifundefined{lilypondpaperlastpagefill}
-       {\vskip 0pt plus\lilypondpaperinterscorelinefill00 fill}
-       {}}
+  %% Handle the `lastpagefill' parameter from the \layout block.
+  \lilypondifundefined{lilypondpaperlastpagefill}
+    {\vskip 0pt plus\lilypondpaperinterscorelinefill00 fill}
     {}
+
   \begingroup
   \lilypondifundefined{lilyponddocument}
-    {\def\x{\endgroup}}
-    {\def\x{\endgroup\csname end\endcsname{document}}}
+    {\def\x{
+       \endgroup}}
+    {\def\x{
+       \endgroup
+       \csname end\endcsname{document}}}
   \x}
 
-%% Allow overriding of pagebreak
-\lilypondifundefined{lilypondpagebreak}
-  {\lilypondifundefined{@nodocument}
-     {\gdef\lilypondpagebreak{\eject}}
-     {\gdef\lilypondpagebreak{\newpage}}}
-  {}
-      
-%% Allow overriding of pagebreak
-\lilypondifundefined{lilypondnopagebreak}
-{\lilypondifundefined{@nodocument}
-   {\gdef\lilypondnopagebreak{}}
-   {\gdef\lilypondnopagebreak{\nopagebreak}}}
-{}
-%% Include \special only once.
+%% Load the PostScript drawing routines.  This is done using \special.
+%% To avoid multiple inclusions, redefine \lilypondspecial to a no-op
+%% afterwards.
+%%
 \gdef\lilypondspecial{
   \special{header=music-drawing-routines.ps}
   \gdef\lilypondspecial{}}
 
-%% The feta characters.
-\input feta20
-
-\global\font\fetasixteen = feta16
-\gdef\fetafont{\fetasixteen}
-\gdef\fetachar#1{\hbox{\fetasixteen#1}}
+%% Put the argument into a box which has zero height and depth (the
+%% \vss forces the latter -- TeXbook, page 80).
+%%
+\gdef\topalign#1{
+  \vbox to 0pt{
+    \hbox{#1}
+    \vss}}
 
-\gdef\topalign#1{\vbox to 0pt{\hbox{#1}\vss}}
-\gdef\leftalign#1{\hbox to 0pt{#1\hss}}
+%% Put the argument into a box which has zero width.
+%%
+\gdef\leftalign#1{
+  \hbox to 0pt{
+    #1
+    \hss}}
 
+%% The most used macro in LilyPond output.  Put #3 into a zero-width box
+%% which is moved to the right by #1 (scaled by \outputscale) and moved
+%% up by #2 (also scaled by \outputscale).  Note that negative values for
+%% #2 change the depth of the box defined by \leftalign, not the height.
+%%
 \gdef\lyitem#1#2#3{
-  \raise#2\outputscale \leftalign{\kern#1\outputscale#3}}
+  \raise#2\outputscale \leftalign{
+    \kern#1\outputscale
+    #3}}
 
+%% All LilyPond music data is enclosed in this macro (as fifth argument).
+%% The data is first put into a box with zero height and depth which is
+%% then moved to the right by #1 and moved down by #2.  After this, it is
+%% put into a zero-width box, giving it a height #4 (and depth zero).
+%% Finally, the box is raised so that its true height is exactly the
+%% distance from one baseline to the next.
+%%
+%% Parameters #1 to #4 are scaled by \outputscale.
+%%
 \gdef\lybox#1#2#3#4#5{
   \lytempdim\baselineskip
-  \advance\lytempdim-#4\outputscale
+  \advance\lytempdim -#4\outputscale
   \raise\lytempdim
-  \vbox to#4\outputscale{
-    \leftalign{\kern#1\outputscale\lower#2\outputscale\topalign{#5}}
+  \vbox to #4\outputscale{
+    \leftalign{
+      \kern #1\outputscale
+      \lower #2\outputscale \topalign{
+        #5}}
     \vss}}
 
+%% Produce a black bar (width #2, depth #3, height #4) with a vertical
+%% offset #1.  Everything is scaled by \outputscale.
+%%
 \gdef\lyvrule#1#2#3#4{
   \kern#1\outputscale
   \vrule width #2\outputscale depth #3\outputscale height #4\outputscale}
 
 %% FIXME: 'interscoreline' and 'lilypondPAPERinterscoreline
+%%
 \lilypondifundefined{lilypondpaperinterscorelinefill}
   {\gdef\lilypondpaperinterscorelinefill{0}}
   {\gdef\lilypondpaperinterscorelinefill{1}}
 
-%% Allow overriding of interscoreline, e.g. for lilypond.py's --preview
+%% Allow overriding of interscoreline, e.g., for LilyPond's --preview
+%%
 \lilypondifundefined{interscoreline}
   {\lilypondifundefined{lilypondclassic}
      {\gdef\interscoreline{}}
         plus \lilypondpaperinterscorelinefill fill}}}
   {}
 
-%% Include postscript definitions unless using PDFTeX,
-%% in that case use pdf definitions.
-%% MiKTeX workaround: use \csname.
+%% Include PostScript definitions (which are differently defined for
+%% TeX and pdfTeX).  This is loaded once only because the inputted files
+%% define \lilypondpostscript.
+%%
+%% (Don't remove the spaces after the arguments to \input!)
+%%
 \lilypondifundefined{lilypondpostscript}
   {\lilypondifundefined{pdfoutput}
      {\input lily-ps-defs }
   {}
 
 %% Restore newline functionality (disabled to avoid \par).
+%%
 \endlinechar \lilyponddefsELC
 \endinput