some more build docs

SVN-Revision: 5648
This commit is contained in:
Tim Yardley 2006-11-26 21:28:16 +00:00
parent b7831105b4
commit 10a7c91908
2 changed files with 24 additions and 7 deletions

View file

@ -245,7 +245,7 @@ and abstracted to the point where you only need to specify a few variables.
\item \texttt{PKG\_SOURCE} \\ \item \texttt{PKG\_SOURCE} \\
The filename of the original sources The filename of the original sources
\item \texttt{PKG\_SOURCE\_URL} \\ \item \texttt{PKG\_SOURCE\_URL} \\
Where to download the sources from Where to download the sources from (no trailing slash)
\item \texttt{PKG\_MD5SUM} \\ \item \texttt{PKG\_MD5SUM} \\
A checksum to validate the download A checksum to validate the download
\item \texttt{PKG\_CAT} \\ \item \texttt{PKG\_CAT} \\
@ -255,7 +255,9 @@ and abstracted to the point where you only need to specify a few variables.
\end{itemize} \end{itemize}
The \texttt{PKG\_*} variables define where to download the package from; The \texttt{PKG\_*} variables define where to download the package from;
\texttt{@SF} is a special keyword for downloading packages from sourceforge. \texttt{@SF} is a special keyword for downloading packages from sourceforge. There is also
another keyword of \texttt{@GNU} for grabbing GNU source releases.
The md5sum is used to verify the package was downloaded correctly and The md5sum is used to verify the package was downloaded correctly and
\texttt{PKG\_BUILD\_DIR} defines where to find the package after the sources are \texttt{PKG\_BUILD\_DIR} defines where to find the package after the sources are
uncompressed into \texttt{\$(BUILD\_DIR)}. uncompressed into \texttt{\$(BUILD\_DIR)}.
@ -331,7 +333,26 @@ After you've created your \texttt{package/\textit{<name>}/Makefile}, the new pac
will automatically show in the menu the next time you run "make menuconfig" and if selected will automatically show in the menu the next time you run "make menuconfig" and if selected
will be built automatically the next time "\texttt{make}" is run. will be built automatically the next time "\texttt{make}" is run.
\subsubsection{Troubleshooting}
\subsection{Conventions}
There are a couple conventions to follow regarding packages:
\begin{itemize}
\item \texttt{files}
\begin{enumerate}
\item configuration files follow the convention \\
\texttt{\textit{<name>}.conf}
\item init files follow the convention \\
\texttt{\textit{<name>}.init}
\end{enumerate}
\item \texttt{patches}
\begin{enumerate}
\item patches are numerically prefixed and named related to what they do
\end{enumerate}
\end{itemize}
\subsection{Troubleshooting}
If you find your package doesn't show up in menuconfig, try the following command to If you find your package doesn't show up in menuconfig, try the following command to
see if you get the correct description: see if you get the correct description:

View file

@ -4,14 +4,11 @@
\usepackage[T1]{fontenc} \usepackage[T1]{fontenc}
\usepackage{ae,aecompl,aeguill} \usepackage{ae,aecompl,aeguill}
\usepackage{fancyvrb} \usepackage{fancyvrb}
\setlength{\parindent}{0pt} \setlength{\parindent}{0pt}
\setlength{\parskip}\medskipamount \setlength{\parskip}\medskipamount
\begin{document} \begin{document}
\tableofcontents \tableofcontents
\chapter{The Router} \chapter{The Router}
\section{Getting started} \section{Getting started}
\subsection{Installation} \subsection{Installation}
@ -39,5 +36,4 @@
\section{Debugging and debricking} \section{Debugging and debricking}
\subsection{Adding a serial port} \subsection{Adding a serial port}
\subsection{JTAG} \subsection{JTAG}
\end{document} \end{document}