]> git.donarmstrong.com Git - lilypond.git/blobdiff - scripts/lilypond-book.py
* lily/include/music.hh (class Music): unvirtualize transpose().
[lilypond.git] / scripts / lilypond-book.py
index f19803b8753e52f117d708b476e6e47f2c5bfeff..65c025feda91412b8098c027b216cfd7c837c5a0 100644 (file)
@@ -13,10 +13,11 @@ classic lilypond-book:
      lilypond-book --process="lilypond" BOOK.tely
 
 TODO:
-    *  ly-options: intertext ?
+    *  ly-options: intertext?
     *  --linewidth?
-    *  eps in latex / eps by lilypond -fps ?
+    *  eps in latex / eps by lilypond -b ps?
     *  check latex parameters, twocolumn, multicolumn?
+    *  use --png --ps --pdf for making images?
 
     *  Converting from lilypond-book source, substitute:
        @mbinclude foo.itely -> @include foo.itely
@@ -29,23 +30,16 @@ import glob
 import stat
 import string
 
-#
-# TODO:
-#
-#  * use --png --ps --pdf for making images?
-#
-
-################################################################
 # Users of python modules should include this snippet
 # and customize variables below.
 
-# We'll suffer this path init stuff as long as we don't install our
-# python packages in <prefix>/lib/pythonx.y (and don't kludge around
-# it as we do with teTeX on Red Hat Linux: set some environment var
-# (PYTHONPATH) in profile)
+# We'll suffer this path initialization stuff as long as we don't install
+# our python packages in <prefix>/lib/pythonX.Y (and don't kludge around
+# it as we do with teTeX on Red Hat Linux: set some environment variables
+# (PYTHONPATH) in `etc/profile').
 
-# If set, LILYPONDPREFIX must take prevalence
-# if datadir is not set, we're doing a build and LILYPONDPREFIX
+# If set, LILYPONDPREFIX must take prevalence.
+# if datadir is not set, we're doing a build and LILYPONDPREFIX.
 import getopt, os, sys
 datadir = '@local_lilypond_datadir@'
 if not os.path.isdir (datadir):
@@ -57,48 +51,58 @@ if os.environ.has_key ('LILYPONDPREFIX'):
 
 sys.path.insert (0, os.path.join (datadir, 'python'))
 
-# Customize these
+# Customize these.
 #if __name__ == '__main__':
 
 import lilylib as ly
 global _;_=ly._
 global re;re = ly.re
 
-# lilylib globals
+# Lilylib globals.
 program_version = '@TOPLEVEL_VERSION@'
 program_name = sys.argv[0]
 verbose_p = 0
 pseudo_filter_p = 0
 original_dir = os.getcwd ()
 
-help_summary = _ ('''Process LilyPond snippets in hybrid HTML, LaTeX or texinfo document.
+help_summary = _ (
+'''Process LilyPond snippets in hybrid HTML, LaTeX, or texinfo document.
 Example usage:
 
    lilypond-book --filter="tr '[a-z]' '[A-Z]'" BOOK
    lilypond-book --filter="convert-ly --no-version --from=2.0.0 -" BOOK
    lilypond-book --process='lilypond -I include' BOOK
-
 ''')
 
 copyright = ('Jan Nieuwenhuizen <janneke@gnu.org>',
             'Han-Wen Nienhuys <hanwen@cs.uu.nl>')
 
 option_definitions = [
-       (_ ("EXT"), 'f', 'format', _ ("use output format EXT (texi [default], texi-html, latex, html)")),
-       (_ ("FILTER"), 'F', 'filter', _ ("pipe snippets through FILTER [convert-ly -n -]")),
-       ('', 'h', 'help', _ ("print this help")),
-       (_ ("DIR"), 'I', 'include', _ ("add DIR to include path")),
-       (_ ("COMMAND"), 'P', 'process', _ ("process ly_files using COMMAND FILE...")),
-       (_ ("DIR"), 'o', 'output', _ ("write output to DIR")),
-       ('', 'V', 'verbose', _ ("be verbose")),
-       ('', 'v', 'version', _ ("print version information")),
-       ('', 'w', 'warranty', _ ("show warranty and copyright")),
+       (_ ("EXT"), 'f', 'format',
+         _ ('''use output format EXT (texi [default], texi-html,
+               latex, html)''')),
+       (_ ("FILTER"), 'F', 'filter',
+         _ ("pipe snippets through FILTER [convert-ly -n -]")),
+       ('', 'h', 'help',
+         _ ("print this help")),
+       (_ ("DIR"), 'I', 'include',
+         _ ("add DIR to include path")),
+       (_ ("DIR"), 'o', 'output',
+         _ ("write output to DIR")),
+       (_ ("COMMAND"), 'P', 'process',
+         _ ("process ly_files using COMMAND FILE...")),
+       ('', 'V', 'verbose',
+         _ ("be verbose")),
+       ('', 'v', 'version',
+         _ ("print version information")),
+       ('', 'w', 'warranty',
+         _ ("show warranty and copyright")),
 ]
 
 include_path = [ly.abspath (os.getcwd ())]
 lilypond_binary = os.path.join ('@bindir@', 'lilypond')
 
-# only use installed binary when we're installed too.
+# Only use installed binary when we are installed too.
 if '@bindir@' == ('@' + 'bindir@') or not os.path.exists (lilypond_binary):
        lilypond_binary = 'lilypond'
 
@@ -111,7 +115,7 @@ process_cmd = ''
 default_ly_options = {}
 
 #
-# is this pythonic? Personally, I find this rather #define-nesque. --hwn
+# Is this pythonic?  Personally, I find this rather #define-nesque. --hwn
 #
 AFTER = 'after'
 BEFORE = 'before'
@@ -125,6 +129,7 @@ LAYOUT = 'layout'
 LINEWIDTH = 'linewidth'
 NOFRAGMENT = 'nofragment'
 NOINDENT = 'noindent'
+NOQUOTE = 'noquote'
 NOTES = 'body'
 NOTIME = 'notime'
 OUTPUT = 'output'
@@ -139,13 +144,20 @@ TEXIDOC = 'texidoc'
 TEXINFO = 'texinfo'
 VERBATIM = 'verbatim'
 
-# Recognize special sequences in the input;
+# NOTIME has no opposite so it isn't part of this dictionary.
+# NOQUOTE is used internally only.
+no_options = {
+       NOFRAGMENT: FRAGMENT,
+       NOINDENT: INDENT,
+}
+
+# Recognize special sequences in the input.
 #
-# (?P<name>regex) -- assign result of REGEX to NAME
-# *? -- match non-greedily.
-# (?m) -- multiline regex: make ^ and $ match at each line
-# (?s) -- make the dot match all characters including newline
-# (?x) -- ignore whitespace in patterns
+#   (?P<name>regex) -- Assign result of REGEX to NAME.
+#   *? -- Match non-greedily.
+#   (?m) -- Multiline regex: Make ^ and $ match at each line.
+#   (?s) -- Make the dot match all characters including newline.
+#   (?x) -- Ignore whitespace in patterns.
 no_match = 'a\ba'
 snippet_res = {
        ##
@@ -328,7 +340,7 @@ snippet_res = {
                      (?P<code>
                      @c([ \t][^\n]*|)\n))''',
 
-       # don't do this: fucks up with @code{@{}
+       # Don't do this: It interferes with @code{@{}.
        #       'verb': r'''(?P<code>@code{.*?})''',
 
                'verbatim':
@@ -358,6 +370,17 @@ format_res = {
        },
 }
 
+# Options without a pattern in ly_options.
+simple_options = [
+       EXAMPLEINDENT,
+       FRAGMENT,
+       NOFRAGMENT,
+       NOINDENT,
+       PRINTFILENAME,
+       TEXIDOC,
+       VERBATIM
+]
+
 ly_options = {
        ##
        NOTES: {
@@ -370,8 +393,6 @@ ly_options = {
 
                LINEWIDTH: r'''linewidth = %(linewidth)s''',
 
-               NOINDENT: r'''indent = 0.0\mm''',
-
                QUOTE: r'''linewidth = %(linewidth)s - 2.0 * %(exampleindent)s''',
 
                RAGGEDRIGHT: r'''raggedright = ##t''',
@@ -379,8 +400,6 @@ ly_options = {
 
        ##
        LAYOUT: {
-               EXAMPLEINDENT: '',
-
                NOTIME: r'''\context {
     \Staff
     \remove Time_signature_engraver
@@ -418,16 +437,13 @@ output = {
 %(str)s
 </blockquote>
 ''',
+
                VERBATIM: r'''<pre>
 %(verb)s</pre>''',
        },
 
        ##
        LATEX: {
-               AFTER: '',
-
-               BEFORE: '',
-
                OUTPUT: r'''{%%
 \parindent 0pt
 \catcode`\@=12
@@ -469,10 +485,6 @@ output = {
 %(code)s
 @lilypond''',
 
-               AFTER: '',
-
-               BEFORE: '',
-
                OUTPUT: r'''@noindent
 @image{%(base)s,,,[image of music],%(ext)s}''',
 
@@ -480,15 +492,16 @@ output = {
        ''',
 
                QUOTE: r'''@quotation
-%(str)s
-@end quotation
+%(str)s@end quotation
+''',
+
+               NOQUOTE: r'''@format
+%(str)s@end format
 ''',
 
-               # FIXME: @exampleindent 5  is the default...
                VERBATIM: r'''@exampleindent 0
 @example
 %(verb)s@end example
-@exampleindent 5
 ''',
        },
 }
@@ -501,6 +514,7 @@ PREAMBLE_LY = r'''%%%% Generated by %(program_name)s
                               (ly:parser-print-score
                                p (ly:music-scorify m p))))
 
+#(define version-seen? #t)
 %(preamble_string)s
 
 \paper {
@@ -558,38 +572,90 @@ def classic_lilypond_book_compatibility (key, value):
 
 def compose_ly (code, options, type):
        option_dict = {}
+
        for i in options:
                if string.find (i, '=') > 0:
                        (key, value) = re.split ('\s*=\s*', i)
                        option_dict[key] = value
                else:
-                       option_dict[i] = None
+                       if i in no_options.keys ():
+                               if no_options[i] in option_dict.keys ():
+                                       del option_dict[no_options[i]]
+                       else:
+                               option_dict[i] = None
 
        has_linewidth = option_dict.has_key (LINEWIDTH)
+       no_linewidth_value = 0
+
+       # If LINEWIDTH is used without parameter, set it to default.
+       if has_linewidth and option_dict[LINEWIDTH] == None:
+               no_linewidth_value = 1
+               del option_dict[LINEWIDTH]
 
        for i in default_ly_options.keys ():
                if i not in option_dict.keys ():
                        option_dict[i] = default_ly_options[i]
 
-       if not INDENT in option_dict.keys ():
-               option_dict[NOINDENT] = None
+       if not has_linewidth:
+               if type == 'lilypond' or FRAGMENT in option_dict.keys ():
+                       option_dict[RAGGEDRIGHT] = None
+
+               if type == 'lilypond':
+                       if LINEWIDTH in option_dict.keys ():
+                               del option_dict[LINEWIDTH]
+               else:
+                       if RAGGEDRIGHT in option_dict.keys ():
+                               if LINEWIDTH in option_dict.keys ():
+                                       del option_dict[LINEWIDTH]
 
-       if not has_linewidth and LINEWIDTH in option_dict.keys ():
                if QUOTE in option_dict.keys () or type == 'lilypond':
+                       if LINEWIDTH in option_dict.keys ():
+                               del option_dict[LINEWIDTH]
+
+       if not INDENT in option_dict.keys ():
+               option_dict[INDENT] = '0\\mm'
+
+       # The QUOTE pattern from ly_options only emits the `linewidth'
+       # keyword.
+       if has_linewidth and QUOTE in option_dict.keys ():
+               if no_linewidth_value:
                        del option_dict[LINEWIDTH]
-                       option_dict[RAGGEDRIGHT] = None
+               else:
+                       del option_dict[QUOTE]
 
        if FRAGMENT in option_dict.keys ():
                body = FRAGMENT_LY
        else:
                body = FULL_LY
 
-       # defaults
+       # Defaults.
        relative = 1
        override = {}
-       #FIXME: where to get sane value for exampleindent?
-       override[EXAMPLEINDENT] = r'9.0\mm'
-       override[LINEWIDTH] = None
+       # The original concept of the `exampleindent' option is broken.
+       # It is not possible to get a sane value for @exampleindent at all
+       # without processing the document itself.  Saying
+       #
+       #   @exampleindent 0
+       #   @example
+       #   ...
+       #   @end example
+       #   @exampleindent 5
+       #
+       # causes ugly results with the DVI backend of texinfo since the
+       # default value for @exampleindent isn't 5em but 0.4in (or a smaller
+       # value).  Executing the above code changes the environment
+       # indentation to an unknown value because we don't know the amount
+       # of 1em in advance since it is font-dependent.  Modifying
+       # @exampleindent in the middle of a document is simply not
+       # supported within texinfo.
+       #
+       # As a consequence, the only function of @exampleindent is now to
+       # specify the amount of indentation for the `quote' option.
+       #
+       # To set @exampleindent locally to zero, we use the @format
+       # environment for non-quoted snippets.
+       override[EXAMPLEINDENT] = r'0.4\in'
+       override[LINEWIDTH] = texinfo_linewidths['@smallbook']
        override.update (default_ly_options)
 
        option_list = []
@@ -639,11 +705,10 @@ def compose_ly (code, options, type):
                                found = 1
                                break
 
-               if not found and key not in (FRAGMENT, NOFRAGMENT, PRINTFILENAME,
-                                            RELATIVE, VERBATIM, TEXIDOC):
+               if not found and key not in simple_options:
                        ly.warning (_ ("ignoring unknown ly option: %s") % i)
 
-       #URGS
+       # URGS
        if RELATIVE in override.keys () and override[RELATIVE]:
                relative = string.atoi (override[RELATIVE])
 
@@ -669,29 +734,31 @@ def compose_ly (code, options, type):
        return (PREAMBLE_LY + body) % vars ()
 
 # BARF
-# use lilypond for latex (.lytex) books,
+# Use lilypond for latex (.lytex) books,
 # and lilypond --preview for html, texinfo books?
 def to_eps (file):
        cmd = r'latex "\nonstopmode \input %s"' % file
-       # Ugh.  (La)TeX writes progress and error messages on stdout
-       # Redirect to stderr
+       # Ugh.  (La)TeX writes progress and error messages on stdout.
+       # Redirect to stderr.
        cmd = '(( %s >&2 ) >&- )' % cmd
        ly.system (cmd)
-       ly.system ('dvips -Ppdf -u+ec-mftrace.map -u+lilypond.map -E -o %s.eps %s' \
-                  % (file, file))
+       ly.system (
+         'dvips -Ppdf -u+ec-mftrace.map -u+lilypond.map -E -o %s.eps %s' \
+           % (file, file))
 
-       # check if it really is EPS.
+       # Check if it really is EPS.
        # Otherwise music glyphs disappear from 2nd and following pages.
 
-       # TODO: should run dvips -pp -E per page, then we get proper
-       # cropping as well.
+       # TODO: Should run dvips -pp -E per page, then we get proper
+       #       cropping as well.
 
        f = open ('%s.eps' % file)
        for x in range (0, 10):
-               if re.search ("^%%Pages: ", f.readline ()):
-                       # make non EPS.
-                       ly.system ('dvips -Ppdf -u+ec-mftrace.map -u+lilypond.map -o %s.eps %s' \
-                                  % (file, file))
+               if re.search ('^%%Pages: ', f.readline ()):
+                       # Make non-EPS.
+                       ly.system (
+                         'dvips -Ppdf -u+ec-mftrace.map -u+lilypond.map -o %s.eps %s' \
+                           % (file, file))
                        break
 
 def find_file (name):
@@ -736,7 +803,7 @@ class Substring (Chunk):
                self.end = end
 
        def replacement_text (self):
-               return self.source [self.start:self.end]
+               return self.source[self.start:self.end]
 
 class Snippet (Chunk):
        def __init__ (self, type, match, format):
@@ -753,7 +820,7 @@ class Snippet (Chunk):
                return self.match.group (s)
 
        def __repr__ (self):
-               return `self.__class__` + " type = " + self.type
+               return `self.__class__` + ' type = ' + self.type
 
 class Include_snippet (Snippet):
        def processed_filename (self):
@@ -782,7 +849,7 @@ class Lilypond_snippet (Snippet):
                        return compose_ly (s, self.options, self.type)
                return ''
 
-       # todo: use md5?
+       # TODO: Use md5?
        def get_hash (self):
                if not self.hash:
                        self.hash = abs (hash (self.full_ly ()))
@@ -797,21 +864,23 @@ class Lilypond_snippet (Snippet):
                outf = open (self.basename () + '.ly', 'w')
                outf.write (self.full_ly ())
 
-               open (self.basename () + '.txt', 'w').write ("image of music")
+               open (self.basename () + '.txt', 'w').write ('image of music')
 
        def ly_is_outdated (self):
                base = self.basename ()
 
                tex_file = '%s.tex' % base
                ly_file = '%s.ly' % base
-               ok = os.path.exists (ly_file) and os.path.exists (tex_file)\
+               ok = os.path.exists (ly_file) \
+                    and os.path.exists (tex_file)\
                     and os.stat (tex_file)[stat.ST_SIZE] \
                     and open (tex_file).readlines ()[-1][1:-1] \
-                    == 'lilypondend'
+                      == 'lilypondend'
 
-               if ok and (use_hash_p or self.ly () == open (ly_file).read ()):
-                       # TODO: something smart with target formats
-                       # (ps, png) and m/ctimes
+               if ok and (use_hash_p \
+                          or self.ly () == open (ly_file).read ()):
+                       # TODO: Do something smart with target formats
+                       #       (ps, png) and m/ctimes.
                        return None
                return self
 
@@ -822,24 +891,29 @@ class Lilypond_snippet (Snippet):
                        ok = ok and (os.path.exists (base + '.png')
                                     or glob.glob (base + '-page*.png'))
                return not ok
-
+       def texstr_is_outdated (self):
+               base = self.basename ()
+               ok = self.ly_is_outdated ()
+               ok = ok and (os.path.exists (base + '.texstr'))
+               return not ok
+       
        def filter_text (self):
                code = self.substring ('code')
                s = run_filter (code)
                d = {
-                 'code': s,
-                 'options': self.match.group ('options')
+                       'code': s,
+                       'options': self.match.group ('options')
                }
                # TODO
                return output[self.format][FILTER] % d
 
        def replacement_text (self):
-               func = Lilypond_snippet.__dict__ ['output_' + self.format]
+               func = Lilypond_snippet.__dict__['output_' + self.format]
                return func (self)
 
        def get_images (self):
                base = self.basename ()
-               # URGUGHUGHUGUGHU
+               # URGUGHUGHUGUGH
                single = '%(base)s.png' % vars ()
                multiple = '%(base)s-page1.png' % vars ()
                images = (single,)
@@ -870,15 +944,13 @@ class Lilypond_snippet (Snippet):
 
        def output_info (self):
                str = self.output_print_filename (HTML)
-               str = output[TEXINFO][BEFORE] % vars ()
                for image in self.get_images ():
                        (base, ext) = os.path.splitext (image)
 
-                       # URG, makeinfo implicitely prepends dot to ext
-                       # specifying no extension is most robust
+                       # URG, makeinfo implicitly prepends dot to extension.
+                       # Specifying no extension is most robust.
                        ext = ''
                        str += output[TEXINFO][OUTPUT] % vars ()
-               str += output[TEXINFO][AFTER] % vars ()
                return str
 
        def output_latex (self):
@@ -892,12 +964,10 @@ class Lilypond_snippet (Snippet):
                        if QUOTE in self.options:
                                str = output[LATEX][QUOTE] % vars ()
 
-               str += (output[LATEX][BEFORE]
-                       + (output[LATEX][OUTPUT] % vars ())
-                       + output[LATEX][AFTER])
+               str += (output[LATEX][OUTPUT] % vars ())
                return str
 
-       def output_print_filename (self,format):
+       def output_print_filename (self, format):
                str = ''
                if PRINTFILENAME in self.options:
                        base = self.basename ()
@@ -908,9 +978,11 @@ class Lilypond_snippet (Snippet):
        def output_texinfo (self):
                str = ''
                if self.output_print_filename (TEXINFO):
-                       str += ('@html\n' + self.output_print_filename (HTML)
+                       str += ('@html\n'
+                               + self.output_print_filename (HTML)
                                + '\n@end html\n')
-                       str += ('@tex\n' + self.output_print_filename (LATEX)
+                       str += ('@tex\n'
+                               + self.output_print_filename (LATEX)
                                + '\n@end tex\n')
                base = self.basename ()
                if TEXIDOC in self.options:
@@ -921,6 +993,8 @@ class Lilypond_snippet (Snippet):
                if VERBATIM in self.options:
                        verb = verbatim_texinfo (self.substring ('code'))
                        str += (output[TEXINFO][VERBATIM] % vars ())
+                       if not QUOTE in self.options:
+                               str = output[TEXINFO][NOQUOTE] % vars()
 
                str += ('@ifinfo\n' + self.output_info () + '\n@end ifinfo\n')
                str += ('@tex\n' + self.output_latex () + '\n@end tex\n')
@@ -937,7 +1011,8 @@ class Lilypond_snippet (Snippet):
 class Lilypond_file_snippet (Lilypond_snippet):
        def ly (self):
                name = self.substring ('filename')
-               return '\\renameinput \"%s\"\n%s' % (name, open (find_file (name)).read ())
+               return '\\renameinput \"%s\"\n%s' \
+                        % (name, open (find_file (name)).read ())
 
 snippet_type_to_class = {
        'lilypond_file': Lilypond_file_snippet,
@@ -953,10 +1028,12 @@ def find_toplevel_snippets (s, types):
 
        snippets = []
        index = 0
-       ## found = dict (map (lambda x: (x, None), types))
+       ## found = dict (map (lambda x: (x, None),
+       ##                    types))
        ## urg python2.1
        found = {}
-       map (lambda x, f = found: f.setdefault (x, None), types)
+       map (lambda x, f = found: f.setdefault (x, None),
+            types)
 
        # We want to search for multiple regexes, without searching
        # the string multiple times for one regex.
@@ -983,7 +1060,8 @@ def find_toplevel_snippets (s, types):
                                found[type] = (start, snip)
 
                        if found[type] \
-                          and (not first or found[type][0] < found[first][0]):
+                          and (not first \
+                               or found[type][0] < found[first][0]):
                                first = type
 
                                # FIXME.
@@ -1051,24 +1129,45 @@ def is_derived_class (cl, baseclass):
                        return 1
        return 0
 
-def process_snippets (cmd, ly_snippets, png_snippets):
-       ly_names = filter (lambda x: x, map (Lilypond_snippet.basename, ly_snippets))
-       png_names = filter (lambda x: x, map (Lilypond_snippet.basename, png_snippets))
+def process_snippets (cmd, ly_snippets, texstr_snippets, png_snippets):
+       ly_names = filter (lambda x: x,
+                          map (Lilypond_snippet.basename, ly_snippets))
+       texstr_names = filter (lambda x: x,
+                          map (Lilypond_snippet.basename, texstr_snippets))
+       png_names = filter (lambda x: x,
+                           map (Lilypond_snippet.basename, png_snippets))
 
        status = 0
-       if ly_names:
-               status = ly.system (string.join ([cmd] + ly_names),
+       def my_system (cmd):
+               status = ly.system (cmd, 
                                    ignore_error = 1, progress_p = 1)
 
-       if status:
-               ly.error ('Process %s exited unsuccessfully.' % cmd)
-               raise Compile_error
+               if status:
+                       ly.error ('Process %s exited unsuccessfully.' % cmd)
+                       raise Compile_error
+
+       # UGH
+       # the --process=CMD switch is a bad idea
+       # it is too generic for lilypond-book.
+       if texstr_names and re.search ('^[0-9A-Za-z/]*lilypond', cmd):
+               
+               my_system (string.join ([cmd + ' --backend texstr ' ] + texstr_names))
+               for l in texstr_names:
+                       my_system ('latex %s.texstr' % l)
+                                       
+
+       if ly_names:
+               my_system (string.join ([cmd] + ly_names))
+               
+
 
        if format == HTML or format == TEXINFO:
                for i in png_names:
-                       if not os.path.exists (i + '.eps') and os.path.exists (i + '.tex'):
+                       if not os.path.exists (i + '.eps') \
+                          and os.path.exists (i + '.tex'):
                                to_eps (i)
-                               ly.make_ps_images (i + '.eps', resolution = 110)
+                               ly.make_ps_images (i + '.eps',
+                                                  resolution = 110)
 
 #                      elif os.path.exists (i + '.ps'):
 #                              ly.make_ps_images (i + '.ps', resolution = 110)
@@ -1081,7 +1180,8 @@ LATEX_DOCUMENT = r'''
 \makeatletter\if@twocolumn\typeout{columns=2}\fi\makeatother
 \end{document}
 '''
-#need anything else besides textwidth?
+
+# Do we need anything else besides `textwidth'?
 def get_latex_textwidth (source):
        m = re.search (r'''(?P<preamble>\\begin\s*{document})''', source)
        preamble = source[:m.start (0)]
@@ -1121,7 +1221,7 @@ ext2format = {
 
 format2ext = {
        HTML: '.html',
-       #TEXINFO: '.texinfo',
+       # TEXINFO: '.texinfo',
        TEXINFO: '.texi',
        LATEX: '.tex',
 }
@@ -1130,10 +1230,21 @@ class Compile_error:
        pass
 
 def do_process_cmd (chunks):
-       ly_outdated = filter (lambda x: is_derived_class (x.__class__, Lilypond_snippet) \
-                       and x.ly_is_outdated (), chunks)
-       png_outdated = filter (lambda x: is_derived_class (x.__class__, Lilypond_snippet) \
-                        and x.png_is_outdated (), chunks)
+       ly_outdated = \
+         filter (lambda x: is_derived_class (x.__class__,
+                                             Lilypond_snippet)
+                           and x.ly_is_outdated (),
+                 chunks)
+       texstr_outdated = \
+         filter (lambda x: is_derived_class (x.__class__,
+                                             Lilypond_snippet)
+                           and x.texstr_is_outdated (),
+                 chunks)
+       png_outdated = \
+         filter (lambda x: is_derived_class (x.__class__,
+                                             Lilypond_snippet)
+                           and x.png_is_outdated (),
+                 chunks)
 
        ly.progress (_ ("Writing snippets..."))
        map (Lilypond_snippet.write_ly, ly_outdated)
@@ -1141,18 +1252,18 @@ def do_process_cmd (chunks):
 
        if ly_outdated:
                ly.progress (_ ("Processing...\n"))
-               process_snippets (process_cmd, ly_outdated, png_outdated)
+               process_snippets (process_cmd, ly_outdated, texstr_outdated, png_outdated)
        else:
                ly.progress (_ ("All snippets are up to date..."))
        ly.progress ('\n')
 
 def do_file (input_filename):
-       #ugh
+       # Ugh.
        global format
        if not format:
                e = os.path.splitext (input_filename)[1]
                if e in ext2format.keys ():
-                       #FIXME
+                       # FIXME
                        format = ext2format[e]
                else:
                        ly.error (_ ("cannot determine format for: %s" \
@@ -1179,7 +1290,7 @@ def do_file (input_filename):
                input_base = os.path.basename \
                             (os.path.splitext (input_filename)[0])
 
-       # only default to stdout when filtering
+       # Only default to stdout when filtering.
        if output_name == '-' or (not output_name and filter_cmd):
                output_filename = '-'
                output_file = sys.stdout
@@ -1193,10 +1304,11 @@ def do_file (input_filename):
                                           + '/' + input_base
                                           + format2ext[format])
 
-               if (os.path.exists (input_filename) and
-                   os.path.exists (output_filename) and
-                   os.path.samefile (output_filename, input_fullname)):
-                       ly.error (_ ("Output would overwrite input file; use --output."))
+               if os.path.exists (input_filename) \
+                  and os.path.exists (output_filename) \
+                  and os.path.samefile (output_filename, input_fullname):
+                       ly.error (
+                         _ ("Output would overwrite input file; use --output."))
                        ly.exit (2)
 
                output_file = open (output_filename, 'w')
@@ -1207,7 +1319,8 @@ def do_file (input_filename):
                source = in_handle.read ()
                ly.progress ('\n')
 
-               # FIXME: containing blocks must be first, see find_toplevel_snippets
+               # FIXME: Containing blocks must be first, see
+               #        find_toplevel_snippets.
                snippet_types = (
                        'multiline_comment',
                        'verbatim',
@@ -1216,7 +1329,8 @@ def do_file (input_filename):
                        'singleline_comment',
                        'lilypond_file',
                        'include',
-                       'lilypond', )
+                       'lilypond',
+               )
                ly.progress (_ ("Dissecting..."))
                chunks = find_toplevel_snippets (source, snippet_types)
                ly.progress ('\n')
@@ -1230,16 +1344,21 @@ def do_file (input_filename):
                                  '''%.0f\\pt''' % textwidth
                        elif format == TEXINFO:
                                for (k, v) in texinfo_linewidths.items ():
-                                       # FIXME: @layout is usually not in chunk #0:
-                                       #        \input texinfo @c -*-texinfo-*-
-                                       # bluntly search first K of source
+                                       # FIXME: @layout is usually not in
+                                       # chunk #0:
+                                       #
+                                       #  \input texinfo @c -*-texinfo-*-
+                                       #
+                                       # Bluntly search first K items of
+                                       # source.
                                        # s = chunks[0].replacement_text ()
                                        if re.search (k, source[:1024]):
                                                default_ly_options[LINEWIDTH] = v
                                                break
 
                if filter_cmd:
-                       output_file.writelines ([c.filter_text () for c in chunks])
+                       output_file.writelines ([c.filter_text () \
+                                                for c in chunks])
 
                elif process_cmd:
                        do_process_cmd (chunks)
@@ -1256,7 +1375,9 @@ def do_file (input_filename):
                        do_file (name)
 
                map (process_include,
-                    filter (lambda x: is_derived_class (x.__class__, Include_snippet), chunks))
+                    filter (lambda x: is_derived_class (x.__class__,
+                                                        Include_snippet),
+                            chunks))
        except Compile_error:
                os.chdir (original_dir)
                ly.progress (_ ("Removing `%s'") % output_filename)
@@ -1320,7 +1441,7 @@ def main ():
        files = do_options ()
        global process_cmd
        if process_cmd == '':
-               process_cmd = lilypond_binary + " -f tex "
+               process_cmd = lilypond_binary
 
        if process_cmd:
                process_cmd += string.join ([(' -I %s' % p)
@@ -1336,3 +1457,5 @@ def main ():
 
 if __name__ == '__main__':
        main ()
+
+# EOF