NOM
emacs - projet GNU Emacs
SYNOPSIS
emacs [ options ] [ fichiers... ]
GNU Emacs est une version d'Emacs écrite par l'auteur du Emacs original
(PDP-10), Richard Stallman. La documentation principale concernant GNU
Emacs se situe dans le manuel GNU Emacs, que vous pouvez lire en ligne
en utilisant info (à partir d'Emacs ou en dehors). Jetez-y un coup
d'oeil pour obtenir une information complète et mise à jour. Cette page
de manuel n'est mise à jour que lorsque des volontaires se manifestent,
le but prioritaire des mainteneurs d'Emacs étant de minimiser le temps
passé à écrire cette page de manuel au lieu d'autres projets plus
utiles. Les fonctionnalités utilisateur de GNU Emacs recouvrent tout ce
que les autres éditeurs Emacs peuvent faire, et il est aisément
extensible puisque ses commandes d'édition sont écrites en Lisp.
Emacs met à disposition une vaste aide interactive, mais cette facilité
suppose que vous sachiez comment manipuler les fenêtres et les tampons
d'Emacs. CTRL-h (NDT : backspace ou CTRL-h) lance le mode d'aide. Le
didacticiel d'Aide (CTRL-h t) peut apprendre aux débutants les
fondements d'Emacs en quelques minutes. L'aide Apropos (CTRL-h a)
permet de trouver une commande quand on connaît sa fonctionnalité, le
caractère d'aide (CTRL-h c) décrit l'effet d'un caractère particulier,
et l'aide de fonction (CTRL-h f) décrit une fonction Lisp particulière
spécifiée par son nom.
La fonctionnalité d'annulation d'Emacs peut annuler quelques
modifications successives de vos tampons, de sorte qu'il est facile de
se remettre d'erreurs d'édition.
Les nombreux paquetages spéciaux de GNU Emacs traitent notamment de la
lecture de courriers électroniques (RMail) et de leur envoi (Mail),
d'édition hors ligne (Outline), de compilation (Compile), du lancement
de sous-shells à partir de fenêtres Emacs (Shell), du lancement d'une
boucle lecture-évaluation-affichage Lisp (Lisp-Interaction-Mode), et de
l'utilisation d'une psychothérapie automatique (Doctor).
Il existe un manuel de référence exhaustif, mais les utilisateurs
d'autres Emacs ne devraient rencontrer que peu de problèmes
d'adaptation, et ce, même s'ils n'en possèdent pas la copie. Les
nouveaux utilisateurs d'Emacs pourront utiliser les fonctionnalités de
base assez rapidement en étudiant le didacticiel, et en utilisant les
fonctionnalités de documentation intégrées.
Options d'Emacs
Les options suivantes sont d'intérêt pour tous :
fichier
Éditer le fichier.
--file fichier, --find-file fichier, --visit fichier
Idem qu'en soumettant le nom de fichier directement.
+numéro
Aller à la ligne spécifiée par le numéro (ne pas insérer
d'espace entre le signe « + » et le numéro). Ceci ne
s'applique qu'au fichier suivant spécifié.
+ligne:colonne
Aller à la position spécifiée par ligne:colonne.
-q
Ne pas charger de fichier d'initialisation.
--no-site-file
Ne pas charger le fichier de démarrage du site.
--no-desktop
Ne pas charger de bureau sauvegardé.
-nl, --no-shared-memory
Ne pas utiliser de mémoire partagée.
-Q, --quick
Equivalent à "-q --no-site-file --no-splash".
--no-splash
Ne pas afficher d'écran durant le démarrage.
--debug-init
Active le débogeur Lisp d'Emacs durant le traitement du
fichier d'initialisation de l'utilisateur (~/.emacs).
Ceci est utile pour diagnostiquer des problèmes dans ce
fichier.
-u utilisateur, --user utilisateur
Charger le fichier d'initialisation de l'utilisateur.
-t fichier, --terminal fichier
Utiliser le fichier spécifié comme terminal au lieu de
stdin/stdout. Ceci doit être le premier argument
spécifié sur la ligne de commande.
--multibyte, --no-unibyte
Active le mode multi-octets (activé par défaut).
--unibyte, --no-multibyte
Active le mode 1-octet.
--version
Affiche la version d'Emacs.
--help
Affiche l'aide d'Emacs.
Les options suivantes sont orientées Lisp (ces options sont traitées
dans l'ordre où elles sont rencontrées) :
-f fonction, --funcall fonction
Exécuter la fonction Lisp nommée.
-l fichier, --load fichier
Charger le code Lisp contenu dans le fichier nommé.
-l fichier, --load fichier
Charger le code Lisp contenu dans le fichier nommé.
--eval expr, --execute expr
Evalue l'expression Lisp expr.
Les options suivantes sont utiles lorsqu'Emacs est exécuté en mode non
interactif (« batch », en anglais) :
--batch
Éditer en mode non interactif. L'éditeur enverra les
messages sur stderr. Cette option doit être la première
de la liste des arguments. Vous devez utiliser les
options -l et -f pour spécifier les fichiers à exécuter
et les fonctions à appeler.
--script fichier
Exécute le fichier nommé en tant que script Lisp Emacs.
--insert fichier
Insère le contenu du fichier nommé dans le tampon actif.
--kill
Sortir d'Emacs (quand en mode non interactif).
-L répertoire, --directory répertoire
Ajoute le répertoire nommé à la liste des répertoires où
Emacs recherche des fichiers Lisp.
Utiliser Emacs sous X
Emacs a été taillé pour bien fonctionner avec le système de
fenêtrage X. Si vous lancez Emacs sous X, il créera sa propre
fenêtre X pour son affichage. Vous pourriez vouloir lancer
l'éditeur en tant que processus en tâche de fond afin de pouvoir
continuer à utiliser votre fenêtre originale.
Emacs peut être démarré avec les options X suivantes :
--name nom
Spécifie le nom qui devrait être affecté à la fenêtre
Emacs initiale. Cela permet de contrôler la recherche
des ressources X, ainsi que le titre de la fenêtre.
-T nom, --title nom
Spécifie le titre de la fenêtre X initiale.
-r, -rv, --reverse-video
Afficher la fenêtre Emacs en vidéo inversée.
-fn police, --font police
Fixer la police de caractères de la fenêtre Emacs à la
police nommée. Vous trouverez les différentes polices X
dans le répertoire /usr/lib/X11/fonts. Notez qu'Emacs
n'acceptera que des polices de largeur fixe. Selon les
conventions de nommage des polices de X11R4, n'importe
quelle police possédant la valeur « m » ou « c » dans le
onzième champ du nom de la police est une police de
largeur fixe. De plus, les polices dont le nom est de la
forme largeurxhauteur ont généralement une largeur fixe.
Voyez xlsfonts(1) pour davantage d'informations.
Lorsque vous spécifiez une police, assurez-vous bien de
placer un espace entre l'option et le nom de la police.
--xrm resources
Positionne des ressources X supplémentaires.
--color, --color=mode
Remplace le mode couleur des terminaux. Par défaut, le
mode est ‘auto’ ; il peut également prendre les valeurs
suivantes : ‘never’, ‘auto’, ‘always’, ainsi que des
valeurs telles que ‘ansi8’.
-bw pixels, --border-width pixels
Fixe la largeur de la bordure de la fenêtre d'Emacs au
nombre de pixels spécifiés par pixels. Par défaut, un
pixel est placé de chaque côté de la fenêtre.
-ib pixels, --internal-border pixels
Fixe la largeur du bord interne de la fenêtre au nombre
de pixels spécifiés par pixels. Par défaut, un pixel de
remplissage est placé de chaque côté de la fenêtre.
-g géométrie, --geometry géométrie
Fixe la largeur, la hauteur et la position de la fenêtre
Emacs comme spécifié. La spécification de géométrie fait
partie du format X standard ; voyez X(7) pour davantage
d'informations. La largeur et la hauteur sont spécifiées
en nombre de caractères ; par défaut, il s'agit de 80
caractères de largeur sur 24 caractères de hauteur. Il
est possible de se référer à la section « Options for
Window Size and Position » du manuel Emacs.
-lsp pixels, --line-spacing pixels
Définit un espace supplémentaire à ajouter entre les
lignes.
-vb, --vertical-scroll-bars
Active les barres de défilement vertical.
-fh, --fullheight
Donne au premier écran la hauteur du moniteur.
-fs, --fullscreen
Passe le premier écran en mode plein écran.
-fw, --fullwidth
Donne au premier écran la largeur du moniteur.
-fg couleur, --foreground-color couleur
Sur les affichages acceptant la couleur, définit la
couleur du texte.
Utiliser la commande M-x list-colors-display afin
d'obtenir une liste des noms de couleur valides.
-bg couleur, --background-color couleur
Sur les affichages acceptant la couleur, définit la
couleur d'arrière-plan de la fenêtre.
-bd couleur, --border-color couleur
Sur les affichages acceptant la couleur, fixe la couleur
du bord de la fenêtre.
-cr couleur, --cursor-color couleur
Sur les affichages acceptant la couleur, définit la
couleur du curseur de texte de la fenêtre.
-ms couleur, --mouse-color couleur
Sur les affichages acceptant la couleur, définit la
couleur du curseur de la souris (dans la fenêtre).
-d nom_affichage, --display nom_affichage
Créer la fenêtre Emacs sur le terminal d'affichage
spécifié par nom_affichage. Cette option doit être la
première spécifiée à la ligne de commande.
-nbi, --no-bitmap-icon
Ne pas utiliser l'image GNU pour l'icône Emacs.
--iconic
Démarre Emacs iconifié.
-nbc, --no-blinking-cursor
Désactive le clignotement du curseur.
-nw, --no-window-system
Indiquer à Emacs de ne pas utiliser son interface X
spéciale. Si vous utilisez ce commutateur d'option
lorsque vous invoquez Emacs à partir d'une fenêtre
xterm(1), l'affichage est effectué dans cette fenêtre.
-D, --basic-display
Cette option désactive nombre de caractéristiques
concernant l'affichage ; à utiliser à des fins de
débogage.
Vous pouvez fixer des valeurs X par défaut pour vos fenêtres Emacs au
sein de votre fichier .Xresources (voyez xrdb(1)). Utilisez le format
suivant :
emacs.mot_clé:valeur
où valeur spécifie la valeur par défaut du mot_clé. Emacs vous permet
de fixer des valeurs par défaut pour les mots-clés suivants :
background (classe Background)
Sur les affichages acceptant la couleur, fixer la
couleur d'arrière-plan de la fenêtre.
bitmapIcon (classe BitmapIcon)
Si la valeur de bitmapIcon est on, la fenêtre
s'iconifiera sous la forme d'un « évier de cuisine ».
borderColor (classe BorderColor)
Sur les affichages acceptant la couleur, fixer la
couleur du bord de la fenêtre.
borderWidth (classe BorderWidth)
Fixer la largeur du bord de la fenêtre en pixels.
cursorColor (classe Foreground)
Sur les affichages acceptant la couleur, fixer la
couleur du curseur de texte de la fenêtre.
cursorBlink (classe CursorBlink)
Active ou désactive le clignotement du curseur. La
valeur par défaut est on. Utiliser off ou false
pour désactiver ce clignotement.
font (classe Font)
Définir la police de caractères de la fenêtre.
foreground (classe Foreground)
Sur les affichages acceptant la couleur, fixer la
couleur du texte de la fenêtre.
fullscreen (classe Fullscreen)
The desired fullscreen size. The value can be one of
fullboth, fullwidth, or fullheight, which correspond to
the command-line options ‘-fs’, ‘-fw’, and ‘-fh’,
respectively. Note that this applies to the initial
frame only.
geometry (classe Geometry)
Fixer la géométrie de la fenêtre Emacs (comme décrit
plus haut).
iconName (classe Title)
Fixer le nom de l'icône pour l'icône de la fenêtre Emacs
internalBorder (classe BorderWidth)
Fixer la largeur du bord interne de la fenêtre en pixels
lineSpacing (classe LineSpacing)
Additional space ("leading") between lines, in pixels.
menuBar (classe MenuBar)
Gives frames menu bars if on; don’t have menu bars if
off. See the Emacs manual, sections "Lucid Resources"
and "LessTif Resources", for how to control the
appearance of the menu bar if you have one.
minibuffer (classe Minibuffer)
If none, don’t make a minibuffer in this frame. It will
use a separate minibuffer frame instead.
paneFont (classe Font)
Font name for menu pane titles, in non-toolkit versions
of Emacs.
pointerColor (classe Foreground)
Sur les affichages acceptant la couleur, fixer la
couleur du curseur de la souris (de la fenêtre).
privateColormap (classe PrivateColormap)
If on, use a private color map, in the case where the
"default visual" of class PseudoColor and Emacs is using
it.
reverseVideo (classe ReverseVideo)
Si la valeur de reverseVideo est fixée à on, la fenêtre
sera affiché en vidéo inversée.
screenGamma (classe ScreenGamma)
Gamma correction for colors, equivalent to the frame
parameter ‘screen-gamma’.
scrollBarWidth (classe ScrollBarWidth)
The scroll bar width in pixels, equivalent to the frame
parameter ‘scroll-bar-width’.
selectionFont (classe SelectionFont)
Font name for pop-up menu items, in non-toolkit versions
of Emacs. (For toolkit versions, see the Emacs manual,
sections "Lucid Resources" and "LessTif Resources".)
selectionTimeout (classe SelectionTimeout)
Number of milliseconds to wait for a selection reply. A
value of 0 means wait as long as necessary.
synchronous (classe Synchronous)
Run Emacs in synchronous mode if on. Synchronous mode
is useful for debugging X problems.
title (classe Title)
Fixer le titre de la fenêtre Emacs.
toolBar (classe ToolBar)
Number of lines to reserve for the tool bar.
useXIM (classe UseXIM)
Turns off use of X input methods (XIM) if false or off.
verticalScrollBars (classe ScrollBars)
Gives frames scroll bars if on; suppresses scroll bars
if off.
visualClass (classe VisualClass)
Specify the "visual" that X should use. This tells X
how to handle colors. The value should start with one
of TrueColor, PseudoColor, DirectColor, StaticColor,
GrayScale, and StaticGray, followed by -depth, where
depth is the number of color planes.
Si vous essayez de fixer des valeurs de couleur, alors que vous
utilisez un affichage noir et blanc, les caractéristiques par défaut de
la fenêtre seront : noir pour la couleur d'avant-plan, blanc pour la
couleur d'arrière-plan, gris pour la couleur de la bordure, et noir
pour les curseurs (de texte et de souris).
Utiliser la souris
Voici quelques combinaisons concernant les boutons de souris (dans les
fenêtres Emacs sous X11).
BOUTON SOURIS FONCTION
------------------------------------------------------------
gauche Spécifier un point.
milieu Coller un texte.
droit Couper du texte dans le tampon de coupure de
X.
SHIFT-milieu Couper du texte dans le tampon de coupure de
X.
SHIFT-droit Coller un texte.
CTRL-milieu Couper du texte dans le tampon de coupure de
X et le détruire.
CTRL-droit Sélectionner cette fenêtre, et la découper
ensuite en deux fenêtres. Comme CTRL-x 2 au
clavier.
CTRL-SHIFT-gauche Menu (tampons X) — gardez les boutons et les
touches appuyées, attendez l'apparition du
menu, sélectionnez le tampon, et relâchez.
Déplacez la souris hors du menu, et relâchez
pour annuler.
CTRL-SHIFT-milieu Menu d'aide X — Fait apparaître le menu à
cartes d'aide Emacs.
CTRL-SHIFT-droit Sélectionner la fenêtre avec la souris, et
effacer toutes les autres fenêtres. Comme
CTRL-x 1 au clavier.
MANUELS
Vous pouvez commander des copies imprimées du manuel de GNU Emacs (en
anglais) à la Free Software Foundation, qui développe les logiciels
GNU. Voyez le fichier ORDERS pour plus d'informations à ce sujet.
Votre mainteneur Emacs local peut également disposer de copies. Comme
pour tous les logiciels et publications de la FSF, n'importe qui peut
réaliser et distribuer des copies du manuel d'Emacs. La source TeX du
manuel est également incluse dans la distribution des sources d'Emacs.
FICHIERS
/usr/share/info — fichiers du butineur de documentation Info. Le texte
complet du manuel de référence d'Emacs y est inclus dans une forme
agréable structurée en arbre. Egalement, le manuel de référence Lisp
pour Emacs y est inclus ; ceci est utile à toute personne souhaitant
écrire des programmes en langage Lisp pour Emacs.
/usr/share/emacs/$VERSION/lisp — fichiers sources Lisp et fichiers
compilés définissant la plupart des commandes d'édition. Certains sont
préchargés, d'autres sont chargés automatiquement à partir de ce
répertoire lorsqu'ils sont utilisés.
/usr/lib/emacs/$VERSION/$ARCH — divers programmes utilisés avec GNU
Emacs
/usr/share/emacs/$VERSION/etc — divers fichiers d'information.
/usr/share/emacs/$VERSION/etc/DOC.* — contient les chaînes de
caractères de documentation pour les primitives Lisp et les fonctions
Lisp préchargées de GNU Emacs. Elles sont stockées ici afin de réduire
la taille d'Emacs en lui-même.
/usr/share/emacs/$VERSION/etc/SERVICE — liste les personnes offrant des
services de support aux utilisateurs de GNU Emacs, ce qui inclut la
formation, le dépannage, le portage et la personnalisation.
BOGUES
Il y a une liste de diffusion, bug-gnu-emacs@gnu.org, utilisée pour
communiquer bogues et corrections concernant Emacs. Mais avant de
rapporter ce qui pourrait être un bogue, essayez s'il vous plaît d'être
sûr que c'est un bogue, et non une fonctionnalité délibérée ou
interprétation erronée. Nous vous demandons de lire la section
« Rapporter des Bogues Emacs » à la fin du manuel de référence (ou via
le système Info) ; ceci afin d'obtenir des indications quant à savoir
quand et comment rapporter des bogues. Incluez s'il vous plaît
également le numéro de version de l'Emacs que vous exécutiez dans
chaque rapport de bogue que vous envoyez.
Ne vous attendez pas à une réponse personnelle pour un rapport de
bogue. L'objectif des rapports de bogues est de voir ces bogues
corrigés dans la version suivante, si cela est possible. Pour obtenir
une assistance personnelle, regardez dans le fichier SERVICE (voir plus
haut) pour obtenir une liste des personnes qui l'offrent.
N'envoyez s'il vous plaît que des rapports de bogues à cette liste de
diffusion. Pour plus d'informations sur les listes de diffusion
d'Emacs, lisez le fichier /usr/share/emacs/$VERSION/etc/MAILINGLISTS.
Les bogues ont tendance à être corrigés s'ils peuvent être isolés, et
il est donc de votre intérêt de les rapporter d'une manière telle
qu'ils puissent être facilement reproduits.
NON-RESTRICTIONS
Emacs est libre ; chacun peut redistribuer des copies d'Emacs à tout un
chacun sous les termes présentés dans la Licence Publique Générale
(GPL) d'Emacs, dont une copie accompagne chaque exemplaire d'Emacs et
apparaît également dans le manuel de référence.
Des copies d'Emacs peuvent être parfois reçues incluses dans des
distributions de systèmes Unix, mais elles ne sont jamais comprises
dans la portée de toute licence couvrant ces systèmes. Une telle
inclusion violerait les termes dans lesquels la distribution est
permise. En fait, l'objectif principal de la Licence GPL est d'empêcher
quiconque de vous imposer des restrictions supplémentaires sur la
redistribution d'Emacs.
Richard Stallman vous encourage à améliorer et à étendre Emacs, et vous
incite à contribuer par vos extensions à la librairie GNU. Au final,
GNU (Gnu's Not Unix) remplacera intégralement Unix. Chacun sera libre
d'utiliser, de copier, d'étudier et de modifier le système GNU.
VOIR AUSSI
emacsclient(1), etags(1), X(7), xlsfonts(1), xterm(1), xrdb(1)
AUTEURS
Emacs a été écrit par Richard Stallman et la Free Software Foundation.
Joachim Martillo et Robert Krawitz ont ajouté les fonctionnalités X.
COPIES
Copyright (C) 1995, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
2007, 2008 Free Software Foundation, Inc.
L'autorisation est donnée de copier, de distribuer et/ou de modifier
ce document sous les termes de la GNU Free Documentation License
version 1.3 ou toute autre version ultérieure publiée par la Free
Software Foundation. Lire le texte de la licence ici.
TRADUCTION
Frédéric Delanoy <delanoy_f at yahoo.com>, 2002.
Révision le 28 novembre 2010 par S. Lopin pour le site
www.man-linux-magique.net