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