Lea Linux - Contributions [fr]

Discussion Trucs:Supprimer les ^M dans les fichiers ASCII

2006-01-06T18:14:30Z

Evilash : /* Pour ceux qui n'on vraiment pas de bol ;) */

== Pour ceux qui n'on vraiment pas de bol ;) ==

Si d'aventure vous vous retrouvez avec un fichier sur une seule ligne, et qu'au vu des commentaire précédents vous obtenez un fichier vidé de ses <span style="color:#0000FF;">^M</span> mais toujours sur une ligne, reprenez le fichier brut (pas celui dans lequel on ne distingue plus les fins de lignes, autrement dit le fichier sur lequel vous n'avez appliqué aucune des précédentes méthodes) : <br>
<br>
$ vim lefichierenquestion

une fois sous vim :

:%s/{ctrl-v}{ctrl-m}/{ctrl-v}{entrée}/g

et voilà!
:Ajoute cette ruse carrément dans l’article et non dans les commentaires. [[Utilisateur:Nicola|Nicola]] 5 jan 2006 à 19:03 (CET)

Epson Perfection 3490 Photo

2006-01-06T17:29:00Z

Evilash : /* Pré requis */

[[Catégorie:Imprimantes_et_scanners]]
Le scanner Epson Perfection 3490 n'est officiellement pas supporté par le [http://www.sane-project.org/sane-mfgs.html#Z-EPSON sane-projet.org].

Pour autant, il est possible de le faire fonctionner sous linux en utilisant les pilotes fournis par Epson.

Bien que je ne l'ai pas essayé, il semblerait que le scanner Perfection 3590 ne soit qu'un clone du 3490 et que la configuration soit la même.

La section de ce document concerne la gestion des droits sur les scanners USB et devrait pouvoir être adaptable à tous les scanners usb.

== Pré requis ==
#noyau 2.6.12 ou supérieur avec udev
#libusb
#libsane
#xsane
#le module « scanner » ne doit PAS être installé

libsane est nécessaire, car le pilote fourni par Epson s'appuie sur l'architecture de sane.
La configuration sur laquelle ce scanner a été installé est une debian sarge ( stable ) avec noyau 2.6.12 en provenance de debian sid ( unstable )

Par rapport au module scanner, tout en n'étant pas installé, il peut arriver qu'il existe un fichier /etc/modprobe.d/libsane qui génère des messages d'erreur au boot.<br>
Commenter les deux ligne qu'il contient, ou carrément détruire le fichier.

== Installation ==
Pour l’installation c’est pas trop compliqué :

#Un câble USB2 à mettre sur votre ordinateur. Ca marche aussi en USB1 ou USB1.1 .
#un câble d’alimentation électrique

== Installer les pilotes fournis par Epson ==
Vu qu'Epson nous met à disposition les pilotes, on va aller les chercher [http://www.avasys.jp/english/linux_e/index.html sur leur site internet].

Il y a deux drivers différents ( selon le compilateur utilisé pour le noyau ). Dans mon cas, le deux ont marché de façon indifférente. Il semblerait que les utilisateurs Red Hat doivent utiliser la version pour GCC 3.2

=== Utilisateurs dont le gestionnaire de paquetages utilise des rpm ===
Installer directement le paquetage ( en tant que root ) :
<div class="code"><pre>
rpm -i iscan-1.17.0-1.c2.i386.rpm
</pre></div>

=== Utilisateurs dont le gestionnaire de paquetages utilise des .deb ===
Les utilisateurs de debian et assimilables doivent convertir le .rpm en .deb par la commande alien ( installer alien au besoin ), puis installer le paquetage ( en tant que root ) :
<div class="code"><pre>
alien -i iscan-1.17.0-1.c2.i386.rpm<br>
dpkg -i iscan_1.14.0-4_i386.deb
</pre></div>

=== Donner accès en lecture aux pilotes Epson ===
Les droits par défaut livrés avec les pilotes fournis par Epson ne permettent pas l'acquisition de données.

Il faut changer ces droits et/ou le propriétaire .
Le plus simple :
<div class="code"><pre>
chmod 444 /usr/share/iscan/*
</pre></div>

== Configurer sane ==
Indiquer que les scanners de marque « epkowa » sont autorisés en rajoutant epkowa dans le fichier suivant :
<div class="code"><pre>
vi /etc/sane.d/dll.conf

epkowa
</pre></div>

Pour forcer un chargement du module fourni par Epson, débrancher et rebrancher le scanner.

Pour vérifier l'efficacité de cette manoueuvre, en tant que root, taper :
<div class="code"><pre>
root@mimosa:~$ sane-find-scanner
# sane-find-scanner will now attempt to detect your scanner. If the
# result is different from what you expected, first make sure your
# scanner is powered up and properly connected to your computer.

# No SCSI scanners found. If you expected something different, make sure that
# you have loaded a SCSI driver for your SCSI adapter.
# Also you need support for SCSI Generic (sg) in your operating system.
# If using Linux, try "modprobe sg".
found USB scanner (vendor=0x04b8 [EPSON], product=0x0122 [EPSON Scanner]) at libusb:001:002
# Your USB scanner was (probably) detected. It may or may not be supported by
# SANE. Try scanimage -L and read the backend's manpage.

# Not checking for parallel port scanners.

# Most Scanners connected to the parallel port or other proprietary ports
# can't be detected by this program.

# You may want to run this program as root to find all devices. Once you
# found the scanner devices, be sure to adjust access permissions as
# necessary.
</pre></div>
Notre scanner a bien été reconnu.<br>
Nous allons vérifier qu'il est bien supporté par sane :
<div class="code"><pre>
root@mimosa:~$ scanimage -L
device `epkowa:libusb:001:002' is a Epson Perfection 3490/3590 flatbed scanner
</pre></div>
Notre scanner est bien supporté désormais par sane ( si cette étape échoue, inutile de continuer ).

Vérifier qu'un utilisateur normal peut se connecter, en utilisant les mêmes commandes.
Si il y a un pb, cf plus bas.

Dans tous les cas, afin d'améliorer la sécurité du système, il est préconisé d'effectuer les tâches de sécurisation décrites ci-après.

== Gérer proprement les droits ==
Cette section s'applique à tous les scanners usb, quelle que soit la marque et le modèle.
Cela évite d'avoir à se torturer en ce qui concerne la gestion des droits d'accès.

Sous debian, les utilisateurs du scanner sont ceux qui font partie du groupe « scanner ».
Commencer donc par vérifier que vos utilisateurs habilités à l'utilisation du scanner font partie de ce groupe.

Si un utilisateur déjà loggé est ajouté à un groupe, il doit se délogguer et se relogguer pour que la modification prenne effet.

Il faut commencer par demander à lsusb quel est le modèle de notre scanner :
<div class="code"><pre>
root@mimosa:~$ lsusb
Bus 002 Device 001: ID 0000:0000
Bus 001 Device 002: ID 04b8:0122 Seiko Epson Corp.
Bus 001 Device 001: ID 0000:0000
</pre></div>

L'ID du vendeur est 04b8 ( normal, c'est un epson )<br>
L'ID du scanner est 0122<br>
Le scanner est sur le bus 001 et de device 002.<br>
Le bus est donc : /proc/bus/usb/001<br>
Le périphérique est le fichier 002 contenu dans ce répertoire.<br>

Exemple :<br>
<div class="code"><pre>
martin@mimosa:~$ ls -lrt /proc/bus/usb/001/002
-rw-rw-rw- 1 root root 57 2005-12-17 19:55 002
</pre></div>
On voit que les droits sont assez larges : rw- pour tous : tout le monde peut accéder au scanner.

Editer le fichier suivant ( en tant que root ) :
<div class="code"><pre>
vi /etc/sane.d/hotplug/libsane.db
</pre></div>

Rajouter les lignes suivantes :
<div class="code"><pre>
# Epson Corp.|Perfection 3490/3590
0x04b8 0x0122 root:scanner 0660
</pre></div>
Ces lignes peuvent êtres rajoutées juste en dessous du scanner Perfection 2480, par exemple, qui a le numéro de produit précédent (0121 ).

D'une façon générale, la syntaxe est la suivante :<br>
0x+IdVendeur Ox+IdScanner propriétaire:groupe droits

On reconnaît dans les deux premières positions l'ID du vendeur ( précédé de 0x ) et l'ID du scanner ( précédé de 0x )<br>
On indique que le périphérique sera créé avec l'utilisateur root et le groupe scanner, avec des droits rw-rw---- ( 660 )

Débrancher et rebrancher le scanner :
<div class="code"><pre>
martin@mimosa:~$ ls -lrt /proc/bus/usb/001/
total 0
-rw-r--r-- 1 root root 43 2005-12-17 19:43 001
-rw-rw---- 1 root scanner 57 2005-12-17 20:04 003
</pre></div>

On constate que :<br>
suite au débranchement du scanner, le numéro de périphérique a changé
seuls l'utilisateur root et le groupe scanner ont désormais accès au périphérique

Pour les personnes utilisant le driver iscan, fourni par Epson, les droits par défaut sont gérés dans le fichier :
<div class="code"><pre>
vi /etc/hotplug/usb/iscan-device
</pre></div>
Remplacer :
<div class="code"><pre>
DEFAULT_OWNER=root
DEFAULT_GROUP=root
DEFAULT_PERMS=0666
</pre></div>
par :
<div class="code"><pre>
DEFAULT_OWNER=root
#DEFAULT_GROUP=root
#DEFAULT_PERMS=0666
DEFAULT_GROUP=scanner
DEFAULT_PERMS=0660
</pre></div>

Ce sont les droits par défaut qui étaient responsable de la largesse des droits octroyés avant de déclarer le scanner dans libsane.db.

il y a un autre fichier de conf qu'il est possible de renseigner, et qui devrait intéresser justement ceux qui n'utilisent pas iscan :
<div class="code"><pre>
vi /etc/udev/libsane.rules
</pre></div>
rajouter les lignes suivantes :
<div class="code"><pre>
# Epson Corp.|Perfection 3490
SYSFS{idVendor}=="04b8", SYSFS{idProduct}=="0122", MODE="660", GROUP="scanner", RUN+="/etc/hotplug.d/usb/libsane.hotplug"
</pre></div>
d'une façon plus générale :<br>
SYSFS{idVendor}=="IdVendeur", SYSFS{idProduct}=="IdScanner, MODE="droits", GROUP="groupe", RUN+="/etc/hotplug.d/usb/libsane.hotplug"

Noter l'absence du 0x devant les id dans ce fichier

Le script /etc/hotplug.d/usb/libsane.hotplug se charge, entre autre, de gérer les bons droits sur le périphérique. Il est redondant avec /etc/hotplug/usb/iscan-device. Il faut éditer soit l'un, soit l'autre.

Enfin, si on veut vraiement gérer proprement les droits, ceux que nous avons octroyés aux bibliothèques fournis par Epson sont un peu larges.<br>
On va d'abord changer le groupe de ces fichiers : ce sera désormais "scanner"<br>
On va réduire les droits en lecture au propiétaire et au groupe.<br>
Ces deux opérations ne peuvent se faire qu'avec les droits root.<br>
<div class="code"><pre>
chgrp scanner /usr/share/iscan/*
chmod 440 /usr/share/iscan/*
</pre></div>

== Logiciels d'accès au scanner==
Le plus couremment utilisé est xsane, auquel on peut accéder directement comme une extension de Gimp.<br>
Avec ses drivers, Epson fourni iscan, qui offre une interface simple mais efficace au scanner.
Il est possible de rendre iscan accessible depuis gimp :
<div class="code"><pre>
ln -s /usr/bin/iscan ~/.gimp2.2/plug-ins
</pre></div>
== Exemples de fichiers de conf ( extraits ) ==
/etc/sane.d/dll.conf
<div class="code"><pre>
# /etc/sane.d/dll.conf - Configuration file for the SANE dynamic backend loader
#
# On Debian systems, the dll backend will also look for pieces of configuration
# in the /etc/sane.d/dll.d directory -- packages providing backends should drop
# a config file similar to dll.conf in this directory.
#

# enable the next line if you want to allow access through the network:
net
abaton
agfafocus
[...]
dmc
epson
epkowa
fujitsu
#gphoto2
[...]
hp5400
ibm
[...]
</pre></div>
<br>
/etc/sane.d/hotplug/libsane.db
<div class="code"><pre>
# /etc/sane.d/dll.conf - Configuration file for the SANE dynamic backend loader
# This file is part of the SANE distribution
#
# USB Vendor/Product IDs for scanners supported by SANE
#
# 0xVVVV<tab>0xPPPP<tab>root:scanner<tab>0660<tab>[/usr/local/bin/foo.sh]
#
# The following list already contains a lot of scanners. If your scanner
# isn't mentioned there, add it as explained above and mail the entry to
# the sane-devel mailing list.
#
# Hewlett-Packard|ScanJet 4100C
0x03f0 0x0101 root:scanner 0660
[...]
# Epson Corp.|Perfection 2480
0x04b8 0x0121 root:scanner 0660
# Epson Corp.|Perfection 3490/3590
0x04b8 0x0122 root:scanner 0660
# Epson Corp.|GT-15000 (ES-7000)
[...]
</pre></div>
<br>
/etc/hotplug/usb/iscan-device.<br>
Ce fichier fait partie des éléments fournis par Epson dans son paquetage iscan.
<div class="code"><pre>
#!/bin/sh
# iscan-device -- modifies device permissions for supported devices
# Copyright (C) 2005 SEIKO EPSON Corporation

# This file is part of "Image Scan! for Linux".
# You can redistribute it and/or modify it under the terms of the GNU
# General Public License as published by the Free Software Foundation;
# either version 2 of the License or at your option any later version.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of FITNESS
# FOR A PARTICULAR PURPOSE or MERCHANTABILITY.
# See the GNU General Public License for more details.
#
# You should have received a verbatim copy of the GNU General Public
# License along with this program; if not, write to:
#
# Free Software Foundation, Inc.
# 59 Temple Place, Suite 330
# Boston, MA 02111-1307 USA

# This script changes the permissions and ownership of a USB device
# under /proc/bus/usb to grant access to the device to users. This
# will be done according to system policy wherever possible, but as
# a fallback access will be granted to _all_ users.

# Of course, fallback behaviour can be customised ;-)
#
DEFAULT_OWNER=root
DEFAULT_GROUP=scanner
DEFAULT_PERMS=0660

# Rely on the sane-backends script (or a vendor specific script) if
# available. Distributors have probably modified it to suit system
# policy. Following is a list of scripts out there in the wild and
# some notes on where they have been observed.
#
# libusbscanner sane-backends (>= 1.0.14)
# usbscanner Mandrake 10
# desktopdev SUSE 9.1 Pro
#
USB_SCRIPTS="libusbscanner
usbscanner
desktopdev
"
for script in $USB_SCRIPTS; do
if [ -x $HOTPLUG_DIR/$TYPE/$script ]; then
exec $HOTPLUG_DIR/$TYPE/$script
fi
done

# Activate fallback settings
#
if [ "$ACTION" == add -a "$TYPE" == "usb" ]; then
chown $DEFAULT_OWNER:$DEFAULT_GROUP "$DEVICE"
chmod $DEFAULT_PERMS "$DEVICE"
fi
</pre></div>
<br>
/etc/udev/libsane.rules
<div class="code"><pre>
# This file is part of the SANE distribution
#
# udev rules file for supported scanners
#
#
# For now, only USB scanners are listed/supported by this set of rules;
# feel free to add support for other busses.
#
# To add an USB scanner, add a rule to the list below between the SUBSYSTEM...
# and LABEL... lines.
#
# To run a script when your scanner is plugged in, add RUN="/path/to/script"
# to the appropriate rule.
#

SUBSYSTEM!="usb_device", ACTION!="add", GOTO="libsane_rules_end"

# Hewlett-Packard|ScanJet 4100C
SYSFS{idVendor}=="03f0", SYSFS{idProduct}=="0101", MODE="660", GROUP="scanner", RUN+="/etc/hotplug.d/usb/libsane.hotplug"
# Hewlett-Packard|PhotoSmart S20
SYSFS{idVendor}=="03f0", SYSFS{idProduct}=="0102", MODE="660", GROUP="scanner", RUN+="/etc/hotplug.d/usb/libsane.hotplug"
# Hewlett-Packard|ScanJet 4200C
[...]# Epson Corp.|Perfection 2480
SYSFS{idVendor}=="04b8", SYSFS{idProduct}=="0121", MODE="660", GROUP="scanner", RUN+="/etc/hotplug.d/usb/libsane.hotplug"
# Epson Corp.|Perfection 3490
SYSFS{idVendor}=="04b8", SYSFS{idProduct}=="0122", MODE="660", GROUP="scanner", RUN+="/etc/hotplug.d/usb/libsane.hotplug"
# Epson Corp.|GT-15000 (ES-7000)
SYSFS{idVendor}=="04b8", SYSFS{idProduct}=="0126", MODE="660", GROUP="scanner", RUN+="/etc/hotplug.d/usb/libsane.hotplug"
[...]

LABEL="libsane_rules_end"
</pre></div>
{{Copy|Décembre 2005|[[Utilisateur:Martin.riondet|Martin.riondet]]|CC-BY-SA}}

Utiliser groff

2006-01-06T17:26:28Z

Evilash : /* Les forces et faiblesses de groff */

== Introduction ==
Comme Monsieur Jourdain fait de la prose, la plupart des nouveaux utilisateurs et utilisatrices de notre OS libre préféré utilisent un puissant outil de formatage et génération de documents. Cet outil a tendance à se faire oublier, tellement il est discret malgré sa participation vitale au quotidien de tout utilisateur ou utilisatrice, et cela concerne même les plus chevronné(e)s. Cet outil, c'est <code>groff</code>

== Que peut-on faire avec groff ? ==

La commande '''groff''' permet à partir d'une même source de :

* générer des documents mis en page : livre, lettre, documentation, rapport...etc.
* créer des images de ces documents en format : postscript, man (Latin 1 formatés), html, dvi, Textes (Latin1 formatés)...

== Quelles sont ses origines ? ==

Au départ, cet environnement de formatage de documents appelé '''troff''' a été développé en assembleur par Joe Ossanna vers 1973, pour piloter une imprimante graphique (Graphic System CAT Typesetter) branchée sur un bon vieux PDP-11. Il fut porté en C vers 1975, mais malheureusement, Joe Ossanna décède en 1977.

C'est le célèbre Brian Kernighan qui reprend le flambeau en 1979 et modifie '''troff''' afin de le rendre compatible avec d'autres formats de sortie. de 1979 à 1989, les sources de '''troff''' ont été modestement retouchées de manière à laisser la quasi totalité du code intacte en mémoire de Joe Ossanna.

'''groff''' est donc en quelque sorte une oeuvre postume trouvant ses d'origines à quelques pas de l'OS '''UNIX'''. Cet utilitaire extrèmement efficace est aujourd'hui porté sur les systèmes d'exploitations les plus novateurs tels que '''plan 9''', '''inferno''' ou encore '''Amoeba'''.
Dans ces différents portages, il se fait parfois appeler '''roff''', '''nroff''', '''troff''', mais est toujours présent sur tout système de philosophie UNIX.

Il présente parfois de légères différences selon les spécificités des plateformes afin d'en tirer le meilleur parti, mais semble toujours compatible car les développeurs d'environnement ont prévu des équivalences afin de toujours pourvoir générer des documents propres.
Même '''MINIX''' célèbre petit OS didactique développé par Andrew Tenenbaum (MINIX mais il fait le maximum...) dispose de cette commande !

== Les forces et faiblesses de groff ==

'''Forces :'''
*Très rapide à assimiler comparé a son 'grand frêre' '''L<sup>A</sup>T<sub>E</sub>X'''.
*Grande robustesse et génération toujours fidèle aux attentes de l'utilisateur.
*Très léger, il permet un traitement rapide des informations même sur des petites configurations ne *disposant pas d'une interface X-Windows.
*Personnalisable
'''Faiblesses : '''(il en faut bien pour rester objectif)
*Son langage macro est un peu rébarbatif (mais après un petit effort, il devient vite familier).
*Un peu plus rigide que '''L<sup>A</sup>T<sub>E</sub>X''' losque l'on souhaite personnaliser un document.
*Peu de documentations sont disponibles étant donné son grand âge.

== Un exemple ! un exemple ! un exemple... ==

Comme mentionné précédemment, '''groff''' est présent sur votre ordinateur, et vous disposez déjà d'exemples sources ! Il vous suffit par exemple d'ouvrir un fichier de type man, pour cela, il vous suffit de choisir un petit exemple parmi les centaines de documentations man.

=== Comment procéder ? ===
# Trouver l'emplacement des sources des fichiers de documentations du système.
# Copier une commande dans votre répertoire de travail habituel.
# Décompresser le fichier.
# Ouvrir le fichier dans votre éditeur de texte habituel.
# Contempler...

==== En pratique ====
Bien que je sois persuadé que la plupart d'entre-vous ont directement "switché" en mode console et sont déjà en train de tripatouiller un fichier juste pour voir, je vous donne ici les grandes directions qui vous permettront de trouver ces fichiers.
==== Trouver les fichiers sources man ====
Vous pouvez les chercher à la main, en changeant de répertoire. Généralement, on les trouve dans les parages de <tt>/usr/man</tt> ou encore <tt>/usr/share/man</tt> ou encore <tt>/usr/local/man</tt> et bien d'autres endroits.

Choisissez un répertoire parmi ''man1'',''man2'',...,''mann'' situés dans le répertoire ''/.../man/'' ou ''/.../man/fr/''.
<code multi>
[mujma@localhost]#ls -l /usr/share/man
total 300
drwxr-xr-x 4 root root 4096 aoû 17 20:12 bg
drwxr-xr-x 2 root root 4096 aoû 17 20:26 cat1
drwxr-xr-x 2 root root 4096 aoû 17 20:26 cat5
drwxr-xr-x 5 root root 4096 aoû 17 20:12 cs
...
drwxr-xr-x 11 root man 4096 aoû 17 20:16 fr
...
drwxr-xr-x 2 root root 40960 nov 16 22:51 man1
drwxr-xr-x 2 root root 4096 jan 5 2004 man2
drwxr-xr-x 2 root root 114688 nov 8 08:47 man3
drwxr-xr-x 2 root root 4096 aoû 18 14:23 man4
drwxr-xr-x 2 root root 8192 nov 16 22:51 man5
drwxr-xr-x 2 root root 4096 aoû 17 20:20 man6
drwxr-xr-x 2 root root 4096 oct 20 18:20 man7
drwxr-xr-x 2 root root 12288 nov 2 15:07 man8
drwxr-xr-x 2 root root 4096 jan 5 2004 man9
drwxr-xr-x 2 root root 8192 aoû 17 20:29 mann
drwxr-xr-x 5 root root 4096 aoû 17 20:12 nl
...
drwxr-xr-x 4 root root 4096 aoû 17 20:12 sl
drwxr-xr-x 3 root root 4096 aoû 17 20:10 uk
</code>

En listant le répertoire désiré on obtient donc la liste des commandes :

<code multi>
[mujma@localhost]#ls -l /usr/share/man/fr/man1/
total 4036
-rw-r--r-- 1 root man 962 jan 31 1999 3ds2m.1.bz2
-rw-r--r-- 1 root man 967 jul 03 1999 3dsdump.1.bz2
-rw-r--r-- 1 root man 1641 jun 13 2001 9wm.1.bz2
...
-rw-r--r-- 1 root man 6531 aoû 10 2003 ls.1.bz2 <-------- On va copier ce fichier dans le répertoire $HOME
...
-rw-r--r-- 1 root man 2251 apr 08 1989 zmore.1.bz2
-rw-r--r-- 1 root man 751 apr 08 1989 znew.1.bz2
</code>

Enfin on peut copier le fichier et le décompresser :

<code multi>
[mujma@localhost]#cp /usr/share/man/fr/man1/ls.1.bz2 $HOME
[mujma@localhost]#bunzip2 ls.1.bz2
</code>
==== Ouvrir un exemple ====
Enfin, si on ouvre ce fichier dans un éditeur de texte on obtient :

<code multi>
.\" Traduction 19/12/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" màj 04/01/1999 - LDP man-pages 1.22
.\" màj 03/01/2000
.\" màj 26/06/2000 - LDP man-pages 1.30
.\" màj 30/05/2001 - LDP man-pages 1.36
.\" màj 22/10/2002 - LDP man-pages 1.53
.\" MàJ 25/07/2003 LDP-1.56
.TH LS 1L "25 juillet 2003" LDP "Manuel de l'utilisateur Linux"
.SH NOM
ls, dir, vdir \- Afficher le contenu d'un répertoire.
.SH SYNOPSIS
.BI "ls [" options "] [" fichier... ]
.br
.BI "dir [" fichier... ]
.br
.BI "vdir [" fichier... ]
.sp
Options POSIX :
.BI "[\-CFRacdilqrtu1] [\-\-]"
.sp
Options GNU (forme courte) :
.B [\-1abcdfgiklmnopqrstuvwxABCDFGHLNQRSUX]
.BI "[\-w " cols ]

...

Cette page documente la version de
.B ls
du paquetage fileutils-4.0. D'autres versions peuvent diverger légèrement.

.SH TRADUCTION
Christophe Blaess, 1996-2003.
</code>

==== Faire un petit tour de groff ====
Avant de réellement comprendre la signification des codes étranges et barbares parfois situés en début de ligne, je vous invite maintenant à quitter votre éditeur pour rejoindre votre console.

Nous allons maintenant faire quelques manipulations pratique sur le fichier ls.1 que nous avons recopié tout dernièrement dans notre répertoire de travail habituel.

Tapez la commande suivante :
<code>[mujma@localhost]#groff -Tps -man ls.1 > ls.1.ps</code>

Si groff est correctement installé (et il y a 99,9% de chances qu'il le soit), vous devriez voir apparaître le fichier <tt>ls.1.ps</tt> dans le répertoire courant.

Vous pouvez le visualiser avec n'importe quel afficheur postscript.

Maintenant nous allons faire encore plus fort ! Pour cela tapez la commande :
<code>
[mujma@localhost]#groff -Thtml -man ls.1 > ls.1.html
</code>

De manière identique à la commande précédente, vous venez de générer un fichier html. Ouvrez-le vite... Oui, c'est bien la documentation au format html.
Vous pouvez procéder ainsi avec toutes les pages de manuel linux !
En fait, groff est un préprocesseur. Il permet de générer les formats suivants à partir d'une seule source :

; '''dvi''' : Pour ceux qui connaissent, c'est le format TeX/LaTeX DVI.
; '''html''' : c'est le format bien connu dont le nom signifie Hyper Text Markup Language et non, contrairement à ce que certains sous entendent parfois Hautes Technologies Mais Limitées.
; '''lbp''' : Format CAPSL pour les imprimantes laser Canon de type lbp-4 ou lpb-8.
; '''lj4''' : Format PCL5 pour imprimantes HP et compatibles.
; '''ps''' : Du vrai postscript bien de chez nous !
; '''ascii''' : C'est le format ASCII 7-Bits, je le testerai peut-être cet hiver s'il y a de la neige.
; '''cp1047''' : Historiquement destiné à certains serveurs internet et autres mainframes qui n'ont toujours pas étés concurrencés par un certain Bill G. qui impose au monde le cp1250 dans les clicodrômes vitrés depuis la version nonante cinq , mais aussi langage natif de l'imprimante qui vous sert peut-être aujourd'hui de bac à fleurs, ce format implémente le jeux de caractères latin-1 en EBCDIC.
; '''latin1''' : C'est le jeu de caractères ISO 8859-1 utilisé par exemple pour afficher des symboles mystérieux appartenant à l'obscur langage qu'étaient le François et le Français. On notera au passage qu'il offre aussi l'avantage d'afficher des messages en "verlan" et en "nique ta m..." ou encore "nique ta r..." dialectes évolués de notre époque concurrençant le "slang" parlé dans les prisons anglo-saxonnes.
; '''utf8''' : C'est le jeu de caractères Unicode UTF-8, similaire à celui du bios de votre machine.

== groff et ses environnements ==

Si l'on se réfère à l'invocation de '''groff''' dans l'exemple précédent, groff est invoqué avec 3 paramètres en ligne de commande.

<code>groff -Thtml -m man ls.1 > ls.1.html</code>

de manière plus générale on peut invoquer groff de la manière suivante :

<code>groff -T'<format_sortie>' -m '<format_entrée>' > ls.1.html</code>

'<format_sortie>' correspond aux formats de sorties évoqués précédemment.

'<format_entrée>' correspond au format utilisé pour écrire le source.

Pour groff un format de sortie ou un format d'entrée n'est ni plus ni moins qu'un ensemble de macros correspondant à des environnements.

On trouve généralement les environnements (ou format d'entrée) suivants avec le paquet groff :

Les environnement macro dédiés au système de documentation :

; '''man''' : format traditionnel des pages de manuel.
; '''mdoc''' : format BSD des pages de manuel.
; '''mandoc''' : cet environnement encapsule man et mdoc et permet de reconnaître le format du fichier d'origine automatiquement.

Pour des documents plus courants :

; '''me''', '''mm''' et '''ms''' : des environnements de génération de documents plus classiques (livres, rapports...).

Pour générer des pages Web :

; '''www''' : pour générer des documents 'HTML'.

== Où peut-on trouver des informations sur groff ==

Les sites suivants vous apporterons diverses ressources pour '''groff''':
* http://www.gnu.org/software/groff/groff.html
* http://www.troff.org/
* http://www.kohala.com/start/troff/troff.html

{{Copy|2005|Marc UJMA|CC-BY-SA}}