]> git.donarmstrong.com Git - lilypond.git/commitdiff
Begin lilypond-program reworking.
authorGraham Percival <graham@percival-music.ca>
Mon, 30 Jul 2007 08:41:47 +0000 (01:41 -0700)
committerGraham Percival <graham@percival-music.ca>
Mon, 30 Jul 2007 08:41:47 +0000 (01:41 -0700)
Documentation/user/install.itexi
Documentation/user/lilypond-program.tely
Documentation/user/running.itely
Documentation/user/setup.itely [new file with mode: 0644]

index eea55dfe13d6e34cc024f56831583d8b36c40e04..1e1b86c42369264b389827cba231b39970159fc3 100644 (file)
@@ -255,56 +255,6 @@ make conf=prof install
 @end quotation
 
 
-@section Emacs mode
-
-An Emacs mode for entering music and running LilyPond is contained in
-the source archive in the @file{elisp} directory.  Do @command{make
-install} to install it to @var{elispdir}.  The file @file{lilypond-init.el}
-should be placed to @var{load-path}@file{/site-start.d/} or appended
-to your @file{~/.emacs} or @file{~/.emacs.el}.
-
-As a user, you may want add your source path (e.g. @file{~/site-lisp/}) to
-your @var{load-path} by appending the following line (as modified) to your
-@file{~/.emacs}
-@c any reason we do not advise:  (push "~/site-lisp" load-path)
-@quotation
-@example
-(setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
-@end example
-@end quotation
-
-
-@section Vim mode
-
-A Vim mode for entering music and running LilyPond is contained in the
-source archive in @code{$VIM} directory.
-
-The LilyPond file type is detected if the file @file{~/.vim/filetype.vim} @c
-has the following content
-@quotation
-@example
-if exists("did_load_filetypes")
-  finish
-endif
-augroup filetypedetect
-  au! BufNewFile,BufRead *.ly           setf lilypond
-augroup END
-@end example
-@end quotation
-
-Please include this path by appending the following line to your
-@file{~/.vimrc}
-
-@quotation
-@example
-set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
-@end example
-@end quotation
-
-@noindent
-where $@{LILYPOND_VERSION@} is your lilypond version.  If Lilypond was not
-installed in @file{/usr/local/}, then change this path accordingly.
-
 
 @section Problems
 
index 39d7726660c104673503ce8439d57b0d161d558a..b8088341252857829998a1a115125ce3abf4d66c 100644 (file)
@@ -129,6 +129,7 @@ of this and other documentation.
 
 @menu
 * Install::                        How to install or compile.
+* Setup::                          Using LilyPond with other programs.
 * Running LilyPond::               Operation.
 * LilyPond-book::                  Integrating text and music.
 * Converting from other formats::  Converting to lilypond source format.
@@ -147,6 +148,7 @@ Appendices
 @include macros.itexi
 
 @include install.itexi
+@include setup.itely
 @include running.itely
 @include lilypond-book.itely
 @include converters.itely
index 8d477362c43f5fd8bf5a584ab5c1e7411a706815..482e0a06378b0ddc1d5f67f6e211677533e35567 100644 (file)
@@ -28,7 +28,6 @@ you are unfamiliar with the command-line.
 
 @menu
 * Invoking lilypond::           
-* Notes for the MacOS X app::   
 * Updating files with convert-ly::  
 * Reporting bugs::              
 * Error messages::              
@@ -363,60 +362,6 @@ uses more CPU time. The default value is @code{70}.
 @end table
 
 
-@node Notes for the MacOS X app
-@section Notes for the MacOS X app
-
-The scripts (such as lilypond-book, convert-ly, abc2ly, and even
-lilypond itself) are also
-included inside MacOS X .app. They can be run from the command line by
-invoking them directly, e.g.
-
-@example
-@var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
-@end example
-
-@noindent
-The same is true of the other scripts in that directory, including
-lilypond-book, convert-ly, abc2ly, etc.
-
-Alternatively, you may create scripts which add the path
-automatically.  Create a directory to store these scripts,
-
-@example
-mkdir -p ~/bin
-cd ~/bin
-@end example
-
-Create a file called @code{lilypond} which contains
-
-@example
-exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
-@end example
-
-Create similar files @code{lilypond-book}, @code{convert-ly}, and
-any other helper programs you use (@code{abc2ly}, @code{midi2ly},
-etc).  Simply replace the @code{bin/lilypond} with
-@code{bin/convert-ly} (or other program name) in the above file.
-
-Make the file executable,
-
-@example
-chmod u+x lilypond
-@end example
-
-Now, add this directory to your path.  Modify (or create)
-a file called @code{.profile} in your home directory such that it contains
-
-@example
-export PATH=$PATH:~/bin
-@end example
-
-@noindent
-This file should end with a blank line.
-
-Note that @var{path/to} will generally be @code{/Applications/}.
-
-
 @node Updating files with convert-ly
 @section Updating with @command{convert-ly}
 
diff --git a/Documentation/user/setup.itely b/Documentation/user/setup.itely
new file mode 100644 (file)
index 0000000..7ac1c50
--- /dev/null
@@ -0,0 +1,137 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@c This file is part of lilypond-program.tely
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@c was "INSTALL - compiling and installing GNU LilyPond"
+@node Setup
+@chapter Setup
+
+This chapter discusses how to set up LilyPond to integrate with various
+programs.
+
+@menu
+* Notes for the MacOS X app::   
+* Text editor support::         
+@end menu
+
+
+@node Notes for the MacOS X app
+@section Notes for the MacOS X app
+
+The scripts (such as lilypond-book, convert-ly, abc2ly, and even
+lilypond itself) are also
+included inside MacOS X .app. They can be run from the command line by
+invoking them directly, e.g.
+
+@example
+@var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
+@end example
+
+@noindent
+The same is true of the other scripts in that directory, including
+lilypond-book, convert-ly, abc2ly, etc.
+
+Alternatively, you may create scripts which add the path
+automatically.  Create a directory to store these scripts,
+
+@example
+mkdir -p ~/bin
+cd ~/bin
+@end example
+
+Create a file called @code{lilypond} which contains
+
+@example
+exec @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
+@end example
+
+Create similar files @code{lilypond-book}, @code{convert-ly}, and
+any other helper programs you use (@code{abc2ly}, @code{midi2ly},
+etc).  Simply replace the @code{bin/lilypond} with
+@code{bin/convert-ly} (or other program name) in the above file.
+
+Make the file executable,
+
+@example
+chmod u+x lilypond
+@end example
+
+Now, add this directory to your path.  Modify (or create)
+a file called @code{.profile} in your home directory such that it contains
+
+@example
+export PATH=$PATH:~/bin
+@end example
+
+@noindent
+This file should end with a blank line.
+
+Note that @var{path/to} will generally be @code{/Applications/}.
+
+
+@node Text editor support
+@section Text editor support
+
+@menu
+* Emacs mode::                  
+* Vim mode::                    
+@end menu
+
+@node Emacs mode
+@subsection Emacs mode
+
+An Emacs mode for entering music and running LilyPond is contained in
+the source archive in the @file{elisp} directory.  Do @command{make
+install} to install it to @var{elispdir}.  The file @file{lilypond-init.el}
+should be placed to @var{load-path}@file{/site-start.d/} or appended
+to your @file{~/.emacs} or @file{~/.emacs.el}.
+
+As a user, you may want add your source path (e.g. @file{~/site-lisp/}) to
+your @var{load-path} by appending the following line (as modified) to your
+@file{~/.emacs}
+@c any reason we do not advise:  (push "~/site-lisp" load-path)
+@quotation
+@example
+(setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
+@end example
+@end quotation
+
+
+@node Vim mode
+@subsection Vim mode
+
+A Vim mode for entering music and running LilyPond is contained in the
+source archive in @code{$VIM} directory.
+
+The LilyPond file type is detected if the file @file{~/.vim/filetype.vim} @c
+has the following content
+@quotation
+@example
+if exists("did_load_filetypes")
+  finish
+endif
+augroup filetypedetect
+  au! BufNewFile,BufRead *.ly           setf lilypond
+augroup END
+@end example
+@end quotation
+
+Please include this path by appending the following line to your
+@file{~/.vimrc}
+
+@quotation
+@example
+set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
+@end example
+@end quotation
+
+@noindent
+where $@{LILYPOND_VERSION@} is your lilypond version.  If Lilypond was not
+installed in @file{/usr/local/}, then change this path accordingly.
+
+