fixing docs

git-svn-id: svn+slack://slack.fluxo.info/var/svn/simplepkg@419 04377dda-e619-0410-9926-eae83683ac58

4 files changed, 158 insertions, 0 deletions

diff --git a/trunk/doc/mkbuild.tex b/trunk/doc/mkbuild.pt_BR.tex
index 9e620ae..9e620ae 100644
--- a/trunk/doc/mkbuild.tex
+++ b/trunk/doc/mkbuild.pt_BR.tex
diff --git a/trunk/doc/simplaret.tex b/trunk/doc/simplaret.tex
new file mode 100644
index 0000000..c3e1256
--- /dev/null
+++ b/trunk/doc/simplaret.tex
@@ -0,0 +1,158 @@
+\documentclass{article}
+\usepackage[brazilian]{babel}
+\usepackage[latin1]{inputenc}
+\usepackage[dvips]{graphics}
+\usepackage{hyperref}
+\usepackage{html,makeid}
+
+\title{Simplaret: ferramenta para obtenção de pacotes}
+\author{Silvio Rhatto}
+
+\begin{document}\label{start}
+\maketitle
+
+\begin{abstract}
+O \emph{simplaret} é a ferramenta do \htmladdnormallink{simplepkg}{http://slack.sarava.org/node/12} utilizada para obter pacotes de repositórios locais ou remotos. Com ele, você pode não só baixar pacotes do seu sistema \emph{slackware} como também pode baixar de qualquer versão ou arquitetura cujo repositório siga os \htmladdnormallink{mirror guidelines}{http://www.slackware.com/getslack/mirroring_guidelines.txt}, permitindo que você gerencie facilmente todas as suas jaulas e instalações de slackware, independentemente da arquitetura ou versão que elas utilizem. English version \htmladdnormallink{here}{/node/17}.
+
+Ele foi inspirado no comportamento do swaret mas não pretende de modo algum chegar no nível de complexidade deste, mas sim executar a obtenção de pacotes de um modo diferente. Sua finalidade é apenas baixar pacotes para que os aplicativos do \emph{simplepkg} possam utilizá-lo posteriormente. O \emph{simplaret} ainda pode ser usado sozinho para procurar e baixar pacotes.
+\end{abstract}
+
+\section{Obtendo e instalando}
+
+O \emph{simplaret} acompanha o \emph{simplepkg} e por isso sua instalação e configuração é dada no \htmladdnormallink{artigo do simplepkg}{/node/12}. Ele utiliza o mesmo arquivo de configuração do simplepkg, o \emph{/etc/simplepkg/simplepkg.conf} e guarda as definições de repositórios em \emph{/etc/simplepkg/repos.conf}.
+
+\section{Organização do repositório}
+
+O repositório de armazenamento local do simplaret é definido pelo parâmetro \emph{STORAGE} e é organizado da seguinte maneira:
+
+\begin{verbatim}
+$STORAGE/arch/version/
+\end{verbatim}
+
+Pacotes obtidos num repositório que não seja oficial da distribuição ficam em
+
+\begin{verbatim}
+$STORAGE/arch/version/repository-name/
+\end{verbatim}
+
+Isso quer dizer, por exemplo, que pacotes do slackware 10.2 ficariam em
+
+\begin{verbatim}
+$STORAGE/i386/10.2/
+\end{verbatim}
+
+e os pacotes obtidos a partir do \htmladdnormallink{repositório slamd64 do slack.sarava.org}{/node/11} ficaria, por exemplo, em
+
+\begin{verbatim}
+$STORAGE/x86_64/10.2/slack.sarava.org/
+\end{verbatim}
+
+No arquivo de repositórios (\emph{/etc/simplepkg/repos.conf}), as definições de repositório seguem o seguinte esquema, semelhante ao formato de configuração do \emph{swaret}:
+
+\begin{verbatim}
+ROOT-i386="http://slack.sarava.org/slackware/"
+ROOT-x86_64="http://ftp.heanet.ie/pub/slamd64/"
+REPOS-i386-10.2="slack.sarava.org%http://slack.sarava.org/packages/slackware/slackware-10.2/"
+REPOS-x86_64-10.2="slack.sarava.org%http://slack.sarava.org/packages/slamd64/slamd64-10.2/"
+\end{verbatim}
+
+Repositórios definidos como \emph{ROOT} são aqueles que
+
+\begin{itemize}
+  \item Possuem pacotes da distribuição oficial ou
+  \item Estão organizados por versão, de acordo com os \htmladdnormallink{mirror guidelines}{http://www.slackware.com/getslack/mirroring_guidelines.txt}
+\end{itemize}
+
+Já os repositórios definidos como \emph{REPOS} são aqueles que contém pacotes para uma versão específica e/ou que são não-oficiais.
+
+Quando o \emph{simplaret} busca ou obtém um pacote, a precedência pelos repositórios é dada às definições de \emph{ROOT} e em seguinda às de \emph{REPOS}. As definições \emph{REPOS} ainda devem possuir, além da \emph{URL} do repositório, um nome para identificá-lo, sendo que esses dois campos são separados por um delimitador.
+
+\section{Baixando as listas de pacotes}
+
+Após configurá-lo, é preciso atualizar a lista de pacotes:
+
+\begin{verbatim}
+simplaret --update
+\end{verbatim}
+
+Isso atualiza a lista de pacotes da arquitetura definida em \emph{DEFAULT\_ARCH} e da versão \emph{DEFAULT\_VERSION} apenas. Se você quiser forçar a atualização, por exemplo, para a arquitetura \emph{x86\_64} (\emph{slamd64}) e versão \emph{10.2}, basta
+
+\begin{verbatim}
+ARCH=x86_64 VERSION=10.2 simplaret --update
+\end{verbatim}
+
+\section{Buscando pacotes}
+
+Para buscar um pacote, esses comandos servem de exemplo:
+
+\begin{verbatim}
+simplaret --search coreutils
+\end{verbatim}
+
+pacote para o \htmladdnormallink{Slack/390}{http://www.slack390.org/},
+
+\begin{verbatim}
+ARCH=s390 simplaret --search x11
+\end{verbatim}
+
+e para \emph{slackware 10.1} com pacotes adicionais em \emph{i686},
+
+\begin{verbatim}
+ARCH=i686 VERSION=10.1 simplaret --search icecast
+\end{verbatim}
+
+\section{Baixando um pacote}
+
+Para baixar um pacote:
+
+\begin{verbatim}
+simplaret --get icecast
+\end{verbatim}
+
+O simplaret baixa o primeiro pacote na ordem de precedência dos repositórios. Versões futuras deverão conter uma opção que force a obtenção do pacote de um repositório específico.
+
+\section{Baixando patches}
+
+Através do parâmetro de configuração \emph{PATCHES\_DIR} é possível especificar uma pasta
+onde os patches de cada distribuição serão armazenados, organizados também por arquitetura.
+
+Por exemplo, patches do slackware 10.2 ficarão sempre em
+
+\begin{verbatim}
+$PATCHES_DIR/i386/10.2/
+\end{verbatim}
+
+Os patches na verdade são baixados através de um \emph{simplaret --get} e armazenados na subpasta de \emph{\$STORAGE} correspondente e apenas um link simbólico é mantido em \emph{\$PATCHES\_DIR/\$ARCH/\$VERSION}.
+
+Para baixar os patches, use uma chamada do tipo
+
+\begin{verbatim}
+ARCH=arquitetura VERSION=versao simplaret --get-patches
+\end{verbatim}
+
+E os patches dessa arquitetura e versão serão baixados.
+
+\section{Apagando pacotes}
+
+O repositório de pacotes de uma arquitetura e versão pode ser apagado com o comando
+
+\begin{verbatim}
+simplaret --purge
+\end{verbatim}
+
+\section{Mas pra quê serve isso?}
+
+Você pode estar se perguntando: \emph{quem utilizaria uma ferramenta que baixa pacotes de várias arquiteturas?}
+
+O \emph{simplaret} foi escrito tendo em mente um ambiente \emph{*86} onde várias \emph{jaulas} de diferentes arquiteturas estão instaladas. Suponha por exemplo uma máquina \emph{x86\_64} que possua as seguintes jaulas:
+
+\begin{itemize}
+  \item slamd64 10.2
+  \item slackware 10.2
+  \item slackware 10.1 com pacotes adicionais em \emph{i686}
+  \item \htmladdnormallink{uSlack}{http://gnuden.sarava.org} (\emph{uClibc para i386})
+\end{itemize}
+
+O condenado/a em questão que roda todas essas jaulas, pelos mais diversos motivos, pode ter uma grande dor de cabeça para manter os pacotes em ordem de forma manual. Com o \emph{simplaret} e eventualmente com o \emph{simplepkg}, a tarefa se torna trivial.
+
+\end{document}
diff --git a/trunk/doc/simplepkg.pdf b/trunk/doc/simplepkg.pt_BR.pdf
index 6aa552e..6aa552e 100644
--- a/trunk/doc/simplepkg.pdf
+++ b/trunk/doc/simplepkg.pt_BR.pdf
diff --git a/trunk/doc/simplepkg.tex b/trunk/doc/simplepkg.pt_BR.tex
index 2a3bfa7..2a3bfa7 100644
--- a/trunk/doc/simplepkg.tex
+++ b/trunk/doc/simplepkg.pt_BR.tex