diff --git a/src/usr/doc/ChangeLog.txt b/src/usr/doc/ChangeLog.txt index a7d7580..5185365 100644 --- a/src/usr/doc/ChangeLog.txt +++ b/src/usr/doc/ChangeLog.txt @@ -3,7 +3,8 @@ Sbopkg X.XX.X released. This version contains the following fixes and enhancements: * Revised man pages - these are very different and now document a couple of - previously undocumented things and are worth a (re-)read. + previously undocumented things and are worth a (re-)read. Thanks to + Marie-Claude Collilieux for the French translations of these. * The HACKING file now includes a man page style guide in addition to the coding style guide. * The LOGDIR variable has been removed from sbopkg.conf - DIR can be diff --git a/src/usr/man/fr/man5/sbopkg.conf.5 b/src/usr/man/fr/man5/sbopkg.conf.5 index 53c1c01..b740716 100644 --- a/src/usr/man/fr/man5/sbopkg.conf.5 +++ b/src/usr/man/fr/man5/sbopkg.conf.5 @@ -1,340 +1,588 @@ -.TH SBOPKG.CONF 5 "Juillet 2010" sbopkg-0.33.2 "" +.\"===================================================================== +.TH SBOPKG.CONF 5 "xxxDATExxx" sbopkg-SVN "" +.\"===================================================================== .SH NAME -.B sbopkg.conf -\- Fichier de Configuration de sbopkg - +sbopkg.conf \- Fichier de Configuration de sbopkg +.\"===================================================================== .SH DESCRIPTION -Le fichier sbopkg.conf contient les paramètres de configuration pour -.B sbopkg -(8), un outil pour utiliser le dépôt de SlackBuilds.org ("SBo"), -une collection de scripts Slackbuild externes pour construire des -packages Slackware. Un fichier exemple est fourni par -/etc/sbopkg/sbopkg.conf.new. Lisez aussi, s'il vous plait, la note -ci-dessous sur $ARCH. - -Les options booléennes sont insensibles à la casse. - +Le fichier +.I sbopkg.conf +contient les paramètres de configuration pour +.BR sbopkg (8), +un outil pour utiliser le dépôt de SlackBuilds.org ("SBo"), +une collection de scripts Slackbuild tiers pour construire des +packages Slackware. +Le fichier de configuration par défaut est +.IR /etc/sbopkg/sbopkg.conf . +Lisez aussi, s'il vous plait, la note ci-dessous sur +.BR $ARCH. +.PP +Les options booléennes nécessitent un +.B YES +ou un +.B NO +et sont insensibles à la casse. +Tous les chemins utilisés doivent être absolus. +.PP Voici les différentes options de configuration\ : -.TP 5 -.B REPO_NAME -.br -Cette option permet à l'utilisateur de choisir le dépôt à utiliser. -Les possibilités sont SBo, SB64 et local. -Le choix "local" correspond à un dépôt géré par l'utilisateur et -dont la structure doit être identique à celle de SlackBuilds.org. -NOTE\ : toutes les variables préfixées par REPO_ sont concernées par -les fichiers de dépôt gérés dans le répertoire /etc/sbopkg/repos.d. -Lire le fichier README-repos.d dans le répertoire /doc de sbopkg. - -La valeur par défaut de REPO_NAME est\ : -.br -REPO_NAME=${REPO_NAME:-SBo}. - -.TP 5 -.B REPO_BRANCH -.br -Cette option permet à l'utilisateur de définir la branche active -par défaut du dépôt. Les valeurs possibles sont 11.0, 12.0, 12.1, -12.2, 13.0 et 13.1 pour le dépôt SBo et local pour le dépôt local. -Le dépôt Slamd64Builds est "master" mais n'est pas officiellement -maintenu. - -La valeur par défaut de REPO_BRANCH est\ : -.br -REPO_BRANCH=${REPO_BRANCH:-13.1}. - -.TP 5 -.B REPO_ROOT -.br -Cette option permet à l'utilisateur de définir l'emplacement des -miroirs locaux des dépôts externes. Actuellement la taille d'une copie -locale du dépôt SBo est inférieure à 50MB. - -La valeur par défaut de REPO_ROOT est\ : -.br -REPO_ROOT=${REPO_ROOT:-/var/lib/sbopkg}. - -.TP 5 -.B SRCDIR -.br -Cette option indique l'emplacement du répertoire cache qui -contiendra la sauvegarde des sources téléchargées. - -La valeur par défaut de SRCDIR est\ : -.br -SRCDIR=${SRCDIR:-/var/cache/sbopkg}. - -.TP 5 -.B SBOPKGTMP -.br -Cette option indique le répertoire dans lequel certains fichiers -de travail seront sauvegardés temporairement. - -La valeur par défaut de SBOPKGTMP est\ : -.br -SBOPKGTMP=${SBOPKGTMP:-/tmp/sbopkg}. - -.TP 5 -.B TMP -.br -Cette option définit le répertoire dans lequel seront sauvegardés les -paquets construits. TMP doit être exporté car il est aussi utilisé par -les SlackBuilds SBo. Notez que la valeur par défaut de TMP est donc -identique à celle des scripts SlackBuildS SBo. - -La valeur par défaut de TMP est\ : -.br -export TMP=${TMP:-/tmp/SBo}. - -.TP 5 -.B OUTPUT -.br -Cette option définit le répertoire où seront sauvegardés les paquets -compilés. OUTPUT doit être exporté car il est aussi utilisé par les -SlackBuilds SBo. La valeur par défaut de OUTPUT est donc la même que -celle des SlackBuildS SBO. - -La valeur par défaut de OUTPUT est\ : -.br -export OUTPUT=${OUTPUT:-/tmp}. - - -.TP 5 -.B QUEUEDIR -.br -Cette option définit le répertoire dans lequel seront enregistrées les -files d'attente sauvegardées. - -La valeur par défaut de QUEUEDIR est\ : -.br -QUEUEDIR=${QUEUEDIR:-/var/lib/sbopkg/queues}. - -.TP 5 -.B KEEPLOG -.br -Cette option doit prendre la valeur YES ou NO. Elle permet à -l'utilisateur de conserver un journal permanent des paquets qui sont -construits avec sbopkg pour pouvoir revenir en arrière, revoir la -construction et les erreurs éventuelles après avoir quitté sbopkg. -Si la valeur est YES, ce journal est sauvegardé à l'emplacement -$LOGDIR/sbopkg-build-log. - -La valeur par défaut de KEEPLOG est\ : YES. - -.TP 5 -.B LOGDIR -.br -Cette option définit l'emplacement du journal de sbopkg si l'option -KEEPLOG est à YES (voir le paragraphe précédent) - -La valeur par défaut de LOGDIR est\ : -.br -LOGDIR=${LOGDIR:-/var/log/sbopkg}. - -.TP 5 -.B CLEANUP -.br -Cette option doit être définie à YES ou NO. Définie à YES, les fichiers -source et les divers éléments restant après la construction d'un paquet -seront effacés immédiatement après la construction. -Définir CLEANUP à YES aura aussi pour effet d'ignorer la valeur de TMP -définie via les variables d'environnement ou via les fichiers de -configuration. - -La valeur par défaut de CLEANUP est\ : NO - -.TP 5 +.\"--------------------------------------------------------------------- +.TP 3 .B ALLOW_MULTI -.br -Définie à YES, cette option permet à l'utilisateur de lancer plusieurs -instances de sbopkg. - +Booléen. +.IP +Si sa valeur est +.BR YES , +cette option permet à l'utilisateur de lancer plusieurs instances +simultanées de +.B sbopkg +.IP Comprenez bien que cette option est là pour votre commodité, mais étant donné le nombre d'erreurs potentielles qu'elle peut entraîner (et nous -n'avons pas l'intention de perdre du temps avec les âneries que peut -faire un utilisateur), il faut considérer que travailler avec -ALLOW_MULTI=YES est une fonctionnalité EXPÉRIMENTALE et NON PRISE EN -CHARGE. Si vous rencontrez des problèmes, vérifiez bien qu'ils ne -viennent pas d'actions inappropriées de votre part. +n'allons pas tenter de prévoir toutes les bêtises que peut +faire un utilisateur), il faut considérer que c'est une fonctionnalité +EXPÉRIMENTALE et NON PRISE EN CHARGE. +Si vous rencontrez des problèmes, vérifiez bien qu'ils ne viennent pas +d'actions inappropriées de votre part. -Pour référence, voici quelques unes des actions à ne pas faire lors +Pour information, voici quelques unes des choses à ne pas faire lors de l'utilisation de cette option\ : -.RS 6 -.IP \[bu] 2 -Lancer une instance avec ALLOW_MULTI=NO en même temps que une ou -plusieurs instances avec ALLOW_MULTI=YES. -.IP \[bu] +.RS 5 +.TP 3 +\(bu +Lancer plusieurs instances avec un mélange de paramètres +.B YES +et de paramètres +.B NO +.TP +\(bu Synchroniser un dépôt lorsqu'une autre instance l'utilise. -.IP \[bu] +.TP +\(bu Changer de branche sur un depôt git lorsqu'une autre instance l'utilise -(vous pouvez faire ceci avec un dépôt rsync --- par exemple SlackBuild.org --) -.IP \[bu] -Construire ou installer simultanément le même logiciel à partir de +(cet avertissement ne concerne pas les dépôts rsync) +.TP +\(bu +Compiler ou installer simultanément le même logiciel à partir de différentes instances -.IP \[bu] +.TP +\(bu Sauvegarder une file d'attente en cours d'utilisation par une autre instance .RE - -.RS 5 +.IP Il peut y avoir encore d'autres situations dangereuses auxquelles nous n'avons pas pensé. Soyez prudents. -.RE - - - -.TP 5 -.B DEBUG -.br -Cette option a pour valeur 0, 1 ou 2. DEBUG définit le niveau de débogage -par défaut de la liste de mise à jour de sbopkg. Si DEBUG vaut 0, on affiche -seulement les paquets pouvant être mis à jour (ou degradés). Si DEBUG vaut 1, -on affiche les paquets qui peuvent être mis à jour, les paquets qui ne sont -pas dans le dépôt et les paquets qui sont plus neufs que ceux du dépôt. -Si DEBUG vaut 2, on affiche tous les paquets non à jour. -Modifier la valeur de DEBUG à 1 ou 2 peut être utile si la liste des mises à -jour parait incompléte. - -La valeur par défaut de DEBUG est\ : 0. - -.TP 5 -.B MKDIR_PROMPT -.br -Cette option peut prendre la valeur YES ou NO. Si elle vaut YES, sbopkg -demandera confirmation avant de modifier le système de fichiers en -créant ses répertoires. Si vous ne souhaitez pas avoir à confirmer -(par exemple, certains de ces répertoires sont dans un système de -fichiers temporaires et vous ne voulez avoir à confirmer à chaque -réinitialisation du système de fichiers), vous pouvez mettre cette -valeur à NO. - -La valeur par défaut de DEBUG est\ : YES. - - -.TP 5 -.B RSYNCFLAGS -.br -Rsync est utilisé par sbopkg pour dupliquer le dépôt de SlackBuilds.org. -Cette option permet à l'utilisateur d'ajuster les indicateurs (options) -de rsync utilisés par sbopkg. Les utilisateurs sont mis en garde contre -toute modification des valeurs par défaut de ces indicateurs, -de nouvelles valeurs pouvant fonctionner ou non. -Note\ : la commande rsync de sbopkg utilise déjà les indicateurs --archive, ---delete, --no-owner, et --exclude, il n'est donc pas nécessaire de les -ajouter dans les options de RSYNCFLAGS. Modifier ces options par défaut -n'est pas conseillé. - -La valeur par défaut de RSYNCFLAGS est\ : "--timeout=10 --verbose". - -.TP 5 -.B WGETFLAGS -.br -Wget est utilisé par sbopkg pour télécharger les sources des paquets à -compiler. Cette option permet à l'utilisateur d'ajuster les indicateurs -(options) de wget utilisés par sbopkg. Les utilisateurs sont mis en -garde contre toute modification des valeurs par défaut de ces -indicateurs, de nouvelles valeurs pouvant fonctionner ou non. -Note\ : sbopkg utilise déjà l'option -O de wget, il n'est donc pas -nécessaire de le rajouter dans les options de WGETFLAGS. Modifier ces -options par défaut n'est pas conseillé. - -La valeur par défaut de WGETFLAGS est\ : -.br -"--continue --progress-bar:force --timeout=15 --tries=5". - -.TP 5 +.IP +La valeur par défaut est\ : +.IP +\fCxxxALLOW_MULTIxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B CLEANUP +Booléen. +.IP +Quand il vaut +.BR YES , +les fichiers source décompressés et l'arborescence du paquet dans +.I $TMP +sont effacés immédiatement après la construction, alors que l'archive +source et le paquet réalisé sont conservés dans +.I $SRCDIR +et +.IR $OUTPUT . +.IP +Un effet secondaire de +.B CLEANUP +à +.B YES +est que +.B TMP +est défini par une valeur interne et toute autre valeur de +configuration de +.B TMP +est ignorée. +.IP +La valeur par défaut est\ : +.IP +\fCxxxCLEANUPxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B DEBUG_UPDATES +Énumeration. +.IP +Cette option peut prendre les valeurs +.BR 0 , +.BR 1 , +ou +.BR 2 . +.B DEBUG_UPDATES +définit le niveau de débogage par défaut de la liste de mise à jour de +.BR sbopkg . +Quand elle vaut +.BR 0 , +on affiche seulement les paquets pouvant être mis à jour (ou dégradés). +Quand elle vaut +.BR 1 , +on affiche les paquets qui peuvent être mis à jour, les paquets qui ne +sont pas dans le dépôt et les paquets qui sont plus neufs que ceux du +dépôt. +Quand elle vaut +.BR 2 , +on affiche aussi tous les paquets non à jour. +Modifier +.B DEBUG_UPDATES +à +.B 1 +ou +.B 2 +peut être utile si la liste des mises à jour parait incompléte. +.IP +La valeur par défaut est\ : +.IP +\fCxxxDEBUG_UPDATESxxx\fP +.\"--------------------------------------------------------------------- +.TP .B DIFF -.br +Commande. +.IP Cette option permet à l'utilisateur de définir le programme de -comparaison à utiliser quand sbopkg doit afficher les différences -entre fichiers. - -La valeur par défaut de DIFF est\ : -.br -DIFF=${DIFF:-diff}. - -.TP 5 +comparaison à utiliser quand +.B sbopkg +affiche les différences entre fichiers édités. +.IP +La valeur par défaut est\ : +.IP +\fCxxxDIFFxxx\fP +.\"--------------------------------------------------------------------- +.TP .B DIFFOPTS -.br +Options de commande. +.IP Cette option permet à l'utilisateur de définir les options utilisées -par le programme de comparaison quand sbopkg affiche les différences -entre fichiers. +par le programme +.I $DIFF +quand +.B sbopkg +affiche les différences entre fichiers édités. +.IP +La valeur par défaut est\ : +.IP +\fCxxxDIFFOPTSxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B KEEPLOG +Booléen. +.IP +Cette option permet à l'utilisateur de conserver un journal permanent +des paquets qui sont construits avec +.B sbopkg +pour pouvoir revoir les compilations pour mémoire ou pour d'éventuelles +erreurs. +Voir +.B LOGFILE +pour l'emplacement de ce journal. +.IP +La valeur par défaut est\ : +.IP +\fCxxxKEEPLOGxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B LOGFILE +Chemin. +.IP +Cette option définit l'emplacement du journal de compilation si l'option +.B KEEPLOG +vaut +.BR YES . +.IP +La valeur par défaut est\ : +.IP +\fCxxxLOGFILExxx\fP +.\"--------------------------------------------------------------------- +.TP +.B MKDIR_PROMPT +Booléen. +.IP +Quand il vaut +.BR YES , +.B sbopkg +demandera confirmation avant de modifier le système de fichiers en +créant ses répertoires. +Si vous ne souhaitez pas avoir à confirmer (par exemple, certains de +ces répertoires sont dans un système de fichiers temporaires et vous +ne voulez avoir à confirmer à chaque réinitialisation du système de +fichiers), vous pouvez mettre cette valeur à +.BR NO . +.IP +La valeur par défaut est\ : +.IP +\fCxxxMKDIR_PROMPTxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B OUTPUT +Chemin. +.IP +Cette option définit le répertoire où seront sauvegardés les paquets +compilés. +.B OUTPUT +doit être exporté car il est aussi utilisé par les SlackBuilds SBo. +À noter que La valeur par défaut de +.B OUTPUT +est donc la même que celle des SlackBuildS SBO. +.IP +La valeur par défaut est\ : +.IP +\fCxxxOUTPUTxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B QUEUEDIR +Chemin. +.IP +Cette option définit le répertoire dans lequel seront enregistrées les +files d'attente sauvegardées. +.IP +La valeur par défaut est\ : +.IP +\fCxxxQUEUEDIRxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B REPO_BRANCH +Énumeration. +.IP +Cette option permet à l'utilisateur de définir la branche active +par défaut. Les valeurs actuellement possibles sont indiquées dans le +fichier +.I repos.d/* +et peuvent aussi être affichées en tapant +.RS +.IP +.nf +\fC# sbopkg -V ?\fP +.fi +.RE +.IP +La valeur par défaut est\ : +.IP +\fCxxxREPO_BRANCHxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B REPO_NAME +Énumeration. +.IP +Cette option permet à l'utilisateur de choisir le dépôt à utiliser. +Voir +.B REPO_BRANCH +pour savoir comment obtenir une liste des valeurs admises. +Le choix "local" correspond à un dépôt géré par l'utilisateur et +dont la structure doit être identique à celle de SBo, c'est à dire avec +une hiérarchie +.I category/package/files -La valeur par défaut de DIFFOPTS est\ : - -DIFFOPTS=${DIFFOPTS:--u} - - -.SH REDÉFINIR LES VARIABLES D'ENVIRONMENT +Note\ : toutes les variables +.B REPO_* +sont concernées par les fichiers de dépôt gérés dans le répertoire +.I /etc/sbopkg/repos.d. +Lire le fichier +.I README-repos.d +dans le répertoire de documentation de +.B sbopkg +.IP +La valeur par défaut est\ : +.IP +\fCxxxREPO_NAMExxx\fP +.\"--------------------------------------------------------------------- +.TP +.B REPO_ROOT +Chemin. +.IP +Cette option permet à l'utilisateur de définir l'emplacement des +miroirs locaux des dépôts externes. +Actuellement la taille d'une copie locale du dépôt SBo est xxxSIZExxx. +.IP +La valeur par défaut est\ : +.IP +\fCxxxREPO_ROOTxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B RSYNCFLAGS +Options de commande. +.IP +.B Rsync +est utilisé par +.B sbopkg +pour dupliquer le dépôt de SlackBuilds.org. +Cette option permet à l'utilisateur d'ajuster les indicateurs (options) +de +.B rsync +utilisés par +.BR sbopkg . +Les utilisateurs sont mis en garde contre toute modification des +valeurs par défaut de ces indicateurs, de nouvelles valeurs pouvant +fonctionner ou non. +Note\ : la commande +.B rsync +de +.B sbopkg +utilise déjà les indicateurs +.BR \-\-archive , +.BR \-\-delete , +.BR \-\-no-owner , +et +.B \-\-exclude +il n'est donc pas nécessaire de les ajouter dans les options de +.B RSYNCFLAGS +Modifier ces options par défaut n'est pas conseillé. +Cependant, +.B \-\-timeout +est une option utile à tester en cas d'erreur de synchronisation. +.IP +La valeur par défaut est\ : +.IP +\fCxxxRSYNCFLAGSxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B SBOPKGTMP +Chemin. +.IP +Cette option indique le répertoire dans lequel certains fichiers +de travail spécifiques à +.B sbopkg +seront sauvegardés temporairement. +.IP +La valeur par défaut est\ : +.IP +\fCxxxSBOPKGTMPxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B SRCDIR +Chemin. +.IP +Cette option indique l'emplacement du répertoire cache qui +contiendra la sauvegarde des sources téléchargés. +.IP +La valeur par défaut est\ : +.IP +\fCxxxSRCDIRxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B TMP +Chemin. +.IP +Cette option définit le répertoire dans lequel seront sauvegardés les +paquets construits. +.B TMP +doit être exporté car il est aussi utilisé par les SlackBuilds SBo. +À noter que la valeur par défaut de +.B TMP +est donc identique à celle des SlackBuildS SBo. +.IP +À noter aussi que si la variable +.B CLEANUP +vaut +.BR YES , +toute personnalisation de +.B TMP +est ignorée +.IP +La valeur par défaut est\ : +.IP +\fCxxxTMPxxx\fP +.\"--------------------------------------------------------------------- +.TP +.B WGETFLAGS +Options de commande. +.IP +.B Wget +est utilisé par +.B sbopkg +pour télécharger les sources des paquets à compiler. +Cette option permet à l'utilisateur d'ajuster les indicateurs +(options) de +.B wget +utilisés par +.BR sbopkg . +Les utilisateurs sont mis en garde contre toute modification des +valeurs par défaut de ces indicateurs, de nouvelles valeurs pouvant +fonctionner ou non. +Note\ : la commande +.B wget +de +.B sbopkg +utilise déjà l'indicateur +.B \-O +il n'est donc pas nécessaire de le rajouter dans les options de +.B WGETFLAGS +Modifier ces +options par défaut n'est pas conseillé. +Cependant, +.B \-\-timeout +est une option utile à tester en cas d'erreur de téléchargement. +.IP +La valeur par défaut est\ : +.IP +\fCxxxWGETFLAGSxxx\fP +.\"===================================================================== +.SH NOTES +.\"--------------------------------------------------------------------- +.SS Overriding Environmental Variables Il est possible de définir ou de redéfinir des variables d'environnement et de les exporter vers les scripts SlackBuilds lorsqu'il sont -construits avec sbopkg. Nous avons déjà vu l'exemple suivant dans -le fichier sbopkg.conf\ : - -export TMP=${TMP:-/tmp/SBo} - -Ceci définit la valeur de $TMP pour la construction des paquets -par sbopkg (c'est déjà la valeur par défaut dans les SlackBuilds SBo). +construits avec +.BR sbopkg . +Ceci est déjà demontré dans l'exemple suivant (et d'autres +semblables) dans le fichier +.I sbopkg.conf . +.RS +.PP +.nf +\fCexport TMP=${TMP:-/tmp/SBo}\fP +.fi +.RE +.PP +Ceci définit la valeur de +.B TMP +à +.I /tmp/SBo +for building SBo packages within +pour la construction des paquets SBo dans +.B sbopkg +(c'est déjà la valeur par défaut dans les SlackBuilds SBo). Puisque cette variable est exportée, elle peut être modifiée à la fois -pour sbopkg et pour la construction des paquets SBo. Par exemple, -modifier cette ligne pour\ : - -export TMP=${TMP:-/home/sbo/tmp} - -définit $TMP comme /home/sbo/tmp pour la construction -des paquets. OUTPUT peut aussi être modifié pour sauvegarder les -paquets compilés dans un autre emplacement que celui par défaut, /tmp. - -Se souvenir que si la variable CLEANUP vaut YES, la définition de TMP -est ignorée. - -Il est possible également, d'exporter dans sbopkg.conf des variables -qui ne sont aucunement utilisées par sbopkg. - -.SH À PROPOS DE LA VARIABLE $ARCH -Vous pouvez vous demander pourquoi $ARCH n'est pas un élément de -configuration dans le fichier sbopkg.conf. La raison est qu'il n'a pas -à y être. D'abord sbopkg fait certaines vérifications (avec 'uname -m') - pour déterminer l'architecture du système. Si cette architecture est -x86_64, alors sbopkg définit automatiquement ARCH=x86_64. Si cette -architecture n'est pas x86_64, alors sbopkg récupère la définition de -$ARCH dans l'environnement. Ce qui signifie que l'utilisateur peut -ajouter, par exemple, 'export ARCH=i686' dans son .bashrc ou dans un -fichier similaire, il peut aussi exécuter quelque chose comme -'export ARCH=i686 && sbopkg' dans un terminal root. En conclusion, si -$ARCH n'est pas défini par l'utilisateur et si sbopkg ne détecte pas -un système x86_64, alors $ARCH prendra par défaut la valeur définie -pour $ARCH dans les scripts SlackBuild. - +pour +.B sbopkg +et pour la construction des paquets dans +.BR sbopkg . +Par exemple, modifier cette ligne pour\ : +.RS +.PP +.nf +\fCexport TMP=${TMP:-/home/sbo/tmp}\fP +.fi +.RE +.PP +définit +.B TMP +comme +.I /home/sbo/tmp +pour la construction des paquets SBo, mais permet cependant de +l'outrepasser au démarrage en lançant +.B sbopkg +ainsi +.RS +.PP +.nf +\fC# export TMP=foo; sbopkg\fP +.fi +.RE +.PP +.B OUTPUT +peut aussi être modifié pour sauvegarder les paquets compilés dans un +autre emplacement que celui par défaut, +.IR /tmp . +.PP +On peut également exporter dans +.I sbopkg.conf +des variables qui ne sont aucunement utilisées par +.B sbopkg . +.\"--------------------------------------------------------------------- +.SS À propos de la variable ARCH +Vous pouvez vous demander pourquoi +.B ARCH +n'est pas configuré dans le fichier par défaut +.I sbopkg.conf . +La raison est qu'il n'a pas à y être. +Si +.B ARCH +n'est pas défini, +.B sbopkg +fait certaines vérifications (utilisant la sortie de +.BR "uname \-m" ) +pour déterminer l'architecture du système. +Si cette architecture est x86, x86_64 ou arm*, alors +.B sbopkg +définit automatiquement +.B ARCH +à i486, x86_64, ou arm, respectivement. +Si +.B ARCH +est défini, +.B sbopkg +récupère cette définition. +Ce qui signifie que l'utilisateur peut, par exemple, ajouter +.B export ARCH=i686 +dans son +.I .bashrc +ou dans un fichier similaire, il peut aussi exécuter, dans un terminal +root, quelque chose comme +.RS +.PP +.nf +\fC# export ARCH=i686; sbopkg\fP +.fi +.RE +.PP +L'utilisateur peut aussi l'ajouter manuellement dans son fichier +.I sbopkg.conf +s'il le souhaite. +En conclusion, si +.B ARCH +n'est pas défini par l'utilisateur et si +.B sbopkg +ne détecte pas l'une des architectures citées précédemment, alors +.B ARCH +prendra par défaut la valeur définie dans les SlackBuilds. +À noter que le SlackBuild peut, dans certains cas, écarter ou +outrepasser des paramètres précédents de +.B ARCH +si c'est nécessaire pour la compilation. +.\"===================================================================== .SH FILES -.B /etc/sbopkg/sbopkg.conf -\ - Fichier qui contient les options de configuration. - -.B /etc/sbopkg/renames.d/50-default -\ - Fichier contenant la liste des logiciels du dépôt SBo qui ont été renommés. -Lire le fichier README-renames.d dans le répertoire /doc de sbopkg pour -plus d'information. - -.B /etc/sbopkg/repos.d/{40-sbo.repo,50-sb64.repo,60-local.repo} -\ - Trois fichiers par défaut pour les différents types de dépôts de sbopkg. -Lire le fichier README-repos.d dans le répertoire /doc de sbopkg pour -plus d'information. - - -.SH "VOIR AUSSI" -.BR sbopkg (8) -.BR doc/README -.BR doc/README-queuefiles -.BR doc/README-renames.d -.BR doc/README-repos.d -.BR doc/queuefiles/* - +.TP 3 +.I /etc/sbopkg/sbopkg.conf +Fichier qui contient les options de configuration. +.TP +.I /etc/sbopkg/renames.d/50-default +Fichier contenant la liste des logiciels du dépôt SBo qui ont été +renommés. +Voir le fichier +.I README-renames.d +dans le répertoire de documentation de +.B sbopkg +pour plus d'information. +.TP +.I /etc/sbopkg/repos.d/{40-sbo.repo,50-sb64.repo,60-local.repo} +Trois fichiers par défaut pour les différents types de dépôts de +.B sbopkg . +Voir le fichier +.I README-repos.d +dans le répertoire de documentation de +.B sbopkg +pour plus d'information. +.\"===================================================================== +.SH AUTHORS +Chess Griffin + +.PP +Mauro Giachero + +.PP +slakmagik + +.\"===================================================================== +.\" Make the release process handle a DOCDIR here? But the files from +.\" the official tarball go here. +.SH VOIR AUSSI +.BR diff (1), +.BR rsync (1), +.BR sbopkg (8), +.BR uname (1), +.BR wget (1), +.IR /usr/doc/sbopkg-SVN/* +.\"===================================================================== .SH TRADUCTION - Ce document est une traduction réalisée par M.C Collilieux - le 21\ juillet\ 2010. + le 28\ juillet\ 2010. N'hésitez pas à signaler au traducteur, toute erreur dans cette page de manuel. La version anglaise la plus à jour de ce document est toujours diff --git a/src/usr/man/fr/man8/sbopkg.8 b/src/usr/man/fr/man8/sbopkg.8 index ba771ba..9c13886 100644 --- a/src/usr/man/fr/man8/sbopkg.8 +++ b/src/usr/man/fr/man8/sbopkg.8 @@ -1,296 +1,513 @@ -.TH SBOPKG 8 "juillet 2010" sbopkg-0.33.2 "" +.\"===================================================================== +.TH SBOPKG 8 "xxxDATExxx" sbopkg-SVN "" +.\"===================================================================== .SH NAME -.B sbopkg -\ - Le navigateur de paquets SlackBuilds.org - +sbopkg \- Le navigateur de paquets SlackBuilds.org +.\"===================================================================== .SH SYNOPSIS .B sbopkg -.B [options] - +.RI [ options ] +.\"===================================================================== .SH DESCRIPTION -Sbopkg est un outil en ligne de commande interactif pour utiliser le -depôt de SlackBuilds.org ("SBo"), une collection de scripts SlackBuild -externes pour compiler des paquets Slackware. - -.SH INSTRUCTIONS -L'utilisation de sbopkg présuppose une compréhension des scripts -SlackBuild en général et du dépôt SlackBuilds.org en particulier. +.B Sbopkg +est un outil en ligne de commande ou avec une interface +.BR dialog +pour utiliser le depôt de SlackBuilds.org ("SBo"), une collection +de scripts SlackBuild tiers pour compiler des paquets +Slackware. +.\"--------------------------------------------------------------------- +.SS Instructions +L'utilisation de +.B Sbopkg +suppose une compréhension des scripts SlackBuild +en général et du dépôt SlackBuilds.org en particulier. Il est fortement recommandé de lire attentivement -http://www.slackbuilds.org/howto/ et les pages traitant des scripts -SlackBuild sur http://www.slackwiki.org. - -Avant de pouvoir utiliser sbopkg, il faut créer le fichier de -configuration /etc/sbopkg/sbopkg.conf. Un fichier exemple est -fourni avec /etc/sbopkg/sbopkg.conf.new. Voir -.B sbopkg.conf -(5) pour plus d'information sur ce fichier de configuration. - -Sbopkg peut être lancé depuis la ligne de commande en tapant simplement -"sbopkg". Sbopkg doit être lancé par root (puisque les scripts -Slackbuild sont prévus pour être utilisés par root). De plus, il est -fortement conseillé d'utiliser 'su -' au lieu de 'su'. Parce que -quelques scripts (par ex. texmf pour construire les pages de manuel) -dépendent de certains outils disponibles uniquement dans le $PATH de -root quand celui-ci est hérité, ce qui n'est pas le cas en utilisant -seulement 'su'. Dans tous les cas, appeler 'sbopkg' depuis la ligne de -commande va lancer l'interface de dialogue, les menus affichés devraient -être suffisament parlants. Le menu principal permet à l'utilisateur -de se synchroniser (avec rsync) avec le dépôt de SlackBuilds.org -(actuellement la taille d'une copie locale du dépôt SBo est inférieure à -50MB), de voir le journal de SlackBuilds.org, de rechercher les mises -à jour possibles de paquets SBo, d'afficher le contenu du répertoire -cache local où sont sauvegardés les sources, d'afficher le journal -permanent des compilations et de lister ou de chercher dans la copie -locale du dépôt de SBo. - +.I http://www.slackbuilds.org/howto/ +et les pages traitant des scripts SlackBuild sur +.I http://www.slackwiki.org +.PP +Avant de pouvoir utiliser +.BR sbopkg , +il faut créer le fichier de configuration +.IR /etc/sbopkg/sbopkg.conf . +Une première installation fournit ce fichier à l'utilisateur tandis +qu'une mise à jour ajoutera un fichier +.I /etc/sbopkg/sbopkg.conf.new +qui pourra remplacer ou être fusionné avec l'ancienne version. +Voir +.BR sbopkg.conf (5) +pour plus d'information sur ce fichier de configuration. +.PP +.B Sbopkg +doit être lancé en tant que root (les Slackbuilds SBo sont écrits pour +être utilisés par l'utilisateur root) +De plus, utiliser l'option +.B \- +avec +.B su +est fortement recommandé. +La raison en est que quelques SlackBuilds dépendent de certains outils +disponibles uniquement dans le +.B PATH +de root quand les scripts situés dans +.I /etc/profile.d +ont été exécutés (par ex. +.B texmf +pour construire les pages de manuel), ce qui n'est réalisé que pour les +login shells, ou sinon exige un environnement root "plus vrai" que celui +fourni par +.BR su +seulement. +Dans tous les cas, appeler +.B sbopkg +sans argument (ou seulement avec +.BR \-d , +.BR \-f , +ou +.BR \-V ) +lancera l'interface +.BR dialog +et les menus affichés devraient être suffisament parlants. +.PP +Le menu principal permet à l'utilisateur de se synchroniser avec le +dépôt de SBo. C'est la première étape (après la configuration) d'une +nouvelle installation de +.BR sbopkg . +Actuellement la taille d'une copie locale du dépôt SBo est environ de +xxxSIZExxx. +Le menu principal permet aussi à l'utilisateur de lire le +.IR Changelog +de SBo, de rechercher les mises à jour possibles de paquets SBo, +d'afficher le contenu du répertoire cache local où sont sauvegardés les +sources, d'afficher le journal permanent des compilations et de lister +ou de chercher dans la copie locale du dépôt de SBo. Lorsque l'on choisit de naviguer dans la copie locale, on peut choisir -dans quelle catégorie de programmes aller. Àprès le choix de cette -catégorie, on peut voir les différents programmes de cette catégorie -disponibles dans le dépôt SBo local. Sélectionner un paquet affiche un -autre menu permettant de lire les fichiers README, SlackBuild, .info -et slack-desc. L'utilisateur peut aussi modifier les fichiers .info -et SlackBuild, les fichiers modifiés seront préservés lors d'une -synchronisation. - +la catégorie de programmes dans laquelle on veut aller. +Après le choix de cette catégorie, on peut voir les différents +programmes disponibles de cette catégorie dans le dépôt SBo local. +Sélectionner un paquet affiche un autre menu permettant de lire les +fichiers +.IR README , +.IR SlackBuild , +.IR .info , +or +.I slack-desc +des paquets. +L'utilisateur peut aussi modifier les fichiers +.I .info +et +.IR SlackBuild , +les fichiers modifiés seront préservés lors d'une synchronisation. De plus, l'utilisateur peut choisir de construire un paquet en utilisant -le SlackBuild d'origine ou la version locale modifiée si elle existe. -Si on utilise l'interface de dialogue et si sbopkg trouve, dans le -répertoire OUTPUT, un paquet compilé pour un programme précis, il va -automatiquement ajouter un nouveau choix au menu pour permettre à -l'utilisateur d'installer ce paquet s'il le souhaite. L'utilisateur -peut aussi décider de compiler ou de compiler et installer un seul -paquet ou plusieurs paquets inscrits dans une file de compilation. -Finalement, si la variable KEEPLOG est à YES dans le fichier de -configuration sbopkg.conf, un journal permanent des opérations de -construction est sauvegardé dans /tmp/sbopkg-build-log. - -Sbopkg peut aussi être lancé en ligne de commande sans utiliser -l'interface de dialogue. Taper "sbopkg -h" affichera la liste des -options disponibles depuis la ligne de commande. - -Avec Sbopkg, on peut charger, sauvegarder et utiliser des files -d'attente crées par l'utilisateur. Ces fichiers sont de simples -ichiers texte comprenant une application par ligne. Lorsqu'on charge -une file d'attente par l'interface de dialogue, l'application est -sélectionnée ou "ON". Ceci peut être modifié en insérant un "-" devant -le nom de l'application dans la file d'attente. Une file d'attente peut -aussi contenir d'autres files, dont le nom est alors précédé d'un "@". -Pour plus d'informations, lire le fichier readme-queuefiles dans le -répertoire /doc. - -Certaines capacités de sbopkg dépendent de binaires externes, comme -un afficheur pour lire les fichiers texte quand sbopkg est lancé en -ligne de commande et un éditeur pour modifier les fichiers .info et -SlackBuild. La fonction affichage recherche la variable d'environnement -$PAGER et si celle-ci n'est pas définie, utilise "more". De même, la -fonction édition recherche la variable $EDITOR et si celle-ci n'est pas -définie, utilise "vi". Si on souhaite que sbopkg utilise un autre -éditeur, nano par exemple, il suffit d'ajouter l'information nécessaire -dans ~/.bashrc, /etc/profile ou tout autre fichier de configuration -similaire qui exporte la variable $EDITOR. - +le +.I SlackBuild +d'origine ou la version locale modifiée si elle existe. +Si on utilise l'interface +.B dialog +et si +.B sbopkg +trouve, dans le répertoire +.B OUTPUT , +un paquet compilé pour un programme spécifique, +.B sbopkg +va automatiquement ajouter un nouveau choix au menu pour permettre à +l'utilisateur d'installer ce paquet s'il le souhaite. +L'utilisateur peut aussi décider de compiler ou de compiler et installer +un seul paquet ou plusieurs paquets listés dans une file de compilation. +Finalement, si la variable +.B KEEPLOG +vaut +.B YES +dans le fichier +.I sbopkg.conf +un journal permanent des opérations de compilation est sauvegardé. +Voir dans +.BR sbopkg.conf (5) +les rubriques +.B KEEPLOG +et +.B LOGFILE +pour plus de détails. +.PP +.B Sbopkg +peut aussi être lancé en ligne de commande sans utiliser l'interface +.B dialog . +Voir la section +.B OPTIONS +pour les options disponibles depuis la ligne de commande. +.PP +.B Sbopkg +peut aussi charger, sauvegarder et utiliser des files d'attente +crées par l'utilisateur. +Ces files d'attente sont de simples fichiers texte comportant une +seule application par ligne. +Lorsqu'on charge une file d'attente par l'interface de dialogue, +l'application est sélectionnée ou "ON". +Ce comportement peut être modifié en insérant un "-" devant le nom de +l'application dans la file d'attente. +Une file d'attente peut aussi contenir d'autres files, dont le nom est +alors précédé d'un "@". +Pour plus d'informations, lire le fichier +.I readme-queuefiles +dans le répertoire de documentation. +.PP +Certaines capacités de +.B sbopkg +dépendent de binaires externes, comme un afficheur pour lire les +fichiers texte quand +.B sbopkg +est lancé en ligne de commande et un éditeur pour modifier les fichiers +.I .info +ou +.I SlackBuild . +La fonction affichage recherche la variable d'environnement +.B PAGER +et si celle-ci n'est pas définie, utilise +.BR more . +De même, la fonction édition recherche la variable +.B EDITOR +et si celle-ci n'est pas définie, utilise +.BR vi . +Si on souhaite que +.B sbopkg +utilise un autre éditeur, +.BR nano +par exemple, il suffit d'ajouter l'information nécessaire dans +.IR ~/.bashrc , +.IR /etc/profile , +ou tout autre fichier de configuration similaire qui exporte la variable +.B EDITOR . +.\"===================================================================== .SH OPTIONS +.\"--------------------------------------------------------------------- .TP 5 -.B -b PAQUET(s)/QUEUE(s) -Recherche et compile PAQUET(s) à partir du dépôt SBo local. Si on -indique plusieurs paquets, il faut les mettre entre guillemets, -par exemple\ : - -#sbopkg -b "toto titi" - -compilera toto et ensuite titi. - -On peut aussi indiquer un nom de file d'attente. Dans ce cas, tous les paquets -indiqués dans le fichier de queue seront compilés. Si par hasard, un fichier de -file d'attente portait le même nom qu'un paquet (l'utilisateur aurait donné au -fichier de file d'attente le nom d'un paquet existant), sbopkg demanderait à -l'utilisateur lequel des deux utiliser. -Les éléments (noms de paquets ou de files d'attente) sont traités dans l'ordre -indiqué dans la ligne de commande ou dans l'ordre de compilation indiqué dans la -file d'attente pour celle-ci. -Si un paquet est cité plusieurs fois, il ne sera traité que la première fois. - -.TP 5 -.B -c -Affiche la liste des paquets SBo installés et les mises à jour +.BI \-b " PAQUET(s)/QUEUE(s)" +Compile les paquets indiqués dans l'argument à partir du dépôt actif. +Si plusieurs paquets sont indiqués, il faut, soit les placer entre +guillemets, soit répéter l'option. +Dans le deuxième cas, on peut donner une liste d'option séparées par un +deux-points. S'il y a des espaces, il faut utiliser les guillemets. +.IP +Par exemple\ : +.RS +.IP +.nf +\fC# sbopkg -b "foo bar"\fP +.fi +.RE +.IP +construira +.I foo +et ensuite +.IR bar . +.IP +Ou +.RS +.IP +.nf +\fC# sbopkg -b app1:opt1="foo bar":opt2=baz -b app2:opt=mu\fP +.fi +.RE +.IP +construira app1 avec les options ''foo bar'' et ''baz'', et construira +app2 avec l'option ''mu''. +.IP +On peut aussi indiquer un nom de file d'attente. +Dans ce cas, tous les paquets indiqués dans le fichier de queue seront +compilés. Si par hasard, un fichier de file d'attente portait le même +nom qu'un paquet (l'utilisateur aurait donné au fichier de file +d'attente le nom d'un paquet existant), +.B sbopkg +demanderait à l'utilisateur lequel des deux utiliser. +Un moyen d'éviter ceci est de préciser le nom de file d'attente avec +une extension +.IR .sqf . +On peut indiquer un mélange de paquets et de files d'attente. +Les éléments (noms de paquets ou de files d'attente) sont traités dans +l'ordre indiqué dans la ligne de commande ou dans l'ordre de compilation +indiqué dans la file d'attente pour celle-ci. +Si un paquet est cité plusieurs fois, il ne sera traité que la +première fois. +.\"--------------------------------------------------------------------- +.TP +.B \-c +Affiche la liste des paquets SBo installés et des mises à jour possibles. - -.TP 5 -.B -d REPERTOIRE -Indique le chemin complet du REPERTOIRE contenant le dépôt SBo local. - -.TP 5 -.B -e ask|continue|stop -Indique ce que sbopkg doit faire s'il rencontre une erreur pendant la -compilation d'un paquet. Les options possibles sont\ : - -.B ask -: Valeur par défaut, demande à l'utilisateur ce qu'il faut faire\ ; - -.B continue -: ignore l'erreur et continue le tratement (comme si l'utilisateur -répondait "Yes" à toutes les questions)\ ; - -.B stop -: Stoppe le processus (comme si l'utilisateur répondait "No" à toutes -les questions)\ ; - - -.TP 5 -.B -f -Remplace le fichier de configuration par défaut, celui de -/etc/sbopkg/sbopkg.conf, par un autre fichier de configuration. - -.TP 5 -.B -g PAQUET(s) -Cherche un PAQUET(s) à partir d'un extrait. Par exemple\ : - -#sbopkg -g nv - -renverra la liste des concordances, comme les paquets nvidia, -konversation, et les autres paquets comportant "nv" dans leur nom. -Si on indique plusieurs extraits, il faut les placer entre guillemets. - -.TP 5 -.B -h +.\"--------------------------------------------------------------------- +.TP +.BI \-d " RÉPERTOIRE" +Indique le chemin complet du +.I RÉPERTOIRE +contenant le dépôt SBo local. +.\"--------------------------------------------------------------------- +.TP +.B \-e ask\fR|\fPcontinue\fR|\fPstop +Indique ce que +.B sbopkg +doit faire s'il rencontre une erreur pendant la construction d'un paquet. +Les options possibles sont\ : +.IP +.BR ask : +Valeur par défaut, demande à l'utilisateur ce qu'il faut faire. +.IP +.BR continue : +Ignore l'erreur et continue le traitement (comme si l'utilisateur +répondait "Yes" à toutes les questions). +.IP +.BR stop : +Stoppe le processus (comme si l'utilisateur répondait "No" à toutes +les questions). +.\"--------------------------------------------------------------------- +.TP +.BI \-f " FICHIER" +Remplace le fichier de configuration par défaut, +.IR /etc/sbopkg/sbopkg.conf , +par +.IR FICHIER . +.\"--------------------------------------------------------------------- +.TP +.BI \-g " PAQUET(s)" +Recherche pour un +.I PAQUET(s) +à partir d'un motif, insensible à la casse, l'argument est +automatiquement entouré par +.BR * s. +Si on indique plusieurs motifs, il faut les placer entre guillemets +ou répéter l'option \-g à chaque motif +.IP +Par exemple\ : +.RS +.IP +.nf +\fC# sbopkg -g "foo bar"\fP +.fi +.RE +.IP +renverra une liste des paquets contenant, soit +.IR foo , +soit +.I bar +dans leur nom. +.\"--------------------------------------------------------------------- +.TP +.B \-h Affiche l'aide. - -.TP 5 -.B -i PAQUET(s) -Recherche, compile et installe PAQUET(s) à partir du dépôt SBo local. -Si on indique plusieurs paquets, il faut les mettre entre guillemets, -les paquets seront compilés et installés dans l'ordre de la liste. Par -exemple\ : - -#sbopkg -i "toto titi" - -compilera et installera toto puis compilera et installera titi. En -faisant bien attention à l'ordre des paquets, il est possible de -compiler et d'installer dans le bon ordre les dépendances avant le -programme principal. Bien sûr, selon la nature des dépendances, -cela ne sera pas toujours possible, et cette possibilité ne constitue -pas une fonctionnalité garantie. Ceci dit, quand ça marche, ça aide. - -Les noms de file d'attente sont aussi acceptés. Pour plus de détails, -se reporter à l'explication de la commande "-b". - -.TP 5 -.B -k -Quand on l'utilise avec -b ou -i, cette option demande à sbopkg +.\"--------------------------------------------------------------------- +.TP +.BI \-i " PAQUET(s)/QUEUE(s)" +Compile et installe les paquets indiqués dans l'argument à partir du +dépôt actif. +.IP +Pour les dérails, voir l'option +.B \-b +car mis à part la partie installation, ces deux options fonctionnent de +la même manière. +.IP +À noter qu'en faisant bien attention à l'ordre des paquets, il est +possible de compiler et d'installer dans le bon ordre les dépendances +avant le programme principal. Bien sûr, selon la nature des dépendances, +cela ne sera pas toujours possible, donc cette possibilité ne constitue +pas une fonctionnalité garantie. +Ceci dit, quand ça marche, ça aide bien. +.\"--------------------------------------------------------------------- +.TP +.B \-k +Quand on l'utilise avec +.B \-b +or +.BR \-i , +cette option demande à +.B sbopkg de passer (c-a-d ne pas construire) tout paquet qui serait déjà installé. - +.IP À noter que celà se réalise avec une simple comparaison de nom, donc -quand on utilise cette option, sbopkg ne s'occupe pas des différences -de version. - -.TP 5 -.B -l -Affiche le fichier ChangeLog.txt de SBo et quitte le programme. - -.TP 5 -.B -o +quand on utilise cette option, +.B sbopkg +sbopkg ne tient pas compte des différences de version. +.\"--------------------------------------------------------------------- +.TP +.B \-l +Affiche le fichier +.I ChangeLog +de SBo et quitte le programme. +.\"--------------------------------------------------------------------- +.TP +.B \-o Affiche la liste des fichiers source installés dans le cache qui sont considérés comme obsolètes et propose de les effacer. - -Les fichiers source sont obsolètes quand plus aucun script SBo ne les -mentionne, ce qui peut arriver après avoir synchronisé le dépôt local. - +.IP +Les fichiers source sont obsolètes quand plus aucun(s) champ(s) +.B DOWNLOAD +du fichier +.I .info +ne les mentionne, ce qui peut arriver après avoir synchronisé le dépôt +local. +.IP Notez qu'on utilise seulement le dépôt actuellement actif pour identifier les sources obsolètes, donc si vous utilisez des dépôts différents (pour des versions différentes de Slackware), les fichiers source utilisés -uniquement dans "d'autres" dépôts seront affichés. - -.TP 5 -.B -P -Affiche la liste des paquets dans le cache qui ne sont pas actuellement -installés sur le système et propose de les effacer. - -.TP 5 -.B -p +uniquement dans "d'autres" dépôts seront quand même affichés. +.\"--------------------------------------------------------------------- +.TP +.B \-P +Affiche les fichiers paquets du cache qui ne sont pas actuellement +installés sur le système et propose de les supprimer. +.\"--------------------------------------------------------------------- +.TP +.B \-p Affiche la liste des paquets SBo installés. - -.TP 5 -.B -q -Entre dans le "mode silencieux". Dans ce mode, la sortie -de certaines option de ligne de commande devient plus succinte. - -.TP 5 -.B -r -Synchronise le dépôt local avec SlackBuilds.org et quitte. - -.TP 5 -.B -R -Affiche tous les fichiers README des paquets en file d'attente avant de -commencer la compilation. Ce qui est utile si vous souhaitez effectuer -un dernier contrôle. - -.TP 5 -.B -s PAQUET(s) -Cherche un PAQUET(s) par son nom précis PAQUET et s'il est trouvé -affiche les fichiers README, SlackBuild, .info, et slack-desc dans cet -ordre en utilisant $PAGER, "more" par défaut comme vu précédemment. Si -on indique plusieurs paquets, ils doivent être entre guillemets. +.\"--------------------------------------------------------------------- +.TP +.B \-q +Entre dans le "mode silencieux". +Dans ce mode, la sortie de certaines option de ligne de commande est +plus succinte. +.\"--------------------------------------------------------------------- +.TP +.B \-R +Montre tous les fichiers +.I README +des paquets en file d'attente avant de lancer la coùpilation. +Utile lorsque l'utilisateur veut effectuer un dernier contrôle. +.\"--------------------------------------------------------------------- +.TP +.B \-r +Synchronise ("rsync") le dépôt local avec SBo et quitte. +.\"--------------------------------------------------------------------- +.TP +.BI \-s " PAQUET(s)" +Cherche un ou plusieurs +.I PAQUET(s) +par un nom précis, sensible à la casse et si trouvé affiche les +fichiers +.IR README , +.IR SlackBuild , +.IR .info +et +.I slack-desc +dans cet ordre pour chaque +.I PAQUET +trouvé en utilisant +.IR $PAGER . +Si on indique plusieurs paquets, ils doivent être mis entre guillemets +ou il faut répéter l'option \-s pour chaque paquet. +.IP Par exemple\ : - -#sbopkg -s "toto titi" - -cherche toto puis titi. - -.TP 5 -.B -u -Vérifie l'existence d'une mise à jour pour sbopkg lui-même et quitte. - -.TP 5 -.B -V DEPOT/VERSION -Définit le dépôt et la version de Slackware à utiliser. - -Pour obtenir la liste des versions valides, lancer sbopkg avec -.BR "sbopkg -V ?" +.RS +.IP +.nf +\fC# sbopkg -s "foo bar"\fP +.fi +.RE +.IP +affichera tous les fichiers indiqués ci-dessus pour des paquets dont les +noms sont exactement +.I foo +ou +.IR bar . +.IP +À noter que les métacaractères du shell peuvent être utilisés dans les +arguments. Par exemple +.RS +.IP +.nf +\fC# sbopkg -s '*[Oo]pen*'\fP +.fi +.RE +.IP +renverra tous les paquets comportant "open" ou "Open" n'importe où dans +leur nom. Si la réponse comprend plusieurs applications, l'utilisateur +pourra effectuer son choix dans un menu. +.\"--------------------------------------------------------------------- +.TP +.B \-u +Vérifie l'existence d'une mise à jour pour +.B sbopkg +lui-même et quitte. +.\"--------------------------------------------------------------------- +.TP +.BI \-V " VERSION" +Définit le dépôt et la version à utiliser. +.IP +Pour obtenir une liste des versions valides, appeler +.B sbopkg +ainsi +.RS +.IP +.nf +\fC# sbopkg -V ?\fP +.fi +.RE +.IP Voir la page de manuel -.B sbopkg.conf (5) -pour plus d'information sur le dépôt "local". - -Le format de VERSION est présenté par dépôt/branche (par ex SBo/13.1). -SI le dépôt n'est pas précisé, sbopkg va chercher la branche -indiquée dans le dépôt par défaut. Si cette recherche échoue, -sbopkg va recherche la première branche qui concorde dans tous -les dépôts. - -.TP 5 -.B -v -Affiche la version courante de sbopkg sur la sortie standard - -.SH FILES -.B /etc/sbopkg/sbopkg.conf -\ - Fichier qui contient les options de configuration. - -.B /etc/sbopkg/renames.d/50-default -\ - Fichier contenant la liste des logiciels du dépôt SBo qui ont été renommés. -Lire le fichier README-renames.d dans le répertoire /doc de sbopkg pour -plus d'information. - -.B /etc/sbopkg/repos.d/{40-sbo.repo,50-sb64.repo,60-local.repo} -\ - Trois fichiers par défaut pour les différents types de dépôts de sbopkg. -Lire le fichier README-repos.d dans le répertoire /doc de sbopkg pour -plus d'information. - - -.SH "VOIR AUSSI" .BR sbopkg.conf (5) -.BR doc/README -.BR doc/README-queuefiles -.BR doc/README-renames.d -.BR doc/README-repos.d -.BR doc/queuefiles/* - -.SH AUTEUR +pour plus d'information sur le dépôt "local". +.IP +Le format de +.I VERSION +est présenté dépôt/branche (par ex SBo/13.1). +Si le dépôt n'est pas précisé, +.B sbopkg +va chercher la branche indiquée dans le dépôt par défaut. +Si cette recherche échoue, +.B sbopkg +sbopkg va rechercher la première branche qui concorde dans tous les +dépôts. +.\"--------------------------------------------------------------------- +.TP +.B \-v +Affiche la version en cours de +.B sbopkg +sur la sortie standard. +.\"===================================================================== +.SH FICHIERS +.TP 5 +.I /etc/sbopkg/sbopkg.conf +Fichier par défaut qui contient les options de configuration. +.TP +.I /etc/sbopkg/renames.d/50-default +Fichier par défaut contenant la liste des logiciels du dépôt SBo qui +ont été renommés. +Voir le document +.I README-renames.d +dans le répertoire de documentation de +.B sbopkg +pour plus d'information. +.TP +.I /etc/sbopkg/repos.d/{40-sbo.repo,50-sb64.repo,60-local.repo} +Trois fichiers par défaut pour les différents types de dépôts de +.B sbopkg . +Voir le document +.I README-repos.d +dans le répertoire de documentation de +.B sbopkg +pour plus d'information. +.\"===================================================================== +.SH AUTEURS Chess Griffin - +.PP +Mauro Giachero + +.PP +slakmagik + +.\"===================================================================== +.SH VOIR AUSSI +.BR dialog (1), +.BR more (1), +.BR removepkg (8), +.BR rsync (1), +.BR sbopkg.conf (5), +.BR su (1), +.BR upgradepkg (8), +.BR vi (1), +.IR /usr/doc/sbopkg-SVN/* +.\"===================================================================== .SH TRADUCTION Ce document est une traduction réalisée par M.C Collilieux - le 23\ juillet\ 2010. + le 28\ juillet\ 2010. N'hésitez pas à signaler au traducteur, toute erreur dans cette page de manuel.