[Lunar-commits] r15639 - lunar-doc/trunk/lunar-manual
ca3sar
ca3sar at lunar-linux.org
Thu Jul 7 21:13:14 UTC 2005
Author: ca3sar
Date: 2005-07-07 21:13:11 +0000 (Thu, 07 Jul 2005)
New Revision: 15639
Modified:
lunar-doc/trunk/lunar-manual/1installation.tex
lunar-doc/trunk/lunar-manual/2using_lunar.tex
lunar-doc/trunk/lunar-manual/5getting_to_work.tex
lunar-doc/trunk/lunar-manual/6development.tex
lunar-doc/trunk/lunar-manual/Lunar_Book.tex
Log:
some minor fixes in code snippets and introducing frame around code, looks awsome
Modified: lunar-doc/trunk/lunar-manual/1installation.tex
===================================================================
--- lunar-doc/trunk/lunar-manual/1installation.tex 2005-07-07 20:55:20 UTC (rev 15638)
+++ lunar-doc/trunk/lunar-manual/1installation.tex 2005-07-07 21:13:11 UTC (rev 15639)
@@ -28,7 +28,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install1.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install1.pdf}
\end{center}
\caption{Boot Menu}
\end{figure}
@@ -39,7 +39,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install2.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install2.pdf}
\end{center}
\caption{Welcome to the Lunar Linux Installer}
\end{figure}
@@ -52,9 +52,9 @@
We now have some customization settings to configure. You can choose keyboard map, console font and global language. \par
-\begin{figure}[h]
+\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install3.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install3.pdf}
\end{center}
\caption{Localise your Lunar Linux}
\end{figure}
@@ -65,13 +65,8 @@
\section{Setting Up Partitions}
-\begin{figure}[hb]
-\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install4.pdf}
-\end{center}
-\caption{Partition Setup}
-\end{figure}
+
The next step is to set up partitions on your hard drive. Upon selecting the "Partition Drive" option, you will be shown a list of all the discs the kernel has detected. If we assume that you have one hard drive connected via an IDE channel, which will show up in the menu as "disc0". After selecting the disc to partition, you are given the option of using one of three partitioning programs. They are:
\begin{itemize}
@@ -86,6 +81,13 @@
You might also want to install a /tmp partition. By default, Lunar will create a tempfs filesystem mounted on /tmp (tempfs minimizes filesystem fragmentation because it resides in volatile memory). This can be a good choice if you have a lot of memory on your machine. If memory is tight, we recommend creating a /tmp partition to minimize filesystem fragmentation.\par
+\begin{figure}
+\begin{center}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install4.pdf}
+\end{center}
+\caption{Partition Setup}
+\end{figure}
+
It is important to note that you can not mount the directories /etc, /bin, /sbin, /dev, /lib and /proc on separate partitions. These directories need to be contained within the root ("/") directory. The installation program should block you from doing this, but it's best not to try.\par
Here's our partition setup:\par
@@ -110,7 +112,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install5.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install5.pdf}
\end{center}
\caption{Creating one swap, one / and one /usr partition}
\end{figure}
@@ -136,7 +138,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install6.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install6.pdf}
\end{center}
\caption{Transfering Lunar Linux}
\end{figure}
@@ -149,7 +151,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install7.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install7.pdf}
\end{center}
\caption{Optimisations and Bootloader}
\end{figure}
@@ -179,7 +181,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install8.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install8.pdf}
\end{center}
\caption{Kernel Build Menu}
\end{figure}
@@ -191,9 +193,9 @@
We are now finished setting up our GCC optimizations! When you have you lunar system up and running, you can always change and tweak these GCC settings by typing "lunar" at the commandline prompt, and going to "Optimization Settings". In addition, if you aren't that familiar with what your processor is capable of using for optimizations, you can go to the shell out option on the ISO and type
-\begin{flushleft}
-\textit{ cat /proc/cpuinfo}
-\end{flushleft}
+\begin{lstlisting}
+ cat /proc/cpuinfo
+\end{lstlisting}
at the prompt and the system will show you all the optimizations that the processor reports it can handle.\par
@@ -203,7 +205,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install9.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install9.pdf}
\end{center}
\caption{Kernel Build Menu}
\end{figure}
@@ -303,7 +305,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install10.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install10.pdf}
\end{center}
\caption{Setting the root password}
\end{figure}
@@ -316,7 +318,7 @@
\begin{figure}
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install11.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install11.pdf}
\end{center}
\caption{Setting up networking, services, ssh keys and timezone}
\end{figure}
Modified: lunar-doc/trunk/lunar-manual/2using_lunar.tex
===================================================================
--- lunar-doc/trunk/lunar-manual/2using_lunar.tex 2005-07-07 20:55:20 UTC (rev 15638)
+++ lunar-doc/trunk/lunar-manual/2using_lunar.tex 2005-07-07 21:13:11 UTC (rev 15639)
@@ -58,7 +58,7 @@
\begin{figure}[h]
\begin{center}
-\includegraphics[width=0.8\textwidth]{./image/install12.pdf}
+\includegraphics[angle=270,width=0.8\textwidth]{./image/install12.pdf}
\end{center}
\caption{Gui of the \lstinline{lunar} coretool}
\end{figure}
Modified: lunar-doc/trunk/lunar-manual/5getting_to_work.tex
===================================================================
--- lunar-doc/trunk/lunar-manual/5getting_to_work.tex 2005-07-07 20:55:20 UTC (rev 15638)
+++ lunar-doc/trunk/lunar-manual/5getting_to_work.tex 2005-07-07 21:13:11 UTC (rev 15639)
@@ -164,7 +164,7 @@
To install udev, as root:
\begin{lstlisting}
-root at myshinybox ~#\lin udev
+root at myshinybox ~# lin udev
\end{lstlisting}
will install udev, and sysfsutils and hotplug as dependencies. One thing you have to know about udev is that its use excludes the use of devfs. You can still have devfs support as a module but you must not enable "automatically mount devfs at boot" (see the kernel's Filesystems section, subsection pseudo filesystems). Furthermore, the kernel has to be hotplug aware, so this option should be included when compiling a kernel for udev (see General Setup -> Support for hot-pluggable devices).\par
@@ -187,7 +187,7 @@
Taking for granted you do want to install kernel-headers-2.6, as root type:
\begin{lstlisting}
-root at myshinybox ~ \# \textit{lin kernel-headers-2.6}
+root at myshinybox ~# lin kernel-headers-2.6
\end{lstlisting}
Second step here is to rebuild your software against your new headers. This should be done in a certain order. As a base 2.6 install, from which later rebuild the rest of your apps, you should \lstinline{ lin}:
Modified: lunar-doc/trunk/lunar-manual/6development.tex
===================================================================
--- lunar-doc/trunk/lunar-manual/6development.tex 2005-07-07 20:55:20 UTC (rev 15638)
+++ lunar-doc/trunk/lunar-manual/6development.tex 2005-07-07 21:13:11 UTC (rev 15639)
@@ -35,7 +35,7 @@
Every module is required to have at least a \lstinline{DETAILS} file. A minimal \lstinline{DETAILS} may appear as follows : (\lstinline{/var/lib/lunar/moonbase/editors/emacs/DETAILS}) \par
-\begin{lstlisting}[basicstyle=\tiny]
+\begin{lstlisting}[basicstyle=\scriptsize]
MODULE=emacs
VERSION=21.3
SOURCE=$MODULE-$VERSION.tar.gz
@@ -46,7 +46,7 @@
WEB_SITE=http://www.gnu.org/software/emacs
ENTERED=20010922
UPDATED=20020529
- SHORT="Emacs is the extensible, self-documenting real-time display editor."
+ SHORT="Emacs is the extensible, self-documenting display editor."
cat << EOF
Emacs is the extensible, customizable, self-documenting real-time display editor.
EOF
@@ -55,21 +55,21 @@
With comments, default values:
-\begin{lstlisting}[basicstyle=\tiny]
- MODULE=emacs # Module name, yes it's redundant
- VERSION=21.3 # Version, changes *often*
- SOURCE=$MODULE-$VERSION.tar.gz # Source filename
-SOURCE_DIRECTORY=$BUILD_DIRECTORY/$MODULE-$VERSION # Where source unpacks # ($BUILD_DIRECTORY=/usr/src)
- SOURCE_URL[0]=$GNU_URL/$MODULE/$SOURCE # Download URL
- SOURCE_URL[1]=ftp://ftp.gnu.org/pub/gnu/$MODULE/$SOURCE # Alternate URL(s)
- SOURCE_VFY=md5:a0bab457cbf5b4f8eb99d1d0a3ada420 # Sets md5 hash or pgp/gpg sig url
- WEB_SITE=http://www.gnu.org/software/emacs # where to learn more
- ENTERED=20010922 # First appearance in moonbase
- UPDATED=20020529 # Date of latest change.
- # Force update by setting this
+\begin{lstlisting}[basicstyle=\scriptsize]
+ MODULE=emacs # Module name, yes it's redundant
+ VERSION=21.3 # Version, changes *often*
+ SOURCE=$MODULE-$VERSION.tar.gz # Source filename
+SOURCE_DIRECTORY=$BUILD_DIRECTORY/$MODULE-$VERSION # Where source unpacks (/usr/src)
+ SOURCE_URL[0]=$GNU_URL/$MODULE/$SOURCE # Download URL
+ SOURCE_URL[1]=ftp://ftp.gnu.org/pub/gnu/$MODULE/$SOURCE # Alternate URL(s)
+ SOURCE_VFY=md5:a0bab457cbf5b4f8eb99d1d0a3ada420 # Sets md5 hash or gpg sig url
+ WEB_SITE=http://www.gnu.org/software/emacs # where to learn more
+ ENTERED=20010922 # First appearance in moonbase
+ UPDATED=20020529 # Date of latest change.
+ # Force update by setting this
# The remaining lines are used for input to the 'lvu what' command
# and are best copied from the source-maintainer's own description.
- SHORT="Emacs is the extensible, self-documenting real-time display editor."
+ SHORT="Emacs is the extensible, self-documenting display editor."
cat << EOF
Emacs is the extensible, customizable, self-documenting real-time display editor.
EOF
@@ -86,13 +86,13 @@
\lstinline{DEPENDS} may include both required and optional dependencies. The depends() function statement simply determines one required package. The \lstinline{optional_depends} function is a little more complex. It consists of the required package, necessary --options to give to\lstinline{ ./configure} (for yes and no respectively, and an explanatory comment telling the user the purpose of the option being presented. A typical \lstinline{DEPENDS} file might appear as follows : (\lstinline{/var/lib/lunar/moonbase/devel/subversion/DEPENDS})
-\begin{lstlisting}[basicstyle=\tiny]
+\begin{lstlisting}
depends zlib &&
depends openssl &&
-optional_depends "db4" "--with-berkeley-db" "" "for creating local repositories"
+optional_depends "db4" "--with-berkeley-db" "" "local repositories"
# ^ ^ ^ ^
# | | | |
-# optional package if "Y" if "N" explanatory comment
+# optional package if "Y" if "N" comment
# { ./configure strings }
\end{lstlisting}
\lstset{basicstyle=\small}
@@ -108,9 +108,9 @@
The \lstinline{CONFIGURE} script is used to collect interactive input from the user on optional parameters for the software build. use the \lstinline'query' function and provide a default answer to each question. The results of the answers are then used to store configuration variables needed in configuration state files. An a simple example might be : (\lstinline{/var/lib/lunar/moonbase/crypto/gnupg/CONFIGURE})
-\begin{lstlisting}[basicstyle=\tiny]
+\begin{lstlisting}
if ! grep -q CONFIGURED $MODULE_CONFIG ; then
- if query "Enable experimental external HKP keyserver interface? " n ; then
+ if query "Enable external HKP keyserver interface? " n ; then
OPTS="$OPTS --enable-external-hkp"
fi
@@ -124,7 +124,7 @@
\begin{lstlisting}
mk_source_dir $SOURCE_DIRECTORY &&
-unpack $SOURCE &&
+unpack $SOURCE &&
cd $MODULE
unpack $SOURCE2
cd tidy
@@ -143,7 +143,7 @@
--prefix=/usr \
--sysconfdir=/etc \
--localstatedir=/var \
- --infodir=/usr/share/info \
+ --infodir=/usr/share/info \
--mandir=/usr/share/man \
$OPTS
\end{lstlisting}
@@ -160,10 +160,10 @@
\begin{lstlisting}
(
-./configure --build=$BUILD \
- --prefix=/usr \
- --bindir=/bin \
- --infodir=/usr/share/info \
+./configure --build=$BUILD \
+ --prefix=/usr \
+ --bindir=/bin \
+ --infodir=/usr/share/info \
--mandir=/usr/share/man &&
make &&
prepare_install &&
@@ -177,12 +177,12 @@
\begin{lstlisting}
(
cd $SOURCE_DIRECTORY &&
- sedit 's/usr.local/usr/' Makefile &&
- sedit 's/= man/= share/man/' Makefile &&
- sedit 's/ucb/bin/' Makefile &&
- sedit 's/= termlib/= ncurses/' Makefile &&
- make &&
- prepare_install &&
+ sedit 's/usr.local/usr/' Makefile &&
+ sedit 's/= man/= share/man/' Makefile &&
+ sedit 's/ucb/bin/' Makefile &&
+ sedit 's/= termlib/= ncurses/' Makefile &&
+ make &&
+ prepare_install &&
make install
) > $C_FIFO 2\&1
@@ -217,16 +217,16 @@
\begin{lstlisting}
cd /usr/lib/gcc-lib/$BUILD/$VERSION &&
-ln -sf /usr/bin/cpp cpp &&
-cd /lib/ &&
-ln -sf /usr/bin/cpp cpp &&
+ln -sf /usr/bin/cpp cpp &&
+cd /lib/ &&
+ln -sf /usr/bin/cpp cpp &&
if [ ! -e /usr/bin/cc ] ; then
ln -s gcc /usr/bin/cc
-fi &&
+fi &&
-rm_source_dir /usr/src/gcc-$VERSION-BUILD &&
-rm_source_dir /usr/src/gcc-$VERSION &&
+rm_source_dir /usr/src/gcc-$VERSION-BUILD &&
+rm_source_dir /usr/src/gcc-$VERSION &&
ldconfig
\end{lstlisting}
Modified: lunar-doc/trunk/lunar-manual/Lunar_Book.tex
===================================================================
--- lunar-doc/trunk/lunar-manual/Lunar_Book.tex 2005-07-07 20:55:20 UTC (rev 15638)
+++ lunar-doc/trunk/lunar-manual/Lunar_Book.tex 2005-07-07 21:13:11 UTC (rev 15639)
@@ -19,7 +19,7 @@
\topmargin 0cm
\selectfont
\sf\sffamily
-\lstset{basicstyle=\small, language=bash, numbers=left, numberstyle=\tiny, stepnumber=2, numbersep=5pt}
+\lstset{basicstyle=\footnotesize, frame=single, language=bash, numbers=left, numberstyle=\tiny, stepnumber=2, numbersep=5pt}
%numbers at left side of source code, small, every 3 steps display on, 5pt away from code
%!!! For large code snippets this WILL be to large. pls invoke via : \begin{lstlisting}[basicstyle=\footnotesize]
More information about the Lunar-commits
mailing list