Commit | Line | Data |
---|---|---|
932e8ec6 | 1 | % Reference Card for Dired -*- coding: utf-8 -*- |
0b5546d6 | 2 | |
ab422c4d | 3 | % Copyright (C) 2000-2013 Free Software Foundation, Inc. |
5e56e175 | 4 | |
0b5546d6 GM |
5 | % Author: Evgeny Roubinchtein <eroubinc@u.washington.edu> |
6 | % French translation: Eric Jacoboni | |
7 | ||
5e56e175 GM |
8 | % This file is part of GNU Emacs. |
9 | ||
b83446dd | 10 | % GNU Emacs is free software: you can redistribute it and/or modify |
5e56e175 | 11 | % it under the terms of the GNU General Public License as published by |
b83446dd GM |
12 | % the Free Software Foundation, either version 3 of the License, or |
13 | % (at your option) any later version. | |
5e56e175 GM |
14 | |
15 | % GNU Emacs is distributed in the hope that it will be useful, | |
16 | % but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | % GNU General Public License for more details. | |
19 | ||
20 | % You should have received a copy of the GNU General Public License | |
b83446dd | 21 | % along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
5e56e175 | 22 | |
0b5546d6 GM |
23 | |
24 | % See dired-ref.tex. | |
25 | ||
5e56e175 GM |
26 | %**start of header |
27 | ||
0b5546d6 GM |
28 | % This file can be printed with 1, 2, or 3 columns per page. |
29 | % Specify how many you want here. | |
5e56e175 | 30 | \newcount\columnsperpage |
5e56e175 GM |
31 | \columnsperpage=2 |
32 | ||
7ca3bc2f MC |
33 | % PDF output layout. 0 for A4, 1 for letter (US), a `l' is added for |
34 | % a landscape layout. | |
7ca3bc2f MC |
35 | \input pdflayout.sty |
36 | \pdflayout=(0) | |
37 | ||
dcf8834b | 38 | \input emacsver.tex |
0b5546d6 GM |
39 | |
40 | % Nothing else needs to be changed. | |
5e56e175 GM |
41 | |
42 | \def\shortcopyrightnotice{\vskip 1ex plus 2 fill | |
43 | \centerline{\small \copyright\ \year\ Free Software Foundation, Inc. | |
0b5546d6 | 44 | Permissions au dos.}} |
5e56e175 GM |
45 | |
46 | \def\copyrightnotice{ | |
47 | \vskip 1ex plus 2 fill\begingroup\small | |
48 | \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.} | |
0b5546d6 GM |
49 | \centerline{Pour GNU Emacs version \versionemacs} |
50 | \centerline{Conception de Stephen Gildea} | |
7616b390 | 51 | \centerline{Mis \`a jour pour Dired en Mai 2000 par Evgeny Roubinchtein} |
5e56e175 GM |
52 | \centerline{Traduction fran\c{c}aise d'\'Eric Jacoboni} |
53 | ||
54 | Vous pouvez faire et distribuer des copies de cette carte, pourvu que | |
55 | la notice de copyright et cette note de permission soient pr\'eserv\'ees | |
56 | sur toutes les copies. | |
57 | ||
0b5546d6 | 58 | Pour obtenir des copies du manuel de GNU Emacs: |
5e56e175 | 59 | |
0b5546d6 | 60 | {\tt http://www.gnu.org/software/emacs/\#Manuals} |
5e56e175 GM |
61 | \endgroup} |
62 | ||
63 | % make \bye not \outer so that the \def\bye in the \else clause below | |
64 | % can be scanned without complaint. | |
65 | \def\bye{\par\vfill\supereject\end} | |
66 | ||
67 | \newdimen\intercolumnskip %horizontal space between columns | |
68 | \newbox\columna %boxes to hold columns already built | |
69 | \newbox\columnb | |
70 | ||
71 | \def\ncolumns{\the\columnsperpage} | |
72 | ||
177c0ea7 | 73 | \message{[\ncolumns\space |
5e56e175 GM |
74 | column\if 1\ncolumns\else s\fi\space per page]} |
75 | ||
76 | \def\scaledmag#1{ scaled \magstep #1} | |
77 | ||
78 | % This multi-way format was designed by Stephen Gildea October 1986. | |
79 | % Note that the 1-column format is fontfamily-independent. | |
80 | \if 1\ncolumns %one-column format uses normal size | |
81 | \hsize 4in | |
82 | \vsize 10in | |
83 | \voffset -.7in | |
84 | \font\titlefont=\fontname\tenbf \scaledmag3 | |
85 | \font\headingfont=\fontname\tenbf \scaledmag2 | |
86 | \font\smallfont=\fontname\sevenrm | |
87 | \font\smallsy=\fontname\sevensy | |
88 | ||
89 | \footline{\hss\folio} | |
90 | \def\makefootline{\baselineskip10pt\hsize6.5in\line{\the\footline}} | |
91 | \else %2 or 3 columns uses prereduced size | |
92 | \hsize 3.4in | |
01108fab | 93 | \vsize 10in |
5e56e175 GM |
94 | \hoffset -.75in |
95 | \voffset -.745in | |
96 | \font\titlefont=cmbx10 \scaledmag2 | |
97 | \font\headingfont=cmbx10 \scaledmag1 | |
98 | \font\smallfont=cmr6 | |
99 | \font\smallsy=cmsy6 | |
100 | \font\eightrm=cmr8 | |
101 | \font\eightbf=cmbx8 | |
102 | \font\eightit=cmti8 | |
103 | \font\eighttt=cmtt8 | |
104 | \font\eightmi=cmmi8 | |
105 | \font\eightsy=cmsy8 | |
106 | \textfont0=\eightrm | |
107 | \textfont1=\eightmi | |
108 | \textfont2=\eightsy | |
109 | \def\rm{\eightrm} | |
110 | \def\bf{\eightbf} | |
111 | \def\it{\eightit} | |
112 | \def\tt{\eighttt} | |
113 | \normalbaselineskip=.8\normalbaselineskip | |
114 | \normallineskip=.8\normallineskip | |
115 | \normallineskiplimit=.8\normallineskiplimit | |
116 | \normalbaselines\rm %make definitions take effect | |
117 | ||
118 | \if 2\ncolumns | |
119 | \let\maxcolumn=b | |
120 | \footline{\hss\rm\folio\hss} | |
121 | \def\makefootline{\vskip 2in \hsize=6.86in\line{\the\footline}} | |
122 | \else \if 3\ncolumns | |
123 | \let\maxcolumn=c | |
124 | \nopagenumbers | |
125 | \else | |
126 | \errhelp{You must set \columnsperpage equal to 1, 2, or 3.} | |
127 | \errmessage{Illegal number of columns per page} | |
128 | \fi\fi | |
129 | ||
130 | \intercolumnskip=.46in | |
131 | \def\abc{a} | |
132 | \output={% %see The TeXbook page 257 | |
133 | % This next line is useful when designing the layout. | |
134 | %\immediate\write16{Column \folio\abc\space starts with \firstmark} | |
135 | \if \maxcolumn\abc \multicolumnformat \global\def\abc{a} | |
136 | \else\if a\abc | |
137 | \global\setbox\columna\columnbox \global\def\abc{b} | |
138 | %% in case we never use \columnb (two-column mode) | |
139 | \global\setbox\columnb\hbox to -\intercolumnskip{} | |
140 | \else | |
141 | \global\setbox\columnb\columnbox \global\def\abc{c}\fi\fi} | |
142 | \def\multicolumnformat{\shipout\vbox{\makeheadline | |
143 | \hbox{\box\columna\hskip\intercolumnskip | |
144 | \box\columnb\hskip\intercolumnskip\columnbox} | |
145 | \makefootline}\advancepageno} | |
146 | \def\columnbox{\leftline{\pagebody}} | |
147 | ||
148 | \def\bye{\par\vfill\supereject | |
149 | \if a\abc \else\null\vfill\eject\fi | |
150 | \if a\abc \else\null\vfill\eject\fi | |
177c0ea7 | 151 | \end} |
5e56e175 GM |
152 | \fi |
153 | ||
154 | % we won't be using math mode much, so redefine some of the characters | |
155 | % we might want to talk about | |
156 | \catcode`\^=12 | |
157 | \catcode`\_=12 | |
158 | ||
159 | \chardef\\=`\\ | |
160 | \chardef\{=`\{ | |
161 | \chardef\}=`\} | |
162 | ||
163 | \hyphenation{mini-buf-fer} | |
164 | \hyphenation{de-le-tion} | |
165 | ||
166 | \parindent 0pt | |
167 | \parskip 1ex plus .5ex minus .5ex | |
168 | ||
169 | \def\small{\smallfont\textfont2=\smallsy\baselineskip=.8\baselineskip} | |
170 | ||
171 | % newcolumn - force a new column. Use sparingly, probably only for | |
172 | % the first column of a page, which should have a title anyway. | |
173 | \outer\def\newcolumn{\vfill\eject} | |
174 | ||
175 | % title - page title. Argument is title text. | |
176 | \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus .5ex} | |
177 | ||
178 | % section - new major section. Argument is section name. | |
179 | \outer\def\section#1{\par\filbreak | |
180 | \vskip 3ex plus 2ex minus 2ex {\headingfont #1}\mark{#1}% | |
181 | \vskip 2ex plus 1ex minus 1.5ex} | |
182 | ||
183 | \newdimen\keyindent | |
184 | ||
185 | % beginindentedkeys...endindentedkeys - key definitions will be | |
186 | % indented, but running text, typically used as headings to group | |
187 | % definitions, will not. | |
188 | \def\beginindentedkeys{\keyindent=1em} | |
189 | \def\endindentedkeys{\keyindent=0em} | |
190 | \endindentedkeys | |
191 | ||
192 | % paralign - begin paragraph containing an alignment. | |
193 | % If an \halign is entered while in vertical mode, a parskip is never | |
194 | % inserted. Using \paralign instead of \halign solves this problem. | |
195 | \def\paralign{\vskip\parskip\halign} | |
196 | ||
197 | % \<...> - surrounds a variable name in a code example | |
198 | \def\<#1>{{\it #1\/}} | |
199 | ||
200 | % kbd - argument is characters typed literally. Like the Texinfo command. | |
201 | \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows | |
202 | ||
203 | % beginexample...endexample - surrounds literal text, such a code example. | |
204 | % typeset in a typewriter font with line breaks preserved | |
205 | \def\beginexample{\par\leavevmode\begingroup | |
206 | \obeylines\obeyspaces\parskip0pt\tt} | |
207 | {\obeyspaces\global\let =\ } | |
208 | \def\endexample{\endgroup} | |
209 | ||
210 | % key - definition of a key. | |
211 | % \key{description of key}{key-name} | |
212 | % prints the description left-justified, and the key-name in a \kbd | |
213 | % form near the right margin. | |
01108fab | 214 | % First hfill tweaked from 0.75 to 0.8 to allow for longer descriptions. |
5e56e175 | 215 | \def\key#1#2{\leavevmode\hbox to \hsize{\vtop |
01108fab | 216 | {\hsize=.8\hsize\rightskip=1em |
5e56e175 GM |
217 | \hskip\keyindent\relax#1}\kbd{#2}\hfil}} |
218 | ||
219 | \newbox\metaxbox | |
220 | \setbox\metaxbox\hbox{\kbd{M-x }} | |
221 | \newdimen\metaxwidth | |
222 | \metaxwidth=\wd\metaxbox | |
223 | ||
224 | % metax - definition of a M-x command. | |
225 | % \metax{description of command}{M-x command-name} | |
226 | % Tries to justify the beginning of the command name at the same place | |
227 | % as \key starts the key name. (The "M-x " sticks out to the left.) | |
228 | \def\metax#1#2{\leavevmode\hbox to \hsize{\hbox to .75\hsize | |
229 | {\hskip\keyindent\relax#1\hfil}% | |
230 | \hskip -\metaxwidth minus 1fil | |
231 | \kbd{#2}\hfil}} | |
232 | ||
233 | % threecol - like "key" but with two key names. | |
234 | % for example, one for doing the action backward, and one for forward. | |
235 | \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&\kbd{#2}\hfil\quad | |
236 | &\kbd{#3}\hfil\quad\cr} | |
237 | ||
238 | % I cannot figure out how to make all dired-x | |
239 | % commands fit on a page in two-column format | |
240 | \def\dx{\bf (DX)} | |
241 | ||
01108fab GM |
242 | % Set to non-zero to check for layout problems. |
243 | \overfullrule 0pt | |
244 | \nopagenumbers | |
245 | ||
5e56e175 GM |
246 | %**end of header |
247 | \f | |
248 | ||
249 | \title{Carte de r\'ef\'erence de Dired} | |
250 | ||
0b5546d6 | 251 | \centerline{(bas\'e sur Dired de GNU Emacs \versionemacs)} |
5e56e175 GM |
252 | \centerline{Les commandes marqu\'ees par \dx{} n\'ecessitent dired-x} |
253 | ||
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'). | |
258 | ||
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 | |
177c0ea7 | 262 | % appliquer des commandes |
932e8ec6 | 263 | % shell ou ins\'erer des sous-r\'epertoires. Vous pouvez « marquer » des |
5e56e175 GM |
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). | |
177c0ea7 | 269 | |
5e56e175 GM |
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. | |
177c0ea7 | 273 | |
5e56e175 GM |
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. | |
177c0ea7 | 283 | |
5e56e175 GM |
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. | |
287 | ||
288 | \section{Lancer et sortir de Dired} | |
289 | ||
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} | |
292 | ||
293 | \section{Commandes de d\'eplacement} | |
294 | ||
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} | |
305 | ||
306 | \section{Commandes avec la souris} | |
307 | \metax{visiter le fichier}{Mouse_Button_2} | |
177c0ea7 | 308 | \metax{ouvrir un menu}{Control-Mouse_Button_3} |
5e56e175 GM |
309 | |
310 | \section{Actions immediates sur les fichiers} | |
311 | ||
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} | |
c2c847d2 GM |
315 | %%\key{visiter le fichier courant dans un autre cadre}{w} |
316 | %%\key{afficher le fichier courant}{C-u o} | |
5e56e175 GM |
317 | \key{cr\'eer un nouveau sous-r\'epertoire}{+} |
318 | \key{comparer le fichier sous le point avec celui sous la marque}{=} | |
319 | ||
320 | \section{Marquer et \^oter les marques des fichiers} | |
321 | ||
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} | |
335 | ||
01108fab | 336 | \section{Modifier le tampon Dired} |
5e56e175 | 337 | |
01108fab GM |
338 | \key{ins\'erer un sous-r\'epertoire dans ce tampon}{i} |
339 | \key{supprimer les fichiers marqu\'es de la liste}{k} | |
340 | \key{supprimer le listing d'un sous-r\'epertoire}{C-u k} | |
341 | \key{relire tous les r\'epertoires (conserve toutes les marques)}{g} | |
342 | \key{bascule le tri sur le nom/date du r\'epertoire courant}{s} | |
343 | \key{\'edite les options de ls }{C-u s} | |
344 | \key{r\'ecup\`ere les marques, les lignes cach\'ees, etc.}{C-_} | |
345 | \key{cache tous les sous-r\'epertoires}{M-\$} | |
346 | \key{cache ou fait appara\^\i{}tre le sous-r\'epertoire}{\$} | |
5e56e175 GM |
347 | |
348 | \section{Commandes sur les fichiers marqu\'es ou sp\'ecifi\'es par le pr\'efixe} | |
349 | ||
350 | \key{copier le(s) fichier(s)}{C} | |
351 | \key{renommer un fichier ou d\'eplacer des fichiers dans un autre r\'epertoire}{R} | |
352 | \key{changer le propri\'etaire d'un (des) fichier(s)}{O} | |
353 | \key{changer le groupe d'un (des) fichier(s)}{G} | |
354 | \key{changer le mode d'un (des) fichier(s)}{M} | |
355 | \key{imprimer le(s) fichier(s)}{P} | |
356 | \key{convertir le(s) nom(s) de fichier(s) en minuscules}{\% l} | |
357 | \key{convertir le(s) nom(s) de fichier(s) en majuscules}{\% u} | |
c2c847d2 GM |
358 | \key{supprimer les fichiers marqu\'es (pas ceux ayant un `flag')}{D} |
359 | %%\key{uuencoder ou uudecoder le(s) fichier(s)}{U} | |
5e56e175 GM |
360 | \key{compresser ou d\'ecompacter le(s) fichier(s)}{Z} |
361 | \key{lancer info sur le fichier}{I\dx} | |
362 | \key{cr\'eer un (des) lien(s) symbolique(s)}{S} | |
363 | \key{cr\'eer des liens symboliques relatifs}{Y} | |
364 | \key{cr\'eer un (des) liens physique(s)}{H} | |
365 | \key{rechercher une expression rationnelle dans des fichiers}{A} | |
366 | \key{remplacer interactivement une expression rationnelle}{Q} | |
367 | \key{byte-compiler des fichiers}{B} | |
368 | \key{charger le(s) fichier(s)}{L} | |
369 | \key{lancer une commande shell sur le(s) fichier(s)}{!} | |
370 | ||
371 | \section{Mettre un flag sur les fichiers \`a d\'etruire} | |
01108fab GM |
372 | %% Hack for overfull line. Proper fix? |
373 | \leftline{\bf Les commandes qui \^otent les marquent suppriment les} | |
374 | \leftline{\bf flags de suppression} | |
5e56e175 | 375 | \key{placer un flag de suppression sur le fichier}{d} |
c2c847d2 | 376 | %%\key{sauvegarder et supprimer le flag de suppression}{delete} |
5e56e175 GM |
377 | \key{placer un flag sur tous les fichiers de sauvegarde (dont les noms |
378 | se terminent par \~{})}{\~{}} | |
379 | \key{placer un flag sur tous les fichiers de sauvegarde automatique}{\#} | |
c2c847d2 | 380 | \key{placer un flag sur les diff\'erents fichiers interm\'ediaires}{\% \&} |
5e56e175 | 381 | \key{placer un flag sur les sauvegardes num\'erot\'ees (finissant par |
177c0ea7 | 382 | .\~{}1\~{}, .\~{}2\~{}, etc.)}{.} |
5e56e175 GM |
383 | \key{ex\'ecuter les suppressions demand\'ees (fichiers ayant un flag)}{x} |
384 | \key{placer un flag sur les fichiers correspondant \`a une expression | |
177c0ea7 | 385 | rationnelle }{\% d} |
5e56e175 | 386 | |
5e56e175 GM |
387 | \section{Commandes sur les expressions rationnelles} |
388 | ||
389 | \key{marquer les noms de fichiers correspondant \`a une expression | |
177c0ea7 | 390 | rationnelle}{\% m} |
5e56e175 GM |
391 | \key{copier les fichiers marqu\'es par une expression rationnelle}{\% C} |
392 | \key{renommer les fichiers marqu\'es par une expression rationnelle}{\% R} | |
393 | \key{lien physique}{\% H} | |
394 | \key{lien symbolique}{\% S} | |
395 | \key{lien symbolique avec chemin relatif}{\% Y} | |
396 | \key{marquer pour une suppression}{\% d} | |
397 | ||
398 | \section{Dired et Find} | |
01108fab GM |
399 | %% Hack for overfull line (should be \metax). Proper fix? |
400 | \key{fichier(s) dired dont le nom correspond \`a un motif}{M-x | |
177c0ea7 | 401 | find-names-dired} |
5e56e175 GM |
402 | \metax{fichier(s) dired contenant un motif}{M-x find-grep-dired} |
403 | \metax{fichier(s) dired bas\'es sur ce que produit \kbd{find}}{M-x find-dired} | |
404 | ||
01108fab GM |
405 | \section{Obtenir de l'aide} |
406 | ||
407 | \key{aide sur dired}{h} | |
408 | \key{r\'esum\'e de dired (aide succinte) et trace d'erreur}{?} | |
409 | ||
5e56e175 GM |
410 | \copyrightnotice |
411 | ||
412 | \bye |