summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorpavlov <pavlov@3c298f89-4303-0410-b956-a3cf2f4a3e73>2006-11-26 21:28:16 +0000
committerpavlov <pavlov@3c298f89-4303-0410-b956-a3cf2f4a3e73>2006-11-26 21:28:16 +0000
commit171c7e4de7e92c1abef1ce650eddcfee49286408 (patch)
tree0af2ad630b70e96395084ef711b9ed7cb7cbcc84 /docs
parent50e59347b4bc77b755e72dd96c9cb3916859611e (diff)
some more build docs
git-svn-id: svn://svn.openwrt.org/openwrt/trunk@5648 3c298f89-4303-0410-b956-a3cf2f4a3e73
Diffstat (limited to 'docs')
-rw-r--r--docs/build.tex27
-rw-r--r--docs/openwrt.tex4
2 files changed, 24 insertions, 7 deletions
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{<name>}/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{<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
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}