.. -*- rst -*-

.. make.txt
..   Com usar make en els projectes d'Informàtica de l'ETSEIB

..   Fitxer reStructuredText. Cal processar-lo amb rst2html per tal
..   d'obtenir la versió en html

==============================
Com usar make en els projectes
==============================


.. |logoUPC| image:: ../imatges/upcf.jpg
.. |logoETSEIB| image:: ../imatges/logo_etseib02.png
..

..  -  `Professorat <../fullInformatiu/consultes/index.html>`_
..  -  `Documentació <../documentacio/index.html>`_
..  -   `Informació general <../general/index.html>`_
..  -   `Projectes <../projectes/index.html>`_



.. sidebar::  |logoETSEIB| Informàtica ETSEIB

 -  `Pàgina principal <../index.html>`_ 
 -   `Material <../material/index.html>`_
 -  `Laboratori <../laboratori/index.html>`_ 
 -  `Einam <../einam/index.html>`_ 
..

.. contents:: Índex

Junt amb els fitxers de cada projecte trobareu un fitxer anomenat
``Makefile`` que conté les instruccions pel programa `make`_ per
a aquest projecte.

Compilació i muntatge
---------------------

L'eina ``make`` automatitza el procés de compilació separada, de
manera que per compilar i muntar un programa, fent el mínim de
feina possible en funció de les modificacions que s'han fet en els
fitxers font, només cal executar l'ordre

::

    make


Execució dels jocs de prova
---------------------------

A més, hem inclòs en el ``Makefile`` objectius que simplifiquen
l'ús de `jocs de prova`_ per comprovar el funcionament d'un programa.
Així, per executar un programa amb les dades del joc de prova 0 i
comprovar que el resultat és l'esperat cal fer

::

    make test0

Si aquesta ordre escriu

::

    Test 0: inici
    Test 0: correcte

al canal estàndard de sortida, aleshores s'ha passat el test 0 amb
èxit. En cas que no escrigui la segona línia, no ha passat el test
i cal revisar el disseny i la traducció a `C`_. Si voleu passar de
cop *tots* els jocs de prova disponibles, escriviu

::

    make test

Empaquetat dels fitxers per al lliurament
-----------------------------------------

Una altra de les funcionalitats que incorpora el fitxer ``Makefile``
que us proporcionem en cada projecte permet generar el fitxer, en
format tar_ comprimit, que cal lliurar a Atenea_. Per exemple, per
generar el fitxer corresponent al *projecte 1b* cal que


1. Editeu un fitxer anomenat ``WHO`` que contingui els noms dels
   membres del grup de projectes fent

   ::

         emacs WHO

2. Escriviu l'ordre

   ::

         make projecte1b.tgz

   que invocarà l'ordre tar amb les opcions i els paràmetres adients
   per `empaquetar i comprimir`_ els fitxers del projecte.


Fent neteja
-----------

La darrera funcionalitat que incorpora el fitxer ``Makefile`` és la
possibilitat d'esborrar els fitxers que s'han generat durant la
compilació i el muntatge, i que es poden tornar a generar sembre
que vulguem. Dit d'una altra manera, per fer *neteja* del directori
de treball podeu fer

::

    make clean


.. _jocs de prova: jocs_prova.html
.. _Atenea: http://atenea.upc.edu/
.. _make: http://en.wikipedia.org/wiki/Make_(software)
.. _tar: http://en.wikipedia.org/wiki/Tar_(file_format)
.. _empaquetar i comprimir: tar.html
.. _C: http://en.wikipedia.org/wiki/C_(programming_language)

----

|xhtml| |css| |vab| 

.. |xhtml| image:: http://www.w3.org/Icons/valid-xhtml10
   :target: http://validator.w3.org/check?uri=referer
   :alt: Valid XHTML 1.0 Transitional
   :height: 31
   :width: 88

.. |css| image:: http://jigsaw.w3.org/css-validator/images/vcss
   :target: http://jigsaw.w3.org/css-validator/
   :alt: Valid CSS!
   :height: 31
   :width: 88

.. |vab| image:: http://www.anybrowser.org/campaign/bvgraphics/qualsevol.png
   :target: http://www.anybrowser.org/campaign/anybrowser_cat.html
   :width: 88
   :height: 31
   :alt: Viewable With Any Browser