(latexenc-find-file-coding-system): Don't inherit the EOL part of the
[emacs.git] / etc / fr-drdref.tex
blob922ce65f622049a4bb4359700755c6b7a02b5fa0
2 % Reference Card for Dired
3 % Copyright (C) 2000 Free Software Foundation, Inc.
5 % This file is part of GNU Emacs.
7 % GNU Emacs is free software; you can redistribute it and/or modify
8 % it under the terms of the GNU General Public License as published by
9 % the Free Software Foundation; either version 2, or (at your option)
10 % any later version.
12 % GNU Emacs is distributed in the hope that it will be useful,
13 % but WITHOUT ANY WARRANTY; without even the implied warranty of
14 % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 % GNU General Public License for more details.
17 % You should have received a copy of the GNU General Public License
18 % along with GNU Emacs; see the file COPYING. If not, write to
19 % the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 % Boston, MA 02111-1307, USA.
22 % This file can be printed with 1, 2, or 3 columns per page (see below).
23 % Specify how many you want here. Nothing else needs to be changed.
24 %**start of header
26 \newcount\columnsperpage
28 \columnsperpage=2
30 % This file is intended to be processed by plain TeX (TeX82).
31 % The reference card looks OK with 2 columns per page, portrait mode.
32 % I haven't tried it with 3 columns per page.
34 % This is a bit of a dirty hack on the GNU Emacs reference card
35 % to produce a Dired reference card instead.
37 % I (Evgeny Roubinchtein, eroubinc@u.washington.edu) put this together
38 % because I wanted a Dired reference card,
39 % but couldn't find anything on the 'net.
40 % Based mostly off Dired's describe-mode.
43 \def\versionnumber{0.1}
44 \def\year{2000}
45 \def\version{Mai \year\ v\versionnumber}
47 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
48 \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
49 Permissions au dos. v\versionnumber}}
51 \def\copyrightnotice{
52 \vskip 1ex plus 2 fill\begingroup\small
53 \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
54 \centerline{conception de Stephen Gildea, \version}
55 \centerline{pour GNU Emacs version 19 sur syst\`emes Unix}
56 \centerline{Mis \`a jour pour Dired en Mai 200 par Evgeny Roubinchtein}
57 \centerline{Traduction fran\c{c}aise d'\'Eric Jacoboni}
59 Vous pouvez faire et distribuer des copies de cette carte, pourvu que
60 la notice de copyright et cette note de permission soient pr\'eserv\'ees
61 sur toutes les copies.
63 Pour obtenir des copies du manuel de GNU Emacs, \'ecrivez \`a la Free Software
64 Foundation, Inc., 675 Massachusetts Ave, Cambridge MA 02139.
66 \endgroup}
68 % make \bye not \outer so that the \def\bye in the \else clause below
69 % can be scanned without complaint.
70 \def\bye{\par\vfill\supereject\end}
72 \newdimen\intercolumnskip %horizontal space between columns
73 \newbox\columna %boxes to hold columns already built
74 \newbox\columnb
76 \def\ncolumns{\the\columnsperpage}
78 \message{[\ncolumns\space
79 column\if 1\ncolumns\else s\fi\space per page]}
81 \def\scaledmag#1{ scaled \magstep #1}
83 % This multi-way format was designed by Stephen Gildea October 1986.
84 % Note that the 1-column format is fontfamily-independent.
85 \if 1\ncolumns %one-column format uses normal size
86 \hsize 4in
87 \vsize 10in
88 \voffset -.7in
89 \font\titlefont=\fontname\tenbf \scaledmag3
90 \font\headingfont=\fontname\tenbf \scaledmag2
91 \font\smallfont=\fontname\sevenrm
92 \font\smallsy=\fontname\sevensy
94 \footline{\hss\folio}
95 \def\makefootline{\baselineskip10pt\hsize6.5in\line{\the\footline}}
96 \else %2 or 3 columns uses prereduced size
97 \hsize 3.4in
98 \vsize 7.95in
99 \hoffset -.75in
100 \voffset -.745in
101 \font\titlefont=cmbx10 \scaledmag2
102 \font\headingfont=cmbx10 \scaledmag1
103 \font\smallfont=cmr6
104 \font\smallsy=cmsy6
105 \font\eightrm=cmr8
106 \font\eightbf=cmbx8
107 \font\eightit=cmti8
108 \font\eighttt=cmtt8
109 \font\eightmi=cmmi8
110 \font\eightsy=cmsy8
111 \textfont0=\eightrm
112 \textfont1=\eightmi
113 \textfont2=\eightsy
114 \def\rm{\eightrm}
115 \def\bf{\eightbf}
116 \def\it{\eightit}
117 \def\tt{\eighttt}
118 \normalbaselineskip=.8\normalbaselineskip
119 \normallineskip=.8\normallineskip
120 \normallineskiplimit=.8\normallineskiplimit
121 \normalbaselines\rm %make definitions take effect
123 \if 2\ncolumns
124 \let\maxcolumn=b
125 \footline{\hss\rm\folio\hss}
126 \def\makefootline{\vskip 2in \hsize=6.86in\line{\the\footline}}
127 \else \if 3\ncolumns
128 \let\maxcolumn=c
129 \nopagenumbers
130 \else
131 \errhelp{You must set \columnsperpage equal to 1, 2, or 3.}
132 \errmessage{Illegal number of columns per page}
133 \fi\fi
135 \intercolumnskip=.46in
136 \def\abc{a}
137 \output={% %see The TeXbook page 257
138 % This next line is useful when designing the layout.
139 %\immediate\write16{Column \folio\abc\space starts with \firstmark}
140 \if \maxcolumn\abc \multicolumnformat \global\def\abc{a}
141 \else\if a\abc
142 \global\setbox\columna\columnbox \global\def\abc{b}
143 %% in case we never use \columnb (two-column mode)
144 \global\setbox\columnb\hbox to -\intercolumnskip{}
145 \else
146 \global\setbox\columnb\columnbox \global\def\abc{c}\fi\fi}
147 \def\multicolumnformat{\shipout\vbox{\makeheadline
148 \hbox{\box\columna\hskip\intercolumnskip
149 \box\columnb\hskip\intercolumnskip\columnbox}
150 \makefootline}\advancepageno}
151 \def\columnbox{\leftline{\pagebody}}
153 \def\bye{\par\vfill\supereject
154 \if a\abc \else\null\vfill\eject\fi
155 \if a\abc \else\null\vfill\eject\fi
156 \end}
159 % we won't be using math mode much, so redefine some of the characters
160 % we might want to talk about
161 \catcode`\^=12
162 \catcode`\_=12
164 \chardef\\=`\\
165 \chardef\{=`\{
166 \chardef\}=`\}
168 \hyphenation{mini-buf-fer}
169 \hyphenation{de-le-tion}
171 \parindent 0pt
172 \parskip 1ex plus .5ex minus .5ex
174 \def\small{\smallfont\textfont2=\smallsy\baselineskip=.8\baselineskip}
176 % newcolumn - force a new column. Use sparingly, probably only for
177 % the first column of a page, which should have a title anyway.
178 \outer\def\newcolumn{\vfill\eject}
180 % title - page title. Argument is title text.
181 \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus .5ex}
183 % section - new major section. Argument is section name.
184 \outer\def\section#1{\par\filbreak
185 \vskip 3ex plus 2ex minus 2ex {\headingfont #1}\mark{#1}%
186 \vskip 2ex plus 1ex minus 1.5ex}
188 \newdimen\keyindent
190 % beginindentedkeys...endindentedkeys - key definitions will be
191 % indented, but running text, typically used as headings to group
192 % definitions, will not.
193 \def\beginindentedkeys{\keyindent=1em}
194 \def\endindentedkeys{\keyindent=0em}
195 \endindentedkeys
197 % paralign - begin paragraph containing an alignment.
198 % If an \halign is entered while in vertical mode, a parskip is never
199 % inserted. Using \paralign instead of \halign solves this problem.
200 \def\paralign{\vskip\parskip\halign}
202 % \<...> - surrounds a variable name in a code example
203 \def\<#1>{{\it #1\/}}
205 % kbd - argument is characters typed literally. Like the Texinfo command.
206 \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows
208 % beginexample...endexample - surrounds literal text, such a code example.
209 % typeset in a typewriter font with line breaks preserved
210 \def\beginexample{\par\leavevmode\begingroup
211 \obeylines\obeyspaces\parskip0pt\tt}
212 {\obeyspaces\global\let =\ }
213 \def\endexample{\endgroup}
215 % key - definition of a key.
216 % \key{description of key}{key-name}
217 % prints the description left-justified, and the key-name in a \kbd
218 % form near the right margin.
219 \def\key#1#2{\leavevmode\hbox to \hsize{\vtop
220 {\hsize=.75\hsize\rightskip=1em
221 \hskip\keyindent\relax#1}\kbd{#2}\hfil}}
223 \newbox\metaxbox
224 \setbox\metaxbox\hbox{\kbd{M-x }}
225 \newdimen\metaxwidth
226 \metaxwidth=\wd\metaxbox
228 % metax - definition of a M-x command.
229 % \metax{description of command}{M-x command-name}
230 % Tries to justify the beginning of the command name at the same place
231 % as \key starts the key name. (The "M-x " sticks out to the left.)
232 \def\metax#1#2{\leavevmode\hbox to \hsize{\hbox to .75\hsize
233 {\hskip\keyindent\relax#1\hfil}%
234 \hskip -\metaxwidth minus 1fil
235 \kbd{#2}\hfil}}
237 % threecol - like "key" but with two key names.
238 % for example, one for doing the action backward, and one for forward.
239 \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&\kbd{#2}\hfil\quad
240 &\kbd{#3}\hfil\quad\cr}
242 % I cannot figure out how to make all dired-x
243 % commands fit on a page in two-column format
244 \def\dx{\bf (DX)}
246 %**end of header
249 \title{Carte de r\'ef\'erence de Dired}
251 \centerline{(bas\'e sur Dired de GNU Emacs 21.x)}
252 \centerline{Les commandes marqu\'ees par \dx{} n\'ecessitent dired-x}
254 % trim this down to fit everything on one page
255 % \section{G\'en\'eral}
256 % Avec dired, vous pouvez \'editer la liste des fichiers d'un r\'epertoire
257 % (et, \'eventuellement, ses r\'epertoires au format 'ls -lR').
259 % L'\'edition d'un r\'epertoire signifie que vous pouvez visiter,
260 % renommer, copier, compresser, compiler des fichiers. Dans le tampon
261 % d'\'edition, vous pouvez modifier les attributs des fichiers, leur
262 % appliquer des commandes
263 % shell ou ins\'erer des sous-r\'epertoires. Vous pouvez « marquer » des
264 % fichiers pour qu'ils soient supprim\'es plus tard ou pour leur
265 % appliquer des commandes ; cela peut \^etre fait pour un seul fichier \`a
266 % la fois ou pour un ensemble de fichiers correspondant \`a certains
267 % crit\`eres (fichiers correspondant \`a une expression rationnelle
268 % donn\'ee, par exemple).
270 % On se d\'eplace dans le tampon \`a l'aide des commandes habituelles de
271 % d\'eplacement du curseur. Les lettres ne s'ins\`erent plus mais servent
272 % \`a ex\'ecuter des commandes, les chiffres (0-9) sont des param\`etres pr\'efixes.
274 % La plupart des commandes agissent soit sur tous les fichiers marqu\'es,
275 % soit sur le fichier courant s'il n'y a pas de fichier marqu\'e. On
276 % utilise un param\`etre pr\'efixe pour agir sur les NUM fichiers suivants
277 % (ou les NUM pr\'ec\'edents si NUM $<$ 0). Le param\`etre pr\'efixe '1' sert
278 % \`a op\'erer sur le fichier courant uniquement. Les param\`etres pr\'efixes
279 % ont priorit\'e sur les marques. Les commandes lan\c{c}ant un
280 % sous-processus sur un groupe de fichiers afficheront une liste des
281 % fichiers pour lesquels le sous-processus a \'echou\'e. Taper y tentera
282 % de vous expliquer ce qui a pos\'e probl\`eme.
284 % Lorsque l'on \'edite plusieurs fichiers dans un unique tampon, chaque
285 % r\'epertoire agit comme une page : C-x [ et C-x ] peuvent donc servir
286 % \`a se d\'eplacer dans ces r\'epertoires.
288 \section{Lancer et sortir de Dired}
290 \key{lancer dired}{C-x d} \key{\'edite le r\'epertoire du fichier que l'on
291 est en train d'\'editer}{C-x C-j\dx} \key{quitter dired}{q}
293 \section{Commandes de d\'eplacement}
295 \key{ligne pr\'ec\'edente}{p}
296 \key{ligne suivante}{n}
297 \key{ligne de r\'epertoire pr\'ec\'edente}{<}
298 \key{ligne de r\'epertoire suivante}{>}
299 \key{fichier marqu\'e suivant}{M-\}}
300 \key{fichier marqu\'e pr\'ec\'edent}{M-\{}
301 \key{sous-r\'epertoire pr\'ec\'edent}{M-C-p}
302 \key{sous-r\'epertoire suivant}{M-C-n}
303 \key{r\'epertoire p\`ere}{^}
304 \key{premier sous-r\'epertoire}{M-C-d}
306 \section{Commandes avec la souris}
307 \metax{visiter le fichier}{Mouse_Button_2}
308 \metax{ouvrir un menu}{Control-Mouse_Button_3}
310 \section{Actions immediates sur les fichiers}
312 \key{visiter le fichier courant}{f}
313 \key{visualiser le fichier courant}{v}
314 \key{visiter le fichier courant dans une autre fen\^etre}{o}
315 \key{visiter le fichier courant dans un autre cadre}{w}
316 \key{afficher le fichier courant}{C-u o}
317 \key{cr\'eer un nouveau sous-r\'epertoire}{+}
318 \key{comparer le fichier sous le point avec celui sous la marque}{=}
320 \section{Marquer et \^oter les marques des fichiers}
322 \key{marquer un fichier ou un sous-r\'epertoire pour de futures commandes}{m}
323 \key{\^oter la marque d'un fichier ou de tous les fichiers d'un sous-r\'epertoire}{u}
324 \key{\^oter la marque de tous les fichiers d'un tampon}{M-delete}
325 \key{marquer les fichiers ayant une extension donn\'ee}{* .}
326 \key{marquer tous les sous-r\'epertoires}{* /}
327 \key{marquer tous les liens symboliques}{* @}
328 \key{marquer tous les ex\'ecutables}{* *}
329 \key{inverser le marquage}{* t}
330 \key{marquer tous les fichiers du sous-r\'epertoire courant}{* s}
331 \key{marquer les fichiers dont les noms correspondent \`a une expression
332 rationnelle}{* \%}
333 \key{modifier les marques par un caract\`ere diff\'erent}{* c}
334 \key{marquer les fichiers pour lesquels une expression Elisp renvoie t}{* (\dx}
336 \section{Obtenir de l'aide}
338 \key{aide sur dired}{h}
339 \key{r\'esum\'e de dired (aide succinte) et trace d'erreur}{?}
341 \section{Commandes sur les fichiers marqu\'es ou sp\'ecifi\'es par le pr\'efixe}
343 \key{copier le(s) fichier(s)}{C}
344 \key{renommer un fichier ou d\'eplacer des fichiers dans un autre r\'epertoire}{R}
345 \key{changer le propri\'etaire d'un (des) fichier(s)}{O}
346 \key{changer le groupe d'un (des) fichier(s)}{G}
347 \key{changer le mode d'un (des) fichier(s)}{M}
348 \key{imprimer le(s) fichier(s)}{P}
349 \key{convertir le(s) nom(s) de fichier(s) en minuscules}{\% l}
350 \key{convertir le(s) nom(s) de fichier(s) en majuscules}{\% u}
351 \key{supprimer les fichiers marqu\'es (pas ceux ayant un `flag')}{X}
352 \key{uuencoder ou uudecoder le(s) fichier(s)}{U}
353 \key{compresser ou d\'ecompacter le(s) fichier(s)}{Z}
354 \key{lancer info sur le fichier}{I\dx}
355 \key{cr\'eer un (des) lien(s) symbolique(s)}{S}
356 \key{cr\'eer des liens symboliques relatifs}{Y}
357 \key{cr\'eer un (des) liens physique(s)}{H}
358 \key{rechercher une expression rationnelle dans des fichiers}{A}
359 \key{remplacer interactivement une expression rationnelle}{Q}
360 \key{byte-compiler des fichiers}{B}
361 \key{charger le(s) fichier(s)}{L}
362 \key{lancer une commande shell sur le(s) fichier(s)}{!}
364 \section{Mettre un flag sur les fichiers \`a d\'etruire}
365 \leftline{\bf Les commandes qui \^otent les marquent suppriment les
366 flags de suppression}
367 \key{placer un flag de suppression sur le fichier}{d}
368 \key{sauvegarder et supprimer le flag de suppression}{delete}
369 \key{placer un flag sur tous les fichiers de sauvegarde (dont les noms
370 se terminent par \~{})}{\~{}}
371 \key{placer un flag sur tous les fichiers de sauvegarde automatique}{\#}
372 \key{placer un flag sur les diff\'erents fichiers interm\'ediaires}{\&}
373 \key{placer un flag sur les sauvegardes num\'erot\'ees (finissant par
374 .\~{}1\~{}, .\~{}2\~{}, etc.)}{.}
375 \key{ex\'ecuter les suppressions demand\'ees (fichiers ayant un flag)}{x}
376 \key{placer un flag sur les fichiers correspondant \`a une expression
377 rationnelle }{\% d}
379 \section{Modifier le tampon Dired}
381 \key{ins\'erer un sous-r\'epertoire dans ce tampon}{i}
382 \key{supprimer les fichiers marqu\'es de la liste}{k}
383 \key{supprimer le listing d'un sous-r\'epertoire}{C-u k}
384 \key{relire tous les r\'epertoires (conserve toutes les marques)}{g}
385 \key{bascule le tri sur le nom/date du r\'epertoire courant}{s}
386 \key{\'edite les options de ls }{C-u s}
387 \key{r\'ecup\`ere les marques, les lignes cach\'ees, etc.}{C-_}
388 \key{cache tous les sous-r\'epertoires}{M-\$}
389 \key{cache ou fait appara\^\i{}tre le sous-r\'epertoire}{\$}
391 \section{Commandes sur les expressions rationnelles}
393 \key{marquer les noms de fichiers correspondant \`a une expression
394 rationnelle}{\% m}
395 \key{copier les fichiers marqu\'es par une expression rationnelle}{\% C}
396 \key{renommer les fichiers marqu\'es par une expression rationnelle}{\% R}
397 \key{lien physique}{\% H}
398 \key{lien symbolique}{\% S}
399 \key{lien symbolique avec chemin relatif}{\% Y}
400 \key{marquer pour une suppression}{\% d}
402 \section{Dired et Find}
403 \metax{fichier(s) dired dont le nom correspond \`a un motif}{M-x
404 find-names-dired}
405 \metax{fichier(s) dired contenant un motif}{M-x find-grep-dired}
406 \metax{fichier(s) dired bas\'es sur ce que produit \kbd{find}}{M-x find-dired}
408 \copyrightnotice
410 \bye
412 % arch-tag: ffe6a489-24a2-4083-b8c3-5d03b621689d