lilypond-0.0.8

diff --git a/CodingStyle b/CodingStyle
deleted file mode 100644 (file)
index c5d730c..0000000
--- a/CodingStyle
+++ /dev/null
@@ -1,55 +0,0 @@
-CODING STANDARDS:
-
-Functions and methods do not return errorcodes, but use assert for
-checking status. 
-
-INDENTATION, in emacs:
-
-
-(add-hook 'c-mode-hook
-         '(lambda ()(setq c-basic-offset 4)))
-
-
-(add-hook 'c++-mode-hook
-         '(lambda() (c-set-style "Stroustrup")
-            )
-         )
-
-
-CLASSES and TYPES:
-
-       This_is_a_class
-
-DATA MEMBERS
-
-       Class:member
-
-if the member's name resembles its type, then we use
-
-       Class Fubular { ..}
-
-       Class::fubular_
-
-COMMENTS
-
-/// short description
-class Class {
-       ///
-       Data data_member_;
-       /**
-               ..
-       */
-
-       /****************/
-
-       /// short memo
-       member();
-       /**
-               long doco of member()
-       */
-};
-/**
-       Class documentation.
-*/
-
-Unfortunately most of the code isn't really documented that good.
\ No newline at end of file

diff --git a/README b/README
index 41c366eec380fc3c6207ba903dd05b778f3b38e6..fd1c616b3a5582f82f5078e3510316996dca3ba0 100644 (file)
--- a/README
+++ b/README
@@ -56,5 +56,12 @@ stacktrace of the crash.
 
 HOW DOES IT WORK
 
-Use The Source, Luke. If you don't know C++, you can try editing
+* Use The Source, Luke. If you don't know C++, you can try editing
 .dstreamrc for copious debugging output.
+
+* see also the subdir Documentation
+
+* The source is commented in the DOC++ style.
+Check out doc++ at
+
+       http://www.ZIB-Berlin.DE/VisPar/doc++/doc++.html 

diff --git a/TODO b/TODO
deleted file mode 100644 (file)
index 1f96a09..0000000
--- a/TODO
+++ /dev/null
@@ -1,13 +0,0 @@
-       * clefs
-
-       * beam
-
-       * fonttables -> fontdims
-
-       * clear IDENTIFIERs
-
-       * Paperdef -> fontsize .
-
-       * merge Paper, Lookup, Outputfile, and Symtable.
-
-       * all places in the code marked TODO! and ugh/ARGH

diff --git a/item.hh b/item.hh
index cf3d11c31347dac6f4fbe9f4cb22ec9061e3454c..b450ab59eac3a09184c2b1c2c528039123165911 100644 (file)
--- a/item.hh
+++ b/item.hh
@@ -4,8 +4,6 @@
 #include "glob.hh"
 #include "boxes.hh"
 #include "string.hh"
-#include "tex.hh"
-
     
 /// a horizontally fixed size element of the score
 struct Item {
@@ -17,7 +15,17 @@ struct Item {
     */
 
     /****************/
+    
+    /// do calculations after determining horizontal spacing
+    virtual void postprocess();
 
+    /// do calculations before determining horizontal spacing
+    virtual void preprocess();
+    /**
+      This is executed directly after the item is added to the
+      PScore
+      */
+    
     virtual Interval width() const;    
     virtual Interval height() const;
     String TeXstring () const ;
@@ -25,7 +33,12 @@ struct Item {
     void print()const;
     virtual ~Item();
 };
-/** An item must be part of a Column
+/** Item is the datastructure for printables whose width is known
+  before the spacing is calculated
+
+  NB. This doesn't mean an Item has to initialize the output field before
+  spacing calculation. 
+  
 */
 
 

diff --git a/notehead.hh b/notehead.hh
new file mode 100644 (file)
index 0000000..b694e95
--- /dev/null
+++ b/notehead.hh
@@ -0,0 +1,38 @@
+/*
+  notehead.hh -- part of LilyPond
+
+  (c) 1996 Han-Wen Nienhuys
+*/
+
+#ifndef NOTEHEAD_HH
+#define NOTEHEAD_HH
+#include "item.hh"
+
+/// ball at the end of the stem
+struct Notehead : public Item
+{
+    int position;
+    int staff_size;
+    int dots;
+    int balltype;
+
+    /****************/
+    void preprocess();
+
+    Notehead(int staff_size);
+    /**
+      position of top line (5 linestaff: 8)
+      */
+    void print()const;
+private:
+    void brew_molecole();
+};
+/**
+  takes care of:
+
+  * help lines  
+  * proper placing of dots 
+
+  */
+#endif // NOTEHEAD_HH
+

diff --git a/stem.hh b/stem.hh
index 039bc5182c2ffa87a3cc690fc844718439b6c6a9..acbebe0d92fb2eb15ea1365a5eec530fef7e25b7 100644 (file)
--- a/stem.hh
+++ b/stem.hh
@@ -8,6 +8,7 @@
 #define STEM_HH
 #include "item.hh"
 
+/// the rule attached to the ball
 struct Stem : public Item {
     // heads the stem encompasses (positions)
     int minnote, maxnote;
@@ -20,12 +21,24 @@ struct Stem : public Item {
     // flagtype? 4 none, 8 8th flag, 0 = beam.
     int flag;
     
-        
     /****************/
-    void brew_molecole();
-    void calculate();
+    
+    void postprocess();
     Stem(int center);
     void print() const;
-    Interval width() const;    
+    Interval width() const;
+private:
+    void calculate();
+    void brew_molecole();
 };
+/**
+  takes care of:
+
+  \begin{itemize}
+  \item the rule
+  \item the flag
+  \item up/down position.
+  \end{itemize}
+  */
+
 #endif

diff --git a/tex.hh b/tex.hh
index 2f60630fd597760965e02386dceed1aafea7f60a..546797a7c19042c6bc9e90a86802e66f35fa0926 100644 (file)
--- a/tex.hh
+++ b/tex.hh
@@ -4,6 +4,7 @@
 #include "string.hh"
 #include "boxes.hh"
 
+/// parameter substitution in TeXstrings
 String
 substitute_args(String source, svec<String> args);
 /**