]> git.donarmstrong.com Git - lilypond.git/blobdiff - TODO
patch::: 1.1.29.jcn3: sleur volg muziek fix
[lilypond.git] / TODO
diff --git a/TODO b/TODO
index 7f8f4b5f9c027687e0d317b0334933ae64d4fc6d..a5b256713df2fea94d62d33bc734f8360f589d62 100644 (file)
--- a/TODO
+++ b/TODO
-Features you cannot find in the doco as working, should be mentioned here.
+-*-outline-layout:(2 (-1 -1 0 :) 0);outline-stylish-prefixes:nil -*-
 
-
-This is an assorted collection of stuff that will be done, might be
-done, or is an idea that I want to think about
+* GNU LilyPond TODO
+Features you cannot find in the doco as working, should be
+mentioned here.  This is an assorted collection of stuff that will be
+done, might be done, or is an idea that I want to think about
 
 Most of the items are marked in the code as well, with full explanation. 
 grep for TODO and ugh/ugr/urg
 
-       * use streambufs to provide IO handling for TeX stream, mudela stream,
-data-file.
-
-       * seriously buffer TeX output (do profile of writing .5 mb TeX file.)
-
-       * strip EXEs before installing
-
-       * zip target for binary windows dist (JBR)
-
-       * repeat bars: need distance after ":|" and before "|:"
-
-       * doco should not depend on a4
-
-       * text continuationss
-
-       * fix plain tex footer line.
-
-       * install TeX stuff into tex/generic directory.
-
-       * preformatted .info stuff.
-
-       * percussion note heads
-
-       * mi2mu empty staffs.
-
-       * include MIDI list 
-
-       * make separate translation property list.
-
-       * make GNU style webpages.
-
-       * There seems to be an install error in lilypond-1.0.0.  Most of the
-       files in the "init" directory don't get installed in the
-       /usr/local/share/lilypond directory.  The files installed are of
-       the form feta*.ly.  In particular init.ly doesn't get installed.
-       I installed the files by hand and then the system seems to work.
-
-       * midi_instrument -> midiInstrument
-
-       * horizontal centering of dynamics 
-
-       * \font\fontA=feta20.afm (.afm?)
-
-       * gzip RH manpage
-
-       * stable make/config stuff
-
-       * stemup/stemdown; see test/updown.fly
-         - check examples; add \type Staff hither and thether
-
-       * $DEPENDENCIES_OUTPUT support
-
-       * use a fake-yodl.sh to mimick yodl when yodl is not installed
-
-       * fix BUGs
-
-       * fix weird behaviour when .AFMs not found.
-
-       * Xdvi zooming ?!
+.* BUGS
+. * .ly files
+.  * input/praeludium-fuga-E.ly
+.  * input/font20
+.  * mutopia/J.S.Bach/wtk1-fugue2.ly
+.  * fix: text on rests: rediculous dims
+. * fix midi output:
+.  * default duration?  d
+     duration must be not entered explicitely on first note.
+. * fix singleStaffBracket
+. * \shape 1st dim skipped? 
+. * turn slope-damping on/off
+. * c4 \! \> c4
+. * tremolo stuff
+. * gallina barlines.
+. * fix height of / collisions with lyrics (chords), 
+    see input/test/vertical-text.ly; input/test/repeat.ly
+. * latex bla.tex broken (titles / \lilyfooter stuff?)
+. * fix dynamics decently, ie. use kerning & ligatures.  
+. * fix "I've been drinking too much"
+. * support_l_arr_ empty in staff-margin's G_staff_side_item
+. * remove old preformats in RPM
+. * declaring \score   
+. * is \break broken? input/test/hara-kiri.ly
+. * fix OrchestralScore and Hara-kiri (i.e., fix Coriolan)
+. *
+\score{
+       \type Staff \notes\relative c''{
+               \property Staff.instrument = "Toeters"
+               c c c c(\break
+               )c c c c ~\break
+               c c c c\break
+       }
+       \paper{
+               linewidth=60.0\mm;
+%              \translator { \HaraKiriStaffContext }
+               \translator { \OrchestralScoreContext }
+               \translator {
+                       \StaffContext
+                       \consists "Staff_margin_engraver";
+               }
+       }
+}
+
+. *
+Phrasing:  Indicating the textual underlay of a piece, or
+               otherwise dividing a piece into phrases.
+
+There are distinct ways of specifying the first two (although at
+present, they're not properly distinguished) but no distinct way to
+specify the third.  Should there be?
+
+.* TODO before 1.2
+. *
+> Yes.  I want ties to tie only notes of the same pitch, so that
+>      f < a~  a,>  a
+> works as you'd expect it to.
+
+I don't think that's functional, but there is a bug (--jcn):
+Lily will set a tie between the a and the preceeding f.
+. * 1. Can Lily be told where to start numbering?
+Fix: set bar-number to 0 if first bar is an anacrouse?
+. * The timpani part has rests the full first line. Is it possible
+   to force lilypond to print all parts on the first page of the score
+   but use the hara-kiri mechanism on the remaining pages?
+. * do scaled fonts.
+. * profile atom smobs
+. * make ly2dvi test page.
+. * Try to use Killing_cons iso. Pointer_list
+. * make dependencies () a virtual function.
+. * fix Repeated_music_iterator::ok() (constness.)
+. * one big ly2dvi input that includes *all* tests.
+. * Don't use boolean properties (0,1), instead check existence
+of property.
+. * store req -> element, element -> element causes for warnings
+. * junk Text_def, use G_text_item in stead.
+. * junk Script_def
+. * fix partial measures in meaningful way.
+. * fix AFM for BlueSky AFM files.
+. * working notehead style.
+. * add scripts to bars eg.  |^"bla" 
+. * relative mode for mi2mu
+. * uniformise recent feta contributions.
+.  * use SCM and Molecules for {accordeon stuff, }
+.  * bigger and fatter 4/4 C
+. * sort out directory stuff.
+.  * --prefix option?
+.  * -I option per filetype?
+.  * kpathsea?
+. * todo doc left/rightbeamcount
+. * doc Single_malt_grouping_item
+. * ly2dvi/lilypond logfile.
+. * How can I specify a chord whose duration is longer than a whole note?
+ \type ChordNames { \chord{ A1*2-min } }
+
+gives me a parse error.  And \times doesn't work either.  I can't use
+a spacer note.  So it seems to be impossible to have long chords of
+general length.  Of course, in the example above I can use \breve.
+But what if I want a chord that lasts for 3 whole notes?  Or what
+about 2.5 whole notes?  Is there a mechanism for getting this kind of
+length?  
+
+
+Why does my second extender request get junked in the following:
+
+\score{
+< \notes \relative c''{ 
+     a4()b()c()d c()d()b()a }
+   \type Lyrics \lyrics {
+     foo1 __  bar2. __ _4 }
+> }
+
+It seems that \cr and \decr don't work any more.  
+
+\score{
+  \notes{
+    a \cr b \rc c }
+  \paper{linewidth=-1.;}
+}
+
+Gives me 
+
+qq.ly:3:9: warning: can't find (de)crescendo to end:
+    a \cr
+          b \rc c }
+
+
+
+Use of semicolons is still rather confusing.  They are obligatory
+after some types of assignments and illegal after others.  
+
+  \property foo=bar               illegal
+  foo = 3 at top level            illegal
+  foo = 3 inside \paper           obligatory               
+  foo = \notes{ ...} top level    illegal
+  foo = \translator{ } in \paper  obligatory
+
+As far as I can tell, the sole accomplishment of this syntactic
+irregularity is to keep the user as confused as possible.  
+
+
+I was trying to get interstaff beams to work and did this:
+
+\score{
+\type GrandStaff <
+\type Staff=one \notes\relative c'{
+  \stemup
+  [c8 c \translator Staff=two \stemup c c]
+  \translator Staff=one
+  \stemdown 
+  [ b8 \translator Staff=two a8]
+  \translator Staff=one 
+  c4 
+  }
+\type Staff=two \notes{ \clef bass; s1 }
+>
+\paper{
+               \translator{
+                       \GrandStaffContext
+                       minVerticalAlign = 3.0*\staffheight;
+                       maxVerticalAlign = 3.0*\staffheight;
+               }
+  linewidth = -1.;
+}
+}
+
+The beams are at the right angle, but they aren't in the right place.
+. * fractional chord durs.
+. * hang Item on Spanner
+. * remove Interval dim_ from Dimension_cache and rename the struct.
+. * do --safe for PS output?
+. * convert-mudela --output
+. * Staff_margin (with a partial measure.)
+. * fix "I've been drinking too much"
+. * fix pletvisibility properties:
+.  * bracket on/off/no-bracket-when-beam
+.  * num on/off/no-num-when-beam
+. * fix: standchen.
+. * junk backlinks?
+. * junk text{sharp,flat,etc}
+. * fix convert-mudela manpage
+. * decimal point in \paper {}
+. * {  \voiceone <a'4.*2/3  d''4.*2/3 fis''4.*2/3>  [g''8 fis'' e''] d''4 |}
+        and=20
+        { \voicetwo  d'4 d'2.*2/3 } spacing
+. * tied notes for MIDI
+. * sharp /flat on trills (in MIDI ??)
+. * scm-ify \property values.
+. * move class Lookup {} into scm
+. * collisions/voices \voiceone \voicetwo are broken; see 
+. * msgfmt -o check?
+. * \breathmark TeX macro 
+. * catch GUILE errors?
+. * add new glyphs to font.ly
+. * formatting of input stuff. 
+. * \notes{ a \< b \cr } vs \notes{ a \< b \! }
+. * if possible, it might be nice for a warning to appear if someone does
+       \translator with no name and without assigning it to an
+       identifier.  
+. * space after bars?
+. * 'hinterfleisch' before bar (e.g. wtk1-fugue2)?
+. * \type Voice \times 2/3 { [c8 c16 c16 c16 c16] }
+. * repeat bars: need distance after ":|" and before "|:"
+.* Summary of minor spelling irregularities:
+. *  capitalization/use of underscores in property names
+. * fix SkipBars  -> skipBars
+
+. * fix marks/barnumbers/marginal notes
+. * broken scripts:
+       lbheel = \script { "bheel" 0 0 -1  0 0 }
+       rbheel = \script { "bheel" 0 0 1 0 0 }
+       lbtoe = \script { "btoe" 0 0 -1 0 0 }
+       rbtoe = \script { "btoe" 0 0 1 0 0 }
+       lfheel = \script { "fheel" 0 0 -1  0 0 }
+       rfheel = \script { "fheel" 0 0 1 0 0 }
+       lftoe = \script { "ftoe" 0 0 -1 0 0 }
+       rftoe = \script { "ftoe" 0 0 1 0 0 }
+       
+       and also
+       
+       portato= \script { "portato" 0 -1 0 1 0 }
+. * ly2dvi
+.  * bottomnote for ly2dvi
+.  * cf'able ly2dvi  tagline.
+.  * deps for ly2dvi
+.* STUFF
+. * check out legal/(c) matters for scores.
+. * check out GCC signatures?
+. * Align_element::padding  ?
+. * uniformise property names...
+.  * ydirection <-> yDirection
+.  * rather allow '_' in identifiers first (i.e. junk ^ and _),
+           and do y_direction?
+.  * typo checks on property names?
+. * use streambufs and iostream
+       to provide IO handling for TeX stream, mudela stream, data-file.
+. * seriously buffer TeX output (do profile of writing .5 mb TeX file.)
+. * strip EXEs before installing
+. * zip target for binary windows dist (JBR)
+. * junking \skip req in lyrics
+. * Language:
+.  * \type -> \context ?
+.  * \translator -> ?
+.  * fix \partial 
+.  * \bla {} vs \bla ; 
+.  * mix engraver hacking with music ?
+.  * \once\property  KEY = VAL
+.  * \addtranslator, \removetranslator
+.  * junk ^ and _ for scripts
+.  * junk _ for lyrics.
+.  * abstract grammar.
+. * percussion note heads
+. * mi2mu empty staffs.
+. * horizontal centering of dynamics 
+. * gzip RH manpage
+. * stable make/config stuff
+. * $DEPENDENCIES_OUTPUT support
+. * Xdvi zooming ?! Try to understand GS garbage collection.
                gs: Error: /undefined in draw_beam
                gs: Operand stack:
-
-       * run texhash after installing .tex
-
-       * fix vertical alignment and stafflines
-
-       *GrandStaff needs more work -- I want a single word `harpsichord' to the
-          left of the grandstaff, not one on each stave.
-          (Organ staff -- with separate pedal -- but common properties may be
-          something to think about.  Of course for organ you want to be able
-          to give stop indications on the way through, so the \property
-          Voice.Instrument would be a stop, and \property
-          GrandStaff.instrument would be PipeOrgan...)
-
-
-       * make Tie_req a "command" { <c g> ~ <c g> }
-
-       * bib ep1988
-
-       * mix engraver hacking with music ?
-
-       * revise the Score_priority_align_engraver concept.  It sucks. 
-
-       * ly2xdvi
-
-       * make new VoiceOne, VoiceTwo, VoiceThree contexts with
+. * fix vertical alignment and stafflines
+. * GrandStaff needs more work -- I want a single word
+       `harpsichord' to the left of the grandstaff, not one on each
+       stave.  (Organ staff -- with separate pedal -- but common
+       properties may be something to think about.  Of course for
+       organ you want to be able to give stop indications on the way
+       through, so the \property Voice.Instrument would be a stop,
+       and \property GrandStaff.instrument would be PipeOrgan...)
+. * revise the Score_priority_align_engraver concept.  It sucks. 
+. * make new VoiceOne, VoiceTwo, VoiceThree contexts with
 ydirection and hshift preset
-
-       * *.yo: fix pod manpage layout legacy
-
-       * text-items clash with stems/beams
-
-       * --include, -I option for ly2dvi (pass on to lily)
-
-       * fix placement of beam-less abbrev
-
-       * \meter 3/4;
+. * *.yo: fix pod manpage layout legacy
+. * text-items clash with stems/beams
+. * --include, -I option for ly2dvi (pass on to lily)
+. * fix placement of beam-less abbrev
+. * \meter 3/4;
        <{\voiceone cis4. cis8 cis4 | cis4 cis cis | r1 }
         {\voicetwo cis,4 r r | r2. | r1 }> |
        }
-
-       * try to use template<Type> iso MACRO(Type)
-
-       - NEWS: ... Musical_pitch (analogous to Duration and Rhythmic_req)
+. * try to use template<Type> iso MACRO(Type)
+.  * NEWS: ... Musical_pitch (analogous to Duration and Rhythmic_req)
          think about, analogous to pitch: 
           * { a4 a16 } c <-- duration of c?
-          * <a4 b8> c <-- duration of c?
-
-       * \tempo 4. = 90;
-
-       * fix audio-items (don't use (input) requests, but copy data)
-
-       * junk My_lily_parser::abbrev_beam_type_i_ 
-
-       * make sure all ex's have a mudela-version
-
-       * do rest-collisions for Multi_measure_rests as well.
-
-       * split error/warning in error/warning/non_fatal_error
-
-       * add a Duration_convert member to Duration_iter to set parameters.
+          * < a4 b8 > c <-- duration of c?
+. * \tempo 4. = 90;
+. * fix audio-items (don't use (input) requests, but copy data)
+. * make sure all ex's have a mudela-version
+. * do rest-collisions for Multi_measure_rests as well.
+. * split error/warning in error/warning/non_fatal_error
+. * add a Duration_convert member to Duration_iter to set parameters.
        Junk global duration settings. 
-       * deps for ly2dvi
-
-       * clean up abbrev/plet/beam/abbrevbeam/duration mess in parser.
-
-       * minimum length second part broken tie
-       * en-,discouraged linebreaking: 
-         - handle DISALLOW < penalty > FORCE
-         - discourage breaking of slurs
-
-       * multibar rest
-         - symbol(s)
-
-       * fix variable define/lookup parser global<->paper
-
-       * fix title/instrument placements; see input/test/title.ly
-
-       * <\voiceone c4. \voicetwo c4>
-
-       * add full cello suites to web site (kom op, Maarten!)
-
-       * Rethink Time_description
+. * minimum length second part broken tie
+. * en-,discouraged linebreaking: 
+.  * handle DISALLOW < penalty > FORCE
+.  * discourage breaking of slurs
+. * fix variable define/lookup parser global<->paper
+. * fix title/instrument placements; see input/test/title.ly
+. * <\voiceone c4. \voicetwo c4>
+. * add full cello suites to web site (kom op, Maarten!)
+. * Rethink Time_description
          * \cadenza , \meter, \grouping should all be \properties
-
-       * rename
-         - plet -> tuplet
-         - measure -> bar
-         - abbreviation-beam -> (measured/unmeasured) tremolo
-         - partial -> anacrouse
-
-       * libtoolize flowerlib
-
-       * shared lib
-
-       * robustify Beam (in case of no stems, 32nd notes)
-
-       * decentralised spring factory
-
-       * move paper vars into engraver properties
-
-       * check for groff / troff/ nroff et
-
-       * more intelligent file searching
-       - use kpsepath
-       - make LilyPond fully relocatable
-
-       * use kpsepath to find all TeX dirs
-       - configure.in 
-       - clean-fonts.sh
-
-       * nicen examples:
-       - break-up heavily-nested score blocks
-
-       * disable spaces in TeX stuff
-       
-       * handle ^C for tmp/file creation.
-
-       * dots & rest collisions.
-
-       * documentation
-       - introduction?
-       - info?
-       - LaTeX?
-       - more manpages?
-
-       * versioning for Feta
-
-       * the warning about the negative slur/tie length appears twice
+. * rename
+.  * measure -> bar
+.  * abbrev -> tremolo
+.  * abbreviation-beam -> (measured/unmeasured) tremolo
+.  * partial -> anacrouse
+. * shared lib
+. * robustify Beam (in case of no stems, 32nd notes)
+. * decentralised spring factory
+. * move paper vars into engraver properties
+. * check for groff / troff/ nroff et
+. * more intelligent file searching
+. * make LilyPond RPM fully relocatable
+. * disable spaces in TeX stuff
+. * handle ^C for tmp/file creation.
+. * dots & rest collisions.
+. * documentation
+.  * introduction?
+.  * info?
+.  * LaTeX?
+.  * more manpages?
+. * versioning for Feta
+. * the warning about the negative slur/tie length appears twice
        which is irritating.
-
-       * The `3' in the meter key is a one or two pixels too thin (at 600dpi)
+. * The `3' in the meter key is a one or two pixels too thin (at 600dpi)
        in the middle:
-
-       * the bracket is ugly (wings are too parabolic, should be more circular)
-
-       * better hshift (dots, distance, head dependent)
-
+. * the bracket is ugly (wings are too parabolic, should be more circular)
+. * better hshift (dots, distance, head dependent)
         * clefs (AG): The "8" should appear closer to the actual clef,
           touching it.
-
-       * scoping for properties?
-
-       {       c4
-               \multi 2  < { \stemup .. } { \stemdown .. } >
-               c2 
-       }
-
-       this modifies \stem for the c2
-
-       * put errorlevel in Input class
-
-       * junk nesting slurs
-
-       * integrate midi-elts from mi2mu and lily?
-
-       * cautionary accidental
-
-       * score-bar-scripts
-       FMR: Free memory read:
-         * This is occurring while in:
-               Bar_column::do_substitute_dependency(Score_element*,Score_element*) [bar
-       -column.cc:29]
-               Score_element::unlink() [score-elem.cc:383]
-               Paper_score::set_breaking(const Array<Column_x_positions>&) [p-score.cc:
-       150]
-               Paper_score::calc_breaking() [p-score.cc:189]
-               Paper_score::process() [p-score.cc:203]
-               Score::run_translator(Music_output_def*) [score.cc:117]
-         * Reading 4 bytes from 0x65d3a0 in the heap.
-         * Address 0x65d3a0 is 160 bytes into a freed  block at 0x65d300 of 208 bytes.
-         * This block was allocated from:
-               malloc         [rtlib.o]
-               __builtin_new  [libgcc.a]
-               Span_score_bar::clone()const [span-score-bar.hh:20]
-               Item::copy_breakable_items() [item.cc:69]
-               Item::do_breakable_col_processing() [item.cc:89]
-               Score_element::calcalute_dependencies(int,int,void(Score_element::*)()*)
-        [score-elem.cc:171]
-         * There have been 22 frees since this block was freed from:
-               free           [rtlib.o]
-               __builtin_delete [libgcc.a]
-               Span_score_bar::~Span_score_bar() [span-score-bar.hh:18]
-               Paper_score::set_breaking(const Array<Column_x_positions>&) [p-score.cc:
-       156]
-               Paper_score::calc_breaking() [p-score.cc:189]
-               Paper_score::process() [p-score.cc:203]
-       Postprocessing elements... 
-       TeX output to score-bar-scripts.tex...
-
-
-3RD PARTY BUGS:
-
-       * redhat (v?) graphical install bomb-out?
-
-       * egcs-1.03 ice: stem.cc:327; should localize bug (mine's still 10K)
-
-       * gcc 2.8.1: see ice and RESIZE_ICE
-
-       * xdvi: PS in magnifying glass.
-
-       * GNU patch 2.1: hardcoded limit of 1024 to the linelength
-
-       * GNU diff 2.7: diff -rN does not see a new directory with empty file
-
-       * GNU patch 2.1: <must find simple example> if patch chokes on a
-         hunk, or on allegedly unsorted hunks in a diff, it may stop 
-         without a trace of failure (create .rej file, print error or 
-         dump core) and just ignore any further diffs.
-
-       * glibc 2.0:
-
+. * put errorlevel in Input class
+. * junk nesting slurs
+. * integrate midi-elts from mi2mu and lily?
+.* 3RD PARTY BUGS
+. * GNU diff 2.7: diff -rN does not see a new directory with empty file
+. * glibc 2.0:
          f = fopen ("/dev/null", "r")
          assert (feof (f))
-
-3RD PARTY PROJECTS:
-
-       * GNU indent: handle C++
-
-       * GNU make: move hardcoded builtin rules to runtime ?
-
-       * GNU patch 
-         - rewrite ? -> check out GNU patch 2.5
-         - 'double-fix' mode: ignore identical fix, rather than suggest 
+.* 3RD PARTY PROJECTS:
+. * make GCC warn about ctor that leaves member vars  uninitialised.
+. * GNU patch 
+.  * 'double-fix' mode: ignore identical fix, rather than suggest 
            to revert patch direction when (more or less? exactly) the same 
            thing is fixed
-
-PROJECTS
-
-       * Scripts:
-       - fix position of bar number
-       - stack scripts in chords:
+.* PROJECTS
+. * Scripts:
+.  * fix position of bar number
+.  * stack scripts in chords:
          % fingering:        footing:
            < a-4 c-2 g-1 >   < c-\ltoe e-\lheel >
-       - script-spacing
-       - slur parts as a script
-       - stack parameterised scripts for fingering and footing:
-
-       * convert-mudela:
-       - automatically add  a \version if not present.
-       - better parsing
-       - make smarter
-       - convert-mudela -e empty.ly
-
-       * emacs mudela-mode
-       -  should handle block comments too.
-       -  handle lexer modes (\header, \melodic, \lyric) etc.
-       -  indentation
-       -  notenames?
-       -  fontlock: \melodic \melodic
-
-       * use properties for:
-       - Text_style
-       - default_octave
-       - plet?
-       - Staff_sym size
-       - default tempo.
-       - font size
-       - bartypes (get rid of derived Span_bar_engravers)
-       - cadenza mode? 
-       - MIDI instrument
-       - staff title
-
-       * page handling:
-       - PS output
-       - optimal pagebreaking.
-
-       * Unicode support? -> man 7 unicode
-       - 16 bit Strings
-       - -u switch
-       - detect of 16/8 bit files
-       - examples to go with it.
-
-       * Spring_spacer:
-       - write a faster Spring_spacer (without matrices if possible)
-       - use straight LP to find minimal "fitting force"
-       - relate energybound to linelen unitspace fontsize etc.
-       - used fixed point fp
-
-       * \header
-       - output header info to MIDI too.
-
-       * Add mudela-output to Rosegarden. (contact Derek Wyatt)
-
-       * a musical dictionary. See Documentation/vocabulary-*, other
+.  * script-spacing
+.  * slur parts as a script
+.  * stack parameterised scripts for fingering and footing:
+
+. * convert-mudela:
+.  * automatically add  a \version if not present.
+.  * better parsing
+.  * make smarter
+.  * convert-mudela -e empty.ly
+
+. * emacs mudela-mode
+.  *  should handle block comments too.
+.  *  handle lexer modes (\header, \melodic, \lyric) etc.
+.  *  indentation
+.  *  notenames?
+.  *  fontlock: \melodic \melodic
+
+. * use properties for:
+.  * plet?
+.  * Staff_sym size
+.  * default tempo.
+.  * font size
+.  * bartypes (get rid of derived Span_bar_engravers)
+.  * cadenza mode? 
+
+. * page handling:
+.  * PS output
+.  * optimal pagebreaking.
+
+. * Unicode support? -> man 7 unicode
+.  * 16 bit Strings
+.  * -u switch
+.  * detect of 16/8 bit files
+.  * examples to go with it.
+
+. * Spring_spacer:
+.  * write a faster Spring_spacer (without matrices if possible)
+.  * relate energybound to linelen unitspace fontsize etc.
+.  * used fixed point fp?
+
+. * \header
+.  * output header info to MIDI too.
+
+. * a musical dictionary. See Documentation/vocabulary-*, other
        languages:
-       - explanation
-       - italian
-       - german
-       - dutch
-       - swedish
+.  * explanations
+.  * italian
+.  * german
+.  * dutch
+.  * swedish
         .. ?
 
-       * chords
-       - guitar chords
-       - chord names
-       - basso continuo
-       - Syntax/parser
-       - MIDI output?
-       - typesetting
-
-       * Debug logs:
-       - derive lily_stream, Dstream, texstream from ostream?
-       - indentable stream as baseclass for TeX stream, lily stream, Dstream.
-       - use dstream feature in mi2mu
-       - integrate IO checking into stream class
-
-       * input converters
-       - NIFF?
-       - ABC? 
-       - SMDL?
-
-       * add to MIDI output:
-       - tempo change
-       - ornaments (and trills?)
-       - repeat
-       - slurs
-       - accents
-       - dynamics
-       - account for rhythmic position in measure
-       - etc.
-
-       * grace notes
-       - make separate class for Grace_*_engravers 
+. * chords
+.  * guitar chords (fret diagrams)
+.  * other chord name styles (american(?) style)
+.  * basso continuo
+.  * MIDI output?
+
+. * Debug logs:
+.  * derive lily_stream, Dstream, texstream from ostream?
+.  * indentable stream as baseclass for TeX stream, lily stream, Dstream.
+.  * use dstream feature in mi2mu
+.  * integrate IO checking into stream class
+
+. * input converters
+.  * NIFF?
+.  * ABC? 
+.  * SMDL?
+
+. * add to MIDI output:
+.  * tempo change
+.  * ornaments (and trills?)
+.  * repeat/volta
+.  * slurs
+.  * accents
+.  * dynamics
+.  * account for rhythmic position in measure
+.  * etc.
+
+. * grace notes
+.  * make separate class for Grace_*_engravers 
        (which is at Voice_gravs level)
-       - make encapsulated spacing problems.
+.  * make encapsulated spacing problems.
 
-       * accidentals per Voice_group
+. * accidentals per Voice_group
 
-       * Output class, handles : (smallish)
-       - help text /(c) notice?
-       - version line
-       - warning /errors/progress
-       - abort on error/warning; exit status
-       - quiet/ignore-version options
-       - logfile output
+. * Output class, handles : (smallish)
+.  * help text /(c) notice?
+.  * version line
+.  * warning /errors/progress
+.  * abort on error/warning; exit status
+.  * quiet/ignore-version options
+.  * logfile output
 
-       * piano staff
+. * elaborate Staff_side baseclass:
+.  * scripts
+.  * text
+.  * slur start/end
 
-       * elaborate Staff_side baseclass:
-       - scripts
-       - text
-       - slur start/end
+. * PS 
+.  * speed up PS code.
+.  * PS lines to .eps files
+.  * write custom prolog
 
-       * PS 
-       - speed up PS code.
-       - PS lines to .eps files
-       - write custom prolog
-
-
-       * Output an output format independent (ofi) typeset file; and 
+. * Output an output format independent (ofi) typeset file; and 
          make ofi2 TeX, MusiXTex, Display PostScript, PostScript,
          Ascii... interpreters. (difficult)
 
-       - NIFF ?
-       - Common Music Notation
-       - PostScript output (esp. Beams, Slurs, etc)
-       - Move all Score_elems, into libmutype.a
-       - SGML
-
-       * Documentation
-       - Doc (C) stuff of sheet music
-       - a better format?  SGML?  TeX?  Info?
-       - a tutorial
-
-       * more spanners (smallish)
-       - Glissando
-       - trill
-
-       * Rewrite Stem, Beam and Rhythmic_grouping (hairy)
-       - [c8. c32 c32]
-       - doc on Rhythmic_grouping
-       - general shaving on Beam and Stem
-       - use plet grouping
-       - separate visual from rhythmic info even more
-       - beams over bars
-       - endbeam req should be *after* the duration, so you can do
-       < { [c4]    }
-         { c8. c16 } >
-
-
-       * lines:
-       - Ledger lines, should be separate item: Ledger_lines, Ledger_lines
-       - set different line sizes / thicknesses
-       - beam stem showthrough, inter beam sizes (french vs german style)
-
-       * Collisions
-       - left/right note balls should be handled by Collision:
+.  * NIFF ?
+.  * Common Music Notation
+.  * PostScript output (esp. Beams, Slurs, etc)
+.  * Move all Score_elems, into libmutype.a
+.  * SGML
+
+. * Documentation
+.  * Doc (C) stuff of sheet music
+.  * a better format?  SGML?  TeX?  Info?
+.  * a better tutorial
+
+. * more spanners (smallish)
+.  * Glissando
+.  * trill
+
+. * Rewrite Stem, Beam and Rhythmic_grouping (hairy)
+.  * [c8. c32 c32]
+ **** doc on Rhythmic_grouping
+.  * general shaving on Beam and Stem
+.  * use plet grouping
+.  * separate visual from rhythmic info even more
+.  * beams over bars
+
+. * lines:
+.  * Ledger lines, should be separate item: Ledger_lines, Ledger_lines
+.  * set different line sizes / thicknesses
+.  * beam stem showthrough, inter beam sizes (french vs german style)
+
+. * Collisions
+.  * left/right note balls should be handled by Collision:
        < \multi 2; { \stem 1; <b c> } { <f as b> } >
 
-       * Keys:
-       - merge key{item} & localkey{item}?
-       - Major/Minor
-       - spacing, national styles?
+. * Keys:
+.  * merge key{item} & localkey{item}?
+.  * spacing, national styles?
 
-       * Support for TAB
-       - redo Notehead to allow digits as heads
-       - add a \tablature {} lexer mode for easy entering
+. * Support for TAB
+.  * redo Notehead to allow digits as heads
+.  * add a \tablature {} lexer mode for easy entering
 
-       * should adjust stemlength for flag number.
+. * should adjust stemlength for flag number.
 
-       * breaking:
-       - caching breakpoints
-       - saving them
-       - specify number of lines
+. * breaking:
+.  * caching breakpoints
+.  * saving them
+.  * specify number of lines
+.* INPUTLANGUAGE
 
-       * markers
-
-INPUTLANGUAGE
-
-       * c4 4 4 4 for c4 c4 c4 c4?
-
-       * neatly (and readably) expressing concurrent
+. * c4 4 4 4 for c4 c4 c4 c4?
+. * neatly (and readably) expressing concurrent
        voices
-
-       * <c f a>4 ?
-
-       * Viola mode?
+. * <c f a>4 ?
+. * Viola mode?
 
                @c c g e g 
        for
@@ -497,68 +527,48 @@ INPUTLANGUAGE
                @A c g e g
        for
                cis gis e gis
+. * relative mode for pitch entering
+. * configure pitch_byte
+. * rest name configurable
 
-       * relative mode for pitch entering
-
-       * bracket: volta 1,2
-
-       * configure pitch_byte
-
-       * rest name configurable
-
-SMALLISH PROJECTS
-
-       * limit memory usage; the full coriolan takes up too much resources.
 
-       * fix confusing naming in Engraver vs Engraver_group_engraver (context)
+.* SMALLISH PROJECTS
 
-       * progress when creating MIDI elts.
+. * limit memory usage; the full coriolan takes up too much resources.
 
-       * A range for context errors (eg. mark both { and }. )
+. * fix confusing naming in Engraver vs Engraver_group_engraver (context)
 
-       * lyric in staff  (sharpsharp in staff, text below)
+. * progress when creating MIDI elts.
 
-       * half sharps/flats
+. * A range for context errors (eg. mark both { and }. )
 
-       * write Dynamic_line (to group dynamics horizontally)
+. * lyric in staff  (sharpsharp in staff, text below)
 
-       * use Real for all y positions.
-       - use translate_axis( .. ,Y_AXIS) 
+. * half sharps/flats
 
-       * half-sharps, half-flats
+. * write Dynamic_line (to group dynamics horizontally)
 
-       * adaptive accidental spacing.
+. * use Real for all y positions.
 
-       * handle EOF graciously in error messages.
+. * half-sharps, half-flats
 
-       * centered whole rest
+. * adaptive accidental spacing.
 
-        * qtor, btor, mtor-> tor( QUIET_ver ), tor( DEBUG_ver ), etc.
-       - use tors feature in lily (?)
+. * handle EOF graciously in error messages.
 
-       * declare notenametab?
+. * declare notenametab?
 
-       * midi esp.: use I32 iso int where 32 bits are needed (or assumed...)
+. * midi esp.: use I32 iso int where 32 bits are needed (or assumed...)
 
-       * Flower types:
-       - A decent scalar type
-       - String hash
-       - Pointer hash
+. * stafftypes: voice names/ instrument names.
 
-       * binsearch/hash for identifiers
+. * lily \tempo
 
-       * stafftypes: voice names/ instrument names.
+. * C meter iso 4/4, idem for alla breve, etc.
 
-       * lily \tempo
+. * textspanner: center position
 
-       * C meter iso 4/4, idem for alla breve, etc.
-
-       * textspanner: center position
-
-       * Brackets
-       
-
-            % toe to bheel   four to five
+        *   % toe to bheel   four to five
            %   ^_u            4_5  
            %     -                           
            %  --|x--         --|x--
@@ -566,54 +576,170 @@ SMALLISH PROJECTS
            %  --|---         --|---
           (where "to" is a tiny bow)
 
-       * auxilliary file for caching info.
-
-       * Text_crescendo
-
-       * clean solution for staffsize in items.
-
-       * revise calcideal
-
-       * volta
-
-IDEAS
-
-
-       * Output data structures of Mudela in XML/SGML.
-
-       * create libmudela, or liblily_frontend
-
-       * move MIDI stuff (including Quantization) to a ANSI C libmidi library.
-
-       * use an embedded language: Python, Scheme
-       for: 
-               - Score_elems
-               - Translators
-
-       * y -dims in internote? Staff-space? X-dimensions?
-
-       * Spacing_request for manually adjusting spacing
-
-       * caching breakpoints
-
-       * breath marks 
-
-       * used fixedpoint arithmetic for min. energy.
-
-       * move towards incremental algorithms.
-
-       * far fetched language ideas
-       - design meta-language like TeX and Metafont
-       - programming/macros input
-
-       * versioning stuff (cvt mudela, mudela, etc.)
-
-       * padded vertical alignment (rods for vertical placement)
-
-       * use String iso Text_def for lyrics.
-
-       * Klavarskribo?
-
-       * lyrics in chords still fuck up.
-
-       * Use hooks/dependency graphs for properties
+. * auxilliary file for caching info.
+
+. * Text_crescendo
+
+. * clean solution for staffsize in items.
+
+. * revise calcideal
+.* IDEAS
+. * Output data structures of Mudela in XML/SGML.
+. * create libmudela, or liblily_frontend
+. * move MIDI stuff (including Quantization) to a ANSI C libmidi library.
+. * Spacing_request for manually adjusting spacing
+. * caching breakpoints
+. * used fixedpoint arithmetic for min. energy.
+. * move towards incremental algorithms.
+. * far fetched language ideas
+.  * design meta-language like TeX and Metafont
+.  * programming/macros input
+. * versioning stuff (cvt mudela, mudela, etc.)
+. * Klavarskribo?
+. * dynamic loading of engravers? 
+.* SMOBS
+Han-Wen Nienhuys <hanwen@cs.uu.nl> writes:
+
+> mcmanus@IDT.NET writes:
+> > > I want different C++ objects (with scheme embedded) to be linked by
+> > > C++ pointers.  I want to access these other objects from the Scheme
+> > > code, and I want access to these pointers from C++.
+> > 
+> > You can do this with a  combination of smob's and primitive functions,
+> > though it may not be  be exactly what you wanted.   You would have one
+> > smob  for each class in  your application, and then  you would write a
+> > primitive function that would return the objects  that are linked to a
+> > base object.
+> 
+> And the smob and the C++ class are interlinked?  Like
+> 
+>      class Foo_class {
+>              Foo_smob *smob_ptr_;
+>      }
+> 
+>      struct Foo_smob {
+>              Foo_class *class_ptr_
+>      }
+
+Usually you can get away without having this interlinked structure.
+One piece of information you need when exporting objects to scheme is
+the smob tag for your class.  You might store this value (a long) into
+a class static variable, or a file static variable.  I'll use a class
+static variable in this example.
+
+I typically use code that works like this (untested code ahead):
+
+class Foo_class {
+    static long *Foo_smob_tag;
+    SCM obj; // representation as a scheme object, description comes later
+}
+
+// call this once on startup
+void init_Foo_class {
+    static scm_smobfuns type_rec;
+
+    type_rec.mark = foo_mark;
+    type_rec.free = foo_free;
+    type_rec.print = foo_display;
+    type_rec.equalp = 0;
+    Foo_class::Foo_smob_tag = new int(scm_new_smob(type_rec));
+}
+
+When you want to export an object to scheme, you put a pointer to the
+object itself in the cdr of the cell, and the tag in the car of the
+cell.  The code looks like this:
+
+// Is this a Foo?
+static int
+foo_p(SCM obj)
+{
+    return(SCM_NIMP(obj) && SCM_CAR(obj) == Foo_class::Foo_smob_tag);
+}
+
+// given a Scheme representation, return, a C++ representation
+static Foo_class *
+foo_unbox(SCM obj)
+{
+    return((Foo_class*)SCM_CDR(obj));
+}
+
+// the SCM representation of the object is stored inside itself
+// this will become useful when destructor gets called
+static SCM
+foo_box(Foo_class *foo)
+{
+    SCM_DEFER_INTS;
+    SCM_NEWCELL(foo->obj);
+    SCM_SETCAR(foo->obj, Foo_class::Foo_smob_tag);
+    SCM_SETCDR(foo->obj, (SCM)foo);
+    SCM_ALLOW_INTS;
+    return foo->obj;
+}
+
+> C++ determines life time, so what is the strategy?
+
+What happens now when the destructor gets called?  Lets set the cdr to
+NULL, and then check for that in all of the primitive functions that
+use your smob.  We'll call this notion 'live'; a scheme object is
+'live' if the C++ representation still exists, it's dead if the C++
+object is gone.  You can still have references to dead objects in
+scheme code; it's just an error to use them.  This idea is stolen from
+Emacs's handling of buffers ('buffer-live-p' and friends).
+
+Add another function, foo_live_p:
+
+static int
+foo_live_p(SCM obj)
+{
+    return(foo_p(obj) && SCM_CDR(obj) != NULL);
+}
+
+In you destructor, you need to do:
+
+~Foo_class()
+{
+    SCM_CDR(this->obj, NULL);
+}
+
+When writing new primitives, now just check foo_live_p().
+
+I hope the above helps,
+
+-russ
+
+
+--
+"Even if you are on the right track, you'll get run over 
+if you just sit there."  
+             --Will Rogers (1879-1935)
+
+* OUTLINE SETUP
+.* .EMACS
+;;; from outline.el
+(defvar outline-font-lock-keywords
+  '(;; Highlight headings according to the level.
+    ;; must change this to allout node layout
+    ;;("^\\(\\*+\\)[ \t]*\\(.+\\)?[ \t]*$"
+    ("^\\([.]*[ ]*[*]\\)[ \t]*\\(.*\\)$"
+     (1 font-lock-string-face)
+     (2 (let ((len (- (match-end 1) (match-beginning 1))))
+         (or (cdr (assq len '((1 . font-lock-function-name-face)
+                              (2 . font-lock-keyword-face)
+                              (3 . font-lock-comment-face))))
+             font-lock-variable-name-face))
+       nil t))
+    ;; Highlight citations of the form [1] and [Mar94].
+    ("\\[\\([A-Z][A-Za-z]+\\)*[0-9]+\\]" . font-lock-type-face))
+  "Additional expressions to highlight in Outline mode.")
+
+(add-hook 'outline-mode-hook
+         '(lambda ()
+           (setq font-lock-maximum-decoration t)
+           (setq font-lock-maximum-decoration t)
+           (make-local-variable 'font-lock-defaults)
+           (setq font-lock-defaults '(outline-font-lock-keywords t))
+           (font-lock-mode global-font-lock-mode)
+       ))
+(require 'allout)
+(outline-init 't)