<appendix id="installation">
<title
>Instalação</title>

<sect1 id="general_instructions">
<title
>Instruções Gerais</title>
<para
> A maneira mais fácil de instalar o &umbrello; é obter um pacote binário pré-compilado para seu sistema. Se você prefere compilar seus aplicativos ou se está executando um sistema para o qual não existem pacotes binários, você pode baixar as fontes e seguir as instruções para instalações da fonte. </para>

<!-- LW: Removing, but leaving intact. No point having our translators
work on this, it's largely irrelevant to apps in KDE releases, but
umbrello developers might want to make a standalone release before 3.2
is done -->


<!--
<para>

The Umbrello developers only release source packages of the program, and these source packages are
the only ones we can officially support. However, 
FIXME I officially support the packages I make
We understand that for many users it is difficult to
install a program from sources, so we try to build pre-compiled packages for the systems/distributions
we have access to.
If you want to install Umbrello from a binary package  
you can check if there is a pre-compiled package available for your platform at
<ulink url="http://uml.sourceforge.net"
>Umbrello's home page</ulink
>.
There we will publish the packages we can make ourselves, as well as packages made by 3rd parties for
the systems we do not have access to.
</para>

<para>
If you can make a binary package for a distribution for which there are currently no packages available
at our site, please consider contacting the &umbrello;  developers and contributing your package so that
other users can benefit from it.
</para
> -->

</sect1>

<sect1 id="binary_installation">
<title
>Instalação do Pacote Binário</title>
<para
> Para instalar o Umbrello a partir de um pacote pré-compilado, use o programa de gerenciador de pacote que vem com seu sistema. Você pode também chamar o gerenciador de pacote diretamente da linha de comando. Por exemplo, para instalar um pacote deb mude para o diretório onde você baixou o arquivo e entre com o seguinte comando: <screen width="40">
<prompt
>% </prompt
><userinput
>dpkg -i umbrello-1.1-i386.deb</userinput>
</screen
> </para>
<para
> No caso de pacotes rpm o comando a inserir é <screen width="40">
<prompt
>% </prompt
><userinput
>rpm -i umbrello-1.1-i386.rpm</userinput>
</screen
> </para>
<para
> Para outras plataformas, por favor consulte a documentação fornecida com seu sistema. </para>
</sect1>

<sect1 id="source_installation">
<title
>Instalação do Código</title>

&install.compile.documentation;

<!-- LW: Leaving intact, in case umbrello makes a standalone release prior to KDE 3.2. -->
<!-- Once Umbrello is being released as normal with the rest of KDE, individual -->
<!-- instructions make no sense, and can be removed -->
<!--
<para>
When installing from sources it is important that you check the README and INSTALL files 
for the latest information on this program.
</para>
<para>
In order to install the program, the first step is to unpack the sources so that you can build them.
To do this, cd into the directory where you downloaded the archive file and execute the following command.
<screen width="40">
<prompt
>% </prompt
><userinput
>tar -xvzf umbrello-1.1.tar.gz</userinput>
</screen>
</para>
<para>
This will create a new directory into which all source files are contained.
</para>
<para>
The next step is to change into this new directory to configure and build the program.
For this you need to execute following commands:
<screen width="40">
<prompt
>% </prompt
><userinput
>./configure &ndash;&ndash;prefix=!lt-internal!path to your KDE base directory here!gt-internal!</userinput>
<prompt
>% </prompt
><userinput
>make</userinput>
</screen>
</para>
<para>
Please substitute the correct path for your base KDE installation in the <quote
>&ndash;-prefix</quote
>, as this
will make sure Umbrello finds all the files and libraries it needs to work correctly when you install it.
</para>
<para>
When the build process finishes, the only thing left to do is to install the files to their final
destination. Normally you will need root access for this, in which case you should execute
<screen width="40">
<prompt
>% </prompt
><userinput
>su</userinput>
</screen>
</para>
<para>
and then enter the <systemitem
> root password. To finally install the program simply type
<screen width="40">
<prompt
>% </prompt
><userinput
>make install</userinput>
</screen
>                           
</para
> -->
</sect1>


<sect1 id="running_program">
<title
>Iniciando o programa</title>
<para
> Uma vez que você tenha instalado o &umbrello;, você pode executá-lo a partir de uma linha de comando digitando: <screen>
<prompt
>%</prompt
> <userinput
><command
>umbrello</command
></userinput>
</screen
> </para>
<para
> Ou selecionando a entrada do &kmenu;. O programa está localizado no menu <guimenu
>Desenvolvimento</guimenu
> como <guimenuitem
>Modelador UML Umbrello</guimenuitem
>. </para>

<screenshot
> <screeninfo
>janela principal do &umbrello;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="pics/umbrello-main-screen.png" format="PNG"/> </imageobject
> <textobject
> <phrase
></phrase
> </textobject
> <caption
> <para
> </para
> </caption
> </mediaobject
> </screenshot>

</sect1>
</appendix>

