Documentation/user/convert-ly.txt

   1 %future
   2 %
   3
   4 There are a few things that the convert-ly cannot handle. Here's a list of limitations
   5 that the community has complained about.
   6
   7 This bug report structure has been chosen because convert-ly has a structure that doesn't
   8 allow to smoothly implement all needed changes. Thus this is just a wishlist, placed
   9 here for reference.
  10
  11 1.6->2.0:
  12  Doesn't always convert figured bass correctly, specifically things like {< >}. Mats' comment on working around this:
  13    To be able to run convert-ly
  14    on it, I first replaced all occurencies of '{<' to some dummy like '{#'
  15    and similarly I replaced '>}' with '&}'. After the conversion, I could
  16    then change back from '{ #' to '{ <' and from '& }' to '> }'.
  17  Doesn't convert all text markup correctly. In the old markup syntax,
  18  it was possible to group a number of markup commands together within parentheses, e.g.
  19    -#'((bold italic) "string")
  20    This will incorrectly be converted into
  21    -\markup{{\bold italic} "string"}
  22    instead of the correct
  23    -\markup{\bold \italic "string"}
  24 2.0->2.2:
  25  Doesn't handle \partcombine
  26  Doesn't do \addlyrics => \lyricsto, this breaks some scores with multiple stanzas.
  27 2.0->2.4:
  28  \magnify isn't changed to \fontsize.
  29     - \magnify #m => \fontsize #f, where f = 6ln(m)/ln(2)
  30  remove-tag isn't changed.
  31     - \applymusic #(remove-tag '. . .) => \keepWithTag #'. . .
  32  firstpagenumber isn't changed.
  33     - firstpagenumber no => printfirstpagenumber = ##f
  34  Line breaks in header strings aren't converted.
  35     - \\\\  as line break in \header strings => \markup \center-align <
  36       "First Line" "Second Line" >
  37  Crescendo and decrescendo terminators aren't converted.
  38     - \rced => \!
  39     - \rc => \!
  40 2.2->2.4:
  41  \turnOff (used in \set Staff.VoltaBracket = \turnOff) is not properly converted.
  42 2.4.2->2.5.9
  43  \markup{ \center-align <{ ... }> } should be converted to:
  44  \markup{ \center-align {\line { ... }} }
  45  but now, \line is missing.
  46 2.4->2.6
  47  Special LaTeX characters such as $~$ in text are not converted to UTF8.