]> git.donarmstrong.com Git - lilypond.git/blobdiff - TODO
release: 1.1.15
[lilypond.git] / TODO
diff --git a/TODO b/TODO
index c9edf2878f52cd568af4e2d1b977c6a390f408dc..cbc7bc71578e6bca3cdd6bc9226d010650304d31 100644 (file)
--- a/TODO
+++ b/TODO
 Features you cannot find in the doco as working, should be mentioned here.
 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. 
 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
+grep for TODO and ugh/ugr/urg
 
 
-       * LILYSOURCEDIR
+BUGS:
+       * c4 \! \> c4
 
 
-       * spurious "Junk beam" warnings
+       * tremolo stuff
 
 
-       * standchen: warning: Excentric column (Meter dims?)
+       * gallina barlines.
 
 
-       * optimal pagebreaking.
+       * fix height of / collisions with lyrics (chords), 
+          see input/test/vertical-text.ly
 
 
-       * put errorlevel in Input class
+       * repeat/volta:
+         - one volta spanner per score
+         - repeat bars span staffs
+         - placement alternative number
+
+       * who is trying to print too (small/big) piano braces all the time?
+           warning: piano brace too small (16.000pt)
+
+       * latex bla.tex broken (titles / \lilyfooter stuff?)
+
+       * msgfmt -o check?
+
+       * \breathmark TeX macro 
+
+       * configure error if GUILE 1.3 not found
+
+       * configure error if no rtti (gcc 2.8 or egcs-1.1)
+
+       * 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?
+
+       * \type Voice \times 2/3 { [c8 c16 c16 c16 c16] }
+
+       * fix singleStaffBracket
+
+       * repeat bars: need distance after ":|" and before "|:"
+
+       * The time signature warnings still remain, will be fixed later.
+
+       Summary of minor spelling irregularities:
+       -  capitalization/use of underscores in property names
+
+       * fix SkipBars  -> skipBars
+
+       * \shape 1st dim skipped? 
+
+       * 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 }
+
+STUFF
+       * uniformise recent feta contributions.
+
+       * check out legal/(c) matters for scores.
+
+       * check out GCC signatures?
+
+       * Align_element::padding  ?
+
+       * uniformise property names.
+
+       * ydirection <-> yDirection
+
+       * 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.
+
+       * midi_instrument -> midiInstrument
+
+       * horizontal centering of dynamics 
+
+       * \font\fontA=feta20.afm (.afm?)
+
+       * gzip RH manpage
+
+       * stable make/config stuff
+
+       * $DEPENDENCIES_OUTPUT support
 
 
-       * AFM for font input?
+       * fix BUGs
 
 
-       * naming Mozarella, Madeira, Muella?
+       * fix weird behaviour when .AFMs/.SCMs not found.
 
 
-       * bf: abbrevs over whole note
+       * Xdvi zooming ?! Try to understand GS garbage collection.
+               gs: Error: /undefined in draw_beam
+               gs: Operand stack:
 
 
-       * scoping for properties
+       * run texhash after installing .tex
 
 
-       {       c4
-               \multi 2  < { \stemup .. } { \stemdown .. } >
-               c2 
+       * 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> }
+
+       * 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;
+       <{\voiceone cis4. cis8 cis4 | cis4 cis cis | r1 }
+        {\voicetwo cis,4 r r | r2. | r1 }> |
        }
 
        }
 
-       this modifies \stem for the c2
+       * 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.
+       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
+         * \cadenza , \meter, \grouping should all be \properties
+
+       * 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
+
+       * 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
+       which is irritating.
+
+       * 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)
+
+        * clefs (AG): The "8" should appear closer to the actual clef,
+          touching it.
+
+       * put errorlevel in Input class
+
+       * junk nesting slurs
+
+       * integrate midi-elts from mi2mu and lily?
+
+       * 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:
+
+       * make GCC warn about ctor that leaves member vars  uninitialised.
+
+       * redhat (v?) graphical install bomb-out?
+
+       * 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:
+
+         f = fopen ("/dev/null", "r")
+         assert (feof (f))
+
+3RD PARTY PROJECTS:
+
+       * GNU indent: handle C++
+
+       * 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:
+         % 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:
 
        * use properties for:
-       - Text_style
-       - default_octave
        - plet?
        - plet?
-       - default_duration?
-       - default abbreviation
        - Staff_sym size
        - default tempo.
        - font size
        - bartypes (get rid of derived Span_bar_engravers)
        - cadenza mode? 
        - Staff_sym size
        - default tempo.
        - font size
        - bartypes (get rid of derived Span_bar_engravers)
        - cadenza mode? 
-       - MIDI instrument
-       - staff title
 
 
-       * give Items/Spanners access to unbroken originals      
-
-       * Score_bar/Piano_braces, are *not* ordinary bars 
-
-3RD PARTY BUGS:
-* Rational infty(HUGE_VAL) on glibc / w32
-
-       * Fix profiling. gprof bugreport?
-
-PROJECTS
+       * page handling:
+       - PS output
+       - optimal pagebreaking.
 
 
-       * Unicode support?
+       * Unicode support? -> man 7 unicode
        - 16 bit Strings
        - -u switch
        - detect of 16/8 bit files
        - 16 bit Strings
        - -u switch
        - detect of 16/8 bit files
@@ -64,27 +379,15 @@ PROJECTS
 
        * Spring_spacer:
        - write a faster Spring_spacer (without matrices if possible)
 
        * Spring_spacer:
        - write a faster Spring_spacer (without matrices if possible)
-       - use straight QP to find minimal "fitting force"
        - relate energybound to linelen unitspace fontsize etc.
        - relate energybound to linelen unitspace fontsize etc.
-       - used fixed point fp
+       - used fixed point fp?
 
        * \header
 
        * \header
-       - write perl script for handling it into databases
-       - write TeX macros to generate titles
-       - adapt make-website to use \header info.
-
-       * Makefile stuff:
-       - have make dist produce tarball in out/ directory.
-       - Use Automake
-       - shared lib on Solaris too.
-       - check libtool
-       - generate stuff in out/default, out/sun5-irix etc iso out/ 
-       and out-sun5/
-
-       * Add mudela-output to Rosegarden.
+       - output header info to MIDI too.
 
        * a musical dictionary. See Documentation/vocabulary-*, other
 
        * a musical dictionary. See Documentation/vocabulary-*, other
-languages:
+       languages:
+       - explanations
        - italian
        - german
        - dutch
        - italian
        - german
        - dutch
@@ -92,14 +395,11 @@ languages:
         .. ?
 
        * chords
         .. ?
 
        * chords
-       - guitar chords
-       - chord names
+       - jazz style inversions C/E => <e g c>
+       - guitar chords (fret diagrams)
+       - other chord name styles (american(?) style)
        - basso continuo
        - basso continuo
-       - Syntax/parser
        - MIDI output?
        - MIDI output?
-       - typesetting
-
-       * integrate midi-elts from mi2mu and lily?
 
        * Debug logs:
        - derive lily_stream, Dstream, texstream from ostream?
 
        * Debug logs:
        - derive lily_stream, Dstream, texstream from ostream?
@@ -112,36 +412,23 @@ languages:
        - ABC? 
        - SMDL?
 
        - ABC? 
        - SMDL?
 
-       * placement of bar-numbers
-
-******************
-
-       \score { < 
-               \melodic \type Staff { c'4 g'4 }
-               \lyric { \id "Lyric" ""; hello4 bye4 < a chord > }
-               \lyric { \id "Lyric" ""; bye4 hello4 }
-               \melodic { \id "Staff" ""; c'4 g'4 }
-       > }
-
-******************
-
        * add to MIDI output:
        - tempo change
        * add to MIDI output:
        - tempo change
-       - repeat
+       - ornaments (and trills?)
+       - repeat/volta
        - slurs
        - slurs
-       - dynamics etc.
+       - 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.
 
 
        * grace notes
        - make separate class for Grace_*_engravers 
        (which is at Voice_gravs level)
        - make encapsulated spacing problems.
 
-       * On-demand loading of simple-engravers?
-
        * accidentals per Voice_group
 
        * accidentals per Voice_group
 
-       * Convert all ref/bib stuff into BibTeX.
-
        * Output class, handles : (smallish)
        - help text /(c) notice?
        - version line
        * Output class, handles : (smallish)
        - help text /(c) notice?
        - version line
@@ -157,26 +444,30 @@ languages:
        - text
        - slur start/end
 
        - text
        - slur start/end
 
+       * 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,
+         make ofi2 TeX, MusiXTex, Display PostScript, PostScript,
          Ascii... interpreters. (difficult)
 
          Ascii... interpreters. (difficult)
 
-       - poor man's ascii output possible?
-       - MusixTeX output possible? (would have to be done before break calc.)
        - NIFF ?
        - Common Music Notation
        - PostScript output (esp. Beams, Slurs, etc)
        - Move all Score_elems, into libmutype.a
        - NIFF ?
        - Common Music Notation
        - PostScript output (esp. Beams, Slurs, etc)
        - Move all Score_elems, into libmutype.a
+       - SGML
+
        * Documentation
        * Documentation
-       - Doc Mutopia (Music To The People) 
        - Doc (C) stuff of sheet music
        - Doc (C) stuff of sheet music
-       - a tutorial
+       - a better format?  SGML?  TeX?  Info?
+       - a better tutorial
 
 
-       * TeX spanners , use texbeam.cc as an example (smallish)
+       * more spanners (smallish)
        - Glissando
        - trill
        - Glissando
        - trill
-       - bracket
 
        * Rewrite Stem, Beam and Rhythmic_grouping (hairy)
        - [c8. c32 c32]
 
        * Rewrite Stem, Beam and Rhythmic_grouping (hairy)
        - [c8. c32 c32]
@@ -186,13 +477,9 @@ languages:
        - separate visual from rhythmic info even more
        - beams over bars
 
        - separate visual from rhythmic info even more
        - beams over bars
 
-       * Redo fonts
-       - adapt for multiple font sizes.
-
        * lines:
        - Ledger lines, should be separate item: Ledger_lines, Ledger_lines
        - set different line sizes / thicknesses
        * lines:
        - Ledger lines, should be separate item: Ledger_lines, Ledger_lines
        - set different line sizes / thicknesses
-       - stem down too far right
        - beam stem showthrough, inter beam sizes (french vs german style)
 
        * Collisions
        - beam stem showthrough, inter beam sizes (french vs german style)
 
        * Collisions
@@ -201,11 +488,6 @@ languages:
 
        * Keys:
        - merge key{item} & localkey{item}?
 
        * Keys:
        - merge key{item} & localkey{item}?
-       - do conventional keys (C G A, F B E, a e fis, d as des, etc ), 
-         besides lists of flats/sharps, possibly via declaration
-       - key transposition. 
-       - key undo: \key bes; .. . \key; should print natural   
-       - special key: \key bes 'b bis';
        - spacing, national styles?
 
        * Support for TAB
        - spacing, national styles?
 
        * Support for TAB
@@ -217,24 +499,10 @@ languages:
        * breaking:
        - caching breakpoints
        - saving them
        * breaking:
        - caching breakpoints
        - saving them
-       - allowing users to set them.
-       - penalties
        - specify number of lines
        - specify number of lines
-       - set linelength per line
-
-       * Rhythmic staff.
-
-       * Baroque superstaff
-
-SEVERELY LACKING:
-
-       * SPEED!
-
-       * multibar rests
 
        * markers
 
 
        * markers
 
-
 INPUTLANGUAGE
 
        * c4 4 4 4 for c4 c4 c4 c4?
 INPUTLANGUAGE
 
        * c4 4 4 4 for c4 c4 c4 c4?
@@ -256,77 +524,53 @@ INPUTLANGUAGE
 
        * relative mode for pitch entering
 
 
        * relative mode for pitch entering
 
-       * bracket (bracketplets)
-
        * configure pitch_byte
 
        * rest name configurable
 
        * configure pitch_byte
 
        * rest name configurable
 
-       * Raw request syntax
-
 SMALLISH PROJECTS
 
 SMALLISH PROJECTS
 
+       * limit memory usage; the full coriolan takes up too much resources.
+
+       * fix confusing naming in Engraver vs Engraver_group_engraver (context)
+
        * progress when creating MIDI elts.
 
        * A range for context errors (eg. mark both { and }. )
 
        * lyric in staff  (sharpsharp in staff, text below)
 
        * progress when creating MIDI elts.
 
        * A range for context errors (eg. mark both { and }. )
 
        * lyric in staff  (sharpsharp in staff, text below)
 
+       * half sharps/flats
+
        * write Dynamic_line (to group dynamics horizontally)
 
        * use Real for all y positions.
        * write Dynamic_line (to group dynamics horizontally)
 
        * use Real for all y positions.
+       - use translate_axis( .. ,Y_AXIS)  iso separate variables.
 
        * half-sharps, half-flats
 
        * adaptive accidental spacing.
 
 
        * half-sharps, half-flats
 
        * adaptive accidental spacing.
 
-       * unix style paths for LILYINCLUDE env
-
        * handle EOF graciously in error messages.
 
        * handle EOF graciously in error messages.
 
-       * caching Item/spanner dimensions.
-
        * centered whole rest
 
        * centered whole rest
 
-        * qtor, btor, mtor-> tor( QUIET_ver ), tor( DEBUG_ver ), etc.
-       - use tors feature in lily (?)
-
        * declare notenametab?
 
        * midi esp.: use I32 iso int where 32 bits are needed (or assumed...)
 
        * declare notenametab?
 
        * midi esp.: use I32 iso int where 32 bits are needed (or assumed...)
 
-       * parshape
-
        * Flower types:
        - A decent scalar type
        * Flower types:
        - A decent scalar type
-       - String hash
-       - Pointer hash
-
-       * binsearch/hash for identifiers
 
        * stafftypes: voice names/ instrument names.
 
 
        * stafftypes: voice names/ instrument names.
 
-       * TeX stuff:    
-       - Decent TeX titledefs (\tempo, \metron, etc. )
-       - decent TeX page layout
-
        * lily \tempo
 
        * C meter iso 4/4, idem for alla breve, etc.
 
        * textspanner: center position
 
        * lily \tempo
 
        * C meter iso 4/4, idem for alla breve, etc.
 
        * textspanner: center position
 
-       * Brackets
-       
-       * Scripts:
-       - 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:
-
-            % toe to bheel   four to five
+        *   % toe to bheel   four to five
            %   ^_u            4_5  
            %     -                           
            %  --|x--         --|x--
            %   ^_u            4_5  
            %     -                           
            %  --|x--         --|x--
@@ -342,23 +586,18 @@ SMALLISH PROJECTS
 
        * revise calcideal
 
 
        * revise calcideal
 
-       * volta
-
 IDEAS
 
 IDEAS
 
-       * Output abstract data structures associated with
-Mudela.
+       * Output data structures of Mudela in XML/SGML.
 
        * create libmudela, or liblily_frontend
 
        * move MIDI stuff (including Quantization) to a ANSI C libmidi library.
 
 
        * create libmudela, or liblily_frontend
 
        * move MIDI stuff (including Quantization) to a ANSI C libmidi library.
 
-       * use an embedded language: Python
-       for: 
+       * use an embedded language: Python, Scheme
+       for:
                - Score_elems
                - Score_elems
-               - Engraver
                - Translators
                - Translators
-               - Complex mudela?
 
        * y -dims in internote? Staff-space? X-dimensions?
 
 
        * y -dims in internote? Staff-space? X-dimensions?
 
@@ -366,10 +605,6 @@ Mudela.
 
        * caching breakpoints
 
 
        * caching breakpoints
 
-       * #c <-> cis
-
-       * breath marks 
-
        * used fixedpoint arithmetic for min. energy.
 
        * move towards incremental algorithms.
        * used fixedpoint arithmetic for min. energy.
 
        * move towards incremental algorithms.
@@ -378,39 +613,128 @@ Mudela.
        - design meta-language like TeX and Metafont
        - programming/macros input
 
        - design meta-language like TeX and Metafont
        - programming/macros input
 
-       * Global type registration.
-
-               My_class * p = create_object( My_class )
-               Type t = get_type ( *p );
-               if ( t <= get_type( q ))
-                       ..
-
-       * naming of Voice_group/Voice
-
-       * benchmark band_matrices.
-
        * versioning stuff (cvt mudela, mudela, etc.)
 
        * versioning stuff (cvt mudela, mudela, etc.)
 
-       * a real convert-mudela
-
-       * dots into separate item.
-
-       * use String iso Text_def for lyrics.
-
-       * use position 0 for center of staff iso bottom.
-
        * Klavarskribo?
 
        * Klavarskribo?
 
-       * lyrics in chords still fuck up.
-
-       - rewire acknowledge_element() logic with a process_acknowledged()
-
-       * pushgroup/popgroup
-
-       * whole head on ledger line
-
-       * multi threading?
-         - 1 thread per element/ 1 thread per line
-         - 1 thread per Translator
-
-       * Use hooks/dependency graphs for properties
+       * 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)
+
+***************************