new docbook layout (prep for translations migration to PO)

git-svn-id: https://svn.jboss.org/repos/hibernate/core/trunk@14080 1b8cb986-b30d-0410-93ca-fae66ebed9b2

documentation/manual/pt-BR/src/main/docbook/Hibernate_Reference.xml

@@ -0,0 +1,73 @@
+<?xml version='1.0' encoding="iso-8859-1"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+        <!ENTITY versionNumber "3.3.0.alpha1">
+        <!ENTITY copyrightYear "2004">
+        <!ENTITY copyrightHolder "Red Hat Middleware, LLC.">
+]>
+
+<book>
+
+    <bookinfo>
+        <title>HIBERNATE - Relational Persistence for Idiomatic Java</title>
+        <subtitle>Documentação da Referência do Hibernate</subtitle>
+        <releaseinfo>&versionNumber;</releaseinfo>
+        <productnumber>&versionNumber;</productnumber>
+        <issuenum>1</issuenum>
+        <mediaobject>
+            <imageobject role="fo">
+                <imagedata fileref="images/hibernate_logo_a.png" align="center" />
+            </imageobject>
+            <imageobject role="html">
+                <imagedata fileref="images/hibernate_logo_a.png" depth="3cm" />
+            </imageobject>
+        </mediaobject>
+        <copyright>
+            <year>&copyrightYear;</year>
+            <holder>&copyrightHolder;</holder>
+        </copyright>
+        <xi:include href="translators.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="legal_notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="legal_notice2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    </bookinfo>
+
+    <toc/>
+
+    <xi:include href="content/preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/basic_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/collection_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/association_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/component_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/inheritance_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/session_api.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/batch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/query_hql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/query_criteria.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/query_sql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/filters.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/performance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/toolset_guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/example_parentchild.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/example_weblog.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/example_mappings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/best_practices.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</book>
+

documentation/manual/pt-BR/src/main/docbook/content/architecture.xml

@@ -1,4 +1,19 @@
-<chapter id="architecture">
+<!--
+  ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
+  ~
+  ~ This copyrighted material is made available to anyone wishing to use, modify,
+  ~ copy, or redistribute it subject to the terms and conditions of the GNU
+  ~ Lesser General Public License, v. 2.1. This program is distributed in the
+  ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
+  ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+  ~ Lesser General Public License for more details. You should have received a
+  ~ copy of the GNU Lesser General Public License, v.2.1 along with this
+  ~ distribution; if not, write to the Free Software Foundation, Inc.,
+  ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+  ~
+  ~ Red Hat Author(s): Steve Ebersole
+  -->
+<chapter id="architecture">
 
     <title>Arquitetura</title>
 
@@ -11,10 +26,10 @@
 
         <mediaobject>
             <imageobject role="fo">
-                <imagedata fileref="images/overview.svg" format="SVG" align="center"/>
+                <imagedata fileref="../images/overview.svg" format="SVG" align="center"/>
             </imageobject>
             <imageobject role="html">
-                <imagedata fileref="../shared/images/overview.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/overview.png" format="PNG" align="center"/>
             </imageobject>
         </mediaobject>
 
@@ -34,10 +49,10 @@
 
         <mediaobject>
             <imageobject role="fo">
-                <imagedata fileref="images/lite.svg" format="SVG" align="center"/>
+                <imagedata fileref="../images/lite.svg" format="SVG" align="center"/>
             </imageobject>
             <imageobject role="html">
-                <imagedata fileref="../shared/images/lite.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/lite.png" format="PNG" align="center"/>
             </imageobject>
         </mediaobject>
 
@@ -48,10 +63,10 @@
 
         <mediaobject>
             <imageobject role="fo">
-                <imagedata fileref="images/full_cream.svg" format="SVG" align="center"/>
+                <imagedata fileref="../images/full_cream.svg" format="SVG" align="center"/>
             </imageobject>
             <imageobject role="html">
-                <imagedata fileref="../shared/images/full_cream.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/full_cream.png" format="PNG" align="center"/>
             </imageobject>
         </mediaobject>
 

documentation/manual/pt-BR/src/main/docbook/content/configuration.xml

@@ -1384,7 +1384,7 @@ hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting>
         </para>
 
         <para>
-            The XML configuration file is by default expected to be in the root of
+            The XML configuration file is by default expected to be in the root o
             your <literal>CLASSPATH</literal>. Here is an example:
             O arquivo XML de configuração é por default esperado para estar na 
             raiz do seu <literal>CLASSPATH</literal>. Veja um exemplo:

documentation/manual/pt-BR/src/main/docbook/content/example_mappings.xml

@@ -1,4 +1,19 @@
-<chapter id="example-mappings">
+<!--
+  ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
+  ~
+  ~ This copyrighted material is made available to anyone wishing to use, modify,
+  ~ copy, or redistribute it subject to the terms and conditions of the GNU
+  ~ Lesser General Public License, v. 2.1. This program is distributed in the
+  ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
+  ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+  ~ Lesser General Public License for more details. You should have received a
+  ~ copy of the GNU Lesser General Public License, v.2.1 along with this
+  ~ distribution; if not, write to the Free Software Foundation, Inc.,
+  ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+  ~
+  ~ Red Hat Author(s): Steve Ebersole
+  -->
+<chapter id="example-mappings">
     <title>Exemplo: Vários Mapeamentos</title>
     
     <para>
@@ -18,10 +33,10 @@
 
         <mediaobject>
             <imageobject role="fo">
-                <imagedata fileref="images/EmployerEmployee.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/EmployerEmployee.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="html">
-                <imagedata fileref="../shared/images/EmployerEmployee.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/EmployerEmployee.png" format="PNG" align="center"/>
             </imageobject>
         </mediaobject>
         
@@ -132,10 +147,10 @@ create sequence employer_id_seq]]></programlisting>
 
         <mediaobject>
             <imageobject role="fo">
-                <imagedata fileref="images/AuthorWork.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/AuthorWork.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="html">
-                <imagedata fileref="../shared/images/AuthorWork.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/AuthorWork.png" format="PNG" align="center"/>
             </imageobject>
         </mediaobject>
         
@@ -261,10 +276,10 @@ alter table author_work
 
         <mediaobject>
             <imageobject role="fo">
-                <imagedata fileref="images/CustomerOrderProduct.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/CustomerOrderProduct.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="html">
-                <imagedata fileref="../shared/images/CustomerOrderProduct.gif" format="GIF" align="center"/>
+                <imagedata fileref="../images/CustomerOrderProduct.png" format="PNG" align="center"/>
             </imageobject>
         </mediaobject>
         

documentation/manual/pt-BR/src/main/docbook/content/performance.xml

@@ -1,4 +1,4 @@
-<chapter id="performance">
+<chapter id="performance">
     <title>Aumentando a performance</title>
 
     <sect1 id="performance-fetching" revision="2">
@@ -677,7 +677,7 @@ Cat fritz = (Cat) iter.next();]]></programlisting>
                 <entry>OSCache</entry>
                 <entry><literal>org.hibernate.cache.OSCacheProvider</literal></entry>
                 <entry>memory, disk</entry>
-                <entry>yes (clustered invalidation)</entry>
+                <entry></entry>
                 <entry>yes</entry>
             </row>
             <row>
@@ -940,32 +940,26 @@ sessionFactory.evictCollection("Cat.kittens"); //evict all kitten collections]]>
         <itemizedlist>
         <listitem>
         <para>
-            <literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache.
+            <literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <literal>CacheMode.IGNORE</literal> - never write nor read items from the second-level cache, 
-            except when updating data.
         </para>
         </listitem>
         <listitem>
         <para>
             <literal>CacheMode.GET</literal> - read items from the second-level cache, but don't write to
-            the second-level cache except when updating data.
+            the second-level cache except when updating data
         </para>
         </listitem>
         <listitem>
         <para>
             <literal>CacheMode.PUT</literal> - write items to the second-level cache, but don't read from
-            the second-level cache.
+            the second-level cache
         </para>
         </listitem>
         <listitem>
         <para>
             <literal>CacheMode.REFRESH</literal> - write items to the second-level cache, but don't read from
             the second-level cache, bypass the effect of <literal>hibernate.cache.use_minimal_puts</literal>, forcing
-            a refresh of the second-level cache for all items read from the database.
+            a refresh of the second-level cache for all items read from the database
         </para>
         </listitem>
         </itemizedlist>

documentation/manual/pt-BR/src/main/docbook/content/preface.xml

@@ -0,0 +1,120 @@
+<?xml version='1.0' encoding="iso-8859-1"?>
+<!--
+  ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
+  ~
+  ~ This copyrighted material is made available to anyone wishing to use, modify,
+  ~ copy, or redistribute it subject to the terms and conditions of the GNU
+  ~ Lesser General Public License, v. 2.1. This program is distributed in the
+  ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
+  ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+  ~ Lesser General Public License for more details. You should have received a
+  ~ copy of the GNU Lesser General Public License, v.2.1 along with this
+  ~ distribution; if not, write to the Free Software Foundation, Inc.,
+  ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+  ~
+  ~ Red Hat Author(s): Steve Ebersole
+  -->
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<preface id="preface" revision="2">
+    <title>Prefácio</title>
+
+    <para>
+        Trabalhando com software orientado a objetos e banco de dados relacional, podemos
+        ter alguns incômodos hoje em dia em ambientes empresariais. Hibernate é uma ferramenta
+        que mapeia o objeto/relacional para o ambiente Java. O termo de mapeamento de
+        objeto/relacional (ou ORM – Object/Relational Mapping) se refere a técnica de mapear
+        uma representação de dados de um modelo de objeto para dados de modelo
+        relacional com o esquema baseado em SQL
+    </para>
+
+    <para>
+        O Hibernate não somente cuida do mapeamento de classes em Java
+        para tabelas de banco de dados (e de tipos de dados em Java para tipos de dados em SQL), como também
+        fornece facilidade de consultas e recuperação de dados, podendo também reduzir significantemente o
+        tempo de desenvolvimento gasto com a manipulação manual de dados no SQL e JDBC.
+    </para>
+
+    <para>
+        O objetivo do Hibernate é de aliviar o desenvolvedor de 95 por cento das tarefas de programação
+        relacionadas aos dados comuns de persistência. O Hibernate talvez não seja a melhor solução para
+        aplicações de dados-data-centric que somente usa stored-procedures para implementar a lógica
+        de negócio no banco de dados, isto é muito utilizado com o domínio de modelos orientado a objetos e
+        lógicas de negócio em camadas do meio (middle-tier) baseadas em Java. Porém, o Hibernate
+        poderá certamente ajuda-lo a remover ou encapsular o código SQL de um vendedor específico,
+        ajudando também com a tarefa comum da tradução do resultado ajustado de uma representação
+        para um gráfico de objetos.
+    </para>
+
+    <para>
+        Se você for novo no Hibernate e no mapeamento Objeto/Relacional, ou até mesmo em Java,
+        por favor, siga os seguintes passos.
+    </para>
+
+    <orderedlist>
+        <listitem>
+            <para>
+                Leia <xref linkend="tutorial"/> para um tutorial com instruções passo-a-passo.
+                O código fonte para do tutorial está incluído na distribuição no diretório
+                <literal>doc/reference/tutorial/</literal>.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                Leia o <xref linkend="architecture"/> para entender o ambiente onde o Hibernate pode ser utilizado.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                Dê uma olhada no diretório de exemplo <literal>eg/</literal> da distribuição
+                do Hibernate, ele contém uma simples aplicação standalone.
+                Copie seu driver JDBC para o diretório <literal>lib/</literal> e edite o arquivo
+                <literal>etc/hibernate.properties</literal>, especificando corretamente os valores
+                para seu banco de dados. Usando o prompt de commando no diretorio de distribuicao,
+                digite <literal>ant eg</literal> (usando Ant), ou no Windows, digite
+                <literal>build eg</literal>.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                Use esta documentação de referencia como sua fonte primaria de informação.
+                Considere ler também o livro <emphasis>Java Persistence with Hibernate</emphasis>
+                (http://www.manning.com/bauer2) caso você precise de mais ajuda com o
+                desenvolvimento de aplicações ou caso prefira um tutorial passo-a-passo.
+                Também visite o site http://caveatemptor.hibernate.org e faça o download
+                da aplicação de exemplo do Java Persistence with Hibernate.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                FAQs (perguntas feitas com mais freqüência) estão respondidas no site do Hibernate
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                Demonstrações, exemplos e tutorials estão disponíveis no site do Hibernate.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                A Área da comunidade no site do Hibernate é uma boa fonte de recursos
+                para padrões de projeto e várias soluções de integração (Tomcat, JBoss AS, Struts, EJB, etc.).
+            </para>
+        </listitem>
+     </orderedlist>
+
+     <para>
+         Caso você tenha dúvidas, use o fórum dos usuários encontrado no site do Hibernate.
+         Nós também fornecemos um sistema para controle de bug’s (JIRA) para relatórios de erros
+         e requisições de features. Se você está interessado no desenvolvimento do Hibernate,
+         junte-se a lista de e-mail dos desenvolvedores.
+     </para>
+
+     <para>
+         Suporte comercial de desenvolvimento, suporte de produção e treinamento para o Hibernate
+         está disponível através do JBoss Inc. (veja http://www.hibernate.org/SupportTraining).
+         O Hibernate é um Projeto Profissional de Código Aberto e um componente crítico da suíte
+         de produtos JBoss Enterprise Middleware System (JEMS).
+     </para>
+
+</preface>

documentation/manual/pt-BR/src/main/docbook/content/toolset_guide.xml

@@ -100,7 +100,7 @@
             </para>
             
             <programlisting><![CDATA[<many-to-one name="org" column="orgId" unique-key="OrgEmployeeId"/>
-<property name="employeeId" unique-key="OrgEmployeeId"/>]]></programlisting>
+<property name="employeeId" unique-key="OrgEmployee"/>]]></programlisting>
 
             <para>
                 An <literal>index</literal> attribute specifies the name of an index that

documentation/manual/pt-BR/src/main/docbook/content/tutorial.xml

@@ -1,4 +1,4 @@
-<chapter id="tutorial">
+<chapter id="tutorial">
     <title>Introdu&#x00E7;&#x00E3;o ao Hibernate</title>
     
     <sect1 id="tutorial-intro" revision="1">
@@ -1447,7 +1447,7 @@ out.close();]]></programlisting>
 <programlisting><![CDATA[<target name="war" depends="compile">
     <war destfile="hibernate-tutorial.war" webxml="web.xml">
         <lib dir="${librarydir}">
-          <exclude name="servlet.jar"/>
+          <exclude name="jsdk*.jar"/>
         </lib>
 
         <classes dir="${targetdir}"/>
@@ -1479,9 +1479,8 @@ out.close();]]></programlisting>
 
             <para>
                 Antes de você compilar e fazer o deploy desta aplicação web, note que uma biblioteca 
-                adicional é requerida: <literal>servlet.jar</literal>. Esse é o Java Servlet Development Kit, 
+                adicional é requerida: <literal>jsdk.jar</literal>. Esse é o Java servlet development kit, 
-                se você não possui esta biblioteca, faça seu download na 
+                se você não possui esta biblioteca, faça seu download na página da Sun e copie-a
-                <ulink url="http://java.sun.com/products/servlet/archive.html">página da Sun</ulink> e copie-a
                 para seu diretório de bibliotecas. Entretanto, será usado somente para a compilação e 
                 excluído do pacote WAR.
             </para>

documentation/manual/pt-BR/src/main/docbook/content/tutorial1.xml

@@ -1,4 +1,4 @@
-<chapter id="tutorial">
+<chapter id="tutorial">
     <title>Introdu&#x00E7;&#x00E3;o ao Hibernate</title>
     
     <sect1 id="tutorial-intro" revision="1">
@@ -1461,7 +1461,7 @@ out.close();]]></programlisting>
 <programlisting><![CDATA[<target name="war" depends="compile">
     <war destfile="hibernate-tutorial.war" webxml="web.xml">
         <lib dir="${librarydir}">
-          <exclude name="servlet.jar"/>
+          <exclude name="jsdk*.jar"/>
         </lib>
 
         <classes dir="${targetdir}"/>
@@ -1493,9 +1493,8 @@ out.close();]]></programlisting>
 
             <para>
                 Before you compile and deploy the web application, note that an additional library
-                is required: <literal>servlet.jar</literal>. This is the Java Servlet Development Kit,
+                is required: <literal>jsdk.jar</literal>. This is the Java servlet development kit,
-                if you don't have this library already, get it from the 
+                if you don't have this library already, get it from the Sun website and copy it to
-                <ulink url="http://java.sun.com/products/servlet/archive.html">Sun website</ulink> and copy it to
                 your library directory. However, it will be only used for compliation and excluded
                 from the WAR package.
             </para>

documentation/manual/pt-BR/src/main/docbook/content/xml.xml

@@ -255,7 +255,7 @@ List results = dom4jSession
 for ( int i=0; i<results.size(); i++ ) {
     //add the customer data to the XML document
     Element customer = (Element) results.get(i);
-    doc.getRootElement().add(customer);
+    doc.add(customer);
 }
 
 tx.commit();

documentation/manual/pt-BR/src/main/docbook/legal_notice.xml

@@ -0,0 +1,52 @@
+<?xml version='1.0'?>
+<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<!--
+  ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
+  ~
+  ~ This copyrighted material is made available to anyone wishing to use, modify,
+  ~ copy, or redistribute it subject to the terms and conditions of the GNU
+  ~ Lesser General Public License, v. 2.1. This program is distributed in the
+  ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
+  ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+  ~ Lesser General Public License for more details. You should have received a
+  ~ copy of the GNU Lesser General Public License, v.2.1 along with this
+  ~ distribution; if not, write to the Free Software Foundation, Inc.,
+  ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+  ~
+  ~ Red Hat Author(s): Steve Ebersole
+  -->
+<legalnotice id="Legal_Notice">
+    <title>Legal Notice</title>
+    <para>
+        <address>
+            <street>1801 Varsity Drive</street>
+            <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country>
+            <phone>Phone: +1 919 754 3700</phone>
+            <phone>Phone: 888 733 4281</phone>
+            <fax>Fax: +1 919 754 3701</fax>
+            <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country>
+        </address>
+    </para>
+    <para>
+        Copyright <trademark class="copyright"></trademark> 2007 by Red Hat, Inc. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, V1.0 or later (the latest version is presently available at <ulink url="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</ulink>).
+    </para>
+    <para>
+        Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder.
+    </para>
+    <para>
+        Distribution of the work or derivative of the work in any standard (paper) book form for commercial purposes is prohibited unless prior permission is obtained from the copyright holder.
+    </para>
+    <para>
+        Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat, Inc. in the United States and other countries.
+    </para>
+    <para>
+    All other trademarks referenced herein are the property of their respective owners.
+    </para>
+    <para>
+        The GPG fingerprint of the security@redhat.com key is:
+    </para>
+    <para>
+        CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E
+    </para>
+</legalnotice>

documentation/manual/pt-BR/src/main/docbook/legal_notice2.xml

@@ -0,0 +1,15 @@
+<?xml version='1.0'?>
+<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<legalnotice id="Legal_Notice">
+    <title>Translation-specific Legal Notice</title>
+    <para>
+        <emphasis>Advertencia! Esta é uma versão traduzida do inglês da
+        documentação de referencia do Hibernate. A versão traduziada pode estar
+        desatualizada. Sem dúvida, as diferenças devem ser pequenas e serão corrigidas o
+        mais breve possivel. Consulte a documentação de referencia em inglês, se estiver
+        faltando alguma informação ou você encotrar erros de tradução. Se quiser 
+        colaborar com ama tradução em particular, entre em contato com um dos tradutores
+        abaixo:</emphasis>. Gamarra
+    </para>
+</legalnotice>

documentation/manual/pt-BR/src/main/docbook/master.xml

@@ -1,261 +0,0 @@
-<?xml version='1.0' encoding="iso-8859-1"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
-                      "../support/docbook-dtd/docbookx.dtd"
-[
-<!ENTITY tutorial               SYSTEM "modules/tutorial.xml">
-<!ENTITY architecture           SYSTEM "modules/architecture.xml">
-<!ENTITY configuration          SYSTEM "modules/configuration.xml">
-<!ENTITY persistent-classes     SYSTEM "modules/persistent_classes.xml">
-<!ENTITY basic-mapping          SYSTEM "modules/basic_mapping.xml">
-<!ENTITY collection-mapping     SYSTEM "modules/collection_mapping.xml">
-<!ENTITY association-mapping    SYSTEM "modules/association_mapping.xml">
-<!ENTITY component-mapping      SYSTEM "modules/component_mapping.xml">
-<!ENTITY inheritance-mapping    SYSTEM "modules/inheritance_mapping.xml">
-<!ENTITY session-api            SYSTEM "modules/session_api.xml">
-<!ENTITY transactions           SYSTEM "modules/transactions.xml">
-<!ENTITY events                 SYSTEM "modules/events.xml">
-<!ENTITY batch                  SYSTEM "modules/batch.xml">
-<!ENTITY query-hql              SYSTEM "modules/query_hql.xml">
-<!ENTITY query-criteria         SYSTEM "modules/query_criteria.xml">
-<!ENTITY query-sql              SYSTEM "modules/query_sql.xml">
-<!ENTITY filters                SYSTEM "modules/filters.xml">
-<!ENTITY xml                    SYSTEM "modules/xml.xml">
-<!ENTITY performance            SYSTEM "modules/performance.xml">
-<!ENTITY toolset-guide          SYSTEM "modules/toolset_guide.xml">
-<!ENTITY example-parentchild    SYSTEM "modules/example_parentchild.xml">
-<!ENTITY example-weblog         SYSTEM "modules/example_weblog.xml">
-<!ENTITY example-mappings       SYSTEM "modules/example_mappings.xml">
-<!ENTITY best-practices         SYSTEM "modules/best_practices.xml">
-]>
-
-<book lang="en">
-
-    <bookinfo>
-        <title>HIBERNATE - Relational Persistence for Idiomatic Java</title>
-        <subtitle>Documentação da Referência do Hibernate</subtitle>
-        <releaseinfo>3.2 cr2</releaseinfo>
-    </bookinfo>
-
-    <toc/>
-
-    <preface id="preface" revision="2">
-        <title>Prefácio</title>
-        
-        <para>
-		        <emphasis>Advertencia! Esta é uma versão traduzida do inglês da 
-		        documentação de referencia do Hibernate. A versão traduziada pode estar
-		        desatualizada. Sem dúvida, as diferenças devem ser pequenas e serão corrigidas o 
-		        mais breve possivel. Consulte a documentação de referencia em inglês, se estiver
-		        faltando alguma informação ou você encotrar erros de tradução. Se quiser 
-		        colaborar com ama tradução em particular, entre em contato com um dos tradutores
-		        abaixo:</emphasis>. Gamarra
-		        
-        </para>
-
-        <para>
-            Tradutor(es) em ordem alfabética: 
-        </para>
-
-       <itemizedlist>
-        <listitem>
-        <para>
-            <emphasis>Alvaro Netto</emphasis> alvaronetto@cetip.com.br
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Anderson Braulio</emphasis> andersonbraulio@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Daniel Vieira Costa</emphasis> danielvc@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Francisco gamarra</emphasis> francisco.gamarra@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Gamarra</emphasis> mauricio.gamarra@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Luiz Carlos Rodrigues</emphasis> luizcarlos_rodrigues@yahoo.com.br
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Marcel Castelo</emphasis> marcel.castelo@gmail.com
-        </para>
-        </listitem>
-
-        <listitem>
-        <para>
-            <emphasis>Paulo César</emphasis> paulocol@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Pablo L. de Miranda</emphasis> pablolmiranda@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-         <para>
-            <emphasis>Renato Deggau</emphasis> rdeggau@gmail.com
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Rogério Araújo</emphasis> rgildoaraujo@yahoo.com.br
-        </para>
-        </listitem>
-        <listitem>
-        <para>
-            <emphasis>Wanderson	Siqueira</emphasis> wandersonxs@gmail.com
-        </para>
-        </listitem>
-       
-
-        </itemizedlist>
- 
-        <para>
-            Trabalhando com software orientado a objetos e banco de dados relacional, podemos 
-            ter alguns incômodos hoje em dia em ambientes empresariais. Hibernate é uma ferramenta 
-            que mapeia o objeto/relacional para o ambiente Java. O termo de mapeamento de 
-            objeto/relacional (ou ORM – Object/Relational Mapping) se refere a técnica de mapear 
-            uma representação de dados de um modelo de objeto para dados de modelo 
-            relacional com o esquema baseado em SQL
-        </para>
-
-        <para>
-            O Hibernate não somente cuida do mapeamento de classes em Java 
-            para tabelas de banco de dados (e de tipos de dados em Java para tipos de dados em SQL), como também 
-            fornece facilidade de consultas e recuperação de dados, podendo também reduzir significantemente o 
-            tempo de desenvolvimento gasto com a manipulação manual de dados no SQL e JDBC.
-        </para>
-
-        <para>
-            O objetivo do Hibernate é de aliviar o desenvolvedor de 95 por cento das tarefas de programação 
-            relacionadas aos dados comuns de persistência. O Hibernate talvez não seja a melhor solução para 
-            aplicações de dados-data-centric que somente usa stored-procedures para implementar a lógica 
-            de negócio no banco de dados, isto é muito utilizado com o domínio de modelos orientado a objetos e 
-            lógicas de negócio em camadas do meio (middle-tier) baseadas em Java. Porém, o Hibernate
-            poderá certamente ajuda-lo a remover ou encapsular o código SQL de um vendedor específico,
-            ajudando também com a tarefa comum da tradução do resultado ajustado de uma representação 
-            para um gráfico de objetos.
-        </para>
-
-        <para>
-            Se você for novo no Hibernate e no mapeamento Objeto/Relacional, ou até mesmo em Java, 
-            por favor, siga os seguintes passos.
-        </para>
-
-        <orderedlist>
-            <listitem>
-                <para>
-                    Leia <xref linkend="tutorial"/> para um tutorial com instruções passo-a-passo. 
-                    O código fonte para do tutorial está incluído na distribuição no diretório 
-                    <literal>doc/reference/tutorial/</literal>.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    Leia o <xref linkend="architecture"/> para entender o ambiente onde o Hibernate pode ser utilizado. 
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    Dê uma olhada no diretório de exemplo <literal>eg/</literal> da distribuição 
-                    do Hibernate, ele contém uma simples aplicação standalone. 
-                    Copie seu driver JDBC para o diretório <literal>lib/</literal> e edite o arquivo 
-                    <literal>etc/hibernate.properties</literal>, especificando corretamente os valores 
-                    para seu banco de dados. Usando o prompt de commando no diretorio de distribuicao,
-                    digite <literal>ant eg</literal> (usando Ant), ou no Windows, digite
-                    <literal>build eg</literal>.                     
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    Use esta documentação de referencia como sua fonte primaria de informação. 
-                    Considere ler também o livro <emphasis>Java Persistence with Hibernate</emphasis>  
-                    (http://www.manning.com/bauer2) caso você precise de mais ajuda com o 
-                    desenvolvimento de aplicações ou caso prefira um tutorial passo-a-passo. 
-                    Também visite o site http://caveatemptor.hibernate.org e faça o download 
-                    da aplicação de exemplo do Java Persistence with Hibernate.
-                </para>
-            </listitem>
-            <listitem>
-				<para>
-					FAQs (perguntas feitas com mais freqüência) estão respondidas no site do Hibernate
-				</para>
-            </listitem>
-			<listitem>
-				<para>
-					Demonstrações, exemplos e tutorials estão disponíveis no site do Hibernate.
-				</para>
-			</listitem>
-            <listitem>
-                <para>
-                    A Área da comunidade no site do Hibernate é uma boa fonte de recursos 
-                    para padrões de projeto e várias soluções de integração (Tomcat, JBoss AS, Struts, EJB, etc.).
-                </para>
-            </listitem>
-         </orderedlist>
-
-         <para>
-             Caso você tenha dúvidas, use o fórum dos usuários encontrado no site do Hibernate. 
-             Nós também fornecemos um sistema para controle de bug’s (JIRA) para relatórios de erros 
-             e requisições de features. Se você está interessado no desenvolvimento do Hibernate, 
-             junte-se a lista de e-mail dos desenvolvedores. 
-         </para>
-
-         <para>
-             Suporte comercial de desenvolvimento, suporte de produção e treinamento para o Hibernate 
-             está disponível através do JBoss Inc. (veja http://www.hibernate.org/SupportTraining). 
-             O Hibernate é um Projeto Profissional de Código Aberto e um componente crítico da suíte 
-             de produtos JBoss Enterprise Middleware System (JEMS).              
-         </para>
-
-    </preface>
-
-    &tutorial;
-
-    &architecture;
-
-    &configuration;
-
-    &persistent-classes;
-
-    &basic-mapping;
-    &collection-mapping;
-    &association-mapping;
-    &component-mapping;
-    &inheritance-mapping;
-
-    &session-api;
-    &transactions;
-    &events;
-    &batch;
-
-    &query-hql;
-    &query-criteria;
-    &query-sql;
-    &filters;
-    &xml;
-
-    &performance;
-
-    &toolset-guide;
-
-    &example-parentchild;
-    &example-weblog;
-    &example-mappings;
-
-    &best-practices;
-
-</book>
-

documentation/manual/pt-BR/src/main/docbook/translators.xml

@@ -0,0 +1,93 @@
+<?xml version='1.0'?>
+
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<!--
+  ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
+  ~
+  ~ This copyrighted material is made available to anyone wishing to use, modify,
+  ~ copy, or redistribute it subject to the terms and conditions of the GNU
+  ~ Lesser General Public License, v. 2.1. This program is distributed in the
+  ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
+  ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+  ~ Lesser General Public License for more details. You should have received a
+  ~ copy of the GNU Lesser General Public License, v.2.1 along with this
+  ~ distribution; if not, write to the Free Software Foundation, Inc.,
+  ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+  ~
+  ~ Red Hat Author(s): Steve Ebersole
+  -->
+<authorgroup id="AuthorGroup">
+
+    <othercredit class="translator">
+        <firstname>Alvaro</firstname>
+        <surname>Netto</surname>
+        <email>alvaronetto@cetip.com.br</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Anderson</firstname>
+        <surname>Braulio</surname>
+        <email>andersonbraulio@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Daniel Vieira</firstname>
+        <surname>Costa</surname>
+        <email>danielvc@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Francisco</firstname>
+        <surname>gamarra</surname>
+        <email>francisco.gamarra@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Gamarra</firstname>
+        <email>mauricio.gamarra@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Luiz Carlos</firstname>
+        <surname>Rodrigues</surname>
+        <email>luizcarlos_rodrigues@yahoo.com.br</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Marcel</firstname>
+        <surname>Castelo</surname>
+        <email>marcel.castelo@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Paulo</firstname>
+        <surname>César</surname>
+        <email>paulocol@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Pablo L.</firstname>
+        <surname>de Miranda</surname>
+        <email>pablolmiranda@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Renato</firstname>
+        <surname>Deggau</surname>
+        <email>rdeggau@gmail.com</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Rogério</firstname>
+        <surname>Araújo</surname>
+        <email>rgildoaraujo@yahoo.com.br</email>
+    </othercredit>
+
+    <othercredit class="translator">
+        <firstname>Wanderson</firstname>
+        <surname>Siqueira</surname>
+        <email>wandersonxs@gmail.com</email>
+    </othercredit>
+
+</authorgroup>

documentation/manual/pt-BR/src/main/resources/shared/css/html.css

@@ -1,97 +0,0 @@
-A {
-    color: #003399;
-}
-
-A:active {
-    color: #003399;
-}
-
-A:visited {
-    color: #888888;
-}
-
-P, OL, UL, LI, DL, DT, DD, BLOCKQUOTE {
-    color: #000000;
-}
-
-TD, TH, SPAN {
-    color: #000000;
-}
-
-BLOCKQUOTE {
-    margin-right: 0px;
-}
-
-
-H1, H2, H3, H4, H5, H6    {
-    color: #000000;
-    font-weight:500;
-    margin-top:10px;
-    padding-top:15px;
-}
-
-TABLE  {
-    border-collapse: collapse;
-    border-spacing:0;
-    border: 1px thin black;
-    empty-cells: hide;
-}
-
-TD  {
-    padding: 4pt;
-}
-
-H1 { font-size: 150%; }
-H2 { font-size: 140%; }
-H3 { font-size: 110%; font-weight: bold; }
-H4 { font-size: 110%; font-weight: bold;}
-H5 { font-size: 100%; font-style: italic; }
-H6 { font-size: 100%; font-style: italic; }
-
-TT {
-font-size: 90%;
-    font-family: "Courier New", Courier, monospace;
-    color: #000000;
-}
-
-PRE {
-font-size: 100%;
-    padding: 5px;
-    border-style: solid;
-    border-width: 1px;
-    border-color: #CCCCCC;
-    background-color: #F4F4F4;
-}
-
-UL, OL, LI {
-    list-style: disc;
-}
-
-HR  {
-    width: 100%;
-    height: 1px;
-    background-color: #CCCCCC;
-    border-width: 0px;
-    padding: 0px;
-    color: #CCCCCC;
-}
-
-.variablelist { 
-    padding-top: 10; 
-    padding-bottom:10; 
-    margin:0;
-}
-
-.itemizedlist, UL { 
-    padding-top: 0; 
-    padding-bottom:0; 
-    margin:0; 
-}
-
-.term { 
-    font-weight:bold;
-}
-
-
-
-