<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&ark;">
<!ENTITY % Brazilian-Portuguese "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<title
>Manual do usuário do KDE</title>
<author
><personname
> <firstname
>Lauri</firstname
> <surname
>Watts</surname
> </personname
> &Lauri.Watts.mail;</author>
<date
>25 de fevereiro de 2005</date
> <productname
>K Desktop Environment</productname
> </refentryinfo>

<refmeta>
<refentrytitle
><command
>&kappname;</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
><command
>ark</command
></refname>
<refpurpose
>Uma ferramenta de arquivamento do &kde;</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>ark</command
> <group
> <option
>--extract</option
> <option
>--extract-to</option
> <option
>--add</option
> <option
>--add-to</option
> <option
>--guess-name</option
> </group
> <arg choice="opt"
>pasta</arg
> <arg choice="opt"
>arquivos</arg
> <arg choice="opt"
>arquivo_compactado</arg
> <arg choice="opt"
>Opções genéricas do KDE</arg
> <arg choice="opt"
>Opções genéricas do Qt</arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O &kappname; é um programa para gerenciar vários formatos de arquivos compactados  no ambiente &kde;. Os arquivos compactados podem ser visualizados, extraídos, criados e modificados com o &kappname;. O programa pode manejar vários formatos como <application
>tar</application
>, <application
>gzip</application
>, <application
>bzip2</application
>, <application
>zip</application
>, <application
>rar</application
> e <application
>lha</application
> (se os programas em linha de comando apropriados estão instalados). O &kappname; pode trabalhar em conjunto com o &konqueror; no ambiente &kde; para manejar os arquivos compactados, se você instalar o plug-in de integração do &konqueror; disponível no pacote kdeaddons.</para>

</refsect1>

<refsect1>
<title
>Opções</title>

<variablelist>
<varlistentry>
<term
><option
>--extract</option
></term>
<listitem>
<para
>Abre o diálogo de extração, fecha quando termina</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--extract-to <replaceable
>pasta</replaceable
> <replaceable
>arquivo_compactado</replaceable
></option
></term>
<listitem
><para
>Extrair <replaceable
>arquivo compactado</replaceable
> para <replaceable
>pasta</replaceable
>. Sair quando terminar. A <replaceable
>pasta</replaceable
> será criada se não existir.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--add <replaceable
>arquivos</replaceable
></option
></term>
<listitem>
<para
>Perguntar pelo nome do arquivo compactado a adicionar os <replaceable
>arquivos</replaceable
>. Sair quando terminar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--add-to <replaceable
>arquivos</replaceable
> <replaceable
>arquivo_compactado</replaceable
></option
></term>
<listitem>
<para
>Adicionar <replaceable
>arquivos</replaceable
> para o <replaceable
>arquivo compactado</replaceable
>. Sair quando terminar. O <replaceable
>arquivo compactado</replaceable
> será criado se não existir.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--guess-name <replaceable
>pasta</replaceable
> <replaceable
>arquivo_compactado</replaceable
></option
></term>
<listitem>
<para
>Usado com <option
>--extract-to</option
>. Quando especificado, o <replaceable
>arquivo compactado</replaceable
> será extraído para uma subpasta da <replaceable
>pasta</replaceable
>, cujo nome será o nome do <replaceable
>arquivo compactado sem a extensão do mesmo.</replaceable
></para>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1>
<title
>Ambiente</title>
<variablelist>
<varlistentry>
<term
>$<envar
>PATH</envar
></term>
<listitem>
<para
>Os programas em linha de comando para trabalhar com os arquivos compactados que você deseja manejar no &kappname; devem estar disponível no seu $<envar
>PATH</envar
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title
>Exemplos</title>

<variablelist>
<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>--extract-to --guess-name</option
> <parameter
>.</parameter
> <parameter
>Um-arquivo_compactado.tar.bz2</parameter
></userinput
></term>
<listitem>
<para
>Extrairá <filename
>Um-arquivo_compactado.tar.bz2</filename
> numa pasta chamada <filename class="directory"
>Um-arquivo_compactado</filename
> no diretório atual.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>--add-to</option
> <filename
>*.jpg</filename
> <filename
>figuras.tar.bz2</filename
></userinput
></term>
<listitem>
<para
>Adicionar todos os arquivos terminando em *.jpg para o arquivo compactado chamado <filename
>figuras.tar.bz2</filename
>, criando-o se o mesmo não existir.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title
>Veja também</title>
<para
>tar(1), gzip(1), bzip2(1), zip(1), rar(1), lha(1)</para>

<para
>A documentação mais detalhada para o usuário está disponível em <ulink url="help:/ark"
>help:/ark</ulink
> (tanto poderá inserir esta <acronym
>URL</acronym
> no &konqueror;, como executar o comando <userinput
><command
>khelpcenter</command
> <parameter
>help:/ark</parameter
></userinput
>).</para>

</refsect1>

<refsect1>
<title
>Autores</title>
<para
>O &ark; é mantido por <personname
><firstname
>Henrique</firstname
><surname
>Pinto</surname
></personname
> <email
>stampede@coltec.ufmg.br</email
></para>
<para
>Esta página de manual foi escrita por &Lauri.Watts; &Lauri.Watts.mail; para o &kde; 3.4.</para>
</refsect1>

</refentry>
