#labels Featured,Phase-Support,français
# Documentation française

= Usage =

       myrpm.pl [OPTION]

       myrpm.pl est un générateur automatique de fichier spec prêt à l'emploi.

       Myrpm vous permet d'installer des logiciel librement sur un système
       Linux compatible RPM et de réaliser des paquets RPMs binaires depuis
       une liste de fichiers.

       Ce programme gère les droits et les utilisateurs. C'est un outil simple
       qui simplifie le packaging en mode non privilégié.

= Options générales =
 * -h, --help                             : Affichage de l'aide en ligne.
 *        -v, --verbose                          : Mode verbeux, affichage d'information de deboggage.
 *        -m, --multiple                        : découpage en plusieurs packates RPM doc, config et main
 *       -b, --build                            : Compilation automatique du package.
 * -a, --archive=filename                 : Création d’un RPM à partir d’une archive
 * -u, --uid=user id or name              : Identifiant utilisateur pour l’archive
 * -g, --gid=user id or name              : Identifiant de groupe pour l’archive

 *       -t, --template=filename                : Spécification d'un fichier template aternatif.
 *       -x, --exclude="pattern1,pattern2"      : Exclusion de certaines formes de fichier.
 *       -r, --root-directory=<directory>       : Répertoire racine  ( / par défaut ).
 *      -d, --directory=<directory>            : Répertoire à packager.
                                                 Par défaut, la liste de fichiers est construite depuis le flux d'entrée standard.

= Options du package RPM =
 *       -N, --name=<name>                      : Nom du package - Option obligatoire.
 *       -V, --version=<version>                : Version du package - Option obligatoire.
 *       -R, --release=<release>                : Release du package - Option obligatoire.
 *       -D, --description=<description>        : Description du package.
 *       -S, --summary=<summary>                : Résumé du package.
 *       -P, --packager=<packager>              : Identité du packageur.
 *       -U, --vendor-url=<vendor url>          : URL du fournisseur.
 *       -O, --vendor=<vendor>                  : Nom du fournisseur.
 *       -A, --architecture=<archi>             : Architecture cible.
 *       -T, --distribution=<distro>            : Distribution cible.
 *       --requires=<dependency>,...            : Liste des dépendances.
 *       --build-script=<filename>                : Nom du script à inclure dans la session %build.
 *       --pre-script=<filename>                : Nom du script à inclure dans la session %pre.
 *       --post-script=<filename>               : Nom du script à inclure dans la session %post.
 *      --preun-script=<filename>              : Nom du script à inclure dans la session %preun.
 *      --postun-script=<filename>             : Nom du script à inclure dans la session %postun.

= Exemples =
 == Réalisation rapide d'une image du répertoire /home/jmrenouard/myrpmBuildDir ==

 myrpm.pl -v -d /home/jmrenouard/myrpmBuildDir -r /home/jmrenouard/myrpmBuildDir -N toto -V 1.0 -R 1 -b

== Une autre version ==
 cd /home/jmrenouard/myrpmBuildDir && myrpm.pl -v -d . -r . -N toto -V 1.0 -R 1 -b

 == La même avec des interactions avec les outils UNIX ==

 cd /home/jmrenouard/myrpmBuildDir && find 'pwd' -iname '**' -print |
 myrpm.pl -v -r /home/jmrenouard/myrpmBuildDir -N toto -V 1.0 -R 1 -b

 find /home/jmrenouard/myrpmBuildDir | myrpm.pl -r /home/jmrenouard/myrpmBuildDir -N toto -V 1.0 -R 1

        == Explications ==

  Le script réalise les opérations suivantes :

  * Find construit la liste de tous les fichiers contenus dans le répertoie /home/jmrenouard/myrpmBuildDir.
  * Myrpm.pl packages  tous les fichiers du répertoie /home/jmrenouard/myrpmBuildDir dans le package ayant toto comme nom, 1.0 comme version et 1 comme release.

  * Myrpm.pl considère /home/jmrenouard/myrpmBuildDir comme répertoire root ( / ) si bien que tous les fichiers seront installé à la racine par le programme rpm.

  == Repackager une configuration existante ==

 rpm -ql yum |  myrpm.pl -v -N yum -V 2.7 -R 1_jmr -b

      == Explications ==

 * Rpm donne la liste des fichiers du package Yum installé sur le système.

 * myrpm.pl packages tous les fichiers de ce package dans un nouveau package avec yum comme nom.

 Il s'agit d'un nouveau moyen de packager des modifications depuis un système installé.

= Exemple de fichier de configuration =
 Myrpm utilise le fichier utilisateur pour configurer les valeurs par défaut.

       == Exemples de $HOME/.rpmmacros standard ==
 
 %_topdir       /home/jmrenouard/redhat

 %packager      Jean-Marie Renouard<jmrenouard.externe at pagesjaunes.fr>

 %vendor                Pages Jaunes

 %vendor_url    http://www.pagesjaunes.fr

 %distribution   Red Hat Enterprise 4

 %dist_tag       .1

 %_tmppath      /var/tmp

= Aide à l'amélioration du produit =
       Merci de soumettre les erreurs et les remarques sur
       http://code.google.com/p/myrpm/issues/list


       Vous pouvez contactez Jean-Marie Renouard <jmrenouard at gmail.com>
       pour plus de détails.