X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fcontributor%2Fsource-code.itexi;h=533eca6a10f5d6933140a456409d2e2dd574fd6d;hb=737bdcc2e6e75483d8ce6e824f211a36c969a1ea;hp=80c78edbfe136fe7fc5f2d30976832270bc7415e;hpb=8310faf7732b7e4b26d2951de056b86df76eb113;p=lilypond.git diff --git a/Documentation/contributor/source-code.itexi b/Documentation/contributor/source-code.itexi index 80c78edbfe..533eca6a10 100644 --- a/Documentation/contributor/source-code.itexi +++ b/Documentation/contributor/source-code.itexi @@ -37,6 +37,47 @@ share changes to the lilypond source code. @node Install and configuration of lily-git.tcl @unnumberedsubsec Install and configuration of @command{lily-git.tcl} +@subsubheading Lilybuntu + +@warning{The rest of this manual assumes that you are using the +command-line; go to @clicksequence{Applications @click{} +Accessories @click{} Terminal}.} + +@enumerate +@item +@code{lily-git.tcl} has already been install for you. Simply type +(or copy&paste): + +@example +cd +wish lily-git.tcl +@end example + +@item +Click on the @qq{Get source} button. + +This will create a directory called @file{lilypond-git/} within +your home directory, and will download the source code into that +directory (around 55Mb). When the process is finished, the +@qq{Command output} window will display @qq{Done}, and the button +label will change to say @qq{Update source}. + +@item +Navigate to the @file{lilypond-git/} directory to view the source +files. You should now be able to modify the source files using +your normal text editor. + +@end enumerate + +You should now progress to @ref{Compiling with lilybuntu}. + +@warning{Throughout the rest of this manual, most command-line +input should be entered from @file{~/lilypond-git/}. This is +referred to as the @emph{top source directory}.} + + +@subsubheading Other operating music systems + @enumerate @item If you haven't already, download and install Git. @@ -83,29 +124,17 @@ wish lily-git.tcl @end example @item -Click on the @qq{Get source} button. - -This will create a directory called @file{lilypond-git/} within -your home directory, and will download the source code into that -directory (around 55Mb). When the process is finished, the -@qq{Command output} window will display @qq{Done}, and the button -label will change to say @qq{Update source}. - -@item -Navigate to the @file{lilypond-git/} directory to view the source -files. You should now be able to modify the source files using -your normal text editor. +Go read the lilybuntu instructions, starting from the @qq{get +source} step. @end enumerate -@quotation -Advanced note: The @qq{Get source} button does not fetch the -entire history of the git repository, so utilities like -@command{gitk} will only be able to display the most recent -additions. As you continue to work with @command{lily-git.tcl}, the -@qq{Update source} button will take any new additions and add it -to whatever is currently in your repository's history. -@end quotation +@advanced{the @qq{Get source} button does not fetch the entire +history of the git repository, so utilities like @command{gitk} +will only be able to display the most recent additions. As you +continue to work with @command{lily-git.tcl}, the @qq{Update +source} button will take any new additions and add it to whatever +is currently in your repository's history.} @node Daily use of lily-git.tcl @@ -140,10 +169,8 @@ body is optional. After entering a commit message, click @qq{OK} to finalize the commit. -@quotation -Advanced note: For more information regarding commits and commit -messages, see @ref{Commits and patches}. -@end quotation +@advanced{for more information regarding commits and commit +messages, see @ref{Commits and patches}.} @subsubheading 2b. Amend previous commit @@ -299,7 +326,7 @@ need to access it, but it's good to know it's there. @warning{Throughout the rest of this manual, all command-line input should be entered from the top directory of the Git repository being discussed (eg. @file{~/lilypond-git/}). This is -referred to as a @emph{top source directory}.} +referred to as the @emph{top source directory}.} Before downloading a copy of the main LilyPond repository, you should configure some basic settings with the