Doc: improve style of CG 12.6 (creating Lilydev)

diff --git a/Documentation/contributor/build-notes.itexi b/Documentation/contributor/build-notes.itexi
index 26441ef7032eb55b49f5f7f1294c5e6d2f4ef8cd..e733d665474d81af79578125ca1974ade19a0608 100644 (file)
--- a/Documentation/contributor/build-notes.itexi
+++ b/Documentation/contributor/build-notes.itexi
@@ -628,56 +628,62 @@ then copies some extra files around.
 @node Building an Ubuntu distro
 @section Building an Ubuntu distro
 
+
+Here's the short instruction on how to create lilybuntu iso image
+(Jonathan Kulp did this on a spare drive,
+but he supposes it can be done in a VM too):
+
 @enumerate
+
 @item
-Install ubuntu, reboot
+Install ubuntu, reboot.
 @item
-Run all updates, reboot if asked
+Run all updates, reboot if asked.
 @item
-Enable src repos, refresh package lists
+Enable src repos, refresh package lists.
 @item
 Install LilyPond build deps:
 @example
-  sudo apt-get build-dep lilypond
+sudo apt-get build-dep lilypond
 @end example
 @item
 Install git and autoconf:
 @example
-  sudo apt-get install git-core gitk autoconf
+sudo apt-get install git-core gitk autoconf
 @end example
 
 @item
-TEST TO SEE WHETHER EVERYTHING WORKS NOW:
+Test to see whether everything works fine now:
 @enumerate
 @item
-Use lily-git.tcl to grab source files
+use @command{lily-git.tcl} to grab source files
 @item
-Go to source dir and do "./autogen.sh" ; make ; make doc
+go to source dir and do
+@example
+"./autogen.sh" ; make ; make doc
+@end example
 @item
-If all compiles, move on to iso creation...
-
+if all compiles, move on to iso creation...
 @end enumerate
 
 @item
 Download & install "remastersys":
-@example
-  http://sourceforge.net/projects/remastersys/
-@end example
+@uref{http://sourceforge.net/projects/remastersys/, http://sourceforge.net/projects/remastersys/}
 @item
-Copy lily-git.tcl script file into /etc/skel/
+Copy @command{lily-git.tcl} script file into @file{/etc/skel/}.
 @item
-Modify /etc/remastersys.conf as desired (change .iso name, default
-live session username, etc)
+Modify @file{/etc/remastersys.conf} as desired (change @code{.iso} name,
+default live session username, etc).
 @item
-Remove non-essential desktop software as desired
+Remove non-essential desktop software as desired.
 @item
-Create iso:  sudo remastersys dist
-@item
-New iso is in /home/remastersys/remastersys/
+Create iso:
+@example
+sudo remastersys dist
+@end example
+New iso is in @file{/home/remastersys/remastersys/}.
 @item
 Test iso by installing in VM and repeating steps above for
-getting source files and building lp and docs
-@end enumerate
-
-
+getting source files and building lp and docs.
 
+@end enumerate