update French man pages; thanks to Marie-Claude Collilieux

This commit is contained in:
chess.griffin 2009-08-12 02:46:17 +00:00
parent f859290b84
commit f7c66c3b52
2 changed files with 157 additions and 97 deletions

View file

@ -1,7 +1,7 @@
.TH SBOPKG.CONF 5 "Février 2009" sbopkg-0.27.0 ""
.TH SBOPKG.CONF 5 "Juin 2009" sbopkg-0.30.0beta ""
.SH NAME
.B sbopkg.conf
\- Fichier de Configuration pour sbopkg
\- Fichier de Configuration de sbopkg
.SH DESCRIPTION
@ -13,47 +13,43 @@ packages Slackware. Un fichier exemple est fourni par
/etc/sbopkg/sbopkg.conf.new.
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 est identique à celle de SlackBuilds.org.
NOTE\ : toutes les variables préfixées par REPO_ sont touché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 RSYNCMIRROR
.B REPO_BRANCH
.br
Cette option permet à l'utilisateur de définir le miroir de
synchronisation du dépôt SBo que sbopkg utilisera.
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 et 13.0 pour le dépôt SBo\ ; master pour SB64 et local pour
le dépôt local.
La valeur par défaut de RSYNCMIRROR est\ :
La valeur par défaut de REPO_BRANCH est\ :
.br
slackbuilds.org::slackbuilds.
REPO_BRANCH=${REPO_BRANCH:-13.0}.
.TP 5
.B SLACKVER
.B REPO_ROOT
.br
Cette option permet à l'utilisateur de définir la version de
Slackware qu'il veut synchroniser avec le dépôt SBo correspondant. Les
valeurs possibles sont 11.0, 12.0, 12.1, 12.2 et local. L'option
"local" permet à l'utilisateur de maintenir un dépôt local de la
même manière que le dépôt SBo et de le gérer avec sbopkg. Le dépôt
local doit être au même niveau de répertoire que celui de SBo. Par
exemple, si $LOCALREPO (voir ci-dessous) est /home/sbo, le dépôt SBo
de la Slacware 12.2 doit être /home/sbo/12.2 et le dépôt local sera
/home/sbo/local. L'arborescence des répertoires sous /local doit aussi
être semblable à celle de SBo, incluant des catégories, mais ce ne
sont pas obligatoirement les mêmes catégories que celles de SBo,
par exemple : /home/sbo/local/macategorie/monappli.
Cette option permet à l'utilisateur de définir l'emplacement du
miroir local 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 SLACKVER est\ :
La valeur par défaut de REPO_ROOT est\ :
.br
SLACKVER=${SLACKVER:-12.2}.
.TP 5
.B LOCALREPO
.br
Cette option permet à l'utilisateur de choisir l'emplacement du
miroir local synchronisé avec le dépôt SBo. Actuellement, la taille
d'une copie locale du dépôt SBo est inférieure à 50MB.
La valeur par défaut de LOCALREPO est :
.br
export LOCALREPO=${LOCALREPO:-/home/sbo}.
REPO_ROOT=${REPO_ROOT:-/var/lib/sbopkg}.
.TP 5
.B SRCDIR
@ -63,15 +59,25 @@ contiendra la sauvegarde des sources téléchargées.
La valeur par défaut de SRCDIR est\ :
.br
export SRCDIR=${SRCDIR:-/var/cache/sbopkg}.
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 indique le répertoire dans lequel certains fichiers
de travail seront sauvegardés temporairement. TMP doit être exporté
car il est aussi utilisé par les SlackBuilds SBo. La valeur
par défaut de TMP est donc la même que dans les scripts de SlackBuildS SBO.
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. Remarquez que la valeur par défaut de TMP est donc
identique à celle des SlackBuildS SBO.
La valeur par défaut de TMP est\ :
.br
@ -89,6 +95,7 @@ La valeur par défaut de OUTPUT est\ :
.br
export OUTPUT=${OUTPUT:-/tmp}.
.TP 5
.B QUEUEDIR
.br
@ -97,7 +104,7 @@ files d'attente sauvegardées.
La valeur par défaut de QUEUEDIR est\ :
.br
QUEUEDIR=$TMP/queues.
QUEUEDIR=${QUEUEDIR:-/var/lib/sbopkg/queues}.
.TP 5
.B KEEPLOG
@ -107,17 +114,30 @@ 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
$TMP/sbopkg-build-log.
$LOGDIR/sbopkg-build-log.
La valeur par défaut de KEEPLOG est\ : YES.
.TP 5
.B LOGFILE
.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 LOGFILE is: $TMP/sbopkg-build-log.
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 le fichier de configuration.
La valeur par défaut de CLEANUP est\ : NO
.TP 5
.B DEBUG
@ -128,12 +148,8 @@ les paquets pouvant être mis à jour sont montrés. C'était la sortie par
défaut avant l'utilisation de la variable DEBUG. Si DEBUG vaut 1, sont
montrés 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.
Modifier la valeur de DEBUG à 1 peut aider si la liste des mises à jour
parait incompléte. Si DEBUG vaut 2 (la valeur la plus élevée), en plus
des résultats du niveau 1, la liste des mises à jour affiche chaque paquet
SBo installé, même s'il n'y a pas de mise à jour, ainsi que d'autres
informations de débogage utiles pour corriger des erreurs. Le niveau 2 ne
devrait être utilisé que pour envoyer un rapport de bogue des mises à jour.
Modifier la valeur de DEBUG à 1 peut être utile si la liste des mises à
jour parait incompléte.
La valeur par défaut de DEBUG est\ : 0.
@ -144,7 +160,7 @@ 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 peuvent fonctionner ou non.
de nouvelles valeurs peuvant 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
@ -159,7 +175,7 @@ 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 peuvent fonctionner ou non.
de nouvelles valeurs peuvant 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é.
@ -172,7 +188,7 @@ La valeur par défaut de WGETFLAGS est\ :
.B DIFF
.br
Cette option permet à l'utilisateur de définir le programme de
comparaison à utiliser quand sbopkg doit montrer les différences
comparaison à utiliser quand sbopkg doit afficher les différences
entre fichiers.
La valeur par défaut de DIFF est\ :
@ -190,9 +206,6 @@ La valeur par défaut de DIFFOPTS est\ :
DIFFOPTS=${DIFFOPTS:--u}
.SH FILES
.TP 5
.B /etc/sbopkg/sbopkg.conf
.SH ENVIRONMENT
Il est possible de définir ou de redéfinir des variables d'environnement
@ -202,36 +215,52 @@ le fichier sbopkg.conf\ :
export TMP=${TMP:-/tmp/SBo}
Ceci définit la valeur de $TMP pour les besoins de sbopkg (c-a-d l'endroit
où sbopkg conserve son journal) et pour la construction des paquets
par sbopkg (c'est déjà la valeur par défaut dans les SlackBuilds 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).
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 sbopkg et pour la construcion
définit $TMP comme /home/sbo/tmp pour la construcion
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 configuration de TMP
n'est pas prise en compte.
Il est possible également, d'exporter dans sbopkg.conf des variables
qui ne sont aucunement utilisées par sbopkg.
Comme on peut le constater, avec juste quelques modifications, il est
possible d'obtenir une zone complétement séparée à l'intention de SBo
-- le dépôt dans /home/sbo, le répertoire $TMP dans /home/sbo/tmp,
le cache pour les sources dans /home/sbo/cache et le répertoire
$OUTPUT pour sauvegarder les paquets compilés dans /home/sbo/packages.
.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/*
.SH TRADUCTION
Ce document est une traduction réalisée par M.C Collilieux
<http://mcclinews.free.fr/> le 14\ mars\ 2009.
<http://mcclinews.free.fr/> le 11\ août\ 2009.
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
consultable via la commande\ : «\ \fBLANG=en\ man\ 5\ sbopkg.conf\fR\ ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.

View file

@ -1,7 +1,7 @@
.TH SBOPKG 8 "Février 2009" sbopkg-0.27.0 ""
.TH SBOPKG 8 "Juin 2009" sbopkg-0.30.0beta ""
.SH NAME
.B sbopkg
\ - Le navigateur des paquets SlackBuilds.org
\ - Le navigateur de paquets SlackBuilds.org
.SH SYNOPSIS
.B sbopkg
@ -17,7 +17,7 @@ Slackware.
L'utilisation de 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 à propos des scripts SlackBuild de http://www.slackwiki.org.
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
@ -37,22 +37,21 @@ 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 disponibles de cette
catégorie dans le dépôt SBo local. Sélectionner un paquet affiche un
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.
De plus, si sbopkg est lancé avec les droits de root, 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 dialog 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
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 dialog 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 compiler et installer un seul ou plusieurs paquets dans
la queue de compilation. Finalement, si la variable KEEPLOG est à
compiler ou de compiler et installer un seul ou plusieurs paquets listés dans
une queue 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.
@ -60,6 +59,16 @@ Sbopkg peut aussi être lancé en ligne de commande sans utiliser
l'interface dialog. 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 fichiers texte
comprenant une application par ligne. Lorsqu'on charge une file d'attente
par l'interface dialog, 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 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 er un éditeur pour modifier les fichiers .info et
@ -85,13 +94,12 @@ 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 utiliserait le
fichier de file d'attente.
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é pour la ligne de commande ou dans l'ordre de compilation indiqué dans la
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 inclus dans la file d'attente
que la première fois.
Si un paquet est cité plusieurs fois, il ne sera traité que la première fois.
.TP 5
.B -c
@ -172,7 +180,7 @@ mentionne, ce qui peut arriver après avoir synchronisé le dépôt local.
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
dans "d'autres" dépôts seront affichés.
uniquement dans "d'autres" dépôts seront affichés.
.TP 5
.B -p
@ -180,8 +188,8 @@ Affiche la liste des paquets SBo installés.
.TP 5
.B -q
Entre dans le "mode silencieux". Quand ce drapeau est mis, la sortie
de certaines option en mode ligne de commande devient plus succinte.
Entre dans le "mode silencieux". Dans ce mode, la sortie
de certaines option de ligne de commande devient plus succinte.
.TP 5
.B -r
@ -204,22 +212,44 @@ Vérifie l'existence d'une mise à jour pour sbopkg lui-même et quitte.
.TP 5
.B -v VERSION
Définit la version de Slackware à utiliser pour la recherche dans
le miroir local SBo. Les valeurs possibles sont 11.0, 12.0, 12.1,
12.2 et local. Voir la page de manuel
Définit le dépôt et la version de Slackware à utiliser.
Les valeurs possibles pour le dépôt sont SBo, SB64 et local.
Les valeurs possibles de version sont 11.0, 12.0, 12.1,
12.2 et 13.0 pour le dépôt SBo\ ; master pour SB64
(dépôt Slamd64Builds) et local pour le dépôt local.
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é dépôt/branche (par ex SBo/13.0).
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.
.SH FILES
.B /etc/sbopkg/sbopkg.conf
\ - Fichier qui contient les options de configuration.
.B /etc/sbopkg/sbopkg-renames
\ - Fichier qui contient la liste des programmes du dépôt SBo qui ont
été renommés.
.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
Chess Griffin
@ -227,9 +257,10 @@ Chess Griffin
.SH TRADUCTION
Ce document est une traduction réalisée par M.C Collilieux
<http://mcclinews.free.fr/> le 14\ mars\ 2009.
<http://mcclinews.free.fr/> le 10\ août\ 2009.
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
consultable via la commande\ : «\ \fBLANG=en\ man\ 8\ sbopkg\fR\ ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.