updated French man pages in trunk

Thanks to Marie-Claude Collilieux (also noted in the ChangeLog).
This commit is contained in:
slakmagik 2010-07-29 01:38:16 +00:00
parent 0862608534
commit 8cc3142bc6
3 changed files with 1042 additions and 576 deletions

View file

@ -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

View file

@ -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
<chess@chessgriffin.com>
.PP
Mauro Giachero
<mauro.giachero@gmail.com>
.PP
slakmagik
<slakmagik@gmail.com>
.\"=====================================================================
.\" 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
<mccnews@free.fr> le 21\ juillet\ 2010.
<mccnews@free.fr> 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

View file

@ -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
<chess@chessgriffin.com>
.PP
Mauro Giachero
<mauro.giachero@gmail.com>
.PP
slakmagik
<slakmagik@gmail.com>
.\"=====================================================================
.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
<mccnews@free.fr> le 23\ juillet\ 2010.
<mccnews@free.fr/> le 28\ juillet\ 2010.
N'hésitez pas à signaler au traducteur, toute erreur dans cette
page de manuel.