Cleanup doc generation code, move it to bin/, add PDF generation and...

Cleanup doc generation code, move it to bin/, add PDF generation and dependency installation command

.gitignore

+build

bin/generate-docs.sh

+#!/bin/bash
+EXECPATH=`dirname $0`
+cd $EXECPATH
+cd ..
+
+rm build -Rf
+sphinx-build en build
+
+sphinx-build -b latex en build/pdf
+rubber --into build/pdf --pdf build/pdf/DoctrineDBAL.tex
\ No newline at end of file

bin/install-dependencies.sh

+#!/bin/bash
+sudo apt-get install python25 python25-dev texlive-full rubber
+sudo easy_install pygments
+sudo easy_install sphinx
\ No newline at end of file

en/conf.py

@@ -174,7 +174,7 @@ htmlhelp_basename = 'DoctrineDBALdoc'
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-  ('index2', 'DoctrineDBAL.tex', u'Doctrine DBAL Documentation',
+  ('index', 'DoctrineDBAL.tex', u'Doctrine DBAL Documentation',
    u'Roman Borschel, Guilherme Blanco, Benjamin Eberlei, Jonathan Wage', 'manual'),
 ]
 

en/index.rst

@@ -16,6 +16,7 @@ Contents:
    reference/architecture
    reference/configuration
    reference/data-retrieval-and-manipulation
+   reference/query-builder
    reference/transactions
    reference/platforms
    reference/types

en/reference/query-builder.rst

+SQL Query Builder
+=================
+
+Doctrine 2.1 ships with a powerful query builder for the SQL language. This QueryBuilder object has methods
+to add parts to an SQL statement. If you built the complete state you can execute it using the connection
+it was generated from. The API is roughly the same as that of the DQL Query Builder.
+
+You can access the QueryBuilder by calling ``Doctrine\DBAL\Connection#createQueryBuilder``:
+
+.. code-block:: php
+
+    <?php
+
+    $conn = DriverManager::getConnection(array(/*..*/));
+    $queryBuilder = $conn->createQueryBuilder();
+

generate-docs.sh

-#!/bin/bash
-rm /var/www/doctrine-docs -Rf
-sphinx-build en /var/www/doctrine-docs