lilypond-1.0.16

diff --git a/lily/include/command-request.hh b/lily/include/command-request.hh
index a76a3518615ff765dbb8e1c73e9de2f3fc1c5caf..a0afdc8f5e996765fa9bc54dce9d2fee455e8ea3 100644 (file)
--- a/lily/include/command-request.hh
+++ b/lily/include/command-request.hh
@@ -16,7 +16,7 @@
 #include "musical-pitch.hh"
 
 /** Request which are  assumed to be "happening" before the
-  musical requests. */
+  musical requests.  Not coupled to a note or rest. */
 class Command_req  : public virtual Request  {
 public:
   REQUESTMETHODS(Command_req);

diff --git a/lily/include/music.hh b/lily/include/music.hh
index b05bc0db19f4e2538de02f691ef5f33c80321bd6..efb2f712ee2681f8a4d38bfaf0d5525aecb93cb8 100644 (file)
--- a/lily/include/music.hh
+++ b/lily/include/music.hh
@@ -17,8 +17,8 @@
 #include "lily-proto.hh"
 #include "string.hh"
 
-/** 
-  Anything which has length or pitch.
+/** Music is anything that has duration and supports both time compression and
+  transposition.
   
   In Lily, everything that can be thought to have a length and a pitch
   (which has a duration which can be transposed) is considered "music",
@@ -31,23 +31,28 @@
 class Music:public Input {
 public:
     
-  /** The kind of iterator needed to walk this music.  This doesn't
+  /** The kind of translation needed for this music.  This doesn't
     make sense for simple (ie non-list) music, but it does no harm
     here. Yes, it did harm Music_sequence: you can forget to copy it.
       
     */
   String translator_type_str_;
 
-  /// what name (or look for this name)
+  /// what identification for the translation unit
   String translator_id_str_;    
 
   virtual Musical_pitch to_relative_octave (Musical_pitch);
-  virtual Moment  duration () const;
+
+  /// The duration of this piece of music
+  virtual Moment duration () const;
 
   virtual ~Music(){}
   void print() const;
-  virtual void transpose (Musical_pitch );
-  virtual void compress (Moment);
+  /// Transpose, with the interval central C to #p#
+  virtual void transpose (Musical_pitch p);
+
+  /// Scale the music in time by #factor#.
+  virtual void compress (Moment factor);
   VIRTUAL_COPY_CONS(Music,Music);
   DECLARE_MY_RUNTIME_TYPEINFO;
   Music();

diff --git a/lily/include/musical-request.hh b/lily/include/musical-request.hh
index 70e6467542857be8aff349dfcb91e1a846a92c5c..2f3c3f599c57f2f6ca630fc0df26fb60b30adb7c 100644 (file)
--- a/lily/include/musical-request.hh
+++ b/lily/include/musical-request.hh
@@ -16,7 +16,7 @@
 #include "musical-pitch.hh"
 
 /**
-  A request which is coupled to a #Request_chord#
+  A request which is coupled to a note (that has duration).
   Base class only
  */
 class Musical_req  : public virtual Request  {

diff --git a/lily/include/request.hh b/lily/include/request.hh
index c45d5905e13b2f4b6f6db4a3eb4992eb300a6512..7d976a648e5dfe7b015bdb35571ed4ff7481cf6e 100644 (file)
--- a/lily/include/request.hh
+++ b/lily/include/request.hh
@@ -20,10 +20,11 @@
 #define DEFAULTACCESSOR(T)  virtual T *access_ ## T () { return 0; }
 
 
-/**
-   An atom of musical information .
- Hungarian postfix: req
- @see lilygut manpage
+/** An atom of musical information.  This is an abstract class for any
+  piece of music that does not contain other Music.
+  
+  Hungarian postfix: req
+
  */
 class Request : public Music {
 

diff --git a/lily/include/translator-change.hh b/lily/include/translator-change.hh
index 8de7b806c53b2be89a4ffb1c5c0b94f4d051b102..f9d626524d6cdadee4a26c1cdd88f96069f4172e 100644 (file)
--- a/lily/include/translator-change.hh
+++ b/lily/include/translator-change.hh
@@ -10,6 +10,9 @@
 #ifndef TRANSLATOR_CHANGE_HH
 #define TRANSLATOR_CHANGE_HH
 
+/** Change the nesting of the current translation.  Uses the type_str_
+  and id_str_ differently.
+  */
 class Translator_change : public Music
 {