% This file was generated with po4a. Translate the source file.
%
\documentclass[10pt,final]{beamer}
\mode<presentation> \usetheme{debian}

\usepackage{debiantutorial.gl}

\hypersetup{bookmarks}
\title{Titorial de Empaquetado en Debian}
\author[]{Lucas Nussbaum\\{\small\texttt{packaging-tutorial@packages.debian.org}}}

\date{\footnotesize versión 0.29 -- 2021-11-03} 

\begin{document}


\frame{\titlepage}

\begin{frame}{Sobre este titorial}
  \begin{itemize}
  \item Obxectivo: \textbf{contarche o que debes saber sobre os paquetes en Debian}
    \begin{itemize}
      \hbr
    \item Modificar paquetes existentes
      \hbr
    \item Crear os teus paquetes propios
	    \hbr
    \item Interactuar coa comunidade de Debian
      \hbr
    \item Converterse nun usuario avanzado
    \end{itemize}
    \br
  \item Trata os temas máis importantes, pero non está completo
    \begin{itemize}
    \item Terás que ler máis documentación
    \end{itemize}
    \br
  \item A maioría dos contidos tamén se aplican ás distribucións derivadas de Debian
    \begin{itemize}
      \hbr
    \item Eso inclúe Ubuntu
    \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}{Contidos}
  \tableofcontents[hideallsubsections]
\end{frame}

\section{Introdución}

\subsection{Debian}

\begin{frame}{Debian}
	\begin{itemize}
		\item \textbf{Distribución GNU/Linux}
			\br
		\item A primeira distribución importante «centrada nas ideas de GNU»
			\br
		\item \textbf{Non comercial}, construído en común por milleiros de voluntarios
			\br
		\item 3 características principais:
			\begin{itemize}
				\item \textbf{Calidade} -- comunidade con experiencia técnica \\ {\small\sl Sairá
cando teña que saír}
					\hbr
				\item \textbf{LIbertade} -- desenvolvedores e usuarios obrigados polo
\textsl{Contrato Social}\\ Promovendo a cultura do Software Libre dende 1993
					\hbr
				\item \textbf{Independencia} -- non hai unha compañía única que controle Debian\\ 
E un sistema de toma de decisións aberto (\textsl{laborocracia} +
\textsl{democracia})
			\end{itemize}
                        \br
                \item \textbf{Afeccionados} no bo sentido: traballar por amor ao arte
	\end{itemize}
\end{frame}

\subsection{Paquetes de Debian}
\begin{frame}{Paquetes de Debian}
\begin{itemize}
\item Ficheiros \textbf{.deb} (paquetes binarios)
	\br
\item Unha forma potente e cómoda de distribuír os programas aos usuarios
	\br
\item Un dos dous formatos de paquetes máis usados, xunto con RPM
	\br
\item Universal:
	\begin{itemize}
		\item Hai 30 000 paquetes binarios en Debian\\ $\rightarrow$ a maioría dos
programas libres están empaquetados en Debian!
			\hbr
		\item Dispoñibles en 12 arquitecturas, incluíndo 2 non Linux (Hurd, kFreeBSD)
			\hbr
		\item Tamén os usan 120 distribucións derivadas de Debian
	\end{itemize}
\end{itemize}
\end{frame}


\subsection{O formato de empaquetado Deb}

\begin{frame}[fragile=singleslide]{O formato de empaquetado Deb}
  \begin{itemize}
  \item ficheiro \texttt{.deb}: un arquivo \texttt{ar}
    \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
$ ar tv wget_1.12-2.1_i386.deb
rw-r--r-- 0/0      4 Sep  5 15:43 2010 debian-binary
rw-r--r-- 0/0   2403 Sep  5 15:43 2010 control.tar.gz
rw-r--r-- 0/0 751613 Sep  5 15:43 2010 data.tar.gz
    \end{lstlisting} \begin{itemize}
    \item \texttt{debian-binary}: versión do formato do ficheiro deb,
\texttt{"2.0\textbackslash{}n"}
    \item \texttt{control.tar.gz}: metainformación sobre o paquete\\ {\small
\texttt{\textbf{control}, md5sums, (pre|post)(rm|inst), triggers, shlibs},
\ldots}
    \item \texttt{data.tar.gz}: ficheiros coa información do paquete
    \end{itemize}
    \br
  \item Pódense crear os ficheiros \texttt{.deb} manualmente\\ {\footnotesize
\url{http://tldp.org/HOWTO/html\_single/Debian-Binary-Package-Building-HOWTO/}}
    \br
  \item Pero a maioría da xente non o fai así
  \end{itemize}
  \br
  \centerline{\textbf{Neste titorial: crear paquetes Debian, á maneira Debian}}
\end{frame}

\subsection{Ferramentas necesarias}
\begin{frame}{Ferramentas necesarias}
  \begin{itemize}
  \item Un sistema Debian (ou Ubuntu) con acceso de superusuario
    \br
  \item Algúns paquetes:
    \begin{itemize}
    \item \textbf{build-essential}: depende de paquetes que se supoñen instalados na
máquina do desenvolvedor (non se necesitan indicar no campo de control
\texttt{Build-Depends:}  do teu paquete)
      \begin{itemize}
      \item inclúe unha dependencia a \textbf{dpkg-dev}, que contén ferramentas básicas
para crear paquetes específicas para Debian
      \end{itemize}
      \hbr
    \item \textbf{devscripts}: conten moitos programas útiles para os mantedores de
Debian
    \end{itemize}
  \end{itemize}

  \br
  Máis tarde mencionaranse outras ferramentas, coma \textbf{debhelper},
\textbf{cdbs}, \textbf{quilt}, \textbf{pbuilder}, \textbf{sbuild},
\textbf{lintian}, \textbf{svn-buildpackage}, \textbf{git-buildpackage},
\ldots\\ Instáleas cando as precise.
\end{frame}

\subsection{Fluxo de traballo xeral}
\begin{frame}{Fluxo de traballo xeral}
  \begin{center}
    \begin{tikzpicture}[
      node1/.style={shape=rectangle,draw=rouge,fill=debianbackgroundblue,thick},
      arr/.style={very thick}, command/.style={text=rouge,font=\ttfamily}, ]
      
      \node[node1] (www) at (0, 0) {Web}; \node[node1] (us) at (2.5, 0) {fonte
orixinal}; \node[node1] (da) at (-2.5, 0) {Copia do arquivo}; \node[node1]
(sp) at (0, -2) {paquete fonte}; \draw[arr,<-,dashed,thick] (sp) -- (2.5,-2)
node[right=0cm,text width=2.98cm,text centered,font=\small\sl] {onde se fai
a maioría do traballo manual}; \node[node1] (bin) at (0, -4) {un ou varios
paquetes binarios}; \draw[arr,<-,dashed,thick] (bin) -- (3.5,-4)
node[right,text centered,font=\small\ttfamily\sl] {.deb\normalfont};
\draw[arr,->] (us) -- (sp) node[pos=0.5,right,command] {dh\_make};
\draw[arr,->] (da) -- (sp) node[pos=0.5,left,command] {apt-get source};
\draw[arr,->] (www) -- (sp) node[pos=0.5,left,command] {dget}; \draw[arr,->]
(sp) -- (bin) node[pos=0.5,right,text width=6cm] {\textttc{debuild} (compila
e proba con \textttc{lintian}) ou \textttc{dpkg-buildpackage}};
\draw[arr,->] (bin) -- (1,-6) node[pos=0.5,right] {instala
(\textttc{debi})}; \draw[transparent] (bin) -- (-1,-6)
node[pos=0.5,left,opaque] {sube (\textttc{dput})}; \draw[arr,->,rounded
corners] (bin) -- (-1,-6) -- (-4.5,-6) -- (-4.5,0) -- (da);
\useasboundingbox (-4,-6) rectangle (6,0); \end{tikzpicture}
  \end{center}
\end{frame}

\subsection{Recompilando dash}
\begin{frame}{Exemplo: recompilando dash}
\begin{enumerate}
\item Instale os paquetes necesarios para compilar dash, e devscripts\\ 
{\texttt{sudo apt-get build-dep dash}\\ (require as liñas \texttt{deb-src}
en \texttt{/etc/apt/sources.list})}\\ {\texttt{sudo apt-get install
-{}-no-install-recommends devscripts fakeroot}}
  \hbr
\item Cree un cartafol de traballo, e entre nel: \\ \texttt{mkdir
/tmp/debian-tutorial ; cd /tmp/debian-tutorial}
  \hbr
\item Obteña o paquete fonte de \texttt{dash}\\ \texttt{apt-get source dash}\\ 
{\small (Isto require que teña as liñas \texttt{deb-src} no seu
\texttt{/etc/apt/sources.list})}
  \hbr
\item Compila o paquete\\ {\texttt{cd dash-*\\ debuild -us -uc}} ~~~(\texttt{-us
-uc} desactiva a firma do paquete con GPG)

  \hbr
\item Comprobe se funcionou
	\begin{itemize}
		\item  Hai algúns ficheiros \texttt{.deb} novos no cartafol superior
	\end{itemize}
    \hbr
\item Fíxese no directorio \texttt{debian/}
	\begin{itemize}
		\item É aí onde se realiza o traballo de empaquetado.
	\end{itemize}
\end{enumerate}
\end{frame}

\section{Creando paquetes fonte}
\subsection{Principios dos paquetes fonte}
\begin{frame}{Paquete fonte}
  \begin{itemize}
  \item Un paquete fonte pode xerar varios paquetes binarios\\ {\small p.e. a fonte
\texttt{\bfseries libtar} xera os paquetes binarios \texttt{\bfseries
libtar0} e \texttt{\bfseries libtar-dev}} \hbr
  \item Dous tipos de paquetes: (se ten dúbidas, escolla non nativo)
    \begin{itemize}
      \small
    \item Paquetes nativos: normalmente programas específicos para Debian
(\textsl{dpkg}, \textsl{apt})
    \item Paquetes non nativos: programas desenvoltos fora de Debian
    \end{itemize}
    \hbr
  \item Ficheiro principal: \texttt{.dsc} (meta-información)
    \hbr
  \item Outros ficheiros dependendo da versión do formato fonte
    \begin{itemize}
    \item 1.0 ou 3.0 (nativo): \texttt{paquete\_version.tar.gz}
      \hbr
    \item 1.0 (non nativo):
      \begin{itemize}
      \item \texttt{pkg\_ver.orig.tar.gz}: fonte orixinal
      \item \texttt{pkg\_debver.diff.gz}: parche para engadir cambios específicos para
Debian
      \end{itemize}
      \hbr
    \item 3.0 (quilt):
      \begin{itemize}
      \item \texttt{pkg\_ver.orig.tar.gz}: fonte orixinal
      \item \texttt{pkg\_debver.debian.tar.gz}: arquivo tar cos cambios de Debian
      \end{itemize}
    \end{itemize}
  \end{itemize}
  \hbr
  (ver \texttt{dpkg-source(1)} para máis información)
\end{frame}

\begin{frame}[fragile=singleslide]{Exemplo de paquete fonte (wget\_1.12-2.1.dsc)}
  \begin{lstlisting}[basicstyle=\ttfamily\small]
Format: 3.0 (quilt)
Source: wget
Binary: wget
Architecture: any
Version: 1.12-2.1
Maintainer: Noel Kothe <noel@debian.org>
Homepage: http://www.gnu.org/software/wget/
Standards-Version: 3.8.4
Build-Depends: debhelper (>> 5.0.0), gettext, texinfo,
 libssl-dev (>= 0.9.8), dpatch, info2man
Checksums-Sha1: 
 50d4ed2441e67[..]1ee0e94248 2464747 wget_1.12.orig.tar.gz
 d4c1c8bbe431d[..]dd7cef3611 48308 wget_1.12-2.1.debian.tar.gz
Checksums-Sha256: 
 7578ed0974e12[..]dcba65b572 2464747 wget_1.12.orig.tar.gz
 1e9b0c4c00eae[..]89c402ad78 48308 wget_1.12-2.1.debian.tar.gz
Files: 
 141461b9c04e4[..]9d1f2abf83 2464747 wget_1.12.orig.tar.gz
 e93123c934e3c[..]2f380278c2 48308 wget_1.12-2.1.debian.tar.gz
\end{lstlisting}
\end{frame}

\subsection{Obtendo os paquetes fonte}
\begin{frame}{Obtendo un paquete fonte existente}
  \begin{itemize}
  \item no arquivo Debian:
    \begin{itemize}
    \item \texttt{apt-get source \textsl{package}}
    \item \texttt{apt-get source \textsl{package=version}}
    \item \texttt{apt-get source \textsl{package/release}}
    \end{itemize}
    (Necesita as liñas \texttt{deb-src} no \texttt{sources.list})
    \br
  \item Do Internet:
    \begin{itemize}
    \item \texttt{dget \textsl{url-to.dsc}}
    \item \texttt{dget
http://snapshot.debian.org/archive/debian-archive/\\20090802T004153Z/debian/dists/bo/main/source/web/\\ 
wget\_1.4.4-6.dsc}\\ (\href{http://snapshot.debian.org/}{\ttfamily
snapshot.d.o} encárgase de todos os paquetes Debian dende o 2006)
    \end{itemize}
    \br
  \item Dende o sistema (declarado) de control de versións:
    \begin{itemize}
    \item \texttt{debcheckout \textsl{package}}
    \end{itemize}
    \br
  \item Cando se descargue, descomprímao con \texttt{dpkg-source -x
\textsl{file.dsc}}
  \end{itemize}
\end{frame}

\subsection{Crear un paquete fonte básico}
\begin{frame}{Crear un paquete fonte básico}
  \begin{itemize}
  \item Descarga a fonte orixinal\\ (\textsl{fonte orixinal} = a que provén os
desenvolvedores orixinais do programa)
    \hbr
  \item Renoméeo a
\texttt{<\textsl{fonte\_paquete}>\_<\textsl{orixinal\_versión}>.orig.tar.gz}\\ 
(por exemplo: \texttt{simgrid\_3.6.orig.tar.gz})
    \hbr
  \item Descomprímeo
    \hbr
  \item Renomea o cartafol a
\texttt{<\textsl{fonte\_paquete}>-<\textsl{orixinal\_versión}>}\\ (por
exemplo: \texttt{simgrid-3.6})
    \hbr
  \item \texttt{cd \texttt{<\textsl{fonte\_paquete}>-<\textsl{orixinal\_versión}>}
\&\& dh\_make}\\ (do paquete \textbf{dh-make})
    \hbr
  \item Hai algunhas alternativas a \texttt{dh\_make} para conxuntos específicos de
paquetes: \textbf{dh-make-perl}, \textbf{dh-make-php}, \ldots \hbr
  \item Creado cartafol \texttt{debian/}, con moitos ficheiros nel
  \end{itemize}
\end{frame}

\subsection{Ficheiros en debian/}
\begin{frame}{Ficheiros en debian/}
  Todo o traballo de empaquetar débese facer editando os ficheiros en
\texttt{debian/}
  \hbr
  \begin{itemize}
  \item Ficheiros principais:
    \begin{itemize}
    \item \textbf{control} -- metainformación sobre o paquete (dependencias, etc)
    \item \textbf{rules} -- especifica como compilar o paquete
    \item \textbf{copyright} -- información do paquete sobre dereitos de autor
    \item \textbf{changelog} -- historial do paquete de Debian
    \end{itemize}
    \hbr
  \item Outros ficheiros:
    \begin{itemize}
    \item compat
    \item watch
    \item obxectivos dh\_install* \\ {\small *.dirs, *.docs, *.manpages, \ldots}
    \item programiños dos mantedores\\ {\small *.postinst, *.prerm, \ldots}
    \item source/format
    \item patches/ -- se os necesitas para modificar a fonte orixinal
    \end{itemize}
    \hbr
  \item Algúns ficheiros usan un formato baseado no RFC 882 (cabeceiras do correo-e)
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/changelog}
  \begin{itemize}
  \item Rexistra os cambios no empaquetado de Debian
  \item Garda a versión actual do paquete
  \begin{center}
    \begin{tikzpicture}
	    \draw (0,0) node[above right] {\large 1.2.1.1-5}; \draw
[decorate,decoration={brace}] (2,0) -- (1.45,0) node[at start,below,text
width=1.6cm,text centered] {\small revisión Debian}; \draw
[decorate,decoration={brace}] (1.4,0) -- (0,0) node[midway,below,text
width=1.6cm,text centered] { \small versión orixinal};
\end{tikzpicture}
\end{center}


	  \item Editar manualmente ou con \textttc{dch}
  \begin{itemize}
	  \item Crear unha entrada no rexistro de cambios para unha nova versión:
\textttc{dch -i}
  \end{itemize}
  \item Formato especial para pechar automaticamente fallos en Debian ou Ubuntu\\ 
Debian: \texttt{Closes:~\#595268}; Ubuntu: \texttt{LP:~\#616929}
  \item Instalado coma \texttt{/usr/share/doc/\textit{paquete}/changelog.Debian.gz}
  \end{itemize}
  \seprule
  \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
mpich2 (1.2.1.1-5) unstable; urgency=low

  * Use /usr/bin/python instead of /usr/bin/python2.5. Allow
    to drop dependency on python2.5.  Closes: #595268
  * Make /usr/bin/mpdroot setuid. This is the default after
    the installation of mpich2 from source, too. LP: #616929
    + Add corresponding lintian override.

 -- Lucas Nussbaum <lucas@debian.org>  Wed, 15 Sep 2010 18:13:44 +0200
\end{lstlisting}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/control}
  \hbr
  \begin{itemize}
  \item Metainformación do paquete
    \begin{itemize}
    \item Do paquete fonte en si
    \item Para cada paquete binario compilado dende esta fonte
    \end{itemize}
    \hbr
  \item Nome do paquete, sección, prioridade, mantedor, subidores, dependencias de
compilación, dependencias, descrición, páxina, \ldots \hbr
  \item Documentación: Políticas de Debian, capítulo 5\\ 
\url{https://www.debian.org/doc/debian-policy/ch-controlfields}
  \end{itemize}
  \seprule
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
Source: wget
Section: web
Priority: important
Maintainer: Noel Kothe <noel@debian.org>
Build-Depends: debhelper (>> 5.0.0), gettext, texinfo,
 libssl-dev (>= 0.9.8), dpatch, info2man
Standards-Version: 3.8.4
Homepage: http://www.gnu.org/software/wget/

Package: wget
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: retrieves files from the web
 Wget is a network utility to retrieve files from the Web
\end{lstlisting}
\end{frame}

\begin{frame}{Arquitectura: todas ou calquera}
  Dous tipos de paquetes binarios:
  \hbr
  \begin{itemize}
  \item Paquetes con contidos diferentes dependendo da arquitectura Debian
    \begin{itemize}
    \item Exemplo: Programa C
    \item \texttt{Architecture:\ any} en \texttt{debian/control}
      \begin{itemize}
      \item Ou, se só funciona nun certo número de arquitecturas:\\ 
\texttt{Architecture:\ amd64 i386 ia64 hurd-i386}
      \end{itemize}
    \item buildd.debian.org: compila as outras arquitecturas por ti ao o subires
    \item Nomeado
\texttt{\textsl{paquete}\_\textsl{versión}\_\textsl{arquitectura}.deb}
    \end{itemize}
    \br
  \item Paquetes co mesmo contido en todas as arquitecturas
    \begin{itemize}
    \item Exemplo: biblioteca Perl
    \item \texttt{Architecture:\ all} en \texttt{debian/control}
    \item Nomeado \texttt{\textsl{paquete}\_\textsl{versión}\_\textsl{all}.deb}
    \end{itemize}
  \end{itemize}
  \br
  Un paquete fonte pode xerar unha mestura de paquetes binarios
\texttt{Architecture:\ any} e \texttt{Architecture:\ all}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/rules}
  \hbr
  \begin{itemize}
  \item Makefile
    \br
  \item Interface usada para compilar paquetes Debian
    \br
  \item Explicado na Política de Debian, capítulo 4.8\\ {\small
\url{https://www.debian.org/doc/debian-policy/ch-source\#s-debianrules}}
    \br
  \item Obxectivos requiridos:
    \begin{itemize}
    \item \texttt{build, build-arch, build-indep}: encargaranse de toda a
configuración e compilación
      \hbr
    \item \texttt{binary, binary-arch, binary-indep}: compilan os paquetes binarios
      \begin{itemize}
      \item \texttt{dpkg-buildpackage} chamará a \texttt{binary} para compilar todos os
paquetes, ou a \texttt{binary-arch} para compilar soamente os paquetes
\texttt{Architecture:~any}
      \end{itemize}
      \hbr
    \item \texttt{clean}: limpa o cartafol fonte
    \end{itemize}
  \end{itemize}
\end{frame}

\subsection{Axudas no empaquetado}
\begin{frame}{Axudas no empaquetado -- debhelper}
  \begin{itemize}
  \item Podes escribir código da liña de ordes directamente en \texttt{debian/rules}
  \item Boas prácticas (usado na maioría dos paquetes): usa un \textsl{Axudante no
empaquetado}
  \item Máis popular: \textbf{debhelper} (usado polo 98\% dos paquetes)
  \item Obxectivos:
    \begin{itemize}
    \item Organizar as tarefas comúns nas ferramentas normativizadas usadas por todos
os paquetes
    \item Arranxar algúns fallos de empaquetado en todos os paquetes
    \end{itemize}{\footnotesize dh\_installdirs, dh\_installchangelogs, dh\_installdocs,
dh\_install, dh\_installdebconf, dh\_installinit, dh\_link, dh\_strip,
dh\_compress, dh\_fixperms, dh\_perl, dh\_makeshlibs, dh\_installdeb,
dh\_shlibdeps, dh\_gencontrol, dh\_md5sums, dh\_builddeb, \ldots}
    \begin{itemize}
    \item Chamado dende \texttt{debian/rules}
    \item Pódese configurar usando opcións na liña de ordes ou ficheiros en
\texttt{debian/}
    \end{itemize}{\footnotesize \ttfamily \textsl{package}.docs, \textsl{package}.examples,
\textsl{package}.install, \textsl{package}.manpages, \ldots} \hbr
  \item Axudas de terceiros para conxuntos de paquetes: \textbf{python-support},
\textbf{dh\_ocaml}, \ldots \hbr
  \item \texttt{debian/compat}: Versión compatible de debhelper
	  \begin{itemize}
		  \item Define o comportamento preciso de dh\_*
		  \item Nova sintaxe: \texttt{Build-Depends: debhelper-compat (= 13)}
	  \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/rules usando debhelper (1/2)}
  \begin{lstlisting}[basicstyle=\ttfamily\footnotesize,escapeinside=\{\}]
#!/usr/bin/make -f

# Descomenta para activar o modo detallado.
#export DH_VERBOSE=1

build: 
        $(MAKE)
        #docbook-to-man debian/nomepaquete.sgml > nomepaquete.1

clean: 
        dh_testdir
        dh_testroot
        rm -f build-stamp configure-stamp
        $(MAKE) clean
        dh_clean 

install: build
        dh_testdir
        dh_testroot
        dh_clean -k 
        dh_installdirs
        # Engade aqu{\'i} comandos para instalar o paquete en debian/nomepaquete.
        $(MAKE) DESTDIR=$(CURDIR)/debian/nomepaquete install
\end{lstlisting}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/rules usando debhelper (2/2)}
  \begin{lstlisting}[basicstyle=\ttfamily\footnotesize,escapeinside=\{\}]

# Compilar ficheiros com{\'u}ns a todas as arquitecturas aqu{\'i}.
binary-indep: build install

# Compilar ficheiros espec{\'i}ficos a cada arquitectura aqu{\'i}.
binary-arch: build install
        dh_testdir
        dh_testroot
        dh_installchangelogs 
        dh_installdocs
        dh_installexamples
        dh_install
        dh_installman
        dh_link
        dh_strip
        dh_compress
        dh_fixperms
        dh_installdeb
        dh_shlibdeps
        dh_gencontrol
        dh_md5sums
        dh_builddeb

binary: binary-indep binary-arch
.PHONY: build clean binary-indep binary-arch binary install configure
\end{lstlisting}
\end{frame}

\begin{frame}[fragile=singleslide]{CDBS}
  \hbr
  \begin{itemize}
  \item Con debhelper, inda queda moita redundancia entre paquetes
    \hbr
  \item Axudas de segundo nivel que organizan funcións comúns
    \begin{itemize}
    \item Por exemplo compilando con \texttt{./configure \&\& make \&\& make install}
ou CMake
    \end{itemize}
    \hbr
  \item CDBS:
    \begin{itemize}
    \item Introducido en 2005, baseado en maxia avanzada do \textsl{GNU make}
    \item Documentación: \texttt{/usr/share/doc/cdbs/}
    \item É compatible con Perl, Pyton, Ruby, GNOME, KDE, Java, Haskell, \ldots
    \item Pero algunhas persoas o odian:
      \begin{itemize}
      \item As veces é difícil personalizar as compilacións dos paquetes:\\ 
«\textsl{labirinto arrevesado de makefiles e variables do entorno}»
      \item Máis lento que usar só o debhelper (moitas chamadas inútiles a
\texttt{dh\_*})
      \end{itemize}
    \end{itemize}
  \end{itemize}
  \seprule
      \begin{lstlisting}[basicstyle=\ttfamily\footnotesize,escapeinside=\{\}]
#!/usr/bin/make -f
include /usr/share/cdbs/1/rules/debhelper.mk
include /usr/share/cdbs/1/class/autotools.mk

# Engadir unha acci{\'o}n despois de compilar
build/meupaquete::
    /bin/bash debian/scripts/foo.sh
      \end{lstlisting}
\end{frame}

\begin{frame}[fragile=singleslide]{Dh (tamén chamado Debhelper 7, ou dh7)}
  \begin{itemize}
  \item Introducido en 2008 como o \textsl{asasino do CDBS}
    \hbr
  \item comando \textbf{dh} que chama \texttt{dh\_*}
    \hbr
  \item Sinxelo \textsl{debian/rules}, só describindo as ordes substituídas
    \hbr
  \item Máis sinxelo de personalizar que o CDBS
    \hbr
  \item Documentación: páxinas do manual (\texttt{debhelper(7)}, \texttt{dh(1)}) +
presentacións da conferencia DebConf9\\ 
\url{http://kitenet.net/~joey/talks/debhelper/debhelper-slides.pdf}
  \end{itemize}
  \seprule
    \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
#!/usr/bin/make -f
%:
    dh $@

override_dh_auto_configure:
     dh_auto_configure -- --with-kitchen-sink

override_dh_auto_build:
     make world

 \end{lstlisting}
\end{frame}

\begin{frame}{debhelper clásico contra CDBS contra dh}
  \hbr
  \begin{itemize}
  \item Porcentaxes de popularidade:\\ debhelper clásico: 15\% \hskip 1em CDBS: 15\%
\hskip 1em dh: 68\%
    \hbr
  \item Cales debería coñecer?
    \begin{itemize}
    \item Probablemente todos
    \item Necesitas coñecer debhelper para usar dh e CDBS
    \item Ao mellor tes que modificar paquetes CDBS
    \end{itemize}
    \hbr
  \item Cal debería usar para un novo paquete?
    \begin{itemize}
	    \item \textbf{dh} (o único cuxa popularidade crece)
	    \item Véxase \url{https://trends.debian.net/\#build-systems}
    \end{itemize}
  \end{itemize}
  
  \hbr


\end{frame}

\section{Compilando e probando paquetes}
\subsection{Compilando paquetes}
\begin{frame}{Compilando paquetes}
  \begin{itemize}
  \item \textttc{apt-get build-dep mypackage}\\ Instala as dependencias de
compilación \textsl{build-dependencies} (para paquetes xa existentes en
Debian)\\ Ou \textttc{mk-build-deps -ir} (para paquetes non existentes)
    
    \br
  \item \textttc{debuild}: Compila e proba con \texttt{lintian}, firma con GPG
    \br
  \item Tamén pode chamar a \textttc{dpkg-buildpackage} directamente
    \begin{itemize}
    \item Normalmente con \texttt{dpkg-buildpackage -us -uc}
    \end{itemize}
    \br
  \item É mellor compilar os paquetes nun ambiente limpo e co mínimo necesario
    \begin{itemize}
    \item \textttc{pbuilder} -- Axuda para compilar paquetes nun \textsl{chroot}\\ Boa
documentación: \url{https://wiki.ubuntu.com/PbuilderHowto}\\ (optimización:
\textttc{cowbuilder} \textttc{ccache} \textttc{distcc})
      \hbr
    \item \textttc{schroot} e \textttc{sbuild}: usados nos daemons \\ (non é tan
sinxelo coma \texttt{pbuilder}, pero permite usar imaxes LVM\\ véxase:
\url{https://help.ubuntu.com/community/SbuildLVMHowto} )
    \end{itemize}
    \br
  \item Xera ficheiros \texttt{.deb} e un ficheiro \texttt{.changes}
    \begin{itemize}
    \item \texttt{.changes}: describe o que se compilou; usado para subir o paquete
    \end{itemize}
  \end{itemize}
\end{frame}
\subsection{Instalando e probando paquetes}
\begin{frame}{Instalando e probando paquetes}
  \begin{itemize}
  \item Instalar o paquete de forma local: \textttc{debi} (usa \texttt{.changes}
para saber que ten que instalar) \br
  \item Amosar os contidos do paquete: \texttt{{\color{rouge}debc}
../mypackage<TAB>.changes} \br
  \item Comparar o paquete cunha versión anterior:\\ \texttt{{\color{rouge}debdiff}
../mypackage\_1\_*.changes ../mypackage\_2\_*.changes}\\ ou comparar as
fontes:\\ \texttt{{\color{rouge}debdiff} ../mypackage\_1\_*.dsc
../mypackage\_2\_*.dsc}\\
    \br
  \item Comprobar o paquete co analizador estático \texttt{lintian}:\\ 
\texttt{{\color{rouge}lintian} ../mypackage<TAB>.changes}\\ \texttt{lintian
-i}: da máis información sobre os erros \\ \texttt{lintian -EviIL
+pedantic}: amosa máis erros\br
  \item Subir o paquete a Debian (\textttc{dput}) (previa configuración) \br
  \item Xestionar un arquivo privado de Debian con \textttc{reprepro} ou
\textttc{aptly}\\ Documentación:
\url{https://wiki.debian.org/HowToSetupADebianRepository}
  \end{itemize}
\end{frame}
\section{Sesión práctica 1: modificando o paquete grep}
\begin{frame}{Sesión práctica 1: modificando o paquete grep}
  \begin{enumerate}
  \item Vaia a \url{http://ftp.debian.org/debian/pool/main/g/grep/} e descargue a
versión 2.12-2 do paquete
    \begin{itemize}
		   \item Se o paquete fonte non se descomprime automáticamente, descomprímao con
\texttt{dpkg-source~-x~grep\_*.dsc}
    \end{itemize}

  \item Fixese nos ficheiros en \texttt{debian/}.
    \begin{itemize}
    \item 		Cantos paquetes binarios son xerados por este paquete fonte?
    \item 		Que programa de empaquetado usa este paquete?
    \end{itemize}
    \hbr
  \item Compile o paquete
    \hbr
  \item Agora imos modificar o paquete. Engada unha entrada no rexistro de cambios e
aumente o número de versión.
    \hbr
  \item Agora desactiea a compatibilidade con perl-regexp (é unha opción en
	exttt{./configure})
    \hbr
  \item Recompile o paquete
    \hbr
  \item Compare o orixinal e o novo paquete con debdiff
    \hbr
  \item Instale o novo paquete recentemente compilado
  \end{enumerate}
\end{frame}

\section{Temas de empaquetado avanzados}
\subsection{debian/copyright}
\begin{frame}[fragile=singleslide]{debian/copyright}
  \hbr
  \begin{itemize}
  \item Información das licencias e dos dereitos de autor da fonte e do paquete
  \item Tradicionalmente un ficheiro de texto
  \item Novos formatos lexibles polos ordenadores:
{\small\url{https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/}}
  \end{itemize}
  \seprule
  \begin{lstlisting}[basicstyle=\ttfamily\scriptsize]
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: X Solitaire
Source: ftp://ftp.example.com/pub/games

Files: *
Copyright: Copyright 1998 John Doe <jdoe@example.com>
License: GPL-2+
 This program is free software; you can redistribute it
 [...]
 .
 On Debian systems, the full text of the GNU General Public
 License version 2 can be found in the file
 `/usr/share/common-licenses/GPL-2'.

Files: debian/*
Copyright: Copyright 1998 Jane Smith <jsmith@example.net>
License:
 [TEXTO DA LICENCIA]
\end{lstlisting}
\end{frame}



\subsection{Modificando a fonte orixinal}
\begin{frame}{Modificando a fonte orixinal}
  As veces hai que:
  \begin{itemize}
  \item Arranxar fallos ou engadir personalizacións específicas de Debian
    \hbr
  \item Copiar parches dunha versión máis actual na fonte orixinal
  \end{itemize}
  \br
  Algunhas formas de facelo:
  \begin{itemize}
  \item Modificando directamente os ficheiros
    \begin{itemize}
    \item Sinxelo
    \item Pero non temos forma de rexistrar e documentar os cambios
    \end{itemize}
    \hbr
  \item Usando o sistema de parches
    \begin{itemize}
    \item Facilita a contribución dos teus parches á fonte orixinal
    \item Axuda a compartir os parches cos derivativos
    \item Dalle máis publicidade aos cambios\\ \url{http://patch-tracker.debian.org/}
(por agora non funciona)
    \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}{Sistemas de parcheado}
  \begin{itemize}
  \item Principios: os cambios almacénanse coma parches en \texttt{debian/patches/}
    \br
  \item Aplicados e quitados durante a compilación
    \br
  \item Antes: varias implementacións -- \textsl{simple-patchsys} (\textsl{cdbs}),
\textsl{dpatch}, \textbf{\textsl{quilt}}
    \begin{itemize}
  \item Cada unha permite dous obxectivos de \texttt{debian/rules}:
    \begin{itemize}
    \item \texttt{debian/rules patch}: aplica todos os parches
    \item \texttt{debian/rules unpatch}: quita todos os parches
    \end{itemize}
	  \hbr
  \item Máis información: \url{https://wiki.debian.org/debian/patches}
  \end{itemize}
  \br
  \item \textbf{Novo formato do paquete fonte cun sistema de parches incorporado: 3.0
(quilt)}
  \begin{itemize}
  \item Solución recomendada
	  \hbr
  \item Terá que coñecer \textsl{quilt}\\ 
\url{https://perl-team.pages.debian.net/howto/quilt.html}
    \hbr
  \item Ferramenta válida para todos os sistemas de parches en \texttt{devscripts}:
\texttt{edit-patch}
  \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Documentar os parches}
  \begin{itemize}
	  \item Cabeceiras normativizadas ao comenzo do parche
    \br
  \item Documentado en DEP-3 - Normas para o Etiquetado de Parches\\ 
\url{http://dep.debian.net/deps/dep3/}
  \end{itemize}
  \vfill
\seprule
  \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
Description: Arranxar a velocidade ao fedellar nos trebellos
 Fedellar nos trebellos moi r{\'a}pido causaba explosi{\'o}ns.
Forwarded: http://lists.example.com/2010/03/1234.html
Author: John Doe <johndoe-guest@users.alioth.debian.org>
Applied-Upstream: 1.2, http://bzr.foo.com/frobnicator/revision/123
Last-Update: 2010-03-29

--- a/src/widgets.c
+++ b/src/widgets.c
@@ -101,9 +101,6 @@ struct {
\end{lstlisting}
\end{frame}

\subsection{Facendo cousas durante a instalación e o borrado}
\begin{frame}{Facendo cousas durante a instalación e o borrado}
  \begin{itemize}
  \item As veces non é suficiente descomprimir o paquete
    \hbr
  \item Crear/borrar usuarios do sistema, arrancar/parar servizos, xestionar
\textsl{alternativas}
    \hbr
  \item Iso faise nos \textsl{programas de mantemento}\\ \texttt{preinst, postinst,
prerm, postrm}
    \begin{itemize}
	    \item  Pódense xerar exemplos para accións comúns con debhelper
    \end{itemize}
    \hbr
  \item Documentación:
    \begin{itemize}
    \item Manual das Políticas de Debian, capítulo 6\\ {\footnotesize
\url{https://www.debian.org/doc/debian-policy/ch-maintainerscripts}}
      
      \hbr
    \item Informe dos Desenvolvedores de Debian, capítulo 6.4\\ {\scriptsize
\url{https://www.debian.org/doc/developers-reference/best-pkging-practices.html}}
      \hbr
    \item {\footnotesize
\url{https://people.debian.org/~srivasta/MaintainerScripts.html}}
    \end{itemize}
    \br
  \item Preguntarlle ao usuario
    \begin{itemize}
    \item Débese facer con \textbf{debconf}
      \hbr
    \item Documentación: \texttt{debconf-devel(7)} (paquete \texttt{debconf-doc})
    \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Vixiando as versións da fonte orixinal}
  \begin{itemize}
  \item Indica onde mirar en \texttt{debian/watch} (véxase \texttt{uscan(1)})
    \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
version=3

http://tmrc.mit.edu/mirror/twisted/Twisted/(\d\.\d)/ \
  Twisted-([\d\.]*)\.tar\.bz2
    \end{lstlisting}
    \br
  \item Hai rastrexadores de novas versións nas fontes orixinais, que lle avisan
automaticamente ao mantedor mediante diferentes paneis de control, como
\url{https://tracker.debian.org/} e \url{https://udd.debian.org/dmd/}
    \br
  \item \texttt{uscan}: executar unha comprobación manual
    \br
  \item \texttt{uupdate}: tenta actualizar o teu paquete á última versión da fonte
orixinal
  \end{itemize}
\end{frame}

\subsection{Empaquetando cun Sistema de Control de Versións (SVN, Git)}
\begin{frame}[fragile=singleslide]{Empaquetando cun Sistema de Control de Versións (SVN, Git)}
  \begin{itemize}
  \item Varias ferramentas para axudarche a xestionar as pólas e etiquetas no teu
empaquetado:\\ \texttt{svn-buildpackage}, \texttt{git-buildpackage}
    \hbr
  \item Exemplo: \texttt{git-buildpackage}
    \begin{itemize}
    \item A póla \texttt{upstream} para seguir a fonte orixinal coa etiqueta
\texttt{upstream/\textsl{version}}
    \item A póla \texttt{master} segue o paquete de Debian
    \item Para cada subída as etiquetas \texttt{debian/\textsl{version}}
    \item A póla \texttt{pristine-tar} para reconstruír o arquivo tar orixinal
    \end{itemize}
    Documentación:
\url{http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.html}
    \hbr
  \item Para atopar o repositorio use os campos \texttt{Vcs-*} en
\texttt{debian/control}
	  \begin{itemize}
		\item \url{https://wiki.debian.org/Salsa}
	\end{itemize}
\end{itemize}
  \begin{lstlisting}[basicstyle=\ttfamily\scriptsize]
Navegador SCV: https://salsa.debian.org/debian/devscripts
SCV Git: https://salsa.debian.org/debian/devscripts.git
  \end{lstlisting}
  \begin{lstlisting}[basicstyle=\ttfamily\scriptsize]
Navegador SCV: https://salsa.debian.org/perl-team/modules/packages/libwww-perl
SCV Git: https://salsa.debian.org/perl-team/modules/packages/libwww-perl.git
  \end{lstlisting}
  \begin{itemize}
  \item Interface SCV independente: \texttt{debcheckout}, \texttt{debcommit},
\texttt{debrelease}\\
    \begin{itemize}
	    \item     \texttt{debcheckout grep} $\rightarrow$ comproba o paquete fonte de Git
    \end{itemize}
\end{itemize}
\end{frame}

\subsection{Modernizar paquetes}
\begin{frame}{Modernizar paquetes}
  \begin{itemize}
  \item Obxectivo: usar unha versión nova do paquete nun sistema vello\\ p.e. usar
\textsl{mutt} de Debian \textsl{inestable} en Debian \textsl{estable}
	\br
  \item Idea xeral:
	  \begin{itemize}
		\item Coller o paquete fonte de Debian inestable
		\hbr
		\item Modificalo para que compile e funcione ben en Debian estable
		\begin{itemize}
			\item Ás veces banal (non necesita cambios)
			\item Ás veces dificil
			\item Ás veces imposible (hai moitas dependencias que non se poden conseguir)
		\end{itemize}
	\end{itemize}
	\br
   \item Algunhas modernizacións («backports» en inglés) está feitas e aprobadas polo
proxecto Debian\\ \url{http://backports.debian.org/}
\end{itemize}
\end{frame}



\section{Mantendo paquetes en Debian}
\subsection{Arquivo e suites de Debian}
\begin{frame}{Arquivo e suites de Debian}
  \begin{center}
	  \resizebox{\textwidth}{!}{
    \begin{tikzpicture}[
	    people/.style={shape=ellipse,draw,thick},
      suite/.style={shape=rectangle,draw},
	    devel/.style={fill=red!30!white},
	    test/.style={fill=orange!30!white},
	    prod/.style={fill=green!30!white,node distance=2cm},
	    internal/.style={},
	    old/.style={fill=gray!30!white},
	    veryold/.style={fill=gray!70!white},
      arr/.style={very thick},
	    uploads/.style={decorate,decoration={snake,amplitude=.4mm,segment length=2mm,post length=1mm}},
	    migrations/.style={};
	    command/.style={text=rouge,font=\ttfamily},
	    legend/.style={font=\small}
	    ]
      
      \draw node[suite,prod] (sec) {security}; \draw node[suite,prod,right=of sec]
(su) {stable-updates}; \draw node[suite,prod,right=of su] (st) {stable};
\draw node[suite,old,node distance=0.3cm,below=of st] (os) {oldstable};
\draw node[suite,veryold,node distance=0.3cm,below=of os] (ar)
{archive.d.o}; \draw node[suite,prod,right=of st] (bp) {backports}; \draw
node[suite,test] (spu) at ($(su) + (-0.6,2.5)$) {stable-proposed-updates};
\draw node[suite,internal] (sn) at ($(st) + (-1.8,1.4)$) {stable-new}; \draw
node[suite,test,node distance=1.5cm,above=of st] (te) {testing}; \draw
node[suite,devel,above=of te] (sid) {unstable}; \draw node[suite,devel]
(exp) at ($(sid) + (2.5,0.5)$) {experimental}; \draw node[suite,devel] (tpu)
at ($(te)!0.5!(sid) + (2.5,0)$) {testing-proposed-updates}; \draw
node[people,above=of sid] (dd) {desenvolvedor}; \draw node[people,node
distance=3cm,left=of dd] (secteam) {equipo de seguranza};
\draw[arr,uploads,->] (dd) -- (sid); \draw[arr,uploads,->] (dd) -- (exp);
\draw[arr,uploads,->,bend right=8] (dd) to (tpu); \draw[arr,uploads,->]
(secteam) -- (sid); \draw[arr,uploads,->] (secteam) -- (sec);
\draw[arr,uploads,->] (dd) to (spu); \draw[arr,uploads,->] plot [smooth,
tension=0.75] coordinates { (dd.east) ($(exp.north east)+(0.1,0.1)$)
($(tpu.east)+(0.2,0)$)  ($(bp.north east) + (-0.4,0)$) };
\draw[arr,migrations,->] (tpu) -- (te); \draw[arr,migrations,->] (sid) --
(te); \draw[arr,migrations,->] (te) -- (st) node
[midway,align=left,midway,right,font=\footnotesize] {versión\\ estable};
\draw[arr,migrations,->] (sec) -- (sn); \draw[arr,migrations,->] (sn) to
node [pos=0.2] (spulabel) {} (st); \draw
node[font=\footnotesize,align=right] at ($(spulabel) + (-0.4,-0.45)$)
{versión \\ estable \\ punto}; \draw[arr,migrations,->] (spu) to (sn);
\draw[arr,migrations,->] (spu) -- (su); \draw[arr,migrations,->] (st) --
(os); \draw[arr,migrations,->] (os) -- (ar); \coordinate (legend) at
(-2,-1); \draw[arr,uploads,->] (legend) -- ($(legend) + (0.7,0)$) node
[right,legend] {subir paquete}; \coordinate[node distance=1.1em,below=of
legend] (legend2); \draw[arr,migrations,->] (legend2) -- ($(legend2) +
(0.7,0)$) node [right,legend] {migración do paquete entre suites};
\coordinate[node distance=1.5em,below=of legend2] (legend3); \draw
node[right,suite,devel,legend] (ldev) at (legend3) {desenvolvemento}; \draw
node[node distance=0.1cm,right=of ldev,suite,test,legend] (ltest) {probas};
\draw node[node distance=0.1cm,right=of ltest,suite,internal,legend] (lint)
{interno}; \draw node[node distance=0.1cm,right=of lint,suite,prod,legend]
(lprod) {produción}; \draw ($(legend.north west) + (-0.1,0.25)$) rectangle
($(lprod.south east) + (0.1,-0.1)$); \draw
node[font=\bf,red!70!white,align=center] (tnext) at ($(te.east) + (2,-0.1)$)
{preparar a\\ seguinte versión}; \draw
node[font=\bf,green!70!black,align=center] (tsrm) at ($(sec.north east) +
(1,1)$) {xestión das \\versións\\estables}; \pgfdeclarelayer{background}
\pgfdeclarelayer{foreground} \pgfsetlayers{background,main,foreground}
\begin{pgfonlayer}{background}
	    \fill[red!10!white] plot [smooth cycle,tension=0.55] coordinates {
($(sid.north west) + (-0.1,0.1)$) ($(exp.north east)+(0.1,0.1)$)
($(tpu.south east)+(0.1,-0.1)$) ($(tnext.south) + (0.6,0)$) ($(te.south
west) + (0.1,-0.1)$)  }; \fill[green!10!white] plot [smooth
cycle,tension=0.55] coordinates { ($(spu.north west) + (-0.1,0.1)$)
($(spu.north east)+(0.1,0.1)$) ($(sn.north east)+(0.1,0.1)$) ($(st.north
east) + (0.1,0.5)$) ($(bp.north east) + (0.1,0.1)$)  ($(bp.south east) +
(0.1,-0.1)$) ($(sec.south west) + (-0.1,-0.1)$)  };
\end{pgfonlayer}

    \end{tikzpicture}
	  }
  \end{center}
	\begin{flushright}
		\tiny Baseado nu gráfico de Antoine
Beaupr\'e. \url{https://salsa.debian.org/debian/package-cycle}~~~~~~~~~~~~
	\end{flushright}
\end{frame}

\begin{frame}{Suites para o desenvolvemento}
		\begin{itemize}
			\item As novas versións dos paquetes sóbense á suite inestable \textbf{unstable}
(\textbf{sid})
				\hbr
			\item Os paquetes migran dende \textbf{unstable} a \textbf{testing} dependendo de
varios criterios (coma que leve en unstable 10 días, e que non tivera
regresións)
				\hbr
			\item Os novos paquetes tamén se poden subir a:
				\begin{itemize}
					\item \textbf{experimental} (para os paquetes máis \textsl{experimentais}, por
exemplo cando a nova versión inda non está lista para substituír á que xa
existe en inestable)
						\hhbr
					\item \textbf{testing-proposed-updates}, para actualizar a versión de probas en
\textbf{testing} sen pasar por \textbf{unstable} (non se adoita facer)
				\end{itemize}
		\end{itemize}
\end{frame}

\begin{frame}{Conxelando e soltando unha nova versión}
	\begin{itemize}
					\item Chegado o momento no ciclo de versións, o equipo de versións decide
\textsl{conxelar} as probas: páranse as migracións automáticas dende
\textbf{unstable} a \textbf{testing}, e substitúense por unha aprobación
manual
						\br
		\item Cando o equipo de versións considera que \textbf{testing} está listo para
saír:
			\begin{itemize}
				\item A suite de probas \textbf{testing} convértese na nova suite \textbf{stable}
					\hhbr
				\item Da mesma forma, o anterior \textbf{stable} convértese en \textbf{oldstable}
					\hhbr
				\item As versións que quedaron sen mantemento móvense a
\texttt{archive.debian.org}
			\end{itemize}
			\br
		\item Véxase \url{https://release.debian.org/}
	\end{itemize}
\end{frame}

\begin{frame}{Xestión e suites das versións estables}
	\begin{itemize}
		\item Úsanse varias suites para fornecer a versión estable dos paquetes:
			\hhbr
			\begin{itemize}
				\item \textbf{stable}: a suite principal
					\hbr
				\item A suite de actualizacións \textbf{security} aloxada en
\texttt{security.debian.org}, usada polo equipo de seguridade. As
actualizacións anúncianse na lista de correo
\texttt{debian-security-announce}
					\hbr
				\item \textbf{stable-updates}: actualizacións estables que non están relacionadas
coa seguridade, pero que deberían ser instaladas con urxencia (sen esperar á
seguinte versión punto): bases de datos dos antivirus, paquetes relacionados
coas franxas horarias, etc. Anúncianse na lista de correo
\texttt{debian-stable-announce}
					\hbr
				\item \textbf{backports}: Modernizacións baseadas na versión en \textbf{testing}
			\end{itemize}
			\hbr
		\item A suite estable \textbf{stable} actualízase cada par de meses por
\textsl{versións punto estables} (que só inclúen arranxar fallos)
			\hhbr
			\begin{itemize}
				\item Os paquetes pensando na seguinte versión punto estable sóbense á suite de
propostas de actualización \textbf{stable-proposed-updates} e son revisadas
polo equipo de versións
			\end{itemize}
			\hbr
		\item A seguinte versión estable anterior \textbf{oldstable} ten o mesmo conxunto
de suites
	\end{itemize}
\end{frame}

\subsection{Varias maneiras de contribuír a Debian}
\begin{frame}{Varias maneiras de contribuír a Debian}
  \begin{itemize}
  \item As \textbf{peores} maneiras de contribuír:
    \begin{enumerate}
    \item Empaquetar a túa propia aplicación
    \item Metela en Debian
    \item E desaparecer
    \end{enumerate}
    \br
  \item As \textbf{mellores} maneiras de contribuír:
	  \begin{itemize}
		  \item Implicarse nos equipos de empaquetado
    \begin{itemize}
    \item Moitos equipos céntranse nun conxunto de paquetes, e necesitan axuda
    \item Equipos dispoñibles en \url{https://wiki.debian.org/Teams}
    \item Unha maneira excelente de aprender dos contribuíntes máis experimentados
    \end{itemize}
    \br
\item Adoptar paquetes xa existentes pero sen mantedores (\textsl{paquetes orfos})
    \br
  \item Traer novos programas a Debian
    \begin{itemize}
    \item Pero só se son interesantes e/ou útiles, por favor
    \item Hai alternativas xa empaquetadas en Debian?
    \end{itemize}
  \end{itemize}

  \end{itemize}
\end{frame}

\subsection{Adoptar paquetes orfos}
\begin{frame}{Adoptar paquetes orfos}
      \hbr
  \begin{itemize}
    \item Moitos paquetes sen mantedores en Debian
    \hbr
  \item Lista completa e proceso: \url{https://www.debian.org/devel/wnpp/}
    \hbr
  \item Instalado na túa máquina: \texttt{wnpp-alert}\\ Ou mellor:
\texttt{how-can-i-help}
    \hbr
  \item Diferentes estados:
    \begin{itemize}
		    \small
    \item \textbf{O}rfos: o paquete non ten mantedores\\ Adopta sen medo
      \hbr
    \item \textbf{RFA}: Mantedor buscando adopción [\textbf{R}equest \textbf{F}or
\textbf{A}dopter]\\ O mantedor está buscando adopción, pero segue a
traballar nel entrementres\\ Adóptao sen medo. É de boa educación avisar ao
mantedor
      \hbr
    \item \textbf{ITA}: Intención De Adoptar [\textbf{I}ntent \textbf{T}o
\textbf{A}dopt]\\ Alguén quere adoptar o paquete\\ Podes porte coma
candidato!
      \hbr
    \item \textbf{RFH}: Requírese Axuda [\textbf{R}equest \textbf{F}or
\textbf{H}elp]\\ O mantedor está buscando axuda
    \end{itemize}
    \hbr
  \item Algúns paquetes sen mantedores non descubertos \arr inda non son orfos
    \hbr
  \item Se tes dúbidas pregunta en \texttt{debian-qa@lists.debian.org} \\ ou
\texttt{\#debian-qa} en \texttt{irc.debian.org}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Adoptando un paquete: exemplo}
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
De: Ti <ti@teudominio>
A: 640454@bugs.debian.org, control@bugs.debian.org
Cc: Francois Marier <francois@debian.org>
Asunto: ITA: verbiste -- conxugador franc{\'e}s

retitle 640454 ITA: verbiste -- conxugador franc{\'e}s
owner 640454 !
thanks

Ola,

Estou usando verbiste e estou disposto a coidar do paquete.

Sa{\'u}dos,

Ti
\end{lstlisting}

\begin{itemize}
\item É de boas maneiras contactar o mantedor previo (sobre todo se o paquete
estaba RFA, non orfo)
\item É unha moi boa idea contactar o proxecto orixinal
\end{itemize}
\end{frame}

\subsection{Levando o teu paquete a Debian}
\begin{frame}{Levando o teu paquete a Debian}
\begin{itemize}
\item Non necesitas ter ningún título para poder meter o teu paquete en Debian
	\begin{enumerate}
		\item Envía unha petición \textbf{ITP} (Intención De Empaquetado, ou en inglés
\textbf{I}ntent \textbf{T}o \textbf{P}ackage) usando \texttt{reportbug wnpp}
			\hbr
		\item Preparar un paquete fonte
			\hbr
		\item Atopar un desenvolvedor de Debian que patrocine o teu paquete
	\end{enumerate}
\br
\item Estado oficial (cando sexa un mantedor de paquetes experimentado):
	\begin{itemize}
		\item \textbf{Mantedor Debian (DM):}\\ Permiso para subir os teus propios
paquetes\\ Véxase \url{https://wiki.debian.org/DebianMaintainer}
			\hbr
		\item \textbf{Desenvolvedor Debian (DD):}\\ Membro do proxecto Debian; pode votar
e subir calquera paquete
	\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{Cousas a comprobar antes de pedir padroádego}
\begin{itemize}
	\item Debian \textbf{céntrase moito na calidade}
\hbr
\item Normalmente, \textbf{os patróns son difíciles de atopar e están moi
ocupados}
\begin{itemize}
\item Asegúrate de que o teu paquete está listo antes de preguntar por un
padroádego
\end{itemize}
\hbr
\item A comprobar:
\begin{itemize}
\item Que teña todas as dependencias de compilación: asegúrate de que o teu
paquete compila ben nun \textsl{chroot} \textsl{sid} limpo
\begin{itemize}
\item Recoméndase usar \texttt{pbuilder}
\end{itemize}
\hbr
\item Execute \texttt{lintian -EviIL +pedantic} no seu paquete
\begin{itemize}
\item Os erros débense arranxar, os outros problemas son máis opcionais
\end{itemize}
\hbr
\item Por suposto, faille moitas probas ao teu paquete
\end{itemize}
\hbr
\item Se tes dúbidas, pide axuda
\end{itemize}
\end{frame}

\subsection{Onde atopar axuda?}
\begin{frame}{Onde atopar axuda?}
	\hbr
  Axuda necesaria:
  \begin{itemize}
  \item Consellos e respostas as túas preguntas, revisións do código
  \item Padroádegos para as túas subidas, cando o teu paquete estea listo
  \end{itemize}
  \hbr
  Podes conseguir axuda de:
  \begin{itemize}
	  \item \textbf{Outros membros dun equipo de empaquetado}
    \begin{itemize}
    \item Lista de equipos: \url{https://wiki.debian.org/Teams}
    \end{itemize}
    \hbr
  \item O \textbf{grupo de Mentores de Debian} (se o teu paquete non encaixa con
ningún equipo)
    \begin{itemize}
    \item \url{https://wiki.debian.org/DebianMentorsFaq}
    \item Lista de correo: \url{debian-mentors@lists.debian.org}\\ {\small (tamén unha
boa forma de aprender dos erros)}
    \item IRC: \texttt{\#debian-mentors} en \texttt{irc.debian.org}
    \item \url{http://mentors.debian.net/}
    \item Documentación: \url{http://mentors.debian.net/intro-maintainers}
    \end{itemize}
    \hbr
  \item \textbf{Listas de correo sobre a localización} (obter axuda na túa lingua)
    \begin{itemize}
  \item \texttt{debian-devel-\{french,italian,portuguese,spanish\}@lists.d.o}
  \item Lista completa: \url{https://lists.debian.org/devel.html}
  \item Ou lista de usuarios: \url{https://lists.debian.org/users.html}
  \end{itemize}
  \end{itemize}
\end{frame}

\subsection{Máis documentación}
\begin{frame}{Máis documentación}
  \begin{itemize}
  \item Curruncho dos Desenvolvedores de Debian\\ 
\url{https://www.debian.org/devel/}\\ {\small Ligazóns a moitos recursos
sobre desenvolver en Debian}
    \hbr
  \item Guía para os Mantedores de Debian\\ \url
{https://www.debian.org/doc/manuals/debmake-doc/}
    \hbr
  \item Referencia dos Desenvolvedores de Debian\\ 
\url{https://www.debian.org/doc/developers-reference/}\\ {\small A meirande
parte é sobre os procesos de Debian, pero tamén inclúe boas prácticas no
empaquetado (parte 6)}
    \hbr
  \item Política de Debian\\ \url{https://www.debian.org/doc/debian-policy/}\\
    
    {\small \begin{itemize} \item \small Todos os requirimentos que todo paquete
ten que satisfacer \item \small Políticas específicas para Perl, Java,
Python, \ldots \end{itemize}}
    \hbr
    
  \item Guía de Empaquetado Ubuntu\\ 
\url{https://packaging.ubuntu.com/html/}
  \end{itemize}
\end{frame}

\subsection{Paneis de control de Debian para mantedores}
\begin{frame}{Paneis de control de Debian para mantedores}
  \begin{itemize}
	  \item \textbf{Orientado aos paquetes fonte}:\\ 
\url{https://tracker.debian.org/dpkg}
    \br
  \item \textbf{Orientado aos equipos/mantedores}: Vista Xeral dos Paquetes dos
Desenvolvedores (DDPO)\\ 
\url{https://qa.debian.org/developer.php?login=pkg-ruby-extras-maintainers@lists.alioth.debian.org}
    \br
  \item \textbf{Orientado ás listas PORFACER(TODO)}: Panel de Control dos Mantedores
de Debian (DMD)\\ \url{https://udd.debian.org/dmd/}
  \end{itemize}
\end{frame}

\begin{frame}{Usando o Sistema de Seguimento de Fallos de Debian (BTS)}
\begin{itemize}
\item Unha maneira bastante única para xestionar fallos
\begin{itemize}
\item Interface na rede para consultar fallos
\item Interface por correo electrónico para facer cambios nos fallos
\end{itemize}
\hbr
\item Engadir información sobre os fallos:
	\begin{itemize}
		\item Escribe a \texttt{123456@bugs.debian.org} (sen incluír o remitente,
necesitas engadir \texttt{123456-submitter@bugs.debian.org})
	\end{itemize}
\hbr
\item Cambiar a categoría do problema:
\begin{itemize}
\item Envía ordes a \texttt{control@bugs.debian.org}
\item Interface por liña de ordes: comando \texttt{bts} en \texttt{devscripts}
\item Documentación: \url{https://www.debian.org/Bugs/server-control}
\end{itemize}
\hbr
\item Avisando de fallos: use \texttt{reportbug}
\begin{itemize}
\item Normalmente usado cun servidor local de correo: instale \texttt{ssmtp} ou
\texttt{nullmailer}
\item Ou use \texttt{reportbug -\@-template}, e envíeo (manualmente) a
\texttt{submit@bugs.debian.org}
\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{Usando o BTS: exemplos}
\begin{itemize}
\item Enviándolle un correo ao problema e o remitente:\\ 
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680822\#10}
\hbr
\item Etiquetando e cambiando a importancia:\\ 
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680227\#10}
\hbr
\item Resignando, cambiando a importancia, cambiando o título, \ldots: \\ 
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680822\#93}
\begin{itemize}
	\item \texttt{notfound}(non atopado), \texttt{found}(atopado),
\texttt{notfixed}(sen arranxar), \texttt{fixed}(arranxado) son para
\textbf{version-tracking}(seguimento de versións) \\ Véxase
\url{https://wiki.debian.org/HowtoUseBTS\#Version\_tracking}
\end{itemize}
\hbr
\item Usando etiquetas de usuario:
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?msg=42;bug=642267}\\ 
Véxase \url{https://wiki.debian.org/bugs.debian.org/usertags}
\hbr
\item Documentación BTS:
\begin{itemize}
\item \url{https://www.debian.org/Bugs/}
\item \url{https://wiki.debian.org/HowtoUseBTS}
\end{itemize}
\end{itemize}
\end{frame}

\subsection{Estás máis interesado en Ubuntu?}
\begin{frame}{Estás máis interesado en Ubuntu?}
  \begin{itemize}
  \item Ubuntu normalmente céntrase en xestionar as diferenzas con Debian
    \br
  \item Non se centran en paquetes específicos\\ En troques, colaboran cos equipos
de Debian
    \br
  \item Normalmente recomendan subir os novos paquetes a Debian primeiro\\ 
\url{https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages}
    \br
  \item Unha mellor idea:
    \begin{itemize}
    \item Involúcrate nun equipo de Debian e fai de ponte con Ubuntu
      \hbr
    \item Axuda a reducir as diverxencias e os fallos de triaxe no Launchpad
      \hbr
    \item Moitas ferramentas en Debian:
      \begin{itemize}
      \item A columna de Ubuntu no resumo do desenvolvedor dos paquetes
      \item A caixa de Ubuntu no Sistema de Seguimento de Paquetes (PTS)
      \item Recibir correo dos fallos do Launchpad polo PTS
      \end{itemize}
    \end{itemize}
  \end{itemize}
\end{frame}

\section{Conclusión}
\subsection{Conclusión}
\begin{frame}{Conclusión}
  \begin{itemize}
  \item Xa ten unha vista completa do sistema de empaquetado en Debian
    \br
  \item Pero vai necesitar ler máis documentación
    \br
  \item O que se consideran boas prácticas vai cambiando co tempo
    \begin{itemize}
    \item Se ten dúbidas, use a axuda de empaquetado \textbf{dh}, e o formato
\textbf{3.0 (quilt)}
    \end{itemize}
  \end{itemize}
  \vfill
  \centerline{\large Correccións: \textbf{packaging-tutorial@packages.debian.org}}
\end{frame}

\subsection{Asuntos legais}
\begin{frame}{Asuntos legais}

  Copyright \copyright 2011--2019 Lucas Nussbaum -- lucas@debian.org
  \br

  {\small \textbf{Este documento é software libre}: podes redistribuílo e/ou
modificalo baixo (escolla segundo as súas preferencias): \hbr
\begin{itemize} \item Os termos da Licencia Pública Xeral GNU tal coma a
publica a Free Software Foundation, xa for versión 3 da Licenza, ou (se o
prefire) unha versión posterior.\\ 
\url{http://www.gnu.org/licenses/gpl.html} \br \item Os termos da licenza
Creative Commons Attribution-ShareAlike 3.0 Unported License.\\ 
\url{http://creativecommons.org/licenses/by-sa/3.0/} \end{itemize} }
\end{frame}

\subsection{Contribuír ao tutorial}
\begin{frame}{Contribuír ao tutorial}
	\begin{itemize}
		\item Contribúa:
			\begin{itemize}
				\item{\small \texttt{apt-get source packaging-tutorial}}
					\hbr
				\item  {\small \texttt{debcheckout packaging-tutorial}}
					\hbr
				\item  {\small \texttt{git clone\\ 
https://salsa.debian.org/debian/packaging-tutorial.git}}
					\hbr
				\item {\small \url{https://salsa.debian.org/debian/packaging-tutorial}}
					\hbr
				\item {\small Fallos sen resolver: \url{bugs.debian.org/src:packaging-tutorial}}
			\end{itemize}
			\br
		\item Enviar correccións:
			\begin{itemize}
				\item \href{mailto:packaging-tutorial@packages.debian.org}{\textbf{\texttt{mailto:packaging-tutorial@packages.debian.org}}}
				\begin{itemize}
					\item{\small Que deberíamos engadirlle ao tutorial?}
				\item {\small Que podemos mellorar?}
				\end{itemize}
					\hbr
				\item{\small \texttt{reportbug packaging-tutorial}}
			\end{itemize}
	\end{itemize}
\end{frame}

\section{Sesións prácticas adicionais}

\subsection{Sesión práctica 2: empaquetar GNUjump}
\begin{frame}{Sesión práctica 2: empaquetar GNUjump}
	\begin{enumerate}
		\item Descargue GNUjump 1.0.8 dende
\url{http://ftp.gnu.org/gnu/gnujump/gnujump-1.0.8.tar.gz}
			\br
		\item Cree un paquete Debian para el
			\begin{itemize}
				\item Instale as dependencias de compilación para poder compilar o paquete
				\item Arranxe os fallos
				\item Cree un paquete funcional básico
				\item Remate de encher \texttt{debian/control} e outros ficheiros
			\end{itemize}
			\br
		\item Disfrute
	\end{enumerate}
\centerline{\includegraphics[width=5cm]{figs/gnujump.png}}
\end{frame}

\begin{frame}[fragile=singleslide]{Sesión práctica 2: empaquetando GNUjump (consellos)}
	\begin{itemize}
		\item Para obter un paquete funcional básico use \texttt{dh\_make}
		\item Primeiro, crear un paquete fonte \textsl{1.0} é máis sinxelo que un
\textsl{3.0 (quilt)} (pode cambialo en \texttt{debian/source/format})
		\item Para buscar as dependencias de compilación necesarias, busque o ficheiro que
falta e use \texttt{apt-file} para atopar o paquete necesario
		\item Se atopa este erro:
\begin{lstlisting}[basicstyle=\ttfamily\tiny]
/usr/bin/ld: SDL_rotozoom.o: undefined reference to symbol 'ceil@@GLIBC_2.2.5'
//lib/x86_64-linux-gnu/libm.so.6: error adding symbols: DSO missing from command line
collect2: error: ld returned 1 exit status
Makefile:376: recipe for target 'gnujump' failed
\end{lstlisting}
			Ten que engadir \texttt{-lm} á liña de ordes do ligante:\\ Modifique
\texttt{src/Makefile.am} e substitúa
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
gnujump_LDFLAGS = $(all_libraries)
\end{lstlisting}
					por
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
gnujump_LDFLAGS = -Wl,--as-needed
gnujump_LDADD = $(all_libraries) -lm
\end{lstlisting}
				Despois execute \texttt{autoreconf -i}
	\end{itemize}
\end{frame}

\subsection{Sesión práctica 3: empaquetando unha biblioteca de Java}
\begin{frame}{Sesión práctica 3: empaquetando unha biblioteca de Java}
\begin{enumerate}
	\item Bótelle unha ollada a algunha documentación sobre como empaquetar en Java:\\
		\begin{itemize}
		\item \url{https://wiki.debian.org/Java}
      \hbr
		\item \url{https://wiki.debian.org/Java/Packaging}
      \hbr
		\item \url{https://www.debian.org/doc/packaging-manuals/java-policy/}
      \hbr
		\item \texttt{/usr/share/doc/javahelper/tutorial.txt.gz}
		\end{itemize}
		\br
	\item Descargue IRClib dende \url{http://moepii.sourceforge.net/}
		\br
	\item Empaquéteo
\end{enumerate}
\end{frame}

\subsection{Sesión práctica 4: empaquetando unha xema de Ruby}
\begin{frame}{Sesión práctica 4: empaquetando unha xema de Ruby}
\begin{enumerate}
	\item Bótelle unha ollada á documentación sobre como empaquetar en Ruby:\\
		\begin{itemize}
		\item \url{https://wiki.debian.org/Ruby}
      \hbr
		\item \url{https://wiki.debian.org/Teams/Ruby}
      \hbr
		\item \url{https://wiki.debian.org/Teams/Ruby/Packaging}
      \hbr
		\item \texttt{gem2deb(1)}, \texttt{dh\_ruby(1)} (no paquete \texttt{gem2deb})
		\end{itemize}
		\hbr
	\item Cree un paquete fonte Debian básico a partir da xema \texttt{peach}:\\ 
\texttt{gem2deb peach}
	\hbr
	\item Mellóreo para que se poida converter nun verdadeiro paquete Debian
\end{enumerate}
\end{frame}

\subsection{Sesión práctica 5: empaquetar un módulo Perl}
\begin{frame}[fragile=singleslide]{Sesión práctica 5: empaquetar un módulo Perl}
\begin{enumerate}
	\item Bótelle unha ollada á documentación sobre como empaquetar en Perl:\\
		\begin{itemize}
		\item \url{https://perl-team.pages.debian.net}
      \hbr
		\item \url{https://wiki.debian.org/Teams/DebianPerlGroup}
      \hbr
		\item \texttt{dh-make-perl(1)}, \texttt{dpt(1)} (no paquete
\texttt{pkg-perl-tools})
		\end{itemize}
		\hbr
	\item Cree un paquete fonte Debian básico a partir da distribución CPAN
\texttt{Acme}:\\ \verb|dh-make-perl --cpan Acme|
	\hbr
	\item Mellóreo para que se poida converter nun verdadeiro paquete Debian
\end{enumerate}
\end{frame}

\section{Respostas ás sesións prácticas}

\begin{frame}
	\begin{center}
		\LARGE Respostas as\\[0.5em] sesións prácticas
	\end{center}
\end{frame}


\subsection{Sesión práctica 1: modificando o paquete grep}

\begin{frame}{Sesión práctica 1: modificando o paquete grep}
\begin{enumerate}
  \item Vaia a \url{http://ftp.debian.org/debian/pool/main/g/grep/} e descargue a
versión 2.12-2 do paquete

	\item Fixese nos ficheiros en \texttt{debian/}.
		\begin{itemize}
			\item 		Cantos paquetes binarios son xerados por este paquete fonte?
			\item 		Que programa de empaquetado usa este paquete?
		\end{itemize}
    \hbr
	\item Compile o paquete
    \hbr
	\item Agora imos modificar o paquete. Engada unha entrada no rexistro de cambios e
aumente o número de versión.
    \hbr
	\item Agora desactiea a compatibilidade con perl-regexp (é unha opción en
	exttt{./configure})
    \hbr
	\item Recompile o paquete
    \hbr
	\item Compare o orixinal e o novo paquete con debdiff
    \hbr
	\item Instale o novo paquete recentemente compilado
\end{enumerate}
\end{frame}

\begin{frame}{Obtendo a fonte}
\begin{enumerate}
  \item Vaia a \url{http://ftp.debian.org/debian/pool/main/g/grep/} e descargue a
versión 2.12-2 do paquete
\end{enumerate}
\begin{itemize}
	\item Use dget para descargar o ficheiro \texttt{.dsc}:\\ {\small \texttt{dget
http://cdn.debian.net/debian/pool/main/g/grep/grep\_2.12-2.dsc}}
		\hbr
	\item Se ten \texttt{deb-src} nunha versión de Debian con \texttt{grep} versión
2.12-2 (consúlteo en \url{https://tracker.debian.org/grep}), pode usar
\texttt{apt-get source grep=2.12-2}\\ ou \texttt{apt-get source
grep/release} (p.e. \texttt{grep/stable})\\ ou, se quere tentar á sorte:
\texttt{apt-get source grep}
	\hbr
	\item O paquete fonte \texttt{grep} ten 3 ficheiros:
		\begin{itemize}
			\item \texttt{grep\_2.12-2.dsc}
			\item \texttt{grep\_2.12-2.debian.tar.bz2}
			\item \texttt{grep\_2.12.orig.tar.bz2}
		\end{itemize}
		Esto é típico do formato "3.0 (quilt)".
	\hbr
\item Se é necesario, descomprima a fonte con\\ \texttt{dpkg-source -x
grep\_2.12-2.dsc}
\end{itemize}
\end{frame}

\begin{frame}{Botando unha ollada e compilando o paquete}
	\begin{enumerate}
			\setcounter{enumi}{1}
	\item Mire os ficheiros en \texttt{debian/}
		\begin{itemize}
			\item 		Cantos paquetes binarios son xerados por este paquete fonte?
			\item 		Que programa de empaquetado usa este paquete?
		\end{itemize}
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item Segundo \texttt{debian/control}, este paquete só xera un paquete binario,
nomeado \texttt{grep}.
			\hbr
		\item Segundo \texttt{debian/rules}, este paquete é típico do empaquetado
debhelper \textsl{clásico}, sen usar \textsl{CDBS} ou \textsl{dh}. Pódense
ver as diferentes chamadas ás ordes \texttt{dh\_*} en \texttt{debian/rules}.
	\end{itemize}
	\hbr
	\begin{enumerate}
			\setcounter{enumi}{2}

		\item Compile o paquete
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item Use \texttt{apt-get build-dep grep} para obter as dependencias de
compilación
		\item Entón use \texttt{debuild} ou \texttt{dpkg-buildpackage -us -uc} (Tarda
aprox. 1 min)
	\end{itemize}
\end{frame}

\begin{frame}{Modificar o rexistro de cambios}
	\begin{enumerate}
			\setcounter{enumi}{3}

	\item Agora imos modificar o paquete. Engada unha entrada no rexistro de cambios e
aumente o número de versión.
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item \texttt{debian/changelog} é un ficheiro de texto. Pode modificalo e engadir
novas entradas manualmente.
	\hbr
		\item Ou pode usar \texttt{dch -i}, que engade unha entrada e abre o procesador de
textos
	\hbr
		\item O nome e correo electrónico pódense definir usando as variables de entorno
\texttt{DEBFULLNAME} e \texttt{DEBEMAIL}
	\hbr
		\item Despois diso, recompile o paquete: compilouse unha nova versión do paquete
	\hbr
		\item O sistema de versións dos paquetes explícase na sección 5.6.12 da Política
de Debian\\ \url{https://www.debian.org/doc/debian-policy/ch-controlfields}
	\end{itemize}
\end{frame}

\begin{frame}{Desactivar a compatibilidade con expresións regulares Perl e recompilar}
	\begin{enumerate}
			\setcounter{enumi}{4}

	\item Agora desactiea a compatibilidade con perl-regexp (é unha opción en
	exttt{./configure})
	\item Recompile o paquete
	\end{enumerate}
	\hbr
	\begin{itemize}
	  \item Comprobeo con \texttt{./configure -{}-help}: a opción para desactivar as
expresións regulares Perl é \texttt{-{}-disable-perl-regexp}
	\hbr
		\item Modifique \texttt{debian/rules} e atope a liña \texttt{./configure}
	\hbr
		\item Engada \texttt{-{}-disable-perl-regexp}
	\hbr
		\item Recompile con \texttt{debuild} ou \texttt{dpkg-buildpackage -us -uc}
	\end{itemize}
\end{frame}

\begin{frame}{Comparar e probar os paquetes}
	\begin{enumerate}
			\setcounter{enumi}{6}

	\item Compare o orixinal e o novo paquete con debdiff
	\item Instale o novo paquete recentemente compilado
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item Compara os paquetes binarios: \texttt{debdiff ../*changes}
	\hbr
		\item Comparar os paquetes fonte: \texttt{debdiff ../*dsc}
	\hbr
		\item Instalar o paquete acabado de compilar: \texttt{debi}\\ Ou \texttt{dpkg -i
../grep\_<TAB>}
	\hbr
		\item \texttt{grep -P foo} xa non funcionará!
	\end{itemize}
\br
Reinstalar a anterior versión do paquete:
\begin{itemize}
	\item \texttt{apt-get install -{}-reinstall grep=2.6.3-3} \textit{(= versión
anterior)}
\end{itemize}
\end{frame}

\subsection{Sesión práctica 2: empaquetar GNUjump}
\begin{frame}{Sesión práctica 2: empaquetar GNUjump}
\begin{enumerate}
	\item Descargue GNUjump 1.0.8 dende
\url{http://ftp.gnu.org/gnu/gnujump/gnujump-1.0.8.tar.gz}
		\br
	\item Cree un paquete Debian para el
		\begin{itemize}
			\item Instale as dependencias de compilación para poder compilar o paquete
			\item Cree un paquete funcional básico
			\item Remate de encher \texttt{debian/control} e outros ficheiros
		\end{itemize}
		\br
	\item Disfrute
\end{enumerate}
\centerline{\includegraphics[width=5cm]{figs/gnujump.png}}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots}
\begin{itemize}
	\item \texttt{wget http://ftp.gnu.org/gnu/gnujump/gnujump-1.0.8.tar.gz}
		\hbr
	\item \texttt{mv gnujump-1.0.8.tar.gz gnujump\_1.0.8.orig.tar.gz}
		\hbr
	\item \texttt{tar xf gnujump\_1.0.8.orig.tar.gz}
		\hbr
	\item \texttt{cd gnujump-1.0.8/}
		\hbr
	\item \texttt{dh\_make -f ../gnujump-1.0.8.tar.gz}
	\begin{itemize}
		\item \small Tipo de paquete: único binario (por agora)
	\end{itemize}
\end{itemize}
\begin{lstlisting}[basicstyle=\ttfamily\small]
gnujump-1.0.8$ ls debian/
changelog           gnujump.default.ex   preinst.ex
compat              gnujump.doc-base.EX  prerm.ex
control             init.d.ex            README.Debian
copyright           manpage.1.ex         README.source
docs                manpage.sgml.ex      rules
emacsen-install.ex  manpage.xml.ex       source
emacsen-remove.ex   menu.ex              watch.ex
emacsen-startup.ex  postinst.ex
gnujump.cron.d.ex   postrm.ex
\end{lstlisting}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots (2)}
\begin{itemize}
	\item Mire \texttt{debian/changelog}, \texttt{debian/rules},
\texttt{debian/control}\\ (xa cuberto por \textbf{dh\_make})
		\hbr
	\item En \texttt{debian/control}:\\ \texttt{Build-Depends: debhelper (>= 7.0.50~),
autotools-dev}\\ Amosa as \textsl{build-dependencies} = paquetes necesarios
para compilar o paquete
		\hbr
	\item Intente compilar o paquete tal como está con \texttt{debuild} (grazas á
máxia do \textbf{dh})
		\begin{itemize}
			\item E engada dependencias de compilación ata que compile
			\item Pista: use \texttt{apt-cache search} e \texttt{apt-file} para atopar os
paquetes
			\item Por exemplo:
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
checking for sdl-config... no
checking for SDL - version >= 1.2.0... no
[...]
configure: error: *** SDL version 1.2.0 not found!
\end{lstlisting}
$\rightarrow$ Engádalle \textbf{libsdl1.2-dev} a Build-Depends e instáleo.
		\hbr
	\item Ou mellor: use \textbf{pbuilder} para compilar nun ambiente limpo
		\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots (3)}
	\begin{itemize}
		\item As dependencias de compilación necesarias son \texttt{libsdl1.2-dev,
libsdl-image1.2-dev, libsdl-mixer1.2-dev}

		\item Despois, probablemente se atope con outro erro:
	\end{itemize}
	\begin{lstlisting}[basicstyle=\ttfamily\tiny]
	/usr/bin/ld: SDL_rotozoom.o: undefined reference to symbol 'ceil@@GLIBC_2.2.5'
	//lib/x86_64-linux-gnu/libm.so.6: error adding symbols: DSO missing from command line
	collect2: error: ld returned 1 exit status
	Makefile:376: recipe for target 'gnujump' failed
	\end{lstlisting}
	\begin{itemize}
		\item Este problema é causado por corrupción do binario: gnujump non foi axustado
despois de cambios na ligadura.
		\item Se está a usar a versión \textbf{1.0} do formato fonte, pode cambiar
directamente as fontes orixinais.
			\begin{itemize}
				\item Modifique \texttt{src/Makefile.am} e substitúa
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
gnujump_LDFLAGS = $(all_libraries)
\end{lstlisting}
					por
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
gnujump_LDFLAGS = -Wl,--as-needed
gnujump_LDADD = $(all_libraries) -lm
\end{lstlisting}
				\item Despois execute \texttt{autoreconf -i}
			\end{itemize}
	\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots (4)}
\begin{itemize}
	\item Se estas a usar a versión \textbf{3.0 (quilt)} do formato fonte, usa
\texttt{quilt} para preparar un parche. (Véxase
\url{https://wiki.debian.org/UsingQuilt})
\begin{itemize}
\item \texttt{export QUILT\_PATCHES=debian/patches}
\item \texttt{mkdir debian/patches}\\ \texttt{quilt new linker-fixes.patch}\\ 
\texttt{quilt add src/Makefile.am}\\
\hbr
\item Modifique \texttt{src/Makefile.am} e substitúa
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
gnujump_LDFLAGS = $(all_libraries)
\end{lstlisting}
por
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
gnujump_LDFLAGS = -Wl,--as-needed
gnujump_LDADD = $(all_libraries) -lm
\end{lstlisting}
\hbr
\item \texttt{quilt refresh}
	\hbr
	\item Como o \texttt{src/Makefile.am} foi modificado, autoreconf debe ser chamado
durante a compilación. Para que \texttt{dh} o faga automáticamente, cambie a
chamada a \texttt{dh} en \texttt{debian/rules} de: \texttt{dh \$\@ -{}-with
autotools-dev}\\ a: \texttt{dh \$\@ -{}-with autotools-dev -{}-with
autoreconf}
		\hbr
\end{itemize}
\end{itemize}
\end{frame}


\begin{frame}[fragile=singleslide]{Paso a paso\ldots (5)}
\begin{itemize}
	\item Agora o paquete debería compilar sen problemas.
		\hbr
	\item Use \texttt{debc} para listar os contidos do paquete xerado, e \texttt{debi}
para instalalo e probalo.
		\hbr
	\item Comprobe o paquete con \texttt{lintian}
		\begin{itemize}
			\item Aínda que non é obrigatorio, recoméndase que os paquetes que se suban a
Debian estean \textsl{sen erros de lintian}
		\hbr
			\item Pódense listar os problemas con \texttt{lintian -EviIL +pedantic}
		\hbr
			\item Algúns consellos:
				\begin{itemize}
					\item Borre os ficheiros innecesarios en \texttt{debian/}
		\hbr
					\item Encha \texttt{debian/control}
						\hbr
					\item Sobrescriba \texttt{dh\_auto\_configure} para instalar o executable en
\texttt{/usr/games}
		\hbr
					\item Use as opcións de endurecemento do compilador para aumentar a seguridade.\\ 
Véxase \url{https://wiki.debian.org/Hardening}
				\end{itemize}
		\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{Paso a paso\ldots (6)}
		\begin{itemize}
	\item Compare o teu paquete co que xa existe en Debian:
		\begin{itemize}
			\item O paquete en Debian separa os ficheiros de datos nun paquete secundario, que
é o mesmo en todas as arquitecturas ($\rightarrow$ afórrase espazo no
arquivo de Debian)
				\hbr
			\item Tamén instala un ficheiro .desktop (para os menús de GNOME/KDE) e tamén se
integra no menú Debian
				\hbr
			\item E arranxa algúns problemas pequenos con parches
		\end{itemize}
\end{itemize}
\end{frame}

\subsection{Sesión práctica 3: empaquetando unha biblioteca de Java}
\begin{frame}{Sesión práctica 3: empaquetando unha biblioteca de Java}
\begin{enumerate}
	\item Bótelle unha ollada a algunha documentación sobre como empaquetar en Java:\\
		\begin{itemize}
		\item \url{https://wiki.debian.org/Java}
      \hbr
		\item \url{https://wiki.debian.org/Java/Packaging}
      \hbr
		\item \url{https://www.debian.org/doc/packaging-manuals/java-policy/}
      \hbr
		\item \texttt{/usr/share/doc/javahelper/tutorial.txt.gz}
		\end{itemize}
		\br
	\item Descargue IRClib dende \url{http://moepii.sourceforge.net/}
		\br
	\item Empaquéteo
\end{enumerate}
\end{frame}

\begin{frame}{Paso a paso\ldots}
\begin{itemize}
	\item \texttt{apt-get install javahelper}
		\hbr
	\item Cree un paquete fonte básico: \texttt{jh\_makepkg}
		\begin{itemize}
			\item Biblioteca
			\item Ningún
			\item Compilador e sistema execución en tempo real libre por omisión
		\end{itemize}
		\hbr
	\item Observe e corrixa \texttt{debian/*}
		\hbr
	\item \texttt{dpkg-buildpackage -us -uc} ou \texttt{debuild}
		\hbr
	\item \texttt{lintian}, \texttt{debc}, etc.
		\hbr
	\item Compare os seus resultados co paquete fonte \texttt{libirclib-java}
\end{itemize}
\end{frame}

\subsection{Sesión práctica 4: empaquetando unha xema de Ruby}
\begin{frame}{Sesión práctica 4: empaquetando unha xema de Ruby}
\begin{enumerate}
	\item Bótelle unha ollada á documentación sobre como empaquetar en Ruby:\\
		\begin{itemize}
		\item \url{https://wiki.debian.org/Ruby}
      \hbr
		\item \url{https://wiki.debian.org/Teams/Ruby}
      \hbr
		\item \url{https://wiki.debian.org/Teams/Ruby/Packaging}
      \hbr
		\item \texttt{gem2deb(1)}, \texttt{dh\_ruby(1)} (no paquete \texttt{gem2deb})
		\end{itemize}
		\hbr
	\item Cree un paquete fonte Debian básico a partir da xema \texttt{peach}:\\ 
\texttt{gem2deb peach}
	\hbr
	\item Mellóreo para que se poida converter nun verdadeiro paquete Debian
\end{enumerate}
\end{frame}

\begin{frame}{Paso a paso\ldots}
\texttt{gem2deb peach}:
\begin{itemize}
\item A xema descárgase dende rubygems.org
\item Cree un arquivo .orig.tar.gz axeitado, e descomprímao
\item Inicialice un paquete fonte Debian alicerzado nos metadatos da xema
	\begin{itemize}
		\item Chamado \texttt{ruby-\textsl{nomedaxema}}
	\end{itemize}
\item Intente compilar o paquete Debian binario (pode fallar)
\end{itemize}
\br
\texttt{dh\_ruby} (incluído en \textsl{gem2deb}) fai as operacións
específicas de Ruby:
\begin{itemize}
	\item Compila as extensións C para cada versión de Ruby
	\item Copia os ficheiros ao cartafol de destino
	\item Actualiza os camiños dos executables nos programas interpretados
	\item Executa as probas definidas en \texttt{debian/ruby-tests.rb},
\texttt{debian/ruby-tests.rake}, ou \texttt{debian/ruby-test-files.yaml};
xunto con outras comprobacións varias
\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots (2)}
Mellorar o paquete xerado:
\begin{itemize}
	\item Execute \texttt{debclean} para limpar o código fonte. Mire en
\texttt{debian/}
		\hbr
	\item \texttt{changelog} e \texttt{compat} deberían estar correctos
		\hbr
	\item Modifique \texttt{debian/control}: mellore a \texttt{Description}
		\hbr
	\item Escriba un ficheiro \texttt{copyright} axeitado coa licenza alicerzada nos
ficheiros orixinais
		\hbr
	\item Compile o paquete
		\hbr
	\item Compare o seu paquete co paquete \texttt{ruby-peach} no arquivo de Debian
\end{itemize}
\end{frame}

\subsection{Sesión práctica 5: empaquetar un módulo Perl}
\begin{frame}[fragile=singleslide]{Sesión práctica 5: empaquetar un módulo Perl}
\begin{enumerate}
	\item Bótelle unha ollada á documentación sobre como empaquetar en Perl:\\
		\begin{itemize}
		\item \url{https://perl-team.pages.debian.net}
      \hbr
		\item \url{https://wiki.debian.org/Teams/DebianPerlGroup}
      \hbr
		\item \texttt{dh-make-perl(1)}, \texttt{dpt(1)} (no paquete
\texttt{pkg-perl-tools})
		\end{itemize}
		\hbr
	\item Cree un paquete fonte Debian básico a partir da distribución CPAN
\texttt{Acme}:\\ \verb|dh-make-perl --cpan Acme|
	\hbr
	\item Mellóreo para que se poida converter nun verdadeiro paquete Debian
\end{enumerate}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots}
\verb|dh-make-perl --cpan Acme|:
\begin{itemize}
\item Descarga os arquivos tar da CPAN
\item Crea un .orig.tar.gz axeitado, e o descomprime
\item Inicializa un paquete fonte Debian alicerzado nos metadatos da distribución
	\begin{itemize}
		\item Chámao \texttt{lib\textsl{nomedistribución}-perl}
	\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Paso a paso\ldots (2)}
Mellorar o paquete xerado:
\begin{itemize}
	\item Non debería ter que tocar \texttt{debian/changelog}, \texttt{debian/compat},
\texttt{debian/libacme-perl.docs} nin \texttt{debian/watch}
		\hbr
	\item Modifique \texttt{debian/control}: mellore a descrición
\texttt{Description}, e borre o ciscallo no fondo
		\hbr
	\item Modifique \texttt{debian/copyright}: borre o parágrafo sobrante do
principio, e engádalle os anos da licenza na liña
\texttt{Files:\hspace{0.3em}*}
\end{itemize}
\end{frame}

\end{document}
