1 % Reference Card for Dired
3 % Copyright (C) 2000-2016 Free Software Foundation, Inc.
5 % Author: Evgeny Roubinchtein <eroubinc@u.washington.edu>
7 % This document 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 3 of the License, or
10 % (at your option) any later version.
12 % As a special additional permission, you may distribute reference cards
13 % printed, or formatted for printing, with the notice "Released under
14 % the terms of the GNU General Public License version 3 or later"
15 % instead of the usual distributed-under-the-GNU-GPL notice, and without
16 % a copy of the GPL itself.
18 % This document is distributed in the hope that it will be useful,
19 % but WITHOUT ANY WARRANTY; without even the implied warranty of
20 % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 % GNU General Public License for more details.
23 % You should have received a copy of the GNU General Public License
24 % along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
27 % This file is intended to be processed by plain TeX (TeX82).
29 % This is a bit of a dirty hack on the GNU Emacs reference card
30 % to produce a Dired reference card instead.
32 % I put this together because I wanted a Dired reference card, but
33 % couldn't find anything on the 'net. Based mostly off Dired's
37 \newcount\columnsperpage
39 % This file can be printed with 1, 2, or 3 columns per page.
40 % Specify how many you want here.
41 % The reference card looks OK with 2 columns per page, portrait mode.
42 % I haven't tried it with 3 columns per page.
45 % PDF output layout. 0 for A4, 1 for letter (US), a `l' is added for
52 % Nothing else needs to be changed.
54 \def\shortcopyrightnotice{\vskip 1ex plus
2 fill
55 \centerline{\small \copyright\
\year\ Free Software Foundation, Inc.
56 Permissions on back.
}}
59 \vskip 1ex plus
2 fill
\begingroup\small
60 \centerline{Copyright
\copyright\
\year\ Free Software Foundation, Inc.
}
61 \centerline{For GNU Emacs version
\versionemacs}
62 \centerline{Originally written May
2000 by Evgeny Roubinchtein,
}
63 \centerline{using refcard layout designed by Stephen Gildea.
}
65 Released under the terms of the GNU General Public License version
3 or later.
67 For copies of the GNU Emacs manual, see:
69 {\tt http://www.gnu.org/software/emacs/\#Manuals
}
72 % make \bye not \outer so that the \def\bye in the \else clause below
73 % can be scanned without complaint.
74 \def\bye{\par\vfill\supereject\end}
76 \newdimen\intercolumnskip %horizontal space between columns
77 \newbox\columna %boxes to hold columns already built
80 \def\ncolumns{\the\columnsperpage}
82 \message{[\ncolumns\space
83 column
\if 1\ncolumns\else s
\fi\space per page
]}
85 \def\scaledmag#1{ scaled
\magstep #1}
87 % This multi-way format was designed by Stephen Gildea October 1986.
88 % Note that the 1-column format is fontfamily-independent.
89 \if 1\ncolumns %one-column format uses normal size
93 \font\titlefont=
\fontname\tenbf \scaledmag3
94 \font\headingfont=
\fontname\tenbf \scaledmag2
95 \font\smallfont=
\fontname\sevenrm
96 \font\smallsy=
\fontname\sevensy
99 \def\makefootline{\baselineskip10pt\hsize6.5in
\line{\the\footline}}
100 \else %2 or 3 columns uses prereduced size
105 \font\titlefont=cmbx10
\scaledmag2
106 \font\headingfont=cmbx10
\scaledmag1
122 \normalbaselineskip=
.8\normalbaselineskip
123 \normallineskip=
.8\normallineskip
124 \normallineskiplimit=
.8\normallineskiplimit
125 \normalbaselines\rm %make definitions take effect
129 \footline{\hss\rm\folio\hss}
130 \def\makefootline{\vskip 2in
\hsize=
6.86in
\line{\the\footline}}
135 \errhelp{You must set
\columnsperpage equal to
1,
2, or
3.
}
136 \errmessage{Illegal number of columns per page
}
139 \intercolumnskip=
.46in
141 \output=
{% %see The TeXbook page 257
142 % This next line is useful when designing the layout.
143 %\immediate\write16{Column \folio\abc\space starts with \firstmark}
144 \if \maxcolumn\abc \multicolumnformat \global\def\abc{a
}
146 \global\setbox\columna\columnbox \global\def\abc{b
}
147 %% in case we never use \columnb (two-column mode)
148 \global\setbox\columnb\hbox to -
\intercolumnskip{}
150 \global\setbox\columnb\columnbox \global\def\abc{c
}\fi\fi}
151 \def\multicolumnformat{\shipout\vbox{\makeheadline
152 \hbox{\box\columna\hskip\intercolumnskip
153 \box\columnb\hskip\intercolumnskip\columnbox}
154 \makefootline}\advancepageno}
155 \def\columnbox{\leftline{\pagebody}}
157 \def\bye{\par\vfill\supereject
158 \if a
\abc \else\null\vfill\eject\fi
159 \if a
\abc \else\null\vfill\eject\fi
163 % we won't be using math mode much, so redefine some of the characters
164 % we might want to talk about
172 \hyphenation{mini-buf-fer
}
173 \hyphenation{de-le-tion
}
176 \parskip 1ex plus
.5ex minus
.5ex
178 \def\small{\smallfont\textfont2=
\smallsy\baselineskip=
.8\baselineskip}
180 % newcolumn - force a new column. Use sparingly, probably only for
181 % the first column of a page, which should have a title anyway.
182 \outer\def\newcolumn{\vfill\eject}
184 % title - page title. Argument is title text.
185 \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus
.5ex
}
187 % section - new major section. Argument is section name.
188 \outer\def\section#1{\par\filbreak
189 \vskip 3ex plus
2ex minus
2ex
{\headingfont #1}\mark{#1}%
190 \vskip 2ex plus
1ex minus
1.5ex
}
194 % beginindentedkeys...endindentedkeys - key definitions will be
195 % indented, but running text, typically used as headings to group
196 % definitions, will not.
197 \def\beginindentedkeys{\keyindent=
1em
}
198 \def\endindentedkeys{\keyindent=
0em
}
201 % paralign - begin paragraph containing an alignment.
202 % If an \halign is entered while in vertical mode, a parskip is never
203 % inserted. Using \paralign instead of \halign solves this problem.
204 \def\paralign{\vskip\parskip\halign}
206 % \<...> - surrounds a variable name in a code example
207 \def\<
#1>
{{\it #1\/
}}
209 % kbd - argument is characters typed literally. Like the Texinfo command.
210 \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows
212 % beginexample...endexample - surrounds literal text, such a code example.
213 % typeset in a typewriter font with line breaks preserved
214 \def\beginexample{\par\leavevmode\begingroup
215 \obeylines\obeyspaces\parskip0pt\tt}
216 {\obeyspaces\global\let =\
}
217 \def\endexample{\endgroup}
219 % key - definition of a key.
220 % \key{description of key}{key-name}
221 % prints the description left-justified, and the key-name in a \kbd
222 % form near the right margin.
223 \def\key#1#2{\leavevmode\hbox to
\hsize{\vtop
224 {\hsize=
.75\hsize\rightskip=
1em
225 \hskip\keyindent\relax#1}\kbd{#2}\hfil}}
228 \setbox\metaxbox\hbox{\kbd{M-x
}}
230 \metaxwidth=
\wd\metaxbox
232 % metax - definition of a M-x command.
233 % \metax{description of command}{M-x command-name}
234 % Tries to justify the beginning of the command name at the same place
235 % as \key starts the key name. (The "M-x " sticks out to the left.)
236 \def\metax#1#2{\leavevmode\hbox to
\hsize{\hbox to
.75\hsize
237 {\hskip\keyindent\relax#1\hfil}%
238 \hskip -
\metaxwidth minus
1fil
241 % threecol - like "key" but with two key names.
242 % for example, one for doing the action backward, and one for forward.
243 \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&
\kbd{#2}\hfil\quad
244 &
\kbd{#3}\hfil\quad\cr}
246 % I cannot figure out how to make all dired-x
247 % commands fit on a page in two-column format
255 \title{Dired Reference Card
}
257 \centerline{(based on Dired in GNU Emacs
\versionemacs)
}
258 \centerline{Commands marked with
\dx{} require dired-x
}
260 % trim this down to fit everything on one page
262 % In dired, you can edit a list of the files in a directory (and optionally
263 % its subdirectories in the `ls -lR' format).
265 % Editing a directory means that you can visit, rename, copy, compress,
266 % load, byte-compile files. You can change files' attributes, run shell
267 % commands on files, or insert subdirectories into the edit buffer. You can
268 % "flag" files for deletion or "mark" files for later commands, either one
269 % file at a time or by all files matching certain criteria (e.g., files that
270 % match a certain regexp).
272 % You move throughout the buffer using the usual cursor motion commands.
273 % Letters no longer insert themselves, but execute commands instead. The
274 % digits (0-9) are prefix arguments.
276 % Most commands operate either on all marked files or on the current file if
277 % no files are marked. Use a numeric prefix argument to operate on the next
278 % ARG files (or previous ARG if ARG $<$ 0). Use the prefix argument `1' to
279 % operate on the current file only. Prefix arguments override marks. Commands
280 % which run a sub-process on a group of files will display a list of files
281 % for which the sub-process failed. Typing y will try to tell
282 % you what went wrong.
284 % When editing several directories in one buffer, each directory acts as a
285 % page, so C-x [ and C-x ] can be used to move between directories.
287 \section{Entering and Exiting Dired
}
289 \key{run dired
}{C-x d
}
290 \key{dired the directory of the file you are editing
}{C-x C-j
\dx}
293 \section{Motion Commands
}
295 \key{move up to previous line
}{p
}
296 \key{move down to next line
}{n
}
297 \key{move up to previous directory line
}{<
}
298 \key{move down to next directory line
}{>
}
299 \key{move to next marked file
}{M-\
}}
300 \key{move to previous marked file
}{M-\
{}
301 \key{move up to previous subdirectory
}{M-C-p
}
302 \key{move down to next subdirectory
}{M-C-n
}
303 \key{move to parent directory
}{^
}
304 \key{move to first child subdirectory
}{M-C-d
}
306 \section{Mouse Commands
}
307 \metax{visit file or directory
}{Mouse_Button_2
}
309 \section{Immediate Actions on Files
}
311 \key{visit current file
}{f
}
312 \key{view current file
}{v
}
313 \key{visit current file in other window
}{o
}
315 %% \key{visit current file in other frame}{w}
317 %%\key{display current file}{C-u o}
318 \key{create a new subdirectory
}{+
}
319 \key{compare file at point with the one at mark
}{=
}
321 \section{Marking and Unmarking Files
}
323 \key{mark a file or subdirectory for later commands
}{m
}
324 \key{unmark a file or all files of a subdirectory
}{u
}
325 \key{unmark all marked files in a buffer
}{M-delete
}
326 \key{mark files with a given extension
}{* .
}
327 \key{mark all directories
}{* /
}
328 \key{mark all symlinks
}{* @
}
329 \key{mark all executables
}{* *
}
330 \key{invert marking
}{t
}
331 \key{mark all files in the current subdir
}{* s
}
332 \key{mark file names matching a regular expression
}{* \%
}
333 \key{change the marks to a different character
}{* c
}
334 \key{mark files for which Elisp expression returns t
}{* (
\dx}
336 \section{Modifying the Dired Buffer
}
338 \key{insert a subdirectory into this buffer
}{i
}
339 \key{remove marked files from the listing
}{k
}
340 \key{remove a subdir listing
}{C-u k
}
341 \key{re-read all directories (retains all marks)
}{g
}
342 \key{toggle sorting of current subdir by name/date
}{s
}
343 \key{edit ls switches
}{C-u s
}
344 \key{recover marks, hidden lines, and such (undo)
}{C-_
}
345 \key{hide all subdirectories
}{M-\$
}
346 \key{hide or unhide subdirectory
}{\$
}
348 \section{Commands on Files Marked or Specified by the Prefix
}
350 \key{copy file(s)
}{C
}
351 \key{rename a file or move files to another directory
}{R
}
352 \key{change ownership of file(s)
}{O
}
353 \key{change the group of the file(s)
}{G
}
354 \key{change mode of file(s)
}{M
}
355 \key{print file(s)
}{P
}
356 \key{convert filename(s) to lower case
}{\% l
}
357 \key{convert filename(s) to upper case
}{\% u
}
358 \key{delete marked (as opposed to flagged) file(s)
}{D
}
360 %%\key{uuencode or uudecode file(s)}{U}
361 \key{compress or uncompress file(s)
}{Z
}
362 %% Only uses the current file.
363 \key{run info on file
}{I
\dx}
364 \key{make symbolic link(s)
}{S
}
365 \key{make relative symbolic link(s)
}{Y
}
366 \key{make hard link(s)
}{H
}
367 \key{search files for a regular expression
}{A
}
368 \key{regexp query replace on marked files
}{Q
}
369 \key{byte-compile file(s)
}{B
}
370 \key{load file(s)
}{L
}
371 \key{shell command on file(s)
}{!
}
372 \key{asynchronous shell command on file(s)
}{\&
}
374 \section{Flagging Files for Deletion
}
375 \leftline{\bf Unmark commands remove delete flags
}
376 \key{flag file for deletion
}{d
}
378 %%\key{backup and remove deletion flag}{delete}
379 \key{flag all backup files (file names ending in \~
{})
}{\~
{}}
380 \key{flag all auto-save files
}{\#
}
381 \key{flag various intermediate files
}{\% \&
}
382 \key{flag numeric backups (ending in .\~
{}1\~
{}, .\~
{}2\~
{}, etc.)
}{.
}
383 \key{execute the deletions requested (flagged files)
}{x
}
384 \key{flag files matching a regular expression
}{\% d
}
386 \section{Regular Expression Commands
}
388 \key{mark filenames matching a regular expression
}{\% m
}
389 \key{copy marked files by regexp
}{\% C
}
390 \key{rename marked files by regexp
}{\% R
}
393 \key{symlink, with relative paths
}{\% Y
}
394 \key{mark for deletion
}{\% d
}
396 \section{Dired and Find
}
397 \metax{dired file(s) whose name matches a pattern
}{M-x find-name-dired
}
398 \metax{dired file(s) that contain pattern
}{M-x find-grep-dired
}
399 \metax{dired file(s) based on
\kbd{find
} output
}{M-x find-dired
}
401 \section{Getting Help
}
404 \key{dired summary (short help) and error log
}{?
}