]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc -- add info to programming.itexi
authorCarl Sorensen <c_sorensen@byu.edu>
Tue, 20 Jan 2009 02:32:00 +0000 (19:32 -0700)
committerCarl Sorensen <c_sorensen@byu.edu>
Tue, 20 Jan 2009 02:32:00 +0000 (19:32 -0700)
Documentation/devel/programming-work.itexi

index 747c7bd9ab5a2a8daa2666d818d45a865496fb0f..ef519f68b394449f981a24b300b9eaf3a4dc23ed 100644 (file)
@@ -15,7 +15,8 @@ de
 @node Introduction to programming
 @section Introduction to programming 
 
-blah blah
+FIXME -- decide what goes in here and put it here.  I'm not sure what
+should be here -- CDS
 
 @node Programming without compiling
 @section Programming without compiling
@@ -27,7 +28,7 @@ changes are described in this section.
 
 @subsection Modifying distribution files
 
-Mving uch of LilyPond is written in Scheme or LilyPond input files.  These
+Much of LilyPond is written in Scheme or LilyPond input files.  These
 files are interpreted when the program is run, rather than being compiled
 when the program is built, and are present in all LilyPond distributions.
 You will find .ly files in the ly/ directory and the Scheme files in the
@@ -45,7 +46,7 @@ become a regression test and will be part of the LilyPond distribution.
 
 Files that are part of the LilyPond distribution have Unix-style line
 endings (LF), rather than DOS (CR+LF) or MacOS 9 and earlier (CR).  Make
-sure you use the necessary tools ensure that Unix-style line endings are
+sure you use the necessary tools to ensure that Unix-style line endings are
 preserved in the patches you create.
 
 Tab characters should not be included in files for distribution.  All
@@ -53,6 +54,16 @@ indentation should be done with spaces.  Most editors have settings to
 allow the setting of tab stops and ensuring that no tab characters are
 included in the file.
 
+Scheme files and LilyPond files should be written according to standard
+style guidelines.  Scheme file guidelines can be found at
+@uref{http://community.schemewiki.org/?scheme-style}.  Following these
+guidelines will make your code easier to read.  Both you and others that
+work on your code will be glad you followed these guidelines.
+
+For LilyPond files, you should follow the guidelines for LilyPond snippets
+in the documentation.  You can find these guidelines at
+@ref{LilyPond formatting}.
+
 @node Finding functions
 @section Finding functions
 
@@ -83,7 +94,7 @@ grep functionName subdirectory/*
 This command will search all the contents of the directory subdirectory/
 and display every line in any of the files that contains functionName.
 
-THe most likely directories to grep for function names are scm/ for
+The most likely directories to grep for function names are scm/ for
 scheme files, ly/ for lilypond input (*.ly) files, and lily/ for C++
 files.  
 
@@ -122,7 +133,6 @@ Type functionName in the search box, and hit enter/return
 This will initiate a search of the remote git repository.
 
 
-
 @node Code style
 @section Code style 
 @c email to wl@gnu.org when I get here.