update .pot file
[packaging-tutorial.git] / packaging-tutorial.tex
index 413273e..215b727 100644 (file)
@@ -8,12 +8,6 @@
 %\\usepackage{debiantutorial.fr} \\usepackage[french]{babel} \\frenchsetup{...}
 \usepackage{debiantutorial}
 
-%variables replaced at build time with values from the changelog
-\newcommand{\version}{_VERSION_}
-\renewcommand{\year}{_YEAR_}
-\renewcommand{\month}{_MONTH_}
-\renewcommand{\day}{_DAY_}
-
 \hypersetup{bookmarks}
 \title{Debian Packaging Tutorial}
 \author[]{Lucas Nussbaum\\{\small\texttt{lucas@debian.org}}}
@@ -22,7 +16,7 @@
 %leave \\version unchanged: this will a variable containing the actual version
 %To translate the date, use \\today or a string containing \\year, \\month, \\day
 %(numeric values).
-\date{\footnotesize version \version{} -- \year-\month-\day}
+\date{\footnotesize version 0.5 -- 2011-11-29} % DATE - use debian/rules update-version-date
 
 \begin{document}
 
@@ -196,8 +190,8 @@ rw-r--r-- 0/0 751613 Sep  5 15:43 2010 data.tar.gz
 \begin{frame}{Example: rebuilding dash}
 \begin{enumerate}
 \item Install packages needed to build dash, and devscripts\\
-  {\texttt{apt-get build-dep dash}}\\
-  {\texttt{apt-get install -{}-no-install-recommends devscripts}}
+  {\texttt{sudo apt-get build-dep dash}\\ (requires \texttt{deb-src} lines in \texttt{/etc/apt/sources.list})}\\
+  {\texttt{sudo apt-get install -{}-no-install-recommends devscripts}}
   \hbr
 \item Create a working directory, and get in it:\\
  \texttt{mkdir /tmp/debian-tutorial ; cd /tmp/debian-tutorial}
@@ -256,7 +250,7 @@ rw-r--r-- 0/0 751613 Sep  5 15:43 2010 data.tar.gz
       \end{itemize}
     \end{itemize}
   \end{itemize}
-  \br
+  \hbr
   (See \texttt{dpkg-source(1)} for exact details)
 \end{frame}
 
@@ -695,7 +689,7 @@ override_dh_auto_build:
        see: \url{https://help.ubuntu.com/community/SbuildLVMHowto} )
     \end{itemize}
     \br
-  \item Generate \texttt{.deb} files and a \texttt{.changes} file
+  \item Generates \texttt{.deb} files and a \texttt{.changes} file
     \begin{itemize}
     \item \texttt{.changes}: describes what was built; used to upload the package
     \end{itemize}
@@ -725,7 +719,9 @@ override_dh_auto_build:
 \begin{frame}{Practical session 1: modifying the grep package}
   \begin{enumerate}
   \item Go to \url{http://ftp.debian.org/debian/pool/main/g/grep/} and
-    download version 2.6.3-3 of the package
+    download version 2.6.3-3 of the package (if you use Ubuntu 11.10 or
+    later, or Debian testing or unstable, use version 2.9-1 or 2.9-2 instead)
+
   \item Look at the files in \texttt{debian/}.
     \begin{itemize}
     \item              How many binary packages are generated by this source package?
@@ -841,13 +837,11 @@ License:
 \begin{frame}[fragile]{Documentation of patches}
   \begin{itemize}
          \item Standard headers at the beginning of the patch
-    \hbr
+    \br
   \item Documented in DEP-3 - Patch Tagging Guidelines\\
     \url{http://dep.debian.net/deps/dep3/}
   \end{itemize}
-\begin{itemize}
-\item All patches are published on \url{http://patch-tracker.debian.org/}
-\end{itemize}
+  \vfill
 \seprule
   \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 Description: Fix widget frobnication speeds
@@ -1080,15 +1074,15 @@ Vcs-Svn: svn://svn.debian.org/pkg-perl/trunk/libwww-perl
   \item Debian Developers' Corner\\
     \url{http://www.debian.org/devel/}\\
     {\small Links to many resources about Debian development}
-    \br
+    \hbr
   \item Debian New Maintainers' Guide\\
     \url{http://www.debian.org/doc/maint-guide/}\\
     {\small An introduction to Debian packaging, but could use an update}
-    \br
+    \hbr
   \item Debian Developer's Reference\\
     \url{http://www.debian.org/doc/developers-reference/}\\
     {\small Mostly about Debian procedures, but also some best packaging practices (part 6)}
-    \br
+    \hbr
   \item Debian Policy\\
     \url{http://www.debian.org/doc/debian-policy/}\\
     
@@ -1096,7 +1090,7 @@ Vcs-Svn: svn://svn.debian.org/pkg-perl/trunk/libwww-perl
       \item \small All the requirements that every package must satisfy
       \item \small Specific policies for Perl, Java, Python, \ldots
       \end{itemize}}
-    \br
+    \hbr
     
   \item Ubuntu Packaging Guide\\
     \url{https://wiki.ubuntu.com/PackagingGuide}
@@ -1270,8 +1264,10 @@ Vcs-Svn: svn://svn.debian.org/pkg-perl/trunk/libwww-perl
 
 \begin{frame}{Practical session: modifying the grep package}
 \begin{enumerate}
-       \item Go to \url{http://ftp.debian.org/debian/pool/main/g/grep/} and
-               download version 2.6.3-3 of the package
+  \item Go to \url{http://ftp.debian.org/debian/pool/main/g/grep/} and
+    download version 2.6.3-3 of the package (if you use Ubuntu 11.10 or
+    later, or Debian testing or unstable, use version 2.9-1 or 2.9-2 instead)
+
        \item Look at the files in \texttt{debian/}.
                \begin{itemize}
                        \item           How many binary packages are generated by this source package?