From f7730a4bdb91d931ce010a56b07f28f0e174f9f4 Mon Sep 17 00:00:00 2001 From: Tim Yardley Date: Sun, 26 Nov 2006 21:28:16 +0000 Subject: some more build docs git-svn-id: svn://svn.openwrt.org/openwrt/trunk@5648 3c298f89-4303-0410-b956-a3cf2f4a3e73 --- docs/build.tex | 27 ++++++++++++++++++++++++--- docs/openwrt.tex | 4 ---- 2 files changed, 24 insertions(+), 7 deletions(-) (limited to 'docs') diff --git a/docs/build.tex b/docs/build.tex index e9cdaf382c..1b7f76487d 100644 --- a/docs/build.tex +++ b/docs/build.tex @@ -245,7 +245,7 @@ and abstracted to the point where you only need to specify a few variables. \item \texttt{PKG\_SOURCE} \\ The filename of the original sources \item \texttt{PKG\_SOURCE\_URL} \\ - Where to download the sources from + Where to download the sources from (no trailing slash) \item \texttt{PKG\_MD5SUM} \\ A checksum to validate the download \item \texttt{PKG\_CAT} \\ @@ -255,7 +255,9 @@ and abstracted to the point where you only need to specify a few variables. \end{itemize} 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 \texttt{PKG\_BUILD\_DIR} defines where to find the package after the sources are uncompressed into \texttt{\$(BUILD\_DIR)}. @@ -331,7 +333,26 @@ After you've created your \texttt{package/\textit{}/Makefile}, the new pac 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. -\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{}.conf} + \item init files follow the convention \\ + \texttt{\textit{}.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 see if you get the correct description: diff --git a/docs/openwrt.tex b/docs/openwrt.tex index e63eac3f28..07098b329d 100644 --- a/docs/openwrt.tex +++ b/docs/openwrt.tex @@ -4,14 +4,11 @@ \usepackage[T1]{fontenc} \usepackage{ae,aecompl,aeguill} \usepackage{fancyvrb} - \setlength{\parindent}{0pt} \setlength{\parskip}\medskipamount \begin{document} - \tableofcontents - \chapter{The Router} \section{Getting started} \subsection{Installation} @@ -39,5 +36,4 @@ \section{Debugging and debricking} \subsection{Adding a serial port} \subsection{JTAG} - \end{document} -- cgit v1.2.3