X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fcontributor%2Fadministration.itexi;h=480af18b7f296f2cbec5e1c8f0526724fdae61da;hb=2603b58f6e4f8706c630273b063606296fa39919;hp=a9b32decab0bcbb220e902a0e8fc6f1fbe0e5622;hpb=2d28acb86f2e7b162dbdfa94b38544e3319f5a42;p=lilypond.git diff --git a/Documentation/contributor/administration.itexi b/Documentation/contributor/administration.itexi index a9b32decab..480af18b7f 100644 --- a/Documentation/contributor/administration.itexi +++ b/Documentation/contributor/administration.itexi @@ -7,6 +7,7 @@ don't fit anywhere else. @menu * Meta-policy for this document:: +* Environment variables:: * Meisters:: * Patchy:: * Administrative mailing list:: @@ -78,6 +79,32 @@ Totally disorganized; do whatever the mao you want: @end itemize +@node Environment variables +@section Environment variables + +Some maintenance scripts and instructions in this guide rely on +the following environment variables. They should be predefined in +LilyDev distribution (see @ref{LilyDev}); if you set up your own +development environment, you can set them by appending these settings to +your @file{~/.bashrc} (or whatever defines your default environment +variables for the user account for LilyPond development), then logging +out and in (adapt directories to your setup): + +@example +LILYPOND_GIT=~/lilypond-git +export LILYPOND_GIT +LILYPOND_BUILD_DIR=~/lilypond-git/build +export LILYPOND_BUILD_DIR +@end example + +The standard build and install procedure (with @code{autogen.sh}, +@code{configure}, @code{make}, @code{make install}, @code{make doc} +@dots{}) does not rely on them. + +In addition, for working on the website, @code{LILYPOND_WEB_MEDIA_GIT} +should be set to the repository lilypond-extra, see +@ref{lilypond-extra}. + @node Meisters @section Meisters @@ -91,7 +118,7 @@ Bug Meister: trains new Bug Squad volunteers, organizes who works on which part of their job, checks to make sure that everything is running smoothly, and has final say on our policy for Issues. -Currently: Phil +Currently: Colin H @item Doc Meister: trains new doc editors/writers, organizes who works @@ -119,7 +146,7 @@ finally pushes the patches once they're accepted. This person is would be far too much work -- his/her job is @qq{only} to guide completed patches through our process. -Currently: Carl +Currently: Mike Solomon @end itemize @@ -179,24 +206,26 @@ Make sure it's where you want it and name it lilypond-git (assuming you want to follow the standard naming conventions). @item -Create an environment variable called LILYPOND_GIT and make it -equal to the location of your new git repo. You can do this by -editing @file{$HOME/.profile} and adding the line: -@example -export LILYPOND_GIT=~/lilypond-git -@end example -then logging out and in. +Create environment variables @var{LILYPOND_GIT} and +@var{LILYPOND_BUILD_DIR}, see @ref{Environment variables}. @item -Run patchy once to set up config files. Cancel this build -(ctrl-c). +Run patchy once to set up config files, answer @q{@code{n}} when it +asks for going on, unless the default config file happens to suit your +setup: +@example +cd PATH/TO/lilypond-extra.git/patches +lilypond-patchy-staging.py +@end example +Following calls of @code{lilypond-patchy-staging.py} need not be made +from the directory where it stands. @item -Edit @file{$HOME/.lilypond-patchy-config} to provide working -directories for your build directory, your results directory, -compiler options and notification method. If you don't want to -use email notification, then delete everything after -@code{smtp_command:}. +Edit @file{$HOME/.lilypond-patchy-config} to provide the location of +your local lilypond Git repository, working directories for your build +directory, your results directory, compiler options and notification +method. If you don't want to use email notification, then delete +everything after @code{smtp_command:}. @item Ensure that your new user has git push access. Follow the @@ -208,7 +237,7 @@ to run patchy unattended. @subheading lilypond-patchy-staging.py -lilypond-patchy-staging.py is run with +@code{lilypond-patchy-staging.py} is run with @example python lilypond-patchy-staging.py @end example @@ -394,7 +423,7 @@ We often receive reports of typos and minor text updates to the documentation. It would be great if somebody could create properly-formatted patches for these corrections. -Technical requirements: ability to run @ref{Lilydev}. +Technical requirements: ability to run @ref{LilyDev}. @item LSR editor: LSR contains many useful examples of lilypond, but some snippets @@ -411,7 +440,7 @@ chapters 1 and 2 (or be willing to read the docs to find out). often find them in Ponds of Lilies) and new feature implementors. Technical requirements: development environment (such as -@ref{Lilydev}), ability to read+write scheme and/or C++ code. +@ref{LilyDev}), ability to read+write scheme and/or C++ code. @end itemize @@ -958,11 +987,11 @@ area}, reason to move this to a different type. @item anything which stops contributors from helping out (e.g. lily-git.tcl not working, source tree(s) not being available, -lilydev being unable to compile git master, inaccurate +LilyDev being unable to compile git master, inaccurate instructions in the Contributor's Guide 2 Quick start). To limit this scope of this point, we will assume that the -contributor is using the latest lilydev and has read the relevant +contributor is using the latest LilyDev and has read the relevant part(s) of the Contributor's Guide. Problems in other chapters of the CG are not sufficient to qualify as Type-Critical. @@ -1063,9 +1092,10 @@ all output will still be written to log files; the console output is strictly additional to the log files. @item -Logfiles from calling lilypond (as part of lilypond-book) will go -in the relevant @file{build/out/lybook-db/12/lily-123456.log} -file. All other logfiles will go in the @file{build/logfiles/} +Logfiles from calling lilypond (as part of lilypond-book) will go in +the relevant +@file{$LILYPOND_BUILD_DIR/out/lybook-db/12/lily-123456.log} file. All +other logfiles will go in the @file{$LILYPOND_BUILD_DIR/logfiles/} directory. A single @code{make doc} will therefore result in hundreds of log