X-Git-Url: http://v3vee.org/palacios/gitweb/gitweb.cgi?a=blobdiff_plain;f=manual%2Fmanual.tex;h=c806d91e52514f79506c4a40e11b8cbf26f81369;hb=2938c6b1f4810bdc80dd8131fed87ca3fd7f9437;hp=aaa4dc4d2246aca8c3333a2de867366ca3b7d1ba;hpb=b65297c305017bb77bdbc6d056702df0565673ad;p=palacios.git diff --git a/manual/manual.tex b/manual/manual.tex index aaa4dc4..c806d91 100755 --- a/manual/manual.tex +++ b/manual/manual.tex @@ -310,10 +310,20 @@ overlooked principle of design gives the eye a "place to rest," increasing the appeal of a composition through subtle means." \newline\newline Translation: Use the spacebar, newlines, and parentheses. -\newline\newline + +Curly-brackets are not optional, even for single line conditionals. + +Tabs should be 4 characters in width. + +{\em Special:} If you are using XEmacs add the following to your \verb.init\.el. file: +\begin{verbatim} +(setq c-basic-offset 4) +(c-set-offset 'case-label 4) +\end{verbatim} + {\em Bad} \begin{verbatim} -if(a&&b==5||c!=0){return;} +if(a&&b==5||c!=0) return; \end{verbatim} @@ -322,10 +332,12 @@ if(a&&b==5||c!=0){return;} \begin{verbatim} if (((a) && (b == 5)) || (c != 0)) { - return; + return; } \end{verbatim} + + \paragraph*{Fail Stop} Because booting a basic linux kernel results in over 1 million VM exits catching silent errors is next to impossible. For this reason @@ -358,7 +370,7 @@ whenever possible. \item \verb.v3_. prefix \newline Major interface functions should be named with the prefix \verb.v3_. This -allows easy understanding of how to interact with the subsystems. And +xallows easy understanding of how to interact with the subsystems. And in the case that they need to be externally visible to the host os, make them unlikely to collide with other functions. \end{enumerate} @@ -374,8 +386,8 @@ Two functions of note are \verb.PrintDebug. and \verb.PrintError.. \item PrintDebug: \newline -Should be used for debugging output that will often be -turned off selectively by the VMM configuration. +Should be used for debugging output that will often be turned off +selectively by the VMM configuration. \item PrintError \newline @@ -491,7 +503,7 @@ hgext.mq= \end{verbatim} Mercurial queues use the same stack operations as stacked git, however -does not automatically handle the synchronization with pull +it does not automatically handle the synchronization with pull operations. Before you update from the central version of Kitten you need to pop all of the patches, and then push them once the update is complete. @@ -501,7 +513,7 @@ Basically: hg qpop -a hg pull hg update -hg qupush -a +hg qpush -a \end{verbatim} @@ -586,7 +598,7 @@ computers (v-test-amd, v-test-amd2, etc.) are connected. To bridge, for example, tap10, to this interface, you would do the following (with root's help): \begin{enumerate} -\item You need to bring up eth1 (ifup eth1) +\item You need to bring up eth1 (ifconfig eth1 up {\em address} netmask {\em mask}). It is important that the address and mask you choose are appropriate for the network eth1 is connected to and that it. \item You would bring up tap10 without an address: /sbin/ifconfig tap10 up \item You would bridge tap10 and eth1: /usr/sbin/brctl addif br0