Re: Doc: Correct and extend infos about LilyDev setup (issue 561360043 by address@hidden)

[lemzwerg]

Some more nits.  Thanks for working on this!


https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi
File Documentation/contributor/quick-start.itexi (right):

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode28
Documentation/contributor/quick-start.itexi:28: and the website (also
see @ref{Website work}). It is also prepared
In documentation, please use two spaces after a full stop that indicates
a sentence ending.

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode42
Documentation/contributor/quick-start.itexi:42:
@code{LilyDev-VERSION-debian-vm.zip}.  GNU/Linux users are recommended
s/@code/@file/

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode46
Documentation/contributor/quick-start.itexi:46: create it from the
sources located in the /mkosi subdirectory
... in the @code{/mkosi} sub directory...

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode98
Documentation/contributor/quick-start.itexi:98: extracted the files:
(this may take some time)
I suggest to put the colon after the parenthesized text.

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode104
Documentation/contributor/quick-start.itexi:104: For Windows, look for
the tools @strong{FCIV} or @strong{certutil}
s/@strong/@command/

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode110
Documentation/contributor/quick-start.itexi:110: that @q{VBoxManage} is
in your PATH or call it from your
@code{PATH}

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode114
Documentation/contributor/quick-start.itexi:114: VBoxManage
convertfromraw LilyDev-VERSION-debian-vm.img
LilyDev-VERSION-debian-vm.vdi
This is too long to be printed in the PDF output without an overfull
line.  I thus suggest

@example
VBoxManage convertfromraw LilyDev-VERSION-debian-vm.img \
  LilyDev-VERSION-debian-vm.vdi
@end example

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode135
Documentation/contributor/quick-start.itexi:135: least 1 GB of RAM; the
more RAM you can spare from your host the
1@dmn{GB}

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode142
Documentation/contributor/quick-start.itexi:142: @code{~/VirtualBox
VMs/NAME}).  Click on @q{Use an existing virtual
s/@code/@file/

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode189
Documentation/contributor/quick-start.itexi:189: @q{passwd} as @q{dev}
user, without invoking @q{su}.
s/@q{passwd}/@command{passwd}/
s/@q{su}/@command{su}/

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode200
Documentation/contributor/quick-start.itexi:200: system configuration. 
The @q{sudo} tool allows to gain superuser
@command{sudo}

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode208
Documentation/contributor/quick-start.itexi:208: your AltGr key. 
Normally you will use the default layout settings,
@key{AltGr}

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode209
Documentation/contributor/quick-start.itexi:209: so take number 1.  The
same holds for the question whether you want
s/number 1/number@tie{}1/

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode212
Documentation/contributor/quick-start.itexi:212: Ctrl+Alt+Backspace as a
shortcut to terminate the X server.
@key{Ctrl+Alt+Backspace}

https://codereview.appspot.com/561360043/diff/547520043/Documentation/contributor/quick-start.itexi#newcode229
Documentation/contributor/quick-start.itexi:229: already, simply type
@code{./setup.sh} to run the interactive script
s/@code/@command/

https://codereview.appspot.com/561360043/