tazwok annotate doc/tazwok.pt.html @ rev 495

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