website view pt/doc/manuals/tazwok.pt.html @ rev 446

pt: update manuals
author Claudinei Pereira <claudinei@slitaz.org>
date Wed May 06 03:14:45 2009 +0000 (2009-05-06)
parents 4dfe933b4257
children c7af4341a305
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt">
4 <head>
5 <title>Manual Tazwok</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-07-18 20:30:00" />
10 <style type="text/css"><!--
11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
12 #header { background: #f0ba08; color: black; height: 50px;
13 border-top: 1px solid black; border-bottom: 1px solid black; }
14 #content { margin: 0px 50px 26px 50px; }
15 h1 { margin: 14px 0px 0px 16px; }
16 li { line-height: 1.4em; }
17 pre { padding: 5px; color: black; background: #e1e0b0; }
18 pre.script { padding: 10px; color: black; background: #e8e8e8;
19 border: 1px inset #333333; }
20 code { font-size: 100%; color: #669900; background: transparent; }
21 hr { color: white; background: white; height: 1px; border: 0; }
22 --></style>
23 </head>
24 <body bgcolor="#ffffff">
25 <div id="header">
26 <h1><font color="#3e1220">Manual Tazwok</font></h1>
27 </div>
28 <hr />
29 <!-- Start content -->
30 <div id="content">
31
32 <h2>NOME</h2>
33 <p>
34 Tazwok - SliTaz sources and packages cooker.
35 </p>
36
37 <h2>SINTAXE</h2>
38 <pre> tazwok [command] [package|list|category|dir] [--option]
39 </pre>
40
41 <h2>DESCRIÇÃO</h2>
42 <p>
43 O Tazwok é uma ferramenta de linha de comando para configurar e compilar um pacote
44 a partir de seus fontes. Ele também pode criar pacotes prontos para serem
45 utilizados pelo Tazpkg, o gerenciador de pacotes do SliTaz. Para funcionar,
46 o Tazwok usa um diretório contendo a receita e as informações necessárias para
47 a construção do pacote. Esta receita também pode ser usada pelo Tazpkg e
48 consiste de diferentes variáveis e funções. Tazwok usa o arquivo de configuração
49 /etc/tazwok.conf para achar o caminho até o wok, os fontes do pacote e gerar
50 os pacotes .tazpkg. Também pode gerar uma lista de pacotes com seus md5, criar
51 pacotes interativamente, buscar por pacotes no wok, limpar arquivos gerados e
52 até mesmo produzir diferentes pacotes ao mesmo tempo (ver os comandos disponíveis).
53 </p>
54 <p>
55 O Tazwok é inteiramente construído a partir do zero usando SHell Script.
56 Compatível com o Bash, roda sobre o Ash - parte do projeto Busybox. O Tazwok é
57 distribuído sob a licença livre GNU GPL V3. O Livro de Receitas do SliTaz
58 também fornece documentação sobre o Tazwok e receitas de pacotes.
59 </p>
60
61 <h2>COMANDOS</h2>
62 <h3><font color="#6c0023">usage</font></h3>
63 <p>
64 Mostra um resumo dos comandos disponíveis e uma pequena descrição em inglês:
65 </p>
66 <pre> # tazwok usage
67 </pre>
68 <h3><font color="#6c0023">stats</font></h3>
69 <p>
70 Mostra informações contidas no arquivo de configuração e o número de pacotes
71 disponíveis no wok:
72 </p>
73 <pre> # tazwok stats
74 </pre>
75 <h3><font color="#6c0023">list</font></h3>
76 <p>
77 Permite listar todos os pacotes que se encontram no wok ou as categorias padrão
78 (você pode criar a sua própria). Também lista os pacotes por categoria:
79 </p>
80 <pre> # tazwok list
81 # tazwok list category
82 </pre>
83 <h3><font color="#6c0023">info</font></h3>
84 <p>
85 Este comando fornece informações sobre o pacote - nome, versão, etc. Informações
86 nas receitas básicas de pacote são como as mostradas pelo Tazpkg sobre os
87 pacotes instalados:
88 </p>
89 <pre> # tazwok info package
90 </pre>
91 <h3><font color="#6c0023">check-log</font></h3>
92 <p>
93 Ao compilar um binário a partir dos fontes, o Tazwok gera algumas mensagens que
94 são armazenadas no arquivo "process.log". Para visualizá-lo:
95 </p>
96 <pre> # tazwok check-log package
97 </pre>
98 <h3><font color="#6c0023">search</font></h3>
99 <p>
100 Permite procurar por pacotes no wok. Pode-se especificar uma palavra-chave ou o
101 nome do pacote:
102 </p>
103 <pre> # tazwok search name
104 </pre>
105 <h3><font color="#6c0023">compile</font></h3>
106 <p>
107 Este comando utiliza as regras de compilação (compile_rules) especificadas na
108 receita do pacote em questão para compilar os fontes. Note que as regras de
109 compilação nem sempre são necessárias - pacotes gerados pelos comandos "genpkg"
110 e "cook" também podem compilar fontes e generar pacotes binários. Exemplo:
111 </p>
112 <pre> # tazwok compile package
113 </pre>
114 <h3><font color="#6c0023">genpkg</font></h3>
115 <p>
116 "Genpkg" gera um pacote .tazpkg usando as "genpkg_rules" encontradas na receita.
117 Uma vez que o pacote é gerado, ele é armazenado no repositório de pacotes
118 especificado no arquivo de configuração (para visualizar rode "tazwok stats").
119 O pacote pode ser usando pelo Tazpkg ou pelo Tazlito para gerar uma distribuição
120 LiveCD. Note que arquivos padrão como local, pixmap e name.desktop são
121 automaticamente copiados para $fs/usr/share, caso os caminhos padrões sejam
122 informados ou se o arquivo existe no diretório /stuff. Exemplo de utilização
123 do "genpkg":
124 </p>
125 <pre> # tazwok genpkg package
126 </pre>
127 <h3><font color="#6c0023">cook</font></h3>
128 <p>
129 Simplesmente compila e gera o pacote:
130 </p>
131 <pre> # tazwok cook package
132 </pre>
133 <h3><font color="#6c0023">cook-list</font></h3>
134 <p>
135 Este comando roda o "tazwok cook" em todos os pacotes contidos no arquivo de
136 listagem especificado como argumento na linha de comando. "Cook-list" é usado,
137 por exemplo, para gerar o sistema base (base-system) sem a glibc. No SliTaz,
138 você encontra exemplo de listas de geração no diretório /usr/share/examples/tazwok.cooklists:
139 </p>
140 <pre> # tazwok cook-list packages.cooklist
141 </pre>
142 <h3><font color="#6c0023">clean</font></h3>
143 <p>
144 Deleta todos os arquivos gerados na compilação e empacotamento:
145 </p>
146 <pre> # tazwok clean package
147 </pre>
148 <h3><font color="#6c0023">new-tree</font></h3>
149 <p>
150 O comando "new-tree" cria um novo pacote no wok e pode ser usado interativamente.
151 Ele cria um diretório para o pacote e uma receita, que pode ser editada por seu
152 editor de textos favorito e que pode ser configurada pela opção --interactive.
153 Para obter ajuda você pode dar uma olhada nas receitas existentes ou ler a
154 documentação no Livro de Receitas. Exemplo:
155 </p>
156 <pre> # tazwok new-tree package
157 # tazwok new-tree package --interactive
158 </pre>
159 <h3><font color="#6c0023">gen-list</font></h3>
160 <p>
161 O comando "gen-list" gera uma lista de pacotes (packages.list), seus md5
162 (packages.md5) e uma lista de opções de pacotes contendo informações
163 (packages.txt). As listas são criadas na base de pacotes contidos em um
164 diretório. A lista em formato texto é construída usando uma receita contida
165 no wok. O diretório de pacotes padrão é aquele especificado no arquivo de
166 configuração, mas você pode especificá-lo na linha de comando. Exemplos:
167 </p>
168 <pre> # tazwok gen-list
169 # tazwok gen-list --text
170 # tazwok gen-list /path/to/repository
171 </pre>
172 <h3><font color="#6c0023">gen-clean-wok and clean-wok</font></h3>
173 <p>
174 O comando "gen-clean-wok" cria um novo wok, o que é útil para salvar uma versão
175 do wok ou criar uma cópia de testes. Rodar "clean-wok" limpa todos os pacotes
176 no wok atual e apaga todos os arquivos gerados. Para gerar um wok limpo ou limpar
177 o wok atual:
178 </p>
179 <pre> # tazwok gen-clean-wok path/to/new-wok
180 # tazwok clean-wok
181 </pre>
182 <h3><font color="#6c0023">remove</font></h3>
183 <p>
184 Remove o pacote especificado do wok, incluindo receitas e outros arquivos
185 relacionados:
186 </p>
187 <pre> # tazwok remove package
188 </pre>
189 <h3><font color="#6c0023">build-depends</font></h3>
190 <p>
191 Gera uma lista de pacotes para a construção do wok:
192 </p>
193 <pre> # tazwok build-depends
194 </pre>
195 <h3><font color="#6c0023">cmp|compare</font></h3>
196 <p>
197 Compara o wok e os pacotes preparados e gera um relatório. Pacotes
198 obsoletos podem ser deletados com a opção --remove. A opção --cook
199 compila os pacotes. Exemplos:
200 </p>
201 <pre> # tazwok compare
202 # tazwok compare --remove
203 # tazwok compare --cook
204 </pre>
205 <h3><font color="#6c0023">check</font></h3>
206 <p>
207 Checa as receitas em busca de erros comuns:
208 </p>
209 <pre> # tazwok check
210 </pre>
211
212 <h2>MANTENEDOR</h2>
213 <p>
214 Christophe Lincoln &lt;pankso at slitaz.org&gt;
215 </p>
216
217 <!-- End content -->
218 </div>
219
220 </body>
221 </html>