-*-outline-*-

**************************************************
ToutDoux : Chtit gestionnaire de projet - A littl' project manager
Copyright (c) 2000-2001 Philippe Roy
Auteur - Author : Philippe Roy <ph_roy@toutdoux.org>
**************************************************


* 0. Prface - Foreword
* 1. Usage
* 2. Licence - License
* 3. Ambitions
* 4. Donations & Emploi - Donations & Job
** 1. Donations
** 2. Prix informatif - Informative price
** 3. Emploi - Job
* 5. Dpendances - Requirements
** 1. Dpendances d'utilisation - Requirements
** 2. Dpendances du dorsal SQL - SQL back-end requirements
** 3. Complments - Complements
** 4. MySQL
* 6. Installation
** 1. Dorsal SQL - SQL back-end
** 2. Compilation
** 3. Lancement - Launch
* 7. CVS : Gnration de l'arbre source - CVS : Generating source tree
** 1. Accs anonyme - Anonymous access
** 2. Accs via SSH - Access via SSH


* 0. Prface - Foreword

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

Phonetically "ToutDoux" and "todo" are equivalent.
"ToutDoux" rather "tout doux" is a French expression. 
It means "all sweet" or "all's well", "going smoothly", "it's cool".

* 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


ToutDoux is a small project manager.

It's :
	- an abstract approach of data organisation/manipulation 
	- a tree of actions classed by folder (themes)
	- an action's type for computer development project


* 2. License - Licence

  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.

  Toutdoux is part of the GNU project, and 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.


* 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, ... )

	- complete like M$ Project (not "details in" ...  (I'll (try to) forget bugs and restrictions))
	- adaptable like database
	- multi-user (groupeware)
	- save to file or database
	- integration into other applications (ERP, ... )


* 4. Donations & Emploi - Donations & Job

** 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.

  Programmers and technicians can contribute by writing software and documentation for 
  ToutDoux development. But if you can't or don't contribute in that way, you can support
  the project by donate money or computer hardware.
  Like authors's list, the supporters's list is included in the software's "About"

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

** 2. Prix informatif - Informative price

   Par comparaison aux produits concurents, on peut estimer ToutDoux  40 Euros.
   By comparing ToutDoux with similars products, we can estimate ToutDoux at 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.

  I'm mechanical engineer (my cv is hosted at Lolix). 
  At present, I hacking ToutDoux independently, but I want to continue in full time. 
  So all job proposition along the same lines will be an absolute delight.

  
* 5. Dpendances - Requirements

** 1. Dpendances d'utilisation - Requirements

	- glib-1.2.1		       : infrastructure (utilitaire C - C utility)
	- gtk+-1.2.1		       : X Window et widgets - X Window and widgets
	- gdk-pixbuf-0.9.0	       : manipulation de fichier d'image - image file manipulation
	- gnome-libs-1.0.8	       : support d'application et widgets - widgets and application support
	- libxml-1.8.10		       : manipulation de fichier XML - XML file manipulation
	- gettext-0.10.35	       : internationalisation - internationalization
	- sed-3.02		       : processeur texte - text processeur
	- jade-1.2.1		       : processeur texte - text processeur
	- stylesheets-0.13-4	       : collection de feuilles de styles (SGML/Docbook) - collection of stylesheets (SGML/Docbook)

** 2. Dpendances du dorsal SQL - SQL back-end requirements

	- postgresql-7.0.1	       : base de donnes - database
	- postgresql-server-7.0.1      : base de donnes - database
	- postgresql-devel-7.0.1       : base de donnes - database

** 3. Complments - Complements

	- wget-1.5.3		       : rcupration de fichier distant - remote file retrieval (HTTP-FTP)
	- gtk-doc-0.4		       : gnrateur de documentation - documentation generator

	- hopla-1.0.2		       : lien XML-SQL - link XML-SQL (TODO)
	- emacs-20.7.1		       : editeur texte - text editor (TODO)
	- xwininfo		       : utilitaire pour fentres X - X window utility (TODO)

** 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.

   ToutDoux is ready for using MySQL like local database manager.
   But MySQL don't know sub-queries, it impose upon modules a specific SQL development.
   So, we must wait the next version of MySQL (v4.00).


* 6. Installation 

** 1. Dorsal SQL - SQL back-end

  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.

  ToutDoux uses a SQL back-end for tempory data storage. 
  So we can benefit by the powerful SQL language and reliables softwares like PostgreSQL.
  The unix user (here 'toto') must create and drop database.

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

	$ /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. Compilation

  Les options de configuration sont : - The options of configuration are : 
  
	--enable-gtk-doc=ARG    use gtk-doc to build documentation [default=auto, no]
	--enable-lang-en=ARG    add English to documentation [default=yes, no]
	--enable-lang-fr=ARG    add French to documentation [default=auto, yes, no]

  La procdure reste un grand classique: - The procedure is famous:

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

** 3. Lancement - Launch

	$ toutdoux	: gestionnaire de projet - project manager

* 7. CVS : Gnration de l'arbre source - CVS : Generating source tree

** 1. Accs anonyme - Anonymous access (without password)

	$ 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 - Access via SSH

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