cosmetic changes
authorLucas Nussbaum <lucas@lucas-nussbaum.net>
Wed, 25 May 2011 08:03:19 +0000 (10:03 +0200)
committerLucas Nussbaum <lucas@lucas-nussbaum.net>
Wed, 25 May 2011 08:03:19 +0000 (10:03 +0200)
debiantutorial.sty
packaging-tutorial.tex
pract1-grep.tex

index 2c6e5bc..6cedb2d 100644 (file)
@@ -48,3 +48,5 @@
    \addtocounter{framenumbervorappendix}{-\value{framenumber}}
    \addtocounter{framenumber}{\value{framenumbervorappendix}} 
 }
+
+\newcommand{\seprule}{\vspace*{-0.5em}\centerline{\rule{\linewidth}{0.3pt}}\vspace*{-0.5em}}
index e931896..b6a9ac6 100644 (file)
@@ -110,11 +110,13 @@ rw-r--r-- 0/0 751613 Sep  5 15:43 2010 data.tar.gz
       {\small \texttt{\textbf{control}, md5sums, (pre|post)(rm|inst), triggers, shlibs}, \ldots}
     \item \texttt{data.tar.gz}: data files of the package
     \end{itemize}
+    \br
   \item You could create your \texttt{.deb} files manually\\
     {\footnotesize \url{http://tldp.org/HOWTO/html\_single/Debian-Binary-Package-Building-HOWTO/}}
+    \br
   \item But most people don't do it that way
   \end{itemize}
-  \hbr
+  \br
   \centerline{\textbf{This tutorial: create Debian packages, the Debian way}}
 \end{frame}
 
@@ -180,7 +182,7 @@ rw-r--r-- 0/0 751613 Sep  5 15:43 2010 data.tar.gz
   {\texttt{apt-get install build-essential devscripts debhelper}}
   \hbr
 \item Create a working directory, and get in it:\\
- \texttt{mkdir /tmp/w ; cd /tmp/w}
+ \texttt{mkdir /tmp/debian-tutorial ; cd /tmp/debian-tutorial}
   \hbr
 \item Grab the \texttt{dash} source package\\
   \texttt{apt-get source dash}\\ 
@@ -359,6 +361,7 @@ Files:
     Debian: \texttt{Closes:~\#595268}; Ubuntu: \texttt{LP:~\#616929}
   \item Installed as \texttt{/usr/share/doc/\textit{package}/changelog.Debian.gz}
   \end{itemize}
+  \seprule
   \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 mpich2 (1.2.1.1-5) unstable; urgency=low
 
@@ -386,6 +389,7 @@ mpich2 (1.2.1.1-5) unstable; urgency=low
   \item Documentation: Debian Policy chapter 5\\
     \url{http://www.debian.org/doc/debian-policy/ch-controlfields.html}
   \end{itemize}
+  \seprule
 \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 Source: wget
 Section: web
@@ -570,6 +574,9 @@ binary: binary-indep binary-arch
         "\textsl{twisty maze of makefiles and environment variables}"
       \item Slower than plain debhelper (many useless calls to \texttt{dh\_*})
       \end{itemize}
+    \end{itemize}
+  \end{itemize}
+  \seprule
       \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 #!/usr/bin/make -f
 include /usr/share/cdbs/1/rules/debhelper.mk
@@ -579,8 +586,6 @@ include /usr/share/cdbs/1/class/autotools.mk
 build/mypackage::
     /bin/bash debian/scripts/foo.sh
       \end{lstlisting}
-    \end{itemize}
-  \end{itemize}
 \end{frame}
 
 \begin{frame}[fragile]{Dh (aka Debhelper 7, or dh7)}
@@ -595,7 +600,8 @@ build/mypackage::
     \hbr
   \item Doc: manpages (\texttt{debhelper(7)}, \texttt{dh(1)}) + slides from DebConf9 talk\\
     \url{http://kitenet.net/~joey/talks/debhelper/debhelper-slides.pdf}
-    \br
+  \end{itemize}
+  \seprule
     \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 #!/usr/bin/make -f
 %:
@@ -607,8 +613,7 @@ override_dh_auto_configure:
 override_dh_auto_build:
      make world
 
-    \end{lstlisting}
-  \end{itemize} %$
+    \end{lstlisting}%$
 \end{frame}
 
 \begin{frame}{Classic debhelper vs CDBS vs dh}
@@ -708,12 +713,19 @@ override_dh_auto_build:
     \item              How many binary packages are generated by this source package?
     \item              Which packaging helper does this package use?
     \end{itemize}
+    \hbr
   \item Build the package
+    \hbr
   \item We are now going to modify the package. Add a changelog entry and increase the version number.
+    \hbr
   \item Now disable perl-regexp support (it is a \texttt{./configure} option)
+    \hbr
   \item Rebuild the package
+    \hbr
   \item Compare the original and the new package with debdiff
+    \hbr
   \item Install the newly built package
+    \hbr
   \item Cry if you messed up ;)
   \end{enumerate}
 \end{frame}
@@ -727,6 +739,7 @@ override_dh_auto_build:
   \item Traditionally written as a text file
   \item New machine-readable format: \url{http://dep.debian.net/deps/dep5/}
   \end{itemize}
+  \seprule
   \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 Format: <VERSIONED_FORMAT_URL>
 Upstream-Name: X Solitaire
@@ -814,6 +827,10 @@ License:
   \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}
+\seprule
   \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
 Description: Fix widget frobnication speeds
  Frobnicating widgets too quickly tended to cause explosions.
@@ -826,9 +843,6 @@ Last-Update: 2010-03-29
 +++ b/src/widgets.c
 @@ -101,9 +101,6 @@ struct {
 \end{lstlisting}
-\begin{itemize}
-\item All patches are published on \url{http://patch-tracker.debian.org/}
-\end{itemize}
 \end{frame}
 
 \subsection{Doing things during installation and removal}
index e64ef20..63a27ca 100644 (file)
                        \item           How many binary packages are generated by this source package?
                        \item           Which packaging helper does this package use?
                \end{itemize}
+    \hbr
        \item Build the package
+    \hbr
        \item We are now going to modify the package. Add a changelog entry and increase the version number.
+    \hbr
        \item Now disable perl-regexp support (it is a \texttt{./configure} option)
+    \hbr
        \item Rebuild the package
+    \hbr
        \item Compare the original and the new package with debdiff
+    \hbr
        \item Install the newly built package
+    \hbr
        \item Cry if you messed up ;)
 \end{enumerate}
 \end{frame}