lilypond-0.0.33

diff --git a/Documentation/CodingStyle.pod b/Documentation/CodingStyle.pod
index fdbab0668bafa409aa1138d6d4e03e7dc88bd2c7..02b580c6025dc71b2bdc93b280d320cce0751ceb 100644 (file)
--- a/Documentation/CodingStyle.pod
+++ b/Documentation/CodingStyle.pod
@@ -45,6 +45,7 @@ http://www.zib.de/Visual/software/doc++/index.html
        /**
                short description.
                Long class documentation.
+               (Hungarian postfix)
        */
        class Class {
                /** short description.
@@ -89,9 +90,9 @@ Standard methods:
        void print() const
 
        /**
-       protected member. Usually invoked by non-virtual A_virtual_func()
+       protected member. Usually invoked by non-virtual XXXX()
        */
-       virtual do_A_virtual_func()
+       virtual do_XXXX()
 
        /**add some data to *this.
        Presence of these methods usually imply that it is not feasible to this
@@ -109,22 +110,17 @@ Notation>.
 
 =head2 Hungarian
 
-The Hungarian Notation was conceived by
-or at least got its name from,
-the hungarian programmer x. 
-It is a naming convention with the aim 
-to make code more readable (for fellow programmers)
-and more accessible for programmers 
-that are new to a project.
-
-The essence of the Hungarian Notation 
-is that every identifier has a part
-which identifies its type 
-(for functions this is the result type).
-This is particularly useful in object oriented programming,
-where a particular object implies a specific interface
-(a set of member functions, perhaps some redefined operators),
-and for accounting heap allocated memory pointers and links.
+The Hungarian Notation was conceived by or at least got its name from,
+the hungarian programmer x.  It is a naming convention with the aim to
+make code more readable (for fellow programmers) and more accessible
+for programmers that are new to a project.
+
+The essence of the Hungarian Notation is that every identifier has a
+part which identifies its type (for functions this is the result
+type).  This is particularly useful in object oriented programming,
+where a particular object implies a specific interface (a set of
+member functions, perhaps some redefined operators), and for
+accounting heap allocated memory pointers and links.
 
 =head2 Advantages
 
@@ -203,6 +199,9 @@ with the parts of the names separated by underscores.
 
 =over 5
 
+=item C<byte>
+unsigned cher. (The postfix _by is ambiguous)
+
 =item C<b>
 bool
 
@@ -276,7 +275,7 @@ Temporary variable: an unsigned integer
 =item C<test_ch>
 Variable Test: a character
 
-=item C<firstName_str>
+=item C<first_name_str>
 Variable first_name: a String class object
 
 =item C<first_name_ch_a>

diff --git a/README b/README
index 8c2b831b5af0ddf294b450727312de2e3a5274fb..83f807a7a097bb203f0863b887130c40294e10a7 100644 (file)
--- a/README
+++ b/README
@@ -1,11 +1,14 @@
-IMPORTANT: if you have downloaded a
+IMPORTANT:
+
+if you have downloaded a
 
        *.pre*
 
 version, then this is version is *not* meant for producing nice output
-(but to keep your patchsets up to date)
+(but to keep your patchsets up to date). It might not even compile.
 
 ====================
+
 Please refer to the directory Documentation/, Documentation/README.*
 
 To generate the pretty-printed docs, do this:
@@ -21,8 +24,9 @@ NOTE:
 
 LilyPond is a long way from finished and polished. I do appreciate
 criticism, comments, bugreports, patches, etc. Please send e-mail to
+me,
 
-       hanwen@stack.urc.tue.nl
+       hanwen@stack.nl
 
 Have fun!