@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
@node Converting from other formats
@chapter Converting from other formats
@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
+on the command-line. By @q{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''. Describing how to use
+might be more familiar with the terms @q{DOS shell} or
+@q{command shell}; OSX users might be more familiar with the
+terms @q{terminal} or @q{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.
* 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
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
+Note that by @q{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}.
@item -k, --key=@var{acc}[:@var{minor}]
Set default key. @math{@var{acc} > 0} sets number of sharps;
@math{@var{acc} < 0} sets number of flats. A minor key is indicated by
-":1".
+@samp{:1}.
@item -o, --output=@var{file}
Write output to @var{file}.
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
+Note that by @q{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}:
@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. 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
+Note that by @q{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}:
ABC is a fairly simple ASCII based format. It is described at the ABC site:
@quotation
-@uref{http://@/www@/.gre@/.ac@/.uk/@/~c.walshaw/@/abc2mtex/@/abc@/.txt}.
+@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/abc2mtex/@/abc@/.txt}.
@end quotation
@command{abc2ly} translates from ABC to LilyPond. It is invoked as follows:
%%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 @q{voices} to be inserted
into the current voice of the LilyPond output file.
Similarly,
%%LY slyrics more words
@end example
-will cause the text following the ``slyrics'' keyword to be inserted
+will cause the text following the @q{slyrics} keyword to be inserted
into the current line of lyrics.
@refbugs
-The ABC standard is not very ``standard''. For extended features
-(e.g., polyphonic music) different conventions exist.
+The ABC standard is not very @q{standard}. For extended features
+(e.g., polyphonic music) different conventions exist.
Multiple tunes in one file cannot be converted.
@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
@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}
@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