X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fcontributor%2Fquick-start.itexi;h=92ecafd37c5c3f455cf8a2e62f35aaaf31f44194;hb=61babab909dacfbcb9b797d7ddcea55cef6773c9;hp=4d014836a425f0f504302c92b28119a906f086aa;hpb=0237ee5a38dd6117a7f66cfaff19ed78662e3608;p=lilypond.git diff --git a/Documentation/contributor/quick-start.itexi b/Documentation/contributor/quick-start.itexi index 4d014836a4..92ecafd37c 100644 --- a/Documentation/contributor/quick-start.itexi +++ b/Documentation/contributor/quick-start.itexi @@ -29,7 +29,8 @@ helpful users who may have never created a patch before.} @node Lilydev @section Lilydev -text. +This section discusses how to install and use the Ubuntu LilyPond +Development Remix. @menu * Installing lilydev:: @@ -58,17 +59,19 @@ Download the Ubuntu LilyPond Developer Remix disk image: (approximately 1 GB) @example -@uref{http://files.lilynet.net/ubuntu-lilydev-remix-1.0.iso} +@uref{http://files.lilynet.net/ubuntu-lilydev-remix-1.1.iso} @end example @advanced{Some users might want these files, but if you don't recognize what they are, then you don't want them: -@uref{http://files.lilynet.net/ubuntu-lilydev-remix-1.0.iso.md5} -@uref{http://files.lilynet.net/ubuntu-lilydev-remix-1.0.iso.torrent} +@* +@uref{http://files.lilynet.net/ubuntu-lilydev-remix-1.1.iso.md5} +@c @* +@c @uref{http://files.lilynet.net/ubuntu-lilydev-remix-1.0.iso.torrent} } @item -Create a new @qq{virtual machine} inside your virtualization +Create a music new @qq{virtual machine} inside your virtualization software. If possible, use at least 700 MB of RAM (1GB would be better) for @@ -83,7 +86,7 @@ on your virtualized system. @enumerate @item -When @file{lilydev2.iso} boots, it shows an ISOLINUX +When @file{lilydev.iso} boots, it shows an ISOLINUX @code{boot:} prompt. Type: @example @@ -125,7 +128,12 @@ client. Not all hardware is supported in all virtualization tools. In particular, some contributors have reported problems with USB -devices. If you would like to investigate further, then look for +devices, for example USB network adapters. If you have problems +with network connection (for example internet connection in the +host system is lost when you launch virtual system), try installing +and running Lilydev with your computer's built-in network adapter +used to connect to the network. +If you would like to investigate further, then look for help for your virtualization tool using your normal OS as the @qq{host} and Ubuntu as the @qq{client}. @@ -446,13 +454,7 @@ you bookmark the resulting page: firefox ~/lilypond-git/build/out-www/offline-root/index.html @end example -@subsubheading Other options - -To select different build options, or isolate certain parts of the -build, or to use multiple CPUs while building, read the rest of -this chapter. - -@subsubheading Installing LilyPond with lilydev +@subsubheading Installing Don't. There is no reason to install lilypond within lilydev. All development work can (and should) stay within the @@ -460,6 +462,17 @@ All development work can (and should) stay within the or typesetting work should be done with an official GUB release. +@subsubheading Problems and other options + +To select different build options, or isolate certain parts of the +build, or to use multiple CPUs while building, read +@ref{Compiling}. + +In particular, contributors working on the documentation should be +aware of some bugs in the build system, and should read the +workarounds in @ref{Generating documentation}. + + @node Now start work! @section Now start work! @@ -467,11 +480,22 @@ Lilydev users may now skip to the chapter which is aimed at their intended contributions: @itemize -@item @rcontrib{Documentation work} -@item @rcontrib{Translating the documentation} -@item @rcontrib{Website work} -@item @rcontrib{Regression tests} -@item @rcontrib{Programming work} +@item @ref{Documentation work} +@item @ref{Translating the documentation} +@item @ref{Website work} +@item @ref{Regression tests} +@item @ref{Programming work} +@end itemize + +These chapters are mainly intended for people not using LilyDev, +but they contain extra information about the +@qq{behind-the-scenes} activities. We recommend that you read +these at your leisure, a few weeks after beginning work with +LilyDev. + +@itemize +@item @ref{Working with source code} +@item @ref{Compiling} @end itemize