From 5f14067f8a55f01b2619c97c6fa69b20f58ba943 Mon Sep 17 00:00:00 2001 From: James Lowe Date: Sun, 7 Dec 2014 23:58:57 +0000 Subject: [PATCH] Doc: Usage - added more examples for lilypond Issue 4220 Added example for mass input file processing including the cmds required for Windows Users. This was done on the back of Issue 4187 and the updates to the convert-ly section, also including similar command examples. --- Documentation/usage/running.itely | 38 +++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely index 8be6daded4..994c062a9b 100644 --- a/Documentation/usage/running.itely +++ b/Documentation/usage/running.itely @@ -128,6 +128,44 @@ particular shell, Command (Windows), Terminal or Console applications (MacOS X) to see if output redirection is supported or if the syntax is different. +The following example searches and converts all input files in the +current directory and all directories below it recursively. The output +files will be located in the same directory that the command was run in, +rather than in the same directories as the original input files. + +@example +find . -name '*.ly' -exec lilypond '@{@}' \; +@end example + +@noindent +This should also work for MacOS@tie{}X users. + +A Windows user would run; + +@example +forfiles /s /M *.ly /c "cmd /c lilypond @@file" +@end example + +@noindent +entering these commands in a @code{command prompt} usually found under +@code{Start > Accessories > Command Prompt} or for version 8 users, +by typing in the search window @q{command prompt}. + +Alternatively, an explicit path to the top-level of your folder +containing all the sub-folders that have input files in them can be +stated using the @code{/p} option; + +@example +forfiles /s /p C:\Documents\MyScores /M *.ly /c "cmd /c lilypond @@file" +@end example + +If there are spaces in the path to the top-level folder, then the whole +path needs to be inside double quotes; + +@example +forfiles /s /p "C:\Documents\My Scores" /M *.ly /c "cmd /c lilypond @@file" +@end example + @node Basic command line options for LilyPond @unnumberedsubsec Basic command line options for LilyPond -- 2.39.2