Re: [DDR] Intitulé des pages de manuel de coreutils

[barbier@linuxfr.org (Denis Barbier)]

On Tue, Jul 01, 2003 at 11:00:28PM +0200, Denis Barbier wrote:
> Bonjour,
> 
> le fichier joint contient la description sur une ligne des programmes
> de coreutils, dans le but de générer des pages de manuel traduites
> avec help2man.
> Relectures bienvenues (seulement sur les lignes en français, of course).
> Merci.

Merci à Laurent Defours et Michel Grentzinger pour leurs commentaires,
voici la version relue du document.

Les pages de manuel seront en grande partie générées à partir de la
sortie de l'option --help de chaque programme, qui est gérée par le
traducteur du fichier PO. Comme je ne sais pas s'il souhaite s'occuper
aussi de la traduction intégrale des pages de manuel (et sa messagerie
indique qu'il est injoignable pour un certain temps), je vais faire un
premier jet. Quelques pages incorporent des informations complémentaires,
les voici ainsi que la version anglaise (le texte est au format *roff, il
ne faut pas tenir compte des balises entre crochets). Je me suis contenté
pour l'essentiel de faire du copier/coller avec la doc actuelle produite
par Christophe Blaess, en faisant des mises à jour si nécessaire. Merci
pour les relectures éventuelles.

Denis

basename \- strip directory and suffix from filenames
basename \- Éliminer le chemin d'accès et le suffixe d'un nom de fichier
cat \- concatenate files and print on the standard output
cat \- Concaténer des fichiers et les afficher sur la sortie standard
chgrp \- change group ownership
chgrp \- Changer le groupe propriétaire d'un fichier
chmod \- change file access permissions
chmod \- Modifier les autorisations d'accès à un fichier
chown \- change file owner and group
chown \- Modifier le propriétaire et le groupe d'un fichier
chroot \- run command or interactive shell with special root directory
chroot \- Exécuter une commande ou un shell dans un répertoire racine particulier
cksum \- checksum and count the bytes in a file
cksum \- Fournir le nombre d'octets d'un fichier ainsi qu'une somme de contrôle
comm \- compare two sorted files line by line
comm \- Comparer ligne à ligne deux fichiers triés
cp \- copy files and directories
cp \- Copier des fichiers et des répertoires
csplit \- split a file into sections determined by context lines
csplit \- Découper un fichier en sections définies par des lignes de contexte
cut \- remove sections from each line of files
cut \- Supprimer une partie de chaque ligne d'un fichier
date \- print or set the system date and time
date \- Afficher ou configurer la date et l'heure du système
dd \- convert and copy a file
dd \- Convertir un fichier en le copiant
df \- report filesystem disk space usage
df \- Fournir la quantité d'espace occupé des systèmes de fichiers
dir \- list directory contents
dir \- Afficher le contenu de répertoires
dircolors \- color setup for ls
dircolors \- Configuration des couleurs pour «\ ls\ »
dirname \- strip non-directory suffix from file name
dirname \- Ne conserver que la partie répertoire d'un chemin d'accès
du \- estimate file space usage
du \- Statistiques sur l'utilisation de l'espace disque
echo \- display a line of text
echo \- Afficher une ligne de texte
env \- run a program in a modified environment
env \- Exécuter un programme dans un environnement modifié
expand \- convert tabs to spaces
expand \- Convertir les tabulations en espaces
expr \- evaluate expressions
expr \- Évaluer des expressions
factor \- factor numbers
factor \- Factoriser en nombres premiers
false \- do nothing, unsuccessfully
false \- Ne rien faire, et échouer
fmt \- simple optimal text formatter
fmt \- Mettre en forme du texte
fold \- wrap each input line to fit in specified width
fold \- Couper des lignes de texte à une largeur donnée
groups \- print the groups a user is in
groups \- Afficher les groupes auxquels appartient un utilisateur
head \- output the first part of files
head \- Afficher le début d'un fichier
hostid \- print the numeric identifier for the current host
hostid \- Afficher l'identificateur numérique de l'hôte
hostname \- set or print the name of the current host system
hostname \- Configurer ou afficher le nom de l'hôte
id \- print real and effective UIDs and GIDs
id \- Afficher les UIDs et GIDs effectifs et réels
ginstall \- copy files and set attributes
ginstall \- Copier des fichiers et positionner leurs attributs
join \- join lines of two files on a common field
join \- Fusionner les lignes de deux fichiers ayant un champ commun
link \- call the link function to create a link to a file
link \- Appeler la fonction link pour créer un lien vers un fichier
ln \- make links between files
ln \- Créer des liens entre des fichiers
logname \- print user\'s login name
logname \- Afficher le nom de connexion de l'utilisateur
ls \- list directory contents
ls \- Afficher le contenu de répertoires
md5sum \- compute and check MD5 message digest
md5sum \- Calculer et vérifier des sommes de contrôle MD5
mkdir \- make directories
mkdir \- Créer des répertoires
mkfifo \- make FIFOs (named pipes)
mkfifo \- Créer des FIFOs (tubes nommés)
mknod \- make block or character special files
mknod \- Créer des fichiers spéciaux
mv \- move (rename) files
mv \- Déplacer ou renommer des fichiers
nice \- run a program with modified scheduling priority
nice \- Exécuter un programme avec une priorité d'ordonnancement modifiée
nl \- number lines of files
nl \- Numéroter les lignes d'un fichier
nohup \- run a command immune to hangups, with output to a non-tty
nohup \- Exécuter un programme en le rendant insensible aux déconnexions
od \- dump files in octal and other formats
od \- Afficher le contenu d'un fichier en octal ou sous d'autres formats
paste \- merge lines of files
paste \- Regrouper les lignes de différents fichiers
pathchk \- check whether file names are valid or portable
pathchk \- Vérifier la validité et la portabilité d'un nom de fichier
pinky \- lightweight finger
pinky \- Équivalent plus léger de la commande finger
pr \- convert text files for printing
pr \- Mettre en forme des fichiers de texte pour l'impression
printenv \- print all or part of environment
printenv \- Afficher tout ou partie de l'environnement
printf \- format and print data
printf \- Mettre en forme et afficher des données
ptx \- produce a permuted index of file contents
ptx \- Générer un index croisé du contenu de fichiers
pwd \- print name of current/working directory
pwd \- Afficher le nom du répertoire de travail en cours
readlink \- display value of a symbolic link
readlink \- Afficher la valeur d'un lien symbolique
rm \- remove files or directories
rm \- Effacer des fichiers et des répertoires
rmdir \- remove empty directories
rmdir \- Effacer des répertoires vides
seq \- print a sequence of numbers
seq \- Afficher une séquence de nombres
shasum \- compute and check SHA1 message digest
shasum \- Calculer et vérifier un compte-rendu SHA1
shred \- delete a file securely, first overwriting it to hide its contents
shred \- Supprimer un fichier de manière sûre, en commençant par corrompre son contenu
sleep \- delay for a specified amount of time
sleep \- Attendre une durée déterminée
sort \- sort lines of text files
sort \- Trier les lignes de fichiers texte
split \- split a file into pieces
split \- Découper un fichier en différentes parties
stat \- display file or filesystem status
stat \- Afficher l'état d'un fichier ou d'un système de fichiers
stty \- change and print terminal line settings
stty \- Modifier et afficher la configuration de la ligne de terminal
su \- run a shell with substitute user and group IDs
su \- Exécuter un shell avec un User-ID et un Group-ID différents
sum \- checksum and count the blocks in a file
sum \- Fournir le nombre de blocs d'un fichier ainsi qu'une somme de contrôle
sync \- flush filesystem buffers
sync \- Vider les tampons des systèmes de fichiers
tac \- concatenate and print files in reverse
tac \- Concaténer et afficher des fichiers à l'envers
tail \- output the last part of files
tail \- Afficher la dernière partie de fichiers
tee \- read from standard input and write to standard output and files
tee \- Copier l'entrée standard sur la sortie standard et dans un fichier
test \- check file types and compare values
test \- Vérifier le type d'un fichier, et comparer des valeurs
touch \- change file timestamps
touch \- Modifier l'horodatage d'un fichier
tr \- translate or delete characters
tr \- Transposer ou éliminer des caractères
true \- do nothing, successfully
true \- Ne rien faire, et réussir
tsort \- perform topological sort
tsort \- Effectuer un tri topologique
tty \- print the file name of the terminal connected to standard input
tty \- Afficher le nom du terminal associé à l'entrée standard
uname \- print system information
uname \- Afficher des informations sur le système
unexpand \- convert spaces to tabs
unexpand \- Convertir les espaces en tabulations
uniq \- remove duplicate lines from a sorted file
uniq \- Éliminer les lignes redondantes dans un fichier trié
unlink \- call the unlink function to remove the specified file
unlink \- Appeler la fonction unlink pour supprimer un fichier
uptime \- tell how long the system has been running
uptime \- Indiquer depuis quand le système fonctionne
users \- print the user names of users currently logged in to the current host
users \- Afficher le nom des utilisateurs actuellement connectés
vdir \- list directory contents
vdir \- Afficher le contenu de répertoires
wc \- print the number of bytes, words, and lines in files
wc \- Afficher le nombre d'octets, de mots et de lignes d'un fichier
who \- show who is logged on
who \- Montrer qui est connecté
whoami \- print effective userid
whoami \- Afficher l'U-ID effectif
yes \- output a string repeatedly until killed
yes \- Afficher indéfiniment une chaîne de caractères, jusqu'à la mort

[NOM]
chmod \- Modifier les autorisations d'accès à un fichier
[DESCRIPTION]
Cette page de manuel documente la version GNU du programme
.BR chmod .
.B chmod
modifie les permissions d'accès de chacun des fichiers indiqués,
en suivant l'indication de
.IR mode ,
qui peut être une représentation symbolique des changements à effectuer,
ou un nombre octal représentant le motif binaire des nouvelles
autorisations.
.PP
Le format symbolique des changements de mode est
«\ [ugoa...][[+-=][rwxXstugo...]...][,...]\ ».
Plusieurs opérations symboliques peuvent être séparées par des virgules.
.PP
Une combinaison des lettres «\ ugoa\ » contrôle la catégorie d'accès à
modifier.
Il peut s'agir de l'utilisateur possédant le fichier (u),
des autres utilisateurs du même groupe que le fichier (g),
des utilisateurs n'appartenant pas au groupe du fichier (o),
ou de tous les utilisateurs (a).
Si aucune catégorie n'est indiquée, l'ensemble (a) est
pris par défaut, mais les bits correspondant à des bits à 1 du
umask ne sont pas affectés.
.PP
L'opérateur «\ +\ » ajoute à chaque fichier une autorisation à celles
existant déjà, l'opérateur «\ -\ » en enlève, et l'opérateur «\ =\ »
autorise exclusivement l'accès indiqué.
.PP
Les lettres «\ rwxXstugo\ » sélectionnent le type d'autorisation
concerné\ :
.TP
r
lecture,
.TP
w
écriture,
.TP
x
exécution (ou parcours pour les répertoires),
.TP
X
exécution, uniquement si le fichier est un répertoire, ou s'il a déjà
une autorisation d'exécution pour une des catégories d'utilisateur
(s'il s'agit donc bien d'un fichier exécutable),
.TP
s
utiliser l'ID du propriétaire ou du groupe propriétaire du fichier
lors de l'exécution,
.TP
t
.RI ( sticky-bit )
.TP
u
les permissions dont dispose le propriétaire du fichier,
.TP
g
les permissions dont disposent les autres membres du groupe
propriétaire du fichier,
.TP
o
les permissions dont disposent tous les autres utilisateurs.
.PP
Une valeur numérique pour le \fImode\fP est constituée de 1 à 4 chiffres
en octal (0 à 7), calculés en additionnant les bits de valeurs 4, 2
et 1, un bit non mentionné étant considéré comme nul. Le premier chiffre
correspond aux attributs Set-UID (4), Set-GID (2), et conservation du
code en mémoire -- \fIsticky bit\fR -- (1).
Le second chiffre correspond aux autorisations de lecture (4),
écriture (2) et exécution (1) pour l'utilisateur propriétaire
du fichier. Les troisième et quatrième chiffres correspondent
respectivement aux autorisations d'accès pour les membres du groupe
du fichier, et pour les autres utilisateurs. Les valeurs ont les mêmes
significations que pour le deuxième chiffre.
.PP
.B chmod
ne modifie jamais les autorisations d'accès des liens symboliques,
l'appel système
.B chmod
ne peut pas les modifier. Ceci n'est pas un problème puisque ces
autorisations ne sont jamais prises en compte. En fait,
pour chaque lien symbolique mentionné sur la ligne de commande,
.B chmod
modifie les autorisations d'accès du fichier cible.
En revanche,
.B chmod
ignore purement et simplement les liens symboliques qu'il rencontre
lors des descentes récursives de répertoires.
.SH FICHIERS PERSISTANTS
Sur d'anciens systèmes Unix, le \fIsticky bit\fR rend les fichiers
exécutables résidant dans la zone d'échange (\fIswap\fR). Cette
fonctionnalité n'est plus utile avec les systèmes modernes de
gestion de la mémoire, et le noyau Linux ne prend pas en compte le
\fIsticky bit\fR sur les fichiers. D'autres noyaux peuvent l'utiliser
selon les besoins spécifiques du système. Parfois, seul le
super-utilisateur a le droit de positionner le \fIsticky bit\fR
sur des fichiers.
.SH RÉPERTOIRES PERSISTANTS
Quand un répertoire a son \fIsticky bit\fR positionné, les fichiers
de ce répertoire ne peuvent être effacés et renommés que par
le super-utilisateur et le propriétaire du fichier.
Sans ce \fIsticky bit\fR, toutes les personnes ayant l'autorisation
d'écrire dans le répertoire peuvent supprimer ou renommer des fichiers.
Le \fIsticky bit\fR est couramment utilisé sur des répertoires comme
/tmp, qui sont accessibles en écriture par tout le monde.
.SH OPTIONS

[NAME]
chmod \- change file access permissions
[DESCRIPTION]
This manual page
documents the GNU version of
.BR chmod .
.B chmod
changes the permissions of each given file according to
.IR mode ,
which can be either a symbolic representation of changes to make, or
an octal number representing the bit pattern for the new permissions.
.PP
The format of a symbolic mode is
`[ugoa...][[+-=][rwxXstugo...]...][,...]'.  Multiple symbolic
operations can be given, separated by commas.
.PP
A combination of the letters `ugoa' controls which users' access to
the file will be changed: the user who owns it (u), other users in the
file's group (g), other users not in the file's group (o), or all
users (a).  If none of these are given, the effect is as if `a' were
given, but bits that are set in the umask are not affected.
.PP
The operator `+' causes the permissions selected to be added to the
existing permissions of each file; `-' causes them to be removed; and
`=' causes them to be the only permissions that the file has.
.PP
The letters `rwxXstugo' select the new permissions for the affected
users: read (r), write (w), execute (or access for directories) (x),
execute only if the file is a directory or already has execute
permission for some user (X), set user or group ID on execution (s),
sticky (t), the permissions granted to the user who owns the file (u),
the permissions granted to other users who are members of the file's group (g),
and the permissions granted to users that are in neither of the two preceding
categories (o).
.PP
A numeric mode is from one to four octal digits (0-7), derived by
adding up the bits with values 4, 2, and 1.  Any omitted digits are
assumed to be leading zeros.  The first digit selects the set user ID
(4) and set group ID (2) and sticky (1) attributes.  The second digit
selects permissions for the user who owns the file: read (4), write (2),
and execute (1); the third selects permissions for other users in the
file's group, with the same values; and the fourth for other users not
in the file's group, with the same values.
.PP
.B chmod
never changes the permissions of symbolic links; the
.B chmod
system call cannot change their permissions.  This is not a problem
since the permissions of symbolic links are never used.
However, for each symbolic link listed on the command line,
.B chmod
changes the permissions of the pointed-to file.
In contrast,
.B chmod
ignores symbolic links encountered during recursive directory
traversals.
.SH STICKY FILES
On older Unix systems, the sticky bit caused executable files to be
hoarded in swap space.  This feature is not useful on modern VM
systems, and the Linux kernel ignores the sticky bit on files.  Other
kernels may use the sticky bit on files for system-defined purposes.
On some systems, only the superuser can set the sticky bit on files.
.SH STICKY DIRECTORIES
When the sticky bit is set on a directory, files in that directory may
be unlinked or renamed only by root or their owner.  Without the
sticky bit, anyone able to write to the directory can delete or rename
files.  The sticky bit is commonly found on directories, such as /tmp,
that are world-writable.
.SH OPTIONS

[NOM]
chown \- Modifier le propriétaire et le groupe d'un fichier
[DESCRIPTION]
Cette page de manuel documente la version GNU du programme
.BR chown .
.B chown
modifie l'utilisateur ou le groupe propriétaire de chacun des
fichiers indiqués, en fonction du premier argument rencontré sur
la ligne de commande qui ne soit pas une option. L'influence
de cet argument est la suivante\ : si seul un nom d'utilisateur
(ou un UID numérique) est spécifié, celui-ci devient le propriétaire
des fichiers donnés, mais les groupes de ces fichiers ne sont pas modifiés.
Si le nom d'utilisateur est suivi d'un deux-points ou d'un point, et d'un
nom de groupe (ou d'un GID numérique), sans espaces entre ces
différentes valeurs, les fichiers changent également de groupe.
Si le nom d'utilisateur est suivi d'un deux-points ou d'un point,
sans nom de groupe, les fichiers appartiendront à cet utilisateur
et leur groupe deviendra le groupe initial de l'utilisateur.
Si l'on fournit un nom de groupe, précédé d'un deux-points ou d'un point,
mais sans préciser de nom d'utilisateur, seul l'appartenance au groupe est
modifiée.
Dans ce cas,
.B chown
a les mêmes effets que
.BR chgrp .
.SH OPTIONS

[NAME]
chown \- change file owner and group
[DESCRIPTION]
This manual page
documents the GNU version of
.BR chown .
.B chown
changes the user and/or group ownership of each given file, according
to its first non-option argument, which is interpreted as follows.  If
only a user name (or numeric user ID) is given, that user is made the
owner of each given file, and the files' group is not changed.  If the
user name is followed by a colon or dot and a group name (or numeric group ID),
with no spaces between them, the group ownership of the files is
changed as well.  If a colon or dot but no group name follows the user name,
that user is made the owner of the files and the group of the files is
changed to that user's login group.  If the colon or dot and group are given,
but the user name is omitted, only the group of the files is changed;
in this case,
.B chown
performs the same function as
.BR chgrp .
.SH OPTIONS

[NOM]
df \- Fournir la quantité d'espace occupé des systèmes de fichiers
[DESCRIPTION]
Cette page de manuel documente la version GNU du programme
.BR df 
.B df
indique les quantités d'espace disque utilisées et disponibles sur les
systèmes de fichiers contenant chaque fichier donné en argument.
Sans argument, l'espace disponible sur tous les les systèmes de fichiers
montés seront affichés. Les valeurs sont indiquées en unités de 1024
octets, à moins que la variable d'environnement POSIXLY_CORRECT ne soit
positionnée, auquel cas la taille des blocs passe à 512 octets.
.PP
Si un fichier indiqué en argument est un périphérique disque contenant
un système de fichiers monté,
.B df
affiche l'espace disponible sur ce système de fichiers plutôt que sur
celui contenant le noeud du périphérique (qui est toujours le système
de fichiers racine). Cette version de
.B df
ne peut pas afficher la quantité d'espace disponible sur des systèmes
de fichiers non montés, car pour la majorité des systèmes, cela
nécessiterait une connaissance très pointue de la structure des
systèmes de fichiers, et nuirait donc à la portabilité.
.SH OPTIONS

[NAME]
df \- report filesystem disk space usage
[DESCRIPTION]
This manual page
documents the GNU version of
.BR df .
.B df
displays the amount of disk space available on the filesystem
containing each file name argument.  If no file name is given, the
space available on all currently mounted filesystems is shown.  Disk
space is shown in 1K blocks by default, unless the environment
variable POSIXLY_CORRECT is set, in which case 512-byte blocks are
used.
.PP
If an argument is the absolute file name of a disk device node containing a
mounted filesystem,
.B df
shows the space available on that filesystem rather than on the
filesystem containing the device node (which is always the root
filesystem).  This version of
.B df
cannot show the space available on unmounted filesystems, because on
most kinds of systems doing so requires very nonportable intimate
knowledge of filesystem structures.
.SH OPTIONS

[NOM]
du \- Statistiques sur l'utilisation de l'espace disque
[DESCRIPTION]
[MOTIFS]
MOTIF est une chaîne pouvant comporter les métacaractères usuels du
shell Bourne (mais ce n'est pas une expression rationnelle). Le motif
.BR ?
correspond à un caractère quelconque, tandis que
.BR *
correspond à n'importe quelle chaîne (composée de zéro, un ou plusieurs
caractères). Par exemple,
.BR *.o
correspondra avec tous les fichiers dont le nom se termine en
.BR .o .
Ainsi, la commande
.IP
.B du --exclude='*.o'
.PP
ignorera tous les fichiers et répertoires dont le nom se termine en
.BR .o
(y compris le fichier
.BR .o
lui-même)

[NAME]
du \- estimate file space usage
[DESCRIPTION]
.\" Add any additional description here
[PATTERNS]
PATTERN is a shell pattern (not a regular expression).  The pattern
.BR ?
matches any one character, whereas
.BR *
matches any string (composed of zero, one or multiple characters).  For
example,
.BR *.o
will match any files whose names end in
.BR .o .
Therefore, the command
.IP
.B du --exclude='*.o'
.PP
will skip all files and subdirectories ending in
.BR .o
(including the file
.BR .o
itself).

[NOM]
echo \- Afficher une ligne de texte
[DESCRIPTION]
ATTENTION\ : votre shell peut avoir sa propre version de la commande
echo qui sera utilisée en lieu et place de celle documentée ici.
Veuillez vous référer à la documentation de votre shell pour en
connaître les options.

[NAME]
echo \- display a line of text
[DESCRIPTION]
NOTE: your shell may have its own version of echo which will supercede
the version described here. Please refer to your shell's documentation
for details about the options it supports.

[NOM]
rm \- Effacer des fichiers et des répertoires
[DESCRIPTION]
Cette page de manuel documente la version GNU de
.BR rm .
.B rm
efface chaque fichier spécifié. Par défaut, il n'efface pas
les répertoires.
.P
Si un fichier n'est pas accessible en écriture, si l'entrée standard est
un terminal tty, et si les options \fI\-f\fR et \fI\-\-force\fR ne sont
pas indiquées,
.B rm
demande à l'utilisateur de confirmer l'effacement du fichier. Si
la réponse n'est pas affirmative, le fichier est ignoré.
.SH OPTIONS
[VOIR AUSSI]
shred(1)

[NAME]
rm \- remove files or directories
[DESCRIPTION]
This manual page
documents the GNU version of
.BR rm .
.B rm
removes each specified file.  By default, it does not remove
directories.
.P
If a file is unwritable, the standard input is a tty, and
the \fI\-f\fR or \fI\-\-force\fR option is not given,
.B rm
prompts the user for whether to remove the file.  If the response
does not begin with `y' or `Y', the file is skipped.
.SH OPTIONS
[SEE ALSO]
shred(1)