-*-outline-*-

# *****************************************************************************
# README-fr : Aide de dpart
# README-fr : First help
#
#
# TouxDoux : Chtit gestionnaire de projet - A littl' project manager
# Copyright (c) 2000-2001 Philippe Roy
# Auteur - Author : Philippe Roy <ph_roy@toutdoux.org>
#
#
# Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier
# sous les termes de la licence publique gnrale GNU telle qu'elle est publie par
# la Free Software Foundation ; soit la version 2 de la licence, ou
# (comme vous voulez) toute version ultrieure.
#
# Ce programme est distribu dans l'espoir qu'il sera utile,
# mais SANS AUCUNE GARANTIE ; mme sans la garantie de
# COMMERCIALIT ou d'ADQUATION A UN BUT PARTICULIER. Voir la
# licence publique gnrale GNU pour plus de dtails.
#
# Vous devriez avoir reu une copie de la licence publique gnrale GNU
# avec ce programme ; si ce n'est pas le cas, crivez  la Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
#
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 
# *****************************************************************************

* 0. Prface
* 1. Usage
* 2. Licence
* 3. Ambitions
* 4. Donations & Emploi
** 1. Donations
** 2. Prix informatif
** 3. Emploi
* 5. Dpendances
** 1. Dpendances d'utilisation
** 2. Dpendances du dorsal SQL
** 3. Complments
** 4. MySQL
* 6. Installation
** 1. Dorsal SQL
** 2. Environnement UNIX
** 3. Compilation
** 4. Lancement
* 7. CVS : Gnration de l'arbre source
** 1. Accs anonyme
** 2. Accs via SSH

* 0. Prface

Phontiquement "ToutDoux" et "TODO" sont quivalent.
"TODO" ou plutt "to do" est la traduction anglaise du verbe "faire".

* 1. Usage

ToutDoux est un petit gestionnaire de projet.

C'est :
	- un approche abstraite de l'organisation/manipulation des donnes
	- une arboressance d'actions ranges par dossier (ou thmes)
	- un type d'action caractristique du projet infomatique

* 2. License

  Toutdoux fait partie du projet GNU, c'est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier
  sous les termes de la License Publique Gnrale GNU telle qu'elle est publie par la Free Software Foundation; 
  soit la version 2 de la licence, ou (comme vous voulez) toute version ultrieure. 
   
  Ce programme est distribu dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE; 
  mme sans la garantie de COMMERCIALIT ou d'ADQUATION A UN BUT PARTICULIER. 
  Voir la Licence Publique Gnrale GNU pour plus de dtails.

* 3. Ambitions

	- complet comme M$ Project ( quelques "dtails" prs ... (je vais (tcher d')oublier bugs et restrictions))
	- adaptable comme une base de donnes
	- multi-utilisateur (travail de groupe)
	- sauvegarde sur fichier et bases de donnes
	- intgration sur d'autres applications (SGI, ... )

* 4. Donations & Emploi

** 1. Donations

  Programmeurs et techniciens par leurs programmes ou documentations peuvent contribuer
  au dveloppement de ToutDoux. 
  Cependant si vous ne pouvez ou ne voulez contribuer de cette manire, vous pouvez soutenir le
  projet par une donation montaire ou matriel (informatique).
  Comme la liste des auteurs, la liste des supporters est inclue dans le "A propos" du logiciel.

  mon adresse :    Philippe ROY
		   23, mare aux canards
		   67500 HAGUENAU 
		   FRANCE

** 2. Prix informatif

   Par comparaison aux produits concurents, on peut estimer ToutDoux  40 Euros.

	- BrainForest (Aportis)	       : 40 $ (4/01/2000)
	- Project (M$)		       : 500 $ (4/01/2000)

** 3. Emploi - Job

  De formation, je suis plutt un industriel (ingnieur mcanicien) (mon cv est sur le site Lolix). 
  Cependant dans l'industrie (comme pour d'autres secteurs), la matrise de l'outil informatique est dterminant
  et dans cette optique le concept de logiciels libres est extrment puissant : 

  - l'utilisateur peut rellement intervenir dans la conception/ralisation du logiciel,
  - la concurrence entre logiciels est uniquement base sur les performances, les fonctionnalites et l'ergonomie,
  - coupls  internet, les logiciels libres sont un *vrai* mouvement (voir le seul) de standardisation,
  - ayant le choix de son quipement logiciel et de ses fournisseurs, l'utilisateur n'est plus soumis  une rente financire,
  - enfin les structures attentives  leurs clients sont favorises.

  Par contre, le point faible du modle conomique est sans doute sur la prminance des services associs sur le dveloppement.
  En effet, je programme ToutDoux de manire indpendante, or, je souhaite poursuivre ce travail  temps complet.
  Toute proposition d'emploi dans ce sens serait pour moi un rel enchantement.
  
* 5. Dpendances

** 1. Dpendances d'utilisation

	- glib-1.2.1		       : infrastructure (utilitaire C)
	- gtk+-1.2.1		       : X Window et widgets
	- gdk-pixbuf-0.9.0	       : manipulation de fichier d'image
	- gnome-libs-1.0.8	       : environnement
	- libxml-2.3.5		       : manipulation de fichier XML
	- gettext-0.10.35	       : internationalisation
	- getxml-1.0.3		       : internationalisation des fichiers XML
	- perl-5.6.0		       : interprteur
	- sed-3.02		       : processeur texte
	- jade-1.2.1		       : processeur texte
	- stylesheets-0.13-4	       : collection de feuilles de styles (SGML/Docbook)

** 2. Dpendances du dorsal SQL

	- postgresql-7.0.1	       : systme de gestion de base de donnes
	- postgresql-server-7.0.1      : systme de gestion de base de donnes
	- postgresql-devel-7.0.1       : systme de gestion de base de donnes

** 3. Complments

	- wget-1.5.3		       : rcupration de fichier distant
	- gtk-doc-0.4		       : gnrateur de documentation
	- tetex-1.0.2		       : formatage de texte
	- dvips-5.86		       : traducteur dvi vers postscript
	- gcolorsel-1.4.0	       : navigateur de palette
	- gfontsel-1.4.0	       : navigateur de polices de caractre
	- emacs-20.7.1		       : editeur texte
	- hopla-1.0.2		       : lien XML-SQL (A FAIRE)

** 4. MySQL

   ToutDoux est oprationnel pour utiliser MySQL comme gestionnaire de base de donnes locale. 
   Or, MySQL ne supportant pas les sous-requetes, impose aux modules un dveloppement spcifique des requtes SQL.
   Donc, nous attendrons la prochaine version de MySQL (v4.00).
   C'est dommage car MySQL semble tre plus adapt que PostgreSQL pour grer un petit dorsal SQL pour application locale.

* 6. Installation 

** 1. Dorsal SQL

  ToutDoux utilise un dorsal SQL (base de donnes) pour tout ce qui concerne le stockage temporaire des donnes.
  Ceci permet de bnfier du puissant language SQL et de moteur de requte fiable et performant comme PostgreSQL.
  L'utilisateur unix (ici 'toto') doit pouvoir crer et supprimer une base de donnes.

  Mettre dans /ect.inittab : pg:2345:respawn:/bin/su - pgsql -c "postmaster" : lancement du serveur postmaster au dmarrage de la station.

	$ /bin/su - pgsql -c "postmaster"			      : lancement du postmaster pour la session courante - start postmaster for current session
	$ su postgres						      : connexion en administrateur de la base de donnes - database's superuser login
	$ initdb		   				      : initialisation de la base de donnes - database initialisation
	$ createuser toto					      : cration du compte utilisateur 'toto' - creation of user 'toto'
	Shall the new user be allowed to create database ? (y/n) y    : permission  l'utilisateur 'toto' de crer des bases de donnes - user's permission for database creation
	Shall the new user be allowed to create more users ? (y/n) n  : permission  l'utilisateur 'toto' de crer des compte utilisateurs - user's permission for user creation
	$ exit				                              : dconnexion de l'administrateur de la base de donnes - database's superuser logout

** 2. Environnement UNIX

        - LINGUAS	    		: les langues pour la compilation et documentation (fr, en, ...)
        - BROWSER			: la navigateur pour le manuel de l'utilisateur (galeon, nautilus, ...)
        - EDITOR			: l'diteur (emacs, vi, ...)

** 3. Compilation

  Les options de configuration sont :
  
	--enable-manual=ARG		compilation et installation du manuel utilisateur [default=yes, no]
	--enable-gtk-doc=ARG		compilation et installation du manuel de rfrence avec gtk-doc [default=auto, no]

  La procdure reste un grand classique :

	$ ./configure			: configuration
	$ make				: compilation
	$ su				: connexion en administrateur
	Password:			: mot de passe - password
	# make install			: installation
	# exit				: dconnexion de l'administrateur

** 4. Lancement

	$ toutdoux			: gestionnaire de projet

* 7. CVS : Gnration de l'arbre source

** 1. Accs anonyme

	$ mkdir ToutDoux
        $ cd ToutDoux
        $ cvs -d:pserver:anonymous@cvs.toutdoux.sourceforge.net:/cvsroot/toutdoux login
	CVS password:
        $ cvs -z3 -d:pserver:anonymous@cvs.toutdoux.sourceforge.net:/cvsroot/toutdoux co -P .
	$ ./autogen.sh
	$ make

** 2. Accs via SSH

	$ export CVS_RSH=ssh 
	$ mkdir ToutDoux
        $ cd ToutDoux
	$ cvs -z3 -ddevelopername@cvs.toutdoux.sourceforge.net:/cvsroot/toutdoux co -P .
	$ ./autogen.sh
	$ make
