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

\usepackage{debiantutorial.pt}

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

\date{\footnotesize versão 0.29 -- 2021-11-03} 

\begin{document}


\frame{\titlepage}

\begin{frame}{Acerca deste manual}
  \begin{itemize}
  \item Objectivo: \textbf{dizer o que você precisa mesmo saber sobre empacotamento
de Debian}
    \begin{itemize}
      \hbr
    \item Modificar pacotes existentes
      \hbr
    \item Criar os seus próprios pacotes
	    \hbr
    \item Interagir com a comunidade Debian
      \hbr
    \item Tornar-se um utilizador avançado de Debian
    \end{itemize}
    \br
  \item Cobre os pontos mais importantes, mas não é completo
    \begin{itemize}
    \item Você irá precisar de ler mais documentação
    \end{itemize}
    \br
  \item A maioria do conteúdo também se aplica a distribuições derivadas da Debian
    \begin{itemize}
      \hbr
    \item Isso inclui Ubuntu
    \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}{Esboço}
  \tableofcontents[hideallsubsections]
\end{frame}

\section{Introdução}

\subsection{Debian}

\begin{frame}{Debian}
	\begin{itemize}
		\item \textbf{Distribuição de GNU/Linux}
			\br
		\item 1ª grande distribuição desenvolvida ''abertamente ao espírito de GNU''
			\br
		\item \textbf{Não-comercial}, construída em colaboração por mais de 1000
voluntários
			\br
		\item 3 funcionalidades principais:
			\begin{itemize}
				\item \textbf{Qualidade} -- cultura de excelência técnica\\ {\small\sl Nós
lançamos quando está tudo pronto}
					\hbr
				\item \textbf{Liberdade} -- desenvolvedores e utilizadores unidos pelo
\textsl{Contracto Social}\\ Promovendo a cultura do Software Livre desde
1993
					\hbr
				\item \textbf{Independência} -- nenhuma (nem uma) companhia toma conta da Debian\\ 
E processo de decisão-trabalho aberto (\textsl{do-ocracy} +
\textsl{democracy})
			\end{itemize}
                        \br
                \item \textbf{Amador} no melhor sentido: feito com amor
	\end{itemize}
\end{frame}

\subsection{Pacotes Debian}
\begin{frame}{Pacotes Debian}
\begin{itemize}
\item ficheiros \textbf{.deb} (pacotes binários)
	\br
\item Uma maneira muito poderosa e conveniente de distribuir software aos
utilizadores
	\br
\item Um dos dois formatos de pacotes mais comuns (com o RPM)
	\br
\item Universal:
	\begin{itemize}
		\item 30000 pacotes binários em Debian\\ $\rightarrow$ a maioria do software livre
disponível está empacotado em Debian!
			\hbr
		\item Para 12 portes (arquitecturas), incluindo 2 não-Linux (Hurd; KFreeBSD)
			\hbr
		\item Também usado por 120 distribuições derivadas de Debian
	\end{itemize}
\end{itemize}
\end{frame}


\subsection{O formato de pacotes Deb}

\begin{frame}[fragile=singleslide]{O formato de pacotes Deb}
  \begin{itemize}
  \item Ficheiro \texttt{.deb}: um 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}: versão do formato de ficheiro deb,
\texttt{"2.0\textbackslash{}n"}
    \item \texttt{control.tar.gz}: meta-dados acerca do pacote\\ {\small
\texttt{\textbf{control}, md5sums, (pre|post)(rm|inst), triggers, shlibs},
\ldots}
    \item \texttt{data.tar.gz}: ficheiros de dados do pacote
    \end{itemize}
    \br
  \item Você poderia criar os seus ficheiros \texttt{.deb} manualmente\\ 
{\footnotesize
\url{http://tldp.org/HOWTO/html\_single/Debian-Binary-Package-Building-HOWTO/}}
    \br
  \item Mas a maioria das pessoas não o faz dessa maneira
  \end{itemize}
  \br
  \centerline{\textbf{Este manual: criar pacotes Debian, à maneira Debian}}
\end{frame}

\subsection{Ferramentas que irá precisar}
\begin{frame}{Ferramentas que irá precisar}
  \begin{itemize}
  \item Um sistema Debian (ou Ubuntu) (com acesso a root)
    \br
  \item Alguns pacotes:
    \begin{itemize}
    \item \textbf{build-essential}: tem dependências nos pacotes que irão ser
assumidas para estarem disponíveis na máquina do desenvolvedor (não é
preciso especificá-las no campo de controle  \texttt{Build-Depends:} do seu
pacote)
      \begin{itemize}
      \item Inclui a dependência de \textbf{dpkg-dev}, a qual contém ferramentas básicas
específicas de Debian para criar pacotes
      \end{itemize}
      \hbr
    \item \textbf{devscripts}: contém muitos scripts úteis para mantenedores de Debian
    \end{itemize}
  \end{itemize}

  \br
  Muitas outras ferramentas serão também mencionadas mais tarde, tais como
\textbf{debhelper}, \textbf{cdbs}, \textbf{quilt}, \textbf{pbuilder},
\textbf{sbuild}, \textbf{lintian}, \textbf{svn-buildpackage},
\textbf{git-buildpackage}, \ldots\\ instale-as quando precisar delas.
\end{frame}

\subsection{Fluxo de trabalho de empacotamento geral}
\begin{frame}{Fluxo de trabalho de empacotamento geral}
  \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) {upstream
source}; \node[node1] (da) at (-2.5, 0) {Debian mirror}; \node[node1] (sp)
at (0, -2) {source package}; \draw[arr,<-,dashed,thick] (sp) -- (2.5,-2)
node[right=0cm,text width=2.98cm,text centered,font=\small\sl] {onde a
maioria do trabalho manual é feito}; \node[node1] (bin) at (0, -4) {um ou
vários pacotes binários}; \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}
(compilar e testar com \textttc{lintian}) ou \textttc{dpkg-buildpackage}};
\draw[arr,->] (bin) -- (1,-6) node[pos=0.5,right] {install
(\textttc{debi})}; \draw[transparent] (bin) -- (-1,-6)
node[pos=0.5,left,opaque] {upload (\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 o dash}
\begin{frame}{Exemplo: recompilando o dash}
\begin{enumerate}
\item Instale os pacotes necessários para compilar dash, e devscripts\\ 
{\texttt{sudo apt-get build-dep dash}\\ (requer linhas \texttt{deb-src} em
\texttt{/etc/apt/sources.list})}\\ {\texttt{sudo apt-get install
-{}-no-install-recommends devscripts fakeroot}}
  \hbr
\item Crie um directório de trabalho, e vá para ele :\\ \texttt{mkdir
/tmp/debian-tutorial ; cd /tmp/debian-tutorial}
  \hbr
\item Obtenha o pacote fonte do \texttt{dash}\\ \texttt{apt-get source dash}\\ 
{\small (Para isto precisa de ter linhas \texttt{deb-src} no seu
\texttt{/etc/apt/sources.list})}
  \hbr
\item Compile o pacote\\ {\texttt{cd dash-*\\ debuild -us -uc}} ~~~(\texttt{-us
-uc} desactiva a assinatura do pacote com GPG)

  \hbr
\item Verifique que funcionou
	\begin{itemize}
		\item  Existem alguns ficheiros \texttt{.deb} novos no directório pai
	\end{itemize}
    \hbr
\item Observe o directório \texttt{debian/}
	\begin{itemize}
		\item É onde o trabalho de empacotamento é feito
	\end{itemize}
\end{enumerate}
\end{frame}

\section{Criar pacotes fonte}
\subsection{Bases dos pacotes fonte}
\begin{frame}{Pacote fonte}
  \begin{itemize}
  \item Um pacote fonte pode gerar vários pacotes binários\\ {\small ex, a fonte
\texttt{\bfseries libtar} gera pacotes binários \texttt{\bfseries libtar0} e
\texttt{\bfseries libtar-dev}} \hbr
  \item Dois tipos de pacotes: (em caso de dúvida, use não-nativo)
    \begin{itemize}
      \small
    \item Pacotes nativos: normalmente para software específico de Debian
(\textsl{dpkg}, \textsl{apt})
    \item Pacotes não-nativos: software desenvolvido fora de Debian
    \end{itemize}
    \hbr
  \item Ficheiro principal: \texttt{.dsc} (meta-dados)
    \hbr
  \item Outros ficheiros que dependem da versão do formato fonte
    \begin{itemize}
    \item 1.0 or 3.0 (nativo): \texttt{package\_version.tar.gz}
      \hbr
    \item 1.0 (não-nativo):
      \begin{itemize}
      \item \texttt{pkg\_ver.orig.tar.gz}: fonte da autoria (upstream)
      \item \texttt{pkg\_debver.diff.gz}: patch para adicionar alterações específicas de
Debian
      \end{itemize}
      \hbr
    \item 3.0 (quilt):
      \begin{itemize}
      \item \texttt{pkg\_ver.orig.tar.gz}: fonte da autoria (upstream)
      \item \texttt{pkg\_debver.debian.tar.gz}: tarball com as alterações de Debian
      \end{itemize}
    \end{itemize}
  \end{itemize}
  \hbr
  (Veja \texttt{dpkg-source(1)} para detalhes exactos)
\end{frame}

\begin{frame}[fragile=singleslide]{Exemplo de pacote 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 pacotes fonte}
\begin{frame}{Obtendo um pacote fonte existente}
  \begin{itemize}
  \item Do arquivo Debian:
    \begin{itemize}
    \item \texttt{apt-get source \textsl{pacote}}
    \item \texttt{apt-get source \textsl{pacote=versão}}
    \item \texttt{apt-get source \textsl{pacote/lançamento}}
    \end{itemize}
    (Você precisa de linhas \texttt{deb-src} em \texttt{sources.list})
    \br
  \item Da 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} disponibiliza todos os pacotes de Debian desde 2005)
    \end{itemize}
    \br
  \item Do sistema de controlo de versão (declarado):
    \begin{itemize}
    \item \texttt{debcheckout \textsl{pacote}}
    \end{itemize}
    \br
  \item Após a descarga, extraia com \texttt{dpkg-source -x \textsl{file.dsc}}
  \end{itemize}
\end{frame}

\subsection{Criar um pacote fonte básico}
\begin{frame}{Criar um pacote fonte básico}
  \begin{itemize}
  \item Descarregue a fonte do autor (upstream)\\ (\textsl{upstream source} = aquela
dos desenvolvedores originais do software)
    \hbr
  \item Renomeie para
\texttt{<\textsl{source\_package}>\_<\textsl{upstream\_version}>.orig.tar.gz}\\ 
(exemplo: \texttt{simgrid\_3.6.orig.tar.gz})
    \hbr
  \item Descompacte-o
    \hbr
  \item Renomeie o directório para
\texttt{<\textsl{source\_package}>-<\textsl{upstream\_version}>}\\ (exemplo:
\texttt{simgrid-3.6})
    \hbr
  \item \texttt{cd \texttt{<\textsl{source\_package}>-<\textsl{upstream\_version}>}
\&\& dh\_make}\\ (do pacote \textbf{dh-make})
    \hbr
  \item Existem algumas alternativas ao \texttt{dh\_make} para conjuntos específicos
de pacotes: \textbf{dh-make-perl}, \textbf{dh-make-php}, \ldots \hbr
  \item Directório \texttt{debian/} criado, com muitos ficheiros lá dentro
  \end{itemize}
\end{frame}

\subsection{Ficheiros em debian/}
\begin{frame}{Ficheiros em debian/}
  Todo o trabalho de empacotamento deve ser feito ao modificar ficheiros em
\texttt{debian/}
  \hbr
  \begin{itemize}
  \item Ficheiros principais:
    \begin{itemize}
    \item \textbf{control} -- meta-dados acerca do pacote (dependências, etc)
    \item \textbf{rules} -- especifica como compilar o pacote
    \item \textbf{copyright} -- informação de copyright para o pacote
    \item \textbf{changelog} -- história do pacote Debian
    \end{itemize}
    \hbr
  \item Outros ficheiros:
    \begin{itemize}
    \item compat
    \item watch
    \item dh\_install* targets\\ {\small *.dirs, *.docs, *.manpages, \ldots}
    \item scripts do mantenedor\\ {\small *.postinst, *.prerm, \ldots}
    \item fonte/formato
    \item patches/ -- se você precisar de modificar as fontes do autor
    \end{itemize}
    \hbr
  \item Vários ficheiros usam um formato baseado em RFC 822 (cabeçalhos de mail)
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/changelog}
  \begin{itemize}
  \item Lista as alterações de empacotamento Debian
  \item Dá a versão actual do pacote
  \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 Debian revision}; \draw
[decorate,decoration={brace}] (1.4,0) -- (0,0) node[midway,below,text
width=1.6cm,text centered] { \small Upstream version};
\end{tikzpicture}
\end{center}


	  \item Editado manualmente ou com \textttc{dch}
  \begin{itemize}
	  \item Crie uma entrada no changelog para um novo lançamento: \textttc{dch -i}
  \end{itemize}
  \item Formato especial para fechar automaticamente bugs de Debian ou Ubuntu\\ 
Debian: \texttt{Closes:~\#595268}; Ubuntu: \texttt{LP:~\#616929}
  \item Instalado como \texttt{/usr/share/doc/\textit{pacote}/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 Meta dados do pacote
    \begin{itemize}
    \item Para o próprio pacote fonte
    \item Para cada pacote binário compilado desta fonte
    \end{itemize}
    \hbr
  \item Nome do pacote, secção, prioridade, mantenedor, quem faz os uploads,
dependências de compilação, dependências, descrição, página do projecto,
\ldots \hbr
  \item Documentação: Politica 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 uma qualquer}
  Dois tipos de pacotes binários:
  \hbr
  \begin{itemize}
  \item Pacotes com conteúdos diferentes para cada arquitectura Debian
    \begin{itemize}
    \item Exemplo: programa C
    \item \texttt{Architecture:\ any} em \texttt{debian/control}
      \begin{itemize}
      \item Ou, se apenas funcionar num sub-conjunto de arquitecturas:\\ 
\texttt{Architecture:\ amd64 i386 ia64 hurd-i386}
      \end{itemize}
    \item buildd.debian.org: compila todas as outras arquitecturas para si ao submeter
    \item Chamado \texttt{\textsl{pacote}\_\textsl{versão}\_\textsl{arquitectura}.deb}
    \end{itemize}
    \br
  \item Pacotes com o mesmo conteúdo para todas as arquitecturas
    \begin{itemize}
    \item Exemplo: biblioteca Perl
    \item \texttt{Architecture:\ all} em \texttt{debian/control}
    \item Chamado \texttt{\textsl{pacote}\_\textsl{versão}\_\textbf{todas}.deb}
    \end{itemize}
  \end{itemize}
  \br
  Um pacote fonte pode gerar uma mistura de pacotes binários de
\texttt{Arquitectura:\ any} e \texttt{Arquitectura:\ all}
\end{frame}

\begin{frame}[fragile=singleslide]{debian/rules}
  \hbr
  \begin{itemize}
  \item Makefile
    \br
  \item Interface usada para compilar pacotes Debian
    \br
  \item Documentado em Politica Debian, capitulo 4.8\\ {\small
\url{https://www.debian.org/doc/debian-policy/ch-source\#s-debianrules}}
    \br
  \item Alvos necessários:
    \begin{itemize}
    \item \texttt{build, build-arch, build-indep}: deve executar toda a configuração e
compilação
      \hbr
    \item \texttt{binary, binary-arch, binary-indep}: compila os pacotes binários
      \begin{itemize}
      \item \texttt{dpkg-buildpackage} irá chamar \texttt{binary} para compilar todos os
pacotes, ou \texttt{binary-arch} para compilar apenas os pacotes de
\texttt{Arquitectura:~any}
      \end{itemize}
      \hbr
    \item \texttt{clean}: limpa o directório fonte
    \end{itemize}
  \end{itemize}
\end{frame}

\subsection{Ajudantes de empacotamento}
\begin{frame}{Ajudantes de empacotamento -- debhelper}
  \begin{itemize}
  \item Você podia escrever código de shell directamente em \texttt{debian/rules}
  \item Melhor prática (usada pela maioria dos pacotes): use um \textsl{Ajudante de
Empacotamento}
  \item O mais popular deles: \textbf{debhelper} (usado por 98\% dos pacotes)
  \item Objectivos:
    \begin{itemize}
    \item Factoriza as tarefas comuns em ferramentas standard usadas por todos os
pacotes
    \item Corrige alguns bugs de empacotamento de uma vez para todos os pacotes
    \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 de \texttt{debian/rules}
    \item Configurável usando parâmetros de comandos ou ficheiros em \texttt{debian/}
    \end{itemize}{\footnotesize \ttfamily \textsl{package}.docs, \textsl{package}.exemplos,
\textsl{package}.install, \textsl{package}.manpages, \ldots} \hbr
  \item Ajudantes de terceiros para conjuntos de pacotes: \textbf{python-support},
\textbf{dh\_ocaml}, \ldots \hbr
  \item \texttt{debian/compat}: Versão de compatibilidade do 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

# Uncomment this to turn on verbose mode.
#export DH_VERBOSE=1

build: 
        $(MAKE)
        #docbook-to-man debian/packagename.sgml > packagename.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
        # Add here commands to install the package into debian/packagename.
        $(MAKE) DESTDIR=$(CURDIR)/debian/packagename install
\end{lstlisting}
\end{frame}

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

# Build architecture-independent files here.
binary-indep: build install

# Build architecture-dependent files here.
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 Com o debhelper, ainda muita redundância entre pacotes
    \hbr
  \item Ajudantes de segundo-nível que factorizam funcionalidades comuns
    \begin{itemize}
    \item Ex. compilando com \texttt{./configure \&\& make \&\& make install} ou CMake
    \end{itemize}
    \hbr
  \item CDBS:
    \begin{itemize}
    \item Introduzido em 2005, baseado na magia avançada do \textsl{GNU make}
    \item Documentação: \texttt{/usr/share/doc/cdbs/}
    \item Suporte para Perl, Python, Ruby, GNOME, KDE, Java, Haskell, \ldots
    \item Mas algumas pessoas detestam-o:
      \begin{itemize}
      \item Por vezes é difícil personalizar compilações de pacotes:\\ 
"\textsl{labirinto distorcido de makefiles e variáveis de ambiente}"
      \item Mais lento que o debhelper simples (muitas chamadas desnecessárias 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

# add an action after the build
build/mypackage::
    /bin/bash debian/scripts/foo.sh
      \end{lstlisting}
\end{frame}

\begin{frame}[fragile=singleslide]{Dh (aka Debhelper 7, ou dh7)}
  \begin{itemize}
  \item Introduzido em 2008 como o \textsl{matador do CDBS}
    \hbr
  \item \textbf{dh} comando que chama \texttt{dh\_*}
    \hbr
  \item \textsl{debian/rules} simples, listando apenas as sobreposições
    \hbr
  \item Mais fácil de personalizar que o CDBS
    \hbr
  \item Documentos: manpages (\texttt{debhelper(7)}, \texttt{dh(1)}) + slides da
reunião 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ássico contra CDBS contra dh}
  \hbr
  \begin{itemize}
  \item Mind shares:\\ debhelper clássico: 15\% \hskip 1em CDBS: 15\% \hskip 1em dh:
68\%
    \hbr
  \item Qual deles devo aprender?
    \begin{itemize}
    \item Provavelmente um pouco de todos eles
    \item Você precisa de conhecer o debhelper para usar o dh e o CDBS
    \item Você poderá ter que modificar pacotes CDBS
    \end{itemize}
    \hbr
  \item Qual deles devo usar para um pacote novo?
    \begin{itemize}
	    \item \textbf{dh} (solução apenas com um aumento da mind share)
	    \item Veja \url{https://trends.debian.net/\#build-systems}
    \end{itemize}
  \end{itemize}
  
  \hbr


\end{frame}

\section{Compilando e testando pacotes}
\subsection{Compilando pacotes}
\begin{frame}{Compilando pacotes}
  \begin{itemize}
  \item \textttc{apt-get build-dep mypackage}\\ Instala as
\textsl{build-dependencies} (para um pacote já em Debian)\\ Ou
\textttc{mk-build-deps -ir} (para um pacote ainda não submetido)
    
    \br
  \item \textttc{debuild}: compila, testa com \texttt{lintian}, assina com GPG
    \br
  \item Também possível chamar directamente \textttc{dpkg-buildpackage}
    \begin{itemize}
    \item Normalmente com \texttt{dpkg-buildpackage -us -uc}
    \end{itemize}
    \br
  \item É melhor compilar os pacotes num ambiente limpo \& mínimo
    \begin{itemize}
    \item \textttc{pbuilder} -- ajudante para compilar pacotes em \textsl{chroot}\\ 
Boa documentação: \url{https://wiki.ubuntu.com/PbuilderHowto}\\ 
(optimização: \textttc{cowbuilder} \textttc{ccache} \textttc{distcc})
      \hbr
    \item \textttc{schroot} e \textttc{sbuild}: usados nos daemons de compilação de
Debian\\ (não tão simples como \texttt{pbuilder}, mas permite instantâneos
LVM\\ veja: \url{https://help.ubuntu.com/community/SbuildLVMHowto} )
    \end{itemize}
    \br
  \item Gera ficheiros \texttt{.deb} e um ficheiro \texttt{.changes}
    \begin{itemize}
    \item \texttt{.changes}: descreve o que foi compilado; usado para fazer o upload
do pacote
    \end{itemize}
  \end{itemize}
\end{frame}
\subsection{Instalando e testando pacotes}
\begin{frame}{Instalando e testando pacotes}
  \begin{itemize}
  \item Instale o pacote localmente: \textttc{debi} (irá usar \texttt{.changes} para
saber o que instalar) \br
  \item Liste o conteúdo do pacote: \texttt{{\color{rouge}debc}
../mypackage<TAB>.changes} \br
  \item Compara o pacote com a versão anterior:\\ \texttt{{\color{rouge}debdiff}
../mypackage\_1\_*.changes ../mypackage\_2\_*.changes}\\ ou para comparar as
fontes:\\ \texttt{{\color{rouge}debdiff} ../mypackage\_1\_*.dsc
../mypackage\_2\_*.dsc}\\
    \br
  \item Verifique o pacote com \texttt{lintian} (analisador estático):\\ 
\texttt{{\color{rouge}lintian} ../mypackage<TAB>.changes}\\ \texttt{lintian
-i}: dá mais informação acerca de erros \\ \texttt{lintian -EviIL
+pedantic}: mostra mais problemas\br
  \item Faça o upload do pacote para Debian (\textttc{dput}) (precisa de
configuração) \br
  \item Faça gestão de um arquivo Debian privado com \textttc{reprepro} ou
\textttc{aptly}\\ Documentação:
\url{https://wiki.debian.org/HowToSetupADebianRepository}
  \end{itemize}
\end{frame}
\section{Sessão prática 1: modificar o pacote grep}
\begin{frame}{Sessão prática 1: modificar o pacote grep}
  \begin{enumerate}
  \item Vá a \url{http://ftp.debian.org/debian/pool/main/g/grep/} e descarregue a
versão 2.12-2 do pacote
    \begin{itemize}
		   \item Se o pacote fonte não descompactar automaticamente, descompacte-o com
\texttt{dpkg-source~-x~grep\_*.dsc}
    \end{itemize}

  \item Observe os ficheiros em \texttt{debian/}.
    \begin{itemize}
    \item 		Quantos pacotes binários são gerados por este pacote fonte?
    \item 		Qual o ajudante de empacotamento este pacote usa?
    \end{itemize}
    \hbr
  \item Compile o pacote
    \hbr
  \item Agora você vai modificar o pacote. Adicione uma entrada changelog e
incremente o número da versão.
    \hbr
  \item Agora desactive o suporte a perl-regexp (é uma opção de
\texttt{./configure})
    \hbr
  \item Re-compile o pacote
    \hbr
  \item Compare os pacotes original e novo com o debdiff
    \hbr
  \item instale o pacote compilado recentemente
  \end{enumerate}
\end{frame}

\section{Tópicos de empacotamento avançados}
\subsection{debian/copyright}
\begin{frame}[fragile=singleslide]{debian/copyright}
  \hbr
  \begin{itemize}
  \item Informação de copyright e licença para a fonte e o empacotamento
  \item Tradicionalmente escrito num ficheiro de texto
  \item Novo formato máquina-legível:
{\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:
 [LICENSE TEXT]
\end{lstlisting}
\end{frame}



\subsection{Modificar a fonte do autor}
\begin{frame}{Modificar a fonte do autor}
  Muitas vezes necessário:
  \begin{itemize}
  \item Corrigir bugs ou adicionar personalizações que são específicas de Debian
    \hbr
  \item Correcções a versões anteriores (backport) a partir de lançamento mais
recente do autor
  \end{itemize}
  \br
  Vários métodos para o fazer:
  \begin{itemize}
  \item Modificar os ficheiros directamente
    \begin{itemize}
    \item Simples
    \item Mas sem modo de acompanhar e documentar as alterações
    \end{itemize}
    \hbr
  \item utilizando sistemas de patch
    \begin{itemize}
    \item Facilita a contribuição das suas alterações para o autor original (upstream)
    \item Ajuda a partilhar as correcções com os derivados
    \item Dá melhor exibição às alterações\\ \url{http://patch-tracker.debian.org/}
(presentemente fora de serviço)
    \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}{Sistemas de patch}
  \begin{itemize}
  \item Princípio: as alterações são guardadas como patches em
\texttt{debian/patches/}
    \br
  \item Aplicado e "des-aplicado" durante a compilação
    \br
  \item Passado: várias implementações -- \textsl{simple-patchsys} (\textsl{cdbs}),
\textsl{dpatch}, \textbf{\textsl{quilt}}
    \begin{itemize}
  \item Cada um suporta dois alvos \texttt{debian/rules}:
    \begin{itemize}
    \item \texttt{debian/rules patch}: aplica todas as patches
    \item \texttt{debian/rules unpatch}: retira as alterações de todas as patches
    \end{itemize}
	  \hbr
  \item Mais documentação: \url{https://wiki.debian.org/debian/patches}
  \end{itemize}
  \br
  \item \textbf{Novo formato de pacote fonte com sistema de patch integrado: 3.0 (quilt)}
  \begin{itemize}
  \item Solução recomendada
	  \hbr
  \item Você precisa de aprender \textsl{quilt}\\ 
\url{https://perl-team.pages.debian.net/howto/quilt.html}
    \hbr
  \item Ferramenta patch-system-agnostic em \texttt{devscripts}: \texttt{edit-patch}
  \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Documentação de patches}
  \begin{itemize}
	  \item Cabeçalhos standard no inicio da patch
    \br
  \item Documentado em DEP-3 - Patch Tagging Guidelines\\ 
\url{http://dep.debian.net/deps/dep3/}
  \end{itemize}
  \vfill
\seprule
  \begin{lstlisting}[basicstyle=\ttfamily\footnotesize]
Description: Fix widget frobnication speeds
 Frobnicating widgets too quickly tended to cause explosions.
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{Fazer coisas durante a instalação e remoção}
\begin{frame}{Fazer coisas durante a instalação e remoção}
  \begin{itemize}
  \item Descomprimir o pacote por vezes não é suficiente
    \hbr
  \item Criar/remover utilizadores do sistema, iniciar/para serviços, gerir
\textsl{alternativas}
    \hbr
  \item Feito nos \textsl{scripts do mantenedor}\\ \texttt{preinst, postinst, prerm,
postrm}
    \begin{itemize}
	    \item  Podem ser gerados fragmentos para acções comuns pelo debhelper
    \end{itemize}
    \hbr
  \item Documentação:
    \begin{itemize}
    \item Manual de politicas Debian, capítulo 6\\ {\footnotesize
\url{https://www.debian.org/doc/debian-policy/ch-maintainerscripts}}
      
      \hbr
    \item Referência 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 Questionando o utilizador
    \begin{itemize}
    \item Tem de ser feito com \textbf{debconf}
      \hbr
    \item Documentação: \texttt{debconf-devel(7)} (pacote \texttt{debconf-doc})
    \end{itemize}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Monitorizando versões do autor (upstream)}
  \begin{itemize}
  \item Especifica onde procurar em \texttt{debian/watch} (veja \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 Existem seguidores automatizados de novas versões do autor, que notificam o
mantenedor em vários quadros de instrumentos incluindo
\url{https://tracker.debian.org/} e \url{https://udd.debian.org/dmd/}
    \br
  \item \texttt{uscan}: corre uma verificação manual
    \br
  \item \texttt{uupdate}: tenta actualizar o seu pacote para a versão do autor mais
recente
  \end{itemize}
\end{frame}

\subsection{Empacotar com um Sistema de Controlo de Versão (SVN, Git)}
\begin{frame}[fragile=singleslide]{Empacotar com um Sistema de Controlo de Versão}
  \begin{itemize}
  \item Várias ferramentas para ajudar a gerir ramos e etiquetas para o seu trabalho
de empacotamento:\\ \texttt{svn-buildpackage}, \texttt{git-buildpackage}
    \hbr
  \item Exemplo: \texttt{git-buildpackage}
    \begin{itemize}
    \item \texttt{upstream} ramo para acompanhar a autoria com as etiquetas
\texttt{upstream/\textsl{version}}
    \item \texttt{master} ramo que acompanha o pacote Debian
    \item \texttt{debian/\textsl{version}} etiquetas para cada envio (upload)
    \item \texttt{pristine-tar} ramo para ser possível recompilar o tarball do autor
    \end{itemize}
    Documento:
\url{http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.html}
    \hbr
  \item \texttt{Vcs-*} campos em \texttt{debian/control} para localizar o
repositório
	  \begin{itemize}
		\item \url{https://wiki.debian.org/Salsa}
	\end{itemize}
\end{itemize}
  \begin{lstlisting}[basicstyle=\ttfamily\scriptsize]
Vcs-Browser: https://salsa.debian.org/debian/devscripts
Vcs-Git: https://salsa.debian.org/debian/devscripts.git
  \end{lstlisting}
  \begin{lstlisting}[basicstyle=\ttfamily\scriptsize]
Vcs-Browser: https://salsa.debian.org/perl-team/modules/packages/libwww-perl
Vcs-Git: https://salsa.debian.org/perl-team/modules/packages/libwww-perl.git
  \end{lstlisting}
  \begin{itemize}
  \item Interface VCS-agnostic: \texttt{debcheckout}, \texttt{debcommit},
\texttt{debrelease}\\
    \begin{itemize}
	    \item     \texttt{debcheckout grep} $\rightarrow$ obtém o pacote fonte de Git
    \end{itemize}
\end{itemize}
\end{frame}

\subsection{Portar pacotes para trás (backporting)}
\begin{frame}{Portar pacotes para trás (backporting)}
  \begin{itemize}
  \item Objectivo: usar uma nova versão de um pacote num sistema mais antigo\\ 
ex. usar \textsl{mutt} de Debian \textsl{unstable} em Debian \textsl{stable}
	\br
  \item Ideia geral:
	  \begin{itemize}
		\item Obtenha o pacote fonte de Debian unstable
		\hbr
		\item Modifique para que compile e funcione bem em Debian stable
		\begin{itemize}
			\item Às vezes é trivial (sem alterações necessárias)
			\item Às vezes é difícil
			\item Às vezes é impossível (muitas dependências não disponíveis)
		\end{itemize}
	\end{itemize}
	\br
   \item Alguns "backports" são disponibilizados e suportados pelo projecto Debian\\ 
\url{http://backports.debian.org/}
\end{itemize}
\end{frame}



\section{Mantendo pacotes em Debian}
\subsection{Arquivo e suites Debian}
\begin{frame}{Arquivo e suites 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) {developer}; \draw node[people,node
distance=3cm,left=of dd] (secteam) {security team}; \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] {stable\\ release};
\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)$)
{stable \\ point \\ release}; \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] {package uploads}; \coordinate[node distance=1.1em,below=of
legend] (legend2); \draw[arr,migrations,->] (legend2) -- ($(legend2) +
(0.7,0)$) node [right,legend] {package migrations between suites};
\coordinate[node distance=1.5em,below=of legend2] (legend3); \draw
node[right,suite,devel,legend] (ldev) at (legend3) {development}; \draw
node[node distance=0.1cm,right=of ldev,suite,test,legend] (ltest) {test};
\draw node[node distance=0.1cm,right=of ltest,suite,internal,legend] (lint)
{internal}; \draw node[node distance=0.1cm,right=of lint,suite,prod,legend]
(lprod) {production}; \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)$)
{preparation of \\ next release}; \draw
node[font=\bf,green!70!black,align=center] (tsrm) at ($(sec.north east) +
(1,1)$) {stable\\release\\management}; \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 em graph por Antoine
Beaupr\'e. \url{https://salsa.debian.org/debian/package-cycle}~~~~~~~~~~~~
	\end{flushright}
\end{frame}

\begin{frame}{Suites para desenvolvimento}
		\begin{itemize}
			\item Novas versões de pacotes são enviadas para \textbf{unstable} (\textbf{sid})
				\hbr
			\item Pacotes migram de \textbf{unstable} para \textbf{testing} com base em vários
critérios (ex. esteve em unstable por 10 dias, e nenhuma regressão)
				\hbr
			\item Os novos pacotes também podem ser enviados para:
				\begin{itemize}
					\item \textbf{experimental} (para mais pacotes \textsl{experimental}, tais como
quando uma nova versão não está pronta para substituir aquela presentemente
em unstable)
						\hhbr
					\item \textbf{testing-proposed-updates}, para actualizar a versão em
\textbf{testing} sem ter que passar por \textbf{unstable} (isto é raramente
usado)
				\end{itemize}
		\end{itemize}
\end{frame}

\begin{frame}{Congelar e lançamento}
	\begin{itemize}
					\item A determinada altura durante o ciclo de lançamento, a equipa de lançamento
decide \textsl{freeze} testing: as migrações automáticas de
\textbf{unstable} para \textbf{testing} são paradas, e substituídas por
revisões manuais.
						\br
		\item Quando a equipa de lançamento considera \textbf{testing} pronta para
lançamento:
			\begin{itemize}
				\item A suite \textbf{testing} torna-se a nova suite \textbf{stable}
					\hhbr
				\item De modo semelhante, a antiga \textbf{stable} torna-se \textbf{oldstable}
					\hhbr
				\item Os lançamentos não suportados são movidos para \texttt{archive.debian.org}
			\end{itemize}
			\br
		\item Veja \url{https://release.debian.org/}
	\end{itemize}
\end{frame}

\begin{frame}{Gestão e suites do lançamento estável (Stable)}
	\begin{itemize}
		\item Várias suites são usadas para disponibilizar pacotes de lançamento de
stable:
			\hhbr
			\begin{itemize}
				\item \textbf{stable} a suite principal
					\hbr
				\item \textbf{security} suite de actualizações fornecidas em
\texttt{security.debian.org}, usado pela equipa de segurança. As
actualizações são anunciadas na lista de mail
\texttt{debian-security-announce}
					\hbr
				\item \textbf{stable-updates}: actualizações que não estão relacionadas com
segurança, mas que devem ser instalados urgentemente (sem esperar pelo
próximo lançamento pontual): bases de dados de antivirus, pacotes
relacionados com o fuso horário, etc. Anunciadas na lista de mail
\texttt{debian-stable-announce}
					\hbr
				\item \textbf{backports}: novas versões do autor, com base na versão em
\textbf{testing}
			\end{itemize}
			\hbr
		\item A suite \textbf{stable} é actualizada sempre após alguns meses por
\textsl{stable point releases} (que incluem apenas correcções de bugs).
			\hhbr
			\begin{itemize}
				\item Os pacotes que visam o próximo lançamento pontual de stable são enviados
para \textbf{stable-proposed-updates} e revisados pela equipa de lançamento
			\end{itemize}
			\hbr
		\item O lançamento \textbf{oldstable} tem o mesmo conjunto de suites
	\end{itemize}
\end{frame}

\subsection{Várias maneiras de contribuir para Debian}
\begin{frame}{Várias maneiras de contribuir para Debian}
  \begin{itemize}
  \item \textbf{Pior} maneira de contribuir:
    \begin{enumerate}
    \item Empacote a sua própria aplicação
    \item Entre para a Debian
    \item Desapareça
    \end{enumerate}
    \br
  \item \textbf{Melhores} maneiras de contribuir:
	  \begin{itemize}
		  \item Envolva-se com as equipas de empacotamento
    \begin{itemize}
    \item Muitas equipas que se focam em conjuntos de pacotes, e precisam de ajuda
    \item Lista disponível em \url{https://wiki.debian.org/Teams}
    \item uma excelente maneira de aprender a partir de contribuintes mais experientes
    \end{itemize}
    \br
\item Adoptar pacotes não mantidos existentes (\textsl{pacotes órfãos})
    \br
  \item Traga novo software para Debian
    \begin{itemize}
    \item Apenas se for suficientemente interessante/útil, por favor
    \item Existem alternativas já empacotadas em Debian?
    \end{itemize}
  \end{itemize}

  \end{itemize}
\end{frame}

\subsection{Adoptando pacotes órfãos}
\begin{frame}{Adoptando pacotes órfãos}
      \hbr
  \begin{itemize}
    \item Muitos pacotes não mantidos em Debian
    \hbr
  \item Lista completa + processo: \url{https://www.debian.org/devel/wnpp/}
    \hbr
  \item Instalado na sua máquina: \texttt{wnpp-alert}\\ Ou melhor:
\texttt{how-can-i-help}
    \hbr
  \item Estados diferentes:
    \begin{itemize}
		    \small
    \item \textbf{O}rphaned: o pacote não é mantido\\ Sinta-se livre para o adoptar
      \hbr
    \item \textbf{RFA}: \textbf{R}equest \textbf{F}ou \textbf{A}dopter\\ O mantenedor
procura quem adopte, mas entretanto continua a trabalhar\\ Sinta-se livre
para adoptar. É cortês enviar um mail ao actual mantenedor
      \hbr
    \item \textbf{ITA}: \textbf{I}ntent \textbf{T}o \textbf{A}dopt\\ Alguém tenciona
adoptar o pacote\\ Você pode propor-se a ajudar!
      \hbr
    \item \textbf{RFH}: \textbf{R}equest \textbf{F}or \textbf{H}elp\\ O mantenedor
procura ajuda
    \end{itemize}
    \hbr
  \item Alguns pacotes não mantidos e não detectados \arr ainda não estão órfãos
    \hbr
  \item Quando em dúvidas, pergunte a \texttt{debian-qa@lists.debian.org} \\ ou
\texttt{\#debian-qa} em \texttt{irc.debian.org}
  \end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Adoptando um pacote: exemplo}
\begin{lstlisting}[basicstyle=\ttfamily\footnotesize,escapeinside=\{\}]
From: You <you@yourdomain>
To: 640454@bugs.debian.org, control@bugs.debian.org
Cc: Francois Marier <francois@debian.org>
Subject: ITA: verbiste -- French conjugator

retitle 640454 ITA: verbiste -- French conjugator
owner 640454 !
thanks

Hi,

I am using verbiste and I am willing to take care of the package.

Cheers,

You
\end{lstlisting}

\begin{itemize}
\item Seja cortês ao contactar o anterior mantenedor (especialmente se o pacote
estava em RFA, não órfão)
\item É uma boa ideia contactar a autoria do projecto
\end{itemize}
\end{frame}

\subsection{Colocando o seu pacote na Debian}
\begin{frame}{Colocando o seu pacote na Debian}
\begin{itemize}
\item Você não precisa de nenhum estado oficial para ter o seu pacote na Debian
	\begin{enumerate}
		\item Submeter um \textbf{ITP} bug (\textbf{I}ntent \textbf{T}o \textbf{P}ackage)
usando \texttt{reportbug wnpp}
			\hbr
		\item Preparar um pacote fonte
			\hbr
		\item Encontre um Desenvolvedor Debian que patrocine o seu pacote
	\end{enumerate}
\br
\item Estado oficial (quando você é um mantenedor de pacotes experiente)
	\begin{itemize}
		\item \textbf{Mantenedor Debian (DM):}\\ Permissão para submeter os seus próprios
pacotes\\ Veja \url{https://wiki.debian.org/DebianMaintainer}
			\hbr
		\item \textbf{Desenvolvedor Debian (DD):}\\ Membro do projecto Debian; pode votar
e submeter (upload) qualquer pacote
	\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{Coisas a verificar antes de pedir patrocínio}
\begin{itemize}
	\item Debian tem \textbf{muita atenção à qualidade}
\hbr
\item Geralmente, os \textbf{patrocinadores são difíceis de encontrar e ocupados}
\begin{itemize}
\item Certifique-se que o seu pacote está pronto antes de pedir patrocinador
\end{itemize}
\hbr
\item Coisas a verificar:
\begin{itemize}
\item Evite dependências de compilação em falta: certifique-se que o seu pacote
compila bem num \textsl{chroot} de \textsl{sid} limpo
\begin{itemize}
\item É recomendado usar o \texttt{pbuilder}
\end{itemize}
\hbr
\item Corra \texttt{lintian -EviIL +pedantic} no seu pacote
\begin{itemize}
\item Os erros têm de ser corrigidos, todos os outros problemas devem ser
corrigidos
\end{itemize}
\hbr
\item E claro, faça testes intensivos do seu pacote
\end{itemize}
\hbr
\item Em dúvidas, peça ajuda
\end{itemize}
\end{frame}

\subsection{Onde encontrar ajuda?}
\begin{frame}{Onde encontrar ajuda?}
	\hbr
  Ajuda que irá precisar:
  \begin{itemize}
  \item Conselhos e respostas para as suas questões, revisões de código
  \item Patrocinador para os seus envios (uploads), assim que o seu pacote esteja
pronto
  \end{itemize}
  \hbr
  Você pode obter ajuda de:
  \begin{itemize}
	  \item \textbf{Outros membros de uma equipa de empacotamento}
    \begin{itemize}
    \item Lista de equipas: \url{https://wiki.debian.org/Teams}
    \end{itemize}
    \hbr
  \item O \textbf{Debian Mentors group} (se o seu pacote não encaixar numa equipa)
    \begin{itemize}
    \item \url{https://wiki.debian.org/DebianMentorsFaq}
    \item Lista de mail: \url{debian-mentors@lists.debian.org}\\ {\small (também uma
boa maneira de aprender por acaso)}
    \item IRC: \texttt{\#debian-mentors} em \texttt{irc.debian.org}
    \item \url{http://mentors.debian.net/}
    \item Documentação: \url{http://mentors.debian.net/intro-maintainers}
    \end{itemize}
    \hbr
  \item \textbf{Listas de mail localizadas} (obtenha ajuda na sua linguagem)
    \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 listas de utilizadores: \url{https://lists.debian.org/users.html}
  \end{itemize}
  \end{itemize}
\end{frame}

\subsection{Mais documentação}
\begin{frame}{Mais documentação}
  \begin{itemize}
  \item O Cantinho dos Desenvolvedores de Debian\\ 
\url{https://www.debian.org/devel/}\\ {\small Links para muitos recursos
acerca do desenvolvimento de Debian}
    \hbr
  \item Guia para Mantenedores de Debian\\ 
\url{https://www.debian.org/doc/manuals/debmake-doc/}
    \hbr
  \item Referência dos Desenvolvedores de Debian\\ 
\url{https://www.debian.org/doc/developers-reference/}\\ {\small
Maioritariamente acerca dos procedimentos de Debian, mas também algumas das
melhores práticas de empacotamento (parte 6)}
    \hbr
  \item Politica de Debian\\ \url{https://www.debian.org/doc/debian-policy/}\\
    
    {\small \begin{itemize} \item \small Todos os requerimentos que cada pacote
deve satisfazer \item \small Politicas específicas para Perl, Java, Python,
\ldots \end{itemize}}
    \hbr
    
  \item Guia de Empacotamento de Ubuntu\\ 
\url{https://packaging.ubuntu.com/html/}
  \end{itemize}
\end{frame}

\subsection{Bancadas Debian para mantenedores}
\begin{frame}{Bancadas Debian para mantenedores}
  \begin{itemize}
	  \item \textbf{Central do pacote fonte}:\\ \url{https://tracker.debian.org/dpkg}
    \br
  \item \textbf{Central do mantenedor/equipa}: Visão Geral de Pacotes de
Desenvolvedores (DDPO)\\ 
\url{https://qa.debian.org/developer.php?login=pkg-ruby-extras-maintainers@lists.alioth.debian.org}
    \br
  \item \textbf{Lista-A-FAZER orientada}: Bancada do Mantenedor Debian (DMD)\\ 
\url{https://udd.debian.org/dmd/}
  \end{itemize}
\end{frame}

\begin{frame}{Usando o Debian Bug Tracking System (BTS)}
\begin{itemize}
\item Uma maneira muito única de gerir os bugs
\begin{itemize}
\item Interface web para ver os bugs
\item Interface de email para fazer alterações aos bugs
\end{itemize}
\hbr
\item Adicionar informação aos bugs:
	\begin{itemize}
		\item Escreva para \texttt{123456@bugs.debian.org} (não inclui a pessoa que
submeteu, você precisa adicionar \texttt{123456-submitter@bugs.debian.org})
	\end{itemize}
\hbr
\item Alterar o estado do bug:
\begin{itemize}
\item Envie comandos para \texttt{control@bugs.debian.org}
\item Interface de linha de comandos: comando \texttt{bts} em \texttt{devscripts}
\item Documentação: \url{https://www.debian.org/Bugs/server-control}
\end{itemize}
\hbr
\item Reportar bugs: use \texttt{reportbug}
\begin{itemize}
\item Normalmente usado com um servidor de mail local: instale \texttt{ssmtp} ou
\texttt{nullmailer}
\item Ou use \texttt{reportbug -\@-template}, depois envie (manualmente) para
\texttt{submit@bugs.debian.org}
\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{Usando o BTS: exemplos}
\begin{itemize}
\item Enviar um email para o bug e para quem o submeteu:\\ 
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680822\#10}
\hbr
\item Etiquetar e alterar a severidade:\\ 
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680227\#10}
\hbr
\item Re-atribuir, alterar a severidade, mudar o título \ldots: \\ 
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680822\#93}
\begin{itemize}
	\item \texttt{notfound}, \texttt{found}, \texttt{notfixed}, \texttt{fixed} são
para \textbf{version-tracking} \\ Veja
\url{https://wiki.debian.org/HowtoUseBTS\#Version\_tracking}
\end{itemize}
\hbr
\item Usando usertags:
\url{https://bugs.debian.org/cgi-bin/bugreport.cgi?msg=42;bug=642267}\\ Veja
\url{https://wiki.debian.org/bugs.debian.org/usertags}
\hbr
\item Documentação de BTS:
\begin{itemize}
\item \url{https://www.debian.org/Bugs/}
\item \url{https://wiki.debian.org/HowtoUseBTS}
\end{itemize}
\end{itemize}
\end{frame}

\subsection{Mais interessado em Ubuntu?}
\begin{frame}{Mais interessado em Ubuntu?}
  \begin{itemize}
  \item Ubuntu maioritariamente gere a divergência com Debian
    \br
  \item Nenhuma focagem real em pacotes específicos\\ Em vez disso, colaboração com
as equipas de Debian
    \br
  \item Normalmente é recomendado enviar primeiro os novos pacote para Debian\\ 
\url{https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages}
    \br
  \item Possivelmente um plano melhor:
    \begin{itemize}
    \item Envolva-se numa equipa de Debian e actue como uma ponte com Ubuntu
      \hbr
    \item Ajuda reduz divergência, triagem de bugs no Launchpad
      \hbr
    \item Muitas ferramentas de Debian podem ajudar:
      \begin{itemize}
      \item Coluna do Ubuntu na visão geral de pacotes de Desenvolvedores
      \item Caixa do Ubuntu no Sistema de Acompanhamento de Pacotes
      \item Recebe bugmail do launchpad via PTS
      \end{itemize}
    \end{itemize}
  \end{itemize}
\end{frame}

\section{Conclusões}
\subsection{Conclusões}
\begin{frame}{Conclusões}
  \begin{itemize}
  \item Agora você uma visão geral completa do empacotamento de Debian
    \br
  \item Mas você irá precisar de ler mais documentação
    \br
  \item As melhores práticas evoluíram com os anos
    \begin{itemize}
    \item Em dúvida, use o ajudante de empacotamento \textbf{dh}, e o formato
\textbf{3.0 (quilt)}
    \end{itemize}
  \end{itemize}
  \vfill
  \centerline{\large Feedback: \textbf{packaging-tutorial@packages.debian.org}}
\end{frame}

\subsection{Matérias legais}
\begin{frame}{Matérias legais}

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

  {\small \textbf{This document is free software}: you can redistribute it
and/or modify it under either (at your option): \hbr \begin{itemize} \item
The terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.\\ \url{http://www.gnu.org/licenses/gpl.html} \br \item
The terms of the Creative Commons Attribution-ShareAlike 3.0 Unported
License.\\ \url{http://creativecommons.org/licenses/by-sa/3.0/}
\end{itemize} }
\end{frame}

\subsection{Contribua para este manual}
\begin{frame}{Contribua para este manual}
	\begin{itemize}
		\item Contribuir:
			\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 Bugs abertos: \url{bugs.debian.org/src:packaging-tutorial}}
			\end{itemize}
			\br
		\item Forneça comentários de retorno (Feedback):
			\begin{itemize}
				\item \href{mailto:packaging-tutorial@packages.debian.org}{\textbf{\texttt{mailto:packaging-tutorial@packages.debian.org}}}
				\begin{itemize}
					\item{\small o que deve ser adicionado a este manual?}
				\item {\small O que deve ser melhorado?}
				\end{itemize}
					\hbr
				\item{\small \texttt{reportbug packaging-tutorial}}
			\end{itemize}
	\end{itemize}
\end{frame}

\section{Sessões práticas adicionais}

\subsection{Sessão prática 2: empacotar o GNUjump}
\begin{frame}{Sessão prática 2: empacotar o GNUjump}
	\begin{enumerate}
		\item Faça o download de GNUjump 1.0.8 de
\url{http://ftp.gnu.org/gnu/gnujump/gnujump-1.0.8.tar.gz}
			\br
		\item Crie um pacote Debian para ele
			\begin{itemize}
				\item Instale as dependências de compilação para que possa compilar o pacote
				\item Corrigir bugs
				\item Obtenha um pacote funcional básico
				\item Acabe de preencher \texttt{debian/control} e outros ficheiros
			\end{itemize}
			\br
		\item Aprecie
	\end{enumerate}
\centerline{\includegraphics[width=5cm]{figs/gnujump.png}}
\end{frame}

\begin{frame}[fragile=singleslide]{Sessão prática 2: empacotar o GNUjump (dicas)}
	\begin{itemize}
		\item Para obter um pacote básico funcional, use \texttt{dh\_make}
		\item Para começar, criar um pacote fonte \textsl{1.0} é mais fácil que um
\textsl{3.0 (quilt)} (mude isso em \texttt{debian/source/format})
		\item Para procurar dependências de compilação em falta, encontre um ficheiro em
falta, e use o \texttt{apt-file} para encontrar um pacote em falta.
		\item Se você encontrar esse 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}
			Você precisa de adicionar \texttt{-lm} à linha do comando linker: Edite
\texttt{src/Makefile.am} e substitua
\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}
				Depois corra \texttt{autoreconf -i}
	\end{itemize}
\end{frame}

\subsection{Sessão prática 3: empacotando uma biblioteca Java}
\begin{frame}{Sessão prática 3: empacotando uma biblioteca Java}
\begin{enumerate}
	\item Faça uma leitura rápida a alguma documentação sobre empacotamento de 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 Descarregue o IRClib de \url{http://moepii.sourceforge.net/}
		\br
	\item Empacote-o
\end{enumerate}
\end{frame}

\subsection{Sessão prática 4: empacotar uma gema Ruby}
\begin{frame}{Sessão prática 4: empacotar uma gema Ruby}
\begin{enumerate}
	\item Dê uma leitura rápida a alguma documentação acerca de empacotamento de
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 pacote \texttt{gem2deb})
		\end{itemize}
		\hbr
	\item Crie um pacote fonte Debian básico a partir da gema \texttt{peach}:\\ 
\texttt{gem2deb peach}
	\hbr
	\item Melhore-o para que se torne num pacote Debian apropriado
\end{enumerate}
\end{frame}

\subsection{Sessão prática 5: empacotar um módulo Perl}
\begin{frame}[fragile=singleslide]{Sessão prática 5: empacotar um módulo Perl}
\begin{enumerate}
	\item Faça uma leitura rápida a alguma documentação sobre empacotamento de 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)} (in the \texttt{pkg-perl-tools}
package)
		\end{itemize}
		\hbr
	\item Crie um pacote fonte Debian básico a partir da \texttt{Acme} distribuição
CPAN:\\ \verb|dh-make-perl --cpan Acme|
	\hbr
	\item Melhore-o para que se torne num pacote Debian apropriado
\end{enumerate}
\end{frame}

\section{Respostas às sessões práticas}

\begin{frame}
	\begin{center}
		\LARGE Respostas para\\[0.5em] sessões práticas
	\end{center}
\end{frame}


\subsection{Sessão prática 1: modificar o pacote grep}

\begin{frame}{Sessão prática 1: modificar o pacote grep}
\begin{enumerate}
  \item Vá a \url{http://ftp.debian.org/debian/pool/main/g/grep/} e descarregue a
versão 2.12-2 do pacote

	\item Observe os ficheiros em \texttt{debian/}.
		\begin{itemize}
			\item 		Quantos pacotes binários são gerados por este pacote fonte?
			\item 		Qual o ajudante de empacotamento este pacote usa?
		\end{itemize}
    \hbr
	\item Compile o pacote
    \hbr
	\item Agora você vai modificar o pacote. Adicione uma entrada changelog e
incremente o número da versão.
    \hbr
	\item Agora desactive o suporte a perl-regexp (é uma opção de
\texttt{./configure})
    \hbr
	\item Re-compile o pacote
    \hbr
	\item Compare os pacotes original e novo com o debdiff
    \hbr
	\item instale o pacote compilado recentemente
\end{enumerate}
\end{frame}

\begin{frame}{Obtendo a fonte}
\begin{enumerate}
  \item Vá a \url{http://ftp.debian.org/debian/pool/main/g/grep/} e descarregue a
versão 2.12-2 do pacote
\end{enumerate}
\begin{itemize}
	\item Use o dget para descarregar o ficheiro \texttt{.dsc}:\\ {\small \texttt{dget
http://cdn.debian.net/debian/pool/main/g/grep/grep\_2.12-2.dsc}}
		\hbr
	\item Se você tiver \texttt{deb-src} para um lançamento Debian que tem
\texttt{grep} versão 2.12-2 (descubra em
\url{https://tracker.debian.org/grep}), você pode usar \texttt{apt-get
source grep=2.12-2}\\ ou \texttt{apt-get source grep/release}
(ex. \texttt{grep/stable})\\ ou, se se sentir com sorte \texttt{apt-get
source grep}
	\hbr
	\item O pacote fonte do \texttt{grep} é composto por três 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}
		Isto é típico do formato "3.0 (quilt)".
	\hbr
\item Se necessário, descomprima a fonte com\\ \texttt{dpkg-source -x
grep\_2.12-2.dsc}
\end{itemize}
\end{frame}

\begin{frame}{Observando e compilando o pacote}
	\begin{enumerate}
			\setcounter{enumi}{1}
	\item Observe os ficheiros em \texttt{debian/}
		\begin{itemize}
			\item 		Quantos pacotes binários são gerados por este pacote fonte?
			\item 		Qual o ajudante de empacotamento este pacote usa?
		\end{itemize}
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item De acordo com \texttt{debian/control}, este pacote apenas gera um pacote
binário, chamado \texttt{grep}.
			\hbr
		\item De acordo com \texttt{debian/rules}, este pacote é típico de empacotamento
\textsl{classic} debhelper, sem usar \textsl{CDBS} ou \textsl{dh}. Pode-se
ver as várias chamadas a comandos \texttt{dh\_*} em \texttt{debian/rules}.
	\end{itemize}
	\hbr
	\begin{enumerate}
			\setcounter{enumi}{2}

		\item Compile o pacote
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item Use \texttt{apt-get build-dep grep} para obter as dependências de compilação
		\item Depois \texttt{debuild} ou \texttt{dpkg-buildpackage -us -uc} (Demora cerca
de 1 minuto)
	\end{itemize}
\end{frame}

\begin{frame}{Editando o registo de alterações (changelog)}
	\begin{enumerate}
			\setcounter{enumi}{3}

	\item Agora você vai modificar o pacote. Adicione uma entrada changelog e
incremente o número da versão.
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item \texttt{debian/changelog} é um ficheiro de texto Você pode editá-lo e
adicionar uma nova entrada manualmente.
	\hbr
		\item Ou você pode usar \texttt{dch -i}, que irá adicionar uma entrada e abrir o
editor
	\hbr
		\item O nome e email podem ser definidos usando as variáveis de ambiente
\texttt{DEBFULLNAME} e \texttt{DEBEMAIL}
	\hbr
		\item Após isso, recompile o pacote: é compilada uma nova versão do pacote
	\hbr
		\item O "versionamento" do pacote está detalhado na secção 5.6.12 da politica
Debian\\ \url{https://www.debian.org/doc/debian-policy/ch-controlfields}
	\end{itemize}
\end{frame}

\begin{frame}{Desactivando suporte regexp de Perl e recompilando}
	\begin{enumerate}
			\setcounter{enumi}{4}

	\item Agora desactive o suporte a perl-regexp (é uma opção de
\texttt{./configure})
	\item Re-compile o pacote
	\end{enumerate}
	\hbr
	\begin{itemize}
	  \item Verifique com \texttt{./configure -{}-help}: a opção para desactivar Perl
regexp é \texttt{-{}-disable-perl-regexp}
	\hbr
		\item Edite \texttt{debian/rules} e encontre a linha \texttt{./configure}
	\hbr
		\item Adicione \texttt{-{}-disable-perl-regexp}
	\hbr
		\item Recompile com \texttt{debuild} ou \texttt{dpkg-buildpackage -us -uc}
	\end{itemize}
\end{frame}

\begin{frame}{Comparar e testar os pacotes}
	\begin{enumerate}
			\setcounter{enumi}{6}

	\item Compare os pacotes original e novo com o debdiff
	\item instale o pacote compilado recentemente
	\end{enumerate}
	\hbr
	\begin{itemize}
		\item Compare os pacotes binários: \texttt{debdiff ../*changes}
	\hbr
		\item Compare os pacotes fonte: \texttt{debdiff ../*dsc}
	\hbr
		\item Instale o pacote recentemente compilado: \texttt{debi}\\ Ou \texttt{dpkg -i
../grep\_<TAB>}
	\hbr
		\item \texttt{grep -P foo} não funciona mais!
	\end{itemize}
\br
Reinstale a versão anterior do pacote:
\begin{itemize}
	\item \texttt{apt-get install -{}-reinstall grep=2.6.3-3} \textit{(= previous
version)}
\end{itemize}
\end{frame}

\subsection{Sessão prática 2: empacotar o GNUjump}
\begin{frame}{Sessão prática 2: empacotar o GNUjump}
\begin{enumerate}
	\item Faça o download de GNUjump 1.0.8 de
\url{http://ftp.gnu.org/gnu/gnujump/gnujump-1.0.8.tar.gz}
		\br
	\item Crie um pacote Debian para ele
		\begin{itemize}
			\item Instale as dependências de compilação para que possa compilar o pacote
			\item Obtenha um pacote funcional básico
			\item Acabe de preencher \texttt{debian/control} e outros ficheiros
		\end{itemize}
		\br
	\item Aprecie
\end{enumerate}
\centerline{\includegraphics[width=5cm]{figs/gnujump.png}}
\end{frame}

\begin{frame}[fragile=singleslide]{Passo a passo\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 pacote: binário simples (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]{Passo a passo\ldots (2)}
\begin{itemize}
	\item Observe \texttt{debian/changelog}, \texttt{debian/rules},
\texttt{debian/control}\\ (auto-preenchido por \textbf{dh\_make})
		\hbr
	\item In \texttt{debian/control}:\\ \texttt{Build-Depends: debhelper (>= 7.0.50~),
autotools-dev}\\ Lista as \textsl{build-dependencies} = pacotes necessários
para compilar o pacote
		\hbr
	\item Tenta compilar o pacote como está com \texttt{debuild} (graças à magia do
\textbf{dh})
		\begin{itemize}
			\item E adicione as dependências de compilação, até que compile
			\item Dica: use \texttt{apt-cache search} e \texttt{apt-file} para encontrar os
pacotes
			\item 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$ Adicione \textbf{libsdl1.2-dev} às Build-Depends e instale-o.
		\hbr
	\item Melhor: use \textbf{pbuilder} para compilar num ambiente limpo
		\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Passo a passo\ldots (3)}
	\begin{itemize}
		\item As dependências de compilação necessárias são \texttt{libsdl1.2-dev,
libsdl-image1.2-dev, libsdl-mixer1.2-dev}

		\item Depois, você irá provavelmente ao encontro de 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 pelo bitrot: O gnujump não foi ajustado seguindo as
alterações do linker.
		\item Se você estiver a usar a versão de formato fonte \textbf{1.0} você pode
mudar directamente as fontes do autor.
			\begin{itemize}
				\item Edite \texttt{src/Makefile.am} e substitua
\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 Depois corra \texttt{autoreconf -i}
			\end{itemize}
	\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Passo a passo\ldots (4)}
\begin{itemize}
	\item Se estiver a usar formato fonte de versão \textbf{3.0 (quilt)}, use
\texttt{quilt} para preparar uma patch. (veja
\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 Edite \texttt{src/Makefile.am} e substitua
\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 Desde que o \texttt{src/Makefile.am} mudou, o autoreconf tem de ser chamado
durante a compilação. Para o fazer automaticamente com \texttt{dh}, altere a
chamada \texttt{dh} em \texttt{debian/rules} de: \texttt{dh \$\@ -{}-with
autotools-dev}\\ para: \texttt{dh \$\@ -{}-with autotools-dev -{}-with
autoreconf}
		\hbr
\end{itemize}
\end{itemize}
\end{frame}


\begin{frame}[fragile=singleslide]{Passo a passo\ldots (5)}
\begin{itemize}
	\item O pacote deverá agora compilar sem problemas.
		\hbr
	\item Use \texttt{debc} para listar o conteúdo do pacote gerado, e \texttt{debi}
para o instalar e testar.
		\hbr
	\item Teste o pacote com \texttt{lintian}
		\begin{itemize}
			\item Embora não seja um requerimento estrito, é recomendado que os pacotes
enviados para Debian sejam \textsl{lintian-clean} (passaram o teste do
lintian)
		\hbr
			\item Mais problemas podem ser listados usando \texttt{lintian -EviIL +pedantic}
		\hbr
			\item Algumas dicas:
				\begin{itemize}
					\item Remova os ficheiros que você não precisa em \texttt{debian/}
		\hbr
					\item Preencha \texttt{debian/control}
						\hbr
					\item Instale o executável para \texttt{/usr/games} ao sobrepor
\texttt{dh\_auto\_configure}
		\hbr
					\item Use flags de compilador \textsl{hardening} para aumentar a segurança.\\ Veja
\url{https://wiki.debian.org/Hardening}
				\end{itemize}
		\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{Passo a passo\ldots (6)}
		\begin{itemize}
	\item Compare o seu pacote com aquele já empacotado em Debian:
		\begin{itemize}
			\item Divide os ficheiros de dados para um segundo pacote, que é o mesmo para
todas as arquitecturas ($\rightarrow$ poupa espaço no arquivo de Debian)
				\hbr
			\item Instala um ficheiro .desktop (para os menus de GNOME/KDE) e também o integra
no menu Debian
				\hbr
			\item Corrige alguns problemas menores usando patches
		\end{itemize}
\end{itemize}
\end{frame}

\subsection{Sessão prática 3: empacotando uma biblioteca Java}
\begin{frame}{Sessão prática 3: empacotando uma biblioteca Java}
\begin{enumerate}
	\item Faça uma leitura rápida a alguma documentação sobre empacotamento de 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 Descarregue o IRClib de \url{http://moepii.sourceforge.net/}
		\br
	\item Empacote-o
\end{enumerate}
\end{frame}

\begin{frame}{Passo a passo\ldots}
\begin{itemize}
	\item \texttt{apt-get install javahelper}
		\hbr
	\item Crie um pacote fonte básico: \texttt{jh\_makepkg}
		\begin{itemize}
			\item Biblioteca
			\item Nenhum
			\item Compilador/executor em tempo real Livre Predefinido
		\end{itemize}
		\hbr
	\item Observe e corrija \texttt{debian/*}
		\hbr
	\item \texttt{dpkg-buildpackage -us -uc} ou \texttt{debuild}
		\hbr
	\item \texttt{lintian}, \texttt{debc}, etc.
		\hbr
	\item Compare o seu resultado com o pacote fonte \texttt{libirclib-java}
\end{itemize}
\end{frame}

\subsection{Sessão prática 4: empacotar uma gema Ruby}
\begin{frame}{Sessão prática 4: empacotar uma gema Ruby}
\begin{enumerate}
	\item Dê uma leitura rápida a alguma documentação acerca de empacotamento de
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 pacote \texttt{gem2deb})
		\end{itemize}
		\hbr
	\item Crie um pacote fonte Debian básico a partir da gema \texttt{peach}:\\ 
\texttt{gem2deb peach}
	\hbr
	\item Melhore-o para que se torne num pacote Debian apropriado
\end{enumerate}
\end{frame}

\begin{frame}{Passo a passo\ldots}
\texttt{gem2deb peach}:
\begin{itemize}
\item Descarrega a gema de rubygems.org
\item Cria um arquivo .orig.tar.gz apropriado e descompacta-o
\item Inicializa um pacote fonte Debian baseado nos meta-dados da gema
	\begin{itemize}
		\item Chamado \texttt{ruby-\textsl{gemname}}
	\end{itemize}
\item Tenta compilar o pacote binário Debian (isto pode falhar)
\end{itemize}
\br
\texttt{dh\_ruby} (incluído em \textsl{gem2deb}) faz as tarefas específicas
de Ruby:
\begin{itemize}
	\item Compila extensões de C para cada versão de Ruby
	\item Copie os ficheiros para o sue directório de destino
	\item Actualiza shebangs nos scripts executáveis
	\item Corra os testes definidos em \texttt{debian/ruby-tests.rb},
\texttt{debian/ruby-tests.rake}, ou \texttt{debian/ruby-test-files.yaml},
assim como várias outras verificações
\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Passo a passo\ldots (2)}
Melhore o pacote gerado
\begin{itemize}
	\item Corra \texttt{debclean} para limpar a árvore fonte. Veja em
\texttt{debian/}.
		\hbr
	\item \texttt{changelog} e \texttt{compat} devem estar correctos
		\hbr
	\item Edite \texttt{debian/control}: melhore \texttt{Description}
		\hbr
	\item Escreva um ficheiro \texttt{copyright} apropriado com base nos ficheiros do
autor
		\hbr
	\item Compile o pacote
		\hbr
	\item Compare o seu pacote com o pacote \texttt{ruby-peach} no arquivo Debian
\end{itemize}
\end{frame}

\subsection{Sessão prática 5: empacotar um módulo Perl}
\begin{frame}[fragile=singleslide]{Sessão prática 5: empacotar um módulo Perl}
\begin{enumerate}
	\item Faça uma leitura rápida a alguma documentação sobre empacotamento de 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)} (in the \texttt{pkg-perl-tools}
package)
		\end{itemize}
		\hbr
	\item Crie um pacote fonte Debian básico a partir da \texttt{Acme} distribuição
CPAN:\\ \verb|dh-make-perl --cpan Acme|
	\hbr
	\item Melhore-o para que se torne num pacote Debian apropriado
\end{enumerate}
\end{frame}

\begin{frame}[fragile=singleslide]{Passo a passo\ldots}
\verb|dh-make-perl --cpan Acme|:
\begin{itemize}
\item Descarrega o tarball a partir de CPAN
\item Cria um arquivo .orig.tar.gz apropriado e descompacta-o
\item Inicializa um pacote fonte Debian baseado nos meta-dados da distribuição
	\begin{itemize}
		\item Chamado \texttt{lib\textsl{distname}-perl}
	\end{itemize}
\end{itemize}
\end{frame}

\begin{frame}[fragile=singleslide]{Passo a passo\ldots (2)}
Melhore o pacote gerado
\begin{itemize}
	\item \texttt{debian/changelog}, \texttt{debian/compat},
\texttt{debian/libacme-perl.docs}, e \texttt{debian/watch} devem estar
correctos
		\hbr
	\item Edita \texttt{debian/control}: melhora \texttt{Description}, e remove a
"boilerplate" no fundo
		\hbr
	\item Edita \texttt{debian/copyright}: remove o parágrafo "boilerplate" no topo,
adiciona anos e copyright à estrofe de 	exttt{Files:\hspace{0.3em}*}
\end{itemize}
\end{frame}


\section*{Tradução}
\begin{frame}{Tradução}
 Américo Monteiro
 \hbr

 Se encontrar algum erro na tradução deste documento, por favor comunique para
 \href{mailto:Américo Monteiro}{\texttt{<a\_monteiro@gmx.com>}}.
 ou
 \href{mailto:Equipa Debian de Tradução Portuguesa}{\texttt{<traduz@debianpt.org>}}.
\end{frame}
\end{document}
