Merge branch 'master' of ssh+git://jneem@git.sv.gnu.org/srv/git/lilypond

[lilypond.git] / Documentation / user / converters.itely

diff --git a/Documentation/user/converters.itely b/Documentation/user/converters.itely
index f8b6f6c82f8b5ea8fcd28910eb5520cd41efca2b..7ba2816ab23941d6878743b9c62153f71e735be7 100644 (file)
--- a/Documentation/user/converters.itely
+++ b/Documentation/user/converters.itely
@@ -9,14 +9,26 @@ There are other tools that produce LilyPond input, for example GUI
 sequencers and XML converters.  Refer to the
 @uref{http://@/lilypond@/.org,website} for more details.
 
+These are separate programs from lilypond itself, and are run
+on the command-line.  By ``command-line'', we mean the command
+line in the operating system.  Windows users
+might be more familiar with the terms ``DOS shell'' or
+``command shell''; OSX users might be more familiar with the
+terms ``terminal'' or ``console''.  OSX users should also
+consult @ref{Notes for the MacOS X app}.
+
+Describing how to use
+this part of an operating system is outside the scope of this
+manual; please consult other documentation on this topic if
+you are unfamiliar with the command-line.
+
 
 
 @menu
 * Invoking midi2ly::            Importing MIDI.
 * Invoking etf2ly::             Importing Finale.
 * Invoking musicxml2ly::        
-* Invoking abc2ly::             Importing ABC.          
-* Invoking mup2ly::             Importing MUP. 
+* Invoking abc2ly::             Importing ABC.      
 * Generating LilyPond files::   
 @end menu
 
@@ -55,6 +67,9 @@ It is invoked from the command-line as follows,
 midi2ly [@var{option}]@dots{} @var{midi-file}
 @end example
 
+Note that by ``command-line'', we mean the command line of the
+operating system.  See @ref{Converting from other formats} for
+more information about this.
 
 The following options are supported by @command{midi2ly}.
 
@@ -124,6 +139,10 @@ It is invoked from the command-line as follows.
 etf2ly [@var{option}]@dots{} @var{etf-file}
 @end example
 
+Note that by ``command-line'', we mean the command line of the
+operating system.  See @ref{Converting from other formats} for
+more information about this.
+
 The following options are supported by @command{etf2ly}:
 
 @table @code
@@ -144,16 +163,18 @@ confuse @command{etf2ly}.  Sequences of grace notes are ended improperly.
 @node Invoking musicxml2ly
 @section Invoking @code{musicxml2ly}
 
-@uref{http://@/www.@/recordarde@/.com/xml/,MusicXML} is an XML dialect
+@uref{http://@/www.@/recordarde@/.com/xml@/.html,MusicXML} is an XML dialect
 for representing music notation.
 
 @command{musicxml2ly} extracts the notes from part-wise MusicXML
-files, and writes it to a .ly file.
+files, and writes it to a .ly file.  It is invoked from the command-line.
 
+Note that by ``command-line'', we mean the command line of the
+operating system.  See @ref{Converting from other formats} for
+more information about this.
 
 The following options are supported by @command{musicxml2ly}:
 
-
 @table @code
 @item -h,--help
 print usage and option summary.
@@ -198,7 +219,7 @@ source file.  If you say:
 %%LY voices \set autoBeaming = ##f
 @end example
 
-This will cause the text following the keyword ``voices'' to be inserted 
+This will cause the text following the keyword ``voices'' to be inserted
 into the current voice of the LilyPond output file.
 
 Similarly,
@@ -214,7 +235,7 @@ into the current line of lyrics.
 @refbugs
 
 The ABC standard is not very ``standard''.  For extended features
-(e.g., polyphonic music) different conventions exist. 
+(e.g., polyphonic music) different conventions exist.
 
 Multiple tunes in one file cannot be converted.
 
@@ -224,46 +245,6 @@ ABC synchronizes words and notes at the beginning of a line;
 @command{abc2ly} ignores the ABC beaming.
 
 
-@node Invoking mup2ly
-@section Invoking @command{mup2ly}
-
-Mup (Music Publisher) is a shareware music notation program by Arkkra
-Enterprises.  @command{mup2ly} will convert part of a Mup file to LilyPond
-format.  It is invoked from the command-line as follows:
-
-@cindex Music Publisher
-@cindex Mup
-@cindex Arkkra
-
-@example
-mup2ly [@var{option}]@dots{} @var{mup-file}
-@end example
-
-The following options are supported by @command{mup2ly}:
-
-@table @code
-@item -d,--debug
-show what constructs are not converted, but skipped.
-@item -D, --define=@var{name}[=@code{exp}]
-define macro @var{name} with opt expansion @code{exp}
-@item -E,--pre-process
-only run the pre-processor
-@item -h,--help
-print help
-@item -o,--output=@var{file}
-write output to @var{file}
-@item -v,--version
-version information
-@item -w,--warranty
-print warranty and copyright. 
-@end table
-
-
-@refbugs
-
-Only plain notes (pitches, durations), voices, and staves are
-converted.
-
 
 @node Generating LilyPond files
 @section Generating LilyPond files
@@ -279,9 +260,11 @@ These tools include
 @item
 @uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, a graphical score editor.
 @item
-@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime monophonic MIDI to LilyPond converter.
+@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime
+monophonic MIDI to LilyPond converter.
 @item
-@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an Emacs major mode.
+@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an
+Emacs major mode.
 @item
 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/, xml2ly}, which imports
 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
@@ -291,5 +274,8 @@ which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
 @item
 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 which imports MIDI
+@item
+@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
+a LISP library to generate music notation 
 @end itemize