]> code.delx.au - gnu-emacs/blob - etc/cs-dired-ref.tex
Make background transparent.
[gnu-emacs] / etc / cs-dired-ref.tex
1 % Reference Card for Dired
2 % Copyright (C) 2000, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
3
4 % Czech hyphenation rules applied
5 \chyph
6
7 % This file is part of GNU Emacs.
8
9 % GNU Emacs is free software; you can redistribute it and/or modify
10 % it under the terms of the GNU General Public License as published by
11 % the Free Software Foundation; either version 2, or (at your option)
12 % any later version.
13
14 % GNU Emacs is distributed in the hope that it will be useful,
15 % but WITHOUT ANY WARRANTY; without even the implied warranty of
16 % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 % GNU General Public License for more details.
18
19 % You should have received a copy of the GNU General Public License
20 % along with GNU Emacs; see the file COPYING. If not, write to
21 % the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 % Boston, MA 02110-1301, USA.
23
24 % This file can be printed with 1, 2, or 3 columns per page (see below).
25 % Specify how many you want here. Nothing else needs to be changed.
26 %**start of header
27
28 \newcount\columnsperpage
29
30 \columnsperpage=2
31
32 % This file is intended to be processed by plain TeX (TeX82).
33 % The reference card looks OK with 2 columns per page, portrait mode.
34 % I haven't tried it with 3 columns per page.
35
36 % This is a bit of a dirty hack on the GNU Emacs reference card
37 % to produce a Dired reference card instead.
38
39 % I (Evgeny Roubinchtein, eroubinc@u.washington.edu) put this together
40 % because I wanted a Dired reference card,
41 % but couldn't find anything on the 'net.
42 % Based mostly off Dired's describe-mode.
43
44 % Translated to Czech by Pavel Janík <Pavel@Janik.cz> in March 2001
45
46 % Process the file with `csplain' from the `CSTeX' distribution (included
47 % e.g. in the TeX Live CD).
48
49 \def\versionnumber{0.1}
50 \def\year{2005}
51 \def\version{May \year\ v\versionnumber}
52
53 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
54 \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
55 Permissions on back. v\versionnumber}}
56
57 \def\copyrightnotice{
58 \vskip 1ex plus 2 fill\begingroup\small
59 \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
60 \centerline{designed by Stephen Gildea, \version}
61 \centerline{for GNU Emacs version 21 on Unix systems}
62 \centerline{Updated for Dired in May 2000 by Evgeny Roubinchtein}
63
64 Permission is granted to make and distribute copies of
65 this card provided the copyright notice and this permission notice
66 are preserved on all copies.
67
68 For copies of the GNU Emacs manual, write to the Free Software
69 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
70 MA 02110-1301, USA.
71
72 \endgroup}
73
74 % make \bye not \outer so that the \def\bye in the \else clause below
75 % can be scanned without complaint.
76 \def\bye{\par\vfill\supereject\end}
77
78 \newdimen\intercolumnskip %horizontal space between columns
79 \newbox\columna %boxes to hold columns already built
80 \newbox\columnb
81
82 \def\ncolumns{\the\columnsperpage}
83
84 \message{[\ncolumns\space
85 column\if 1\ncolumns\else s\fi\space per page]}
86
87 \def\scaledmag#1{ scaled \magstep #1}
88
89 % This multi-way format was designed by Stephen Gildea October 1986.
90 % Note that the 1-column format is fontfamily-independent.
91 \if 1\ncolumns %one-column format uses normal size
92 \hsize 4in
93 \vsize 10in
94 \voffset -.7in
95 \font\titlefont=\fontname\tenbf \scaledmag3
96 \font\headingfont=\fontname\tenbf \scaledmag2
97 \font\smallfont=\fontname\sevenrm
98 \font\smallsy=\fontname\sevensy
99
100 \footline{\hss\folio}
101 \def\makefootline{\baselineskip10pt\hsize6.5in\line{\the\footline}}
102 \else %2 or 3 columns uses prereduced size
103 \hsize 3.4in
104 \vsize 7.95in
105 \hoffset -.75in
106 \voffset -.745in
107 \font\titlefont=csbx10 \scaledmag2
108 \font\headingfont=csbx10 \scaledmag1
109 \font\smallfont=csr6
110 \font\smallsy=cmsy6
111 \font\eightrm=csr8
112 \font\eightbf=csbx8
113 \font\eightit=csti8
114 \font\eighttt=cstt8
115 \font\eightmi=csmi8
116 \font\eightsy=cmsy8
117 \textfont0=\eightrm
118 \textfont1=\eightmi
119 \textfont2=\eightsy
120 \def\rm{\eightrm}
121 \def\bf{\eightbf}
122 \def\it{\eightit}
123 \def\tt{\eighttt}
124 \normalbaselineskip=.8\normalbaselineskip
125 \normallineskip=.8\normallineskip
126 \normallineskiplimit=.8\normallineskiplimit
127 \normalbaselines\rm %make definitions take effect
128
129 \if 2\ncolumns
130 \let\maxcolumn=b
131 \footline{\hss\rm\folio\hss}
132 \def\makefootline{\vskip 2in \hsize=6.86in\line{\the\footline}}
133 \else \if 3\ncolumns
134 \let\maxcolumn=c
135 \nopagenumbers
136 \else
137 \errhelp{You must set \columnsperpage equal to 1, 2, or 3.}
138 \errmessage{Illegal number of columns per page}
139 \fi\fi
140
141 \intercolumnskip=.46in
142 \def\abc{a}
143 \output={% %see The TeXbook page 257
144 % This next line is useful when designing the layout.
145 %\immediate\write16{Column \folio\abc\space starts with \firstmark}
146 \if \maxcolumn\abc \multicolumnformat \global\def\abc{a}
147 \else\if a\abc
148 \global\setbox\columna\columnbox \global\def\abc{b}
149 %% in case we never use \columnb (two-column mode)
150 \global\setbox\columnb\hbox to -\intercolumnskip{}
151 \else
152 \global\setbox\columnb\columnbox \global\def\abc{c}\fi\fi}
153 \def\multicolumnformat{\shipout\vbox{\makeheadline
154 \hbox{\box\columna\hskip\intercolumnskip
155 \box\columnb\hskip\intercolumnskip\columnbox}
156 \makefootline}\advancepageno}
157 \def\columnbox{\leftline{\pagebody}}
158
159 \def\bye{\par\vfill\supereject
160 \if a\abc \else\null\vfill\eject\fi
161 \if a\abc \else\null\vfill\eject\fi
162 \end}
163 \fi
164
165 % we won't be using math mode much, so redefine some of the characters
166 % we might want to talk about
167 \catcode`\^=12
168 \catcode`\_=12
169
170 \chardef\\=`\\
171 \chardef\{=`\{
172 \chardef\}=`\}
173
174 \hyphenation{mini-buf-fer}
175 \hyphenation{de-le-tion}
176
177 \parindent 0pt
178 \parskip 1ex plus .5ex minus .5ex
179
180 \def\small{\smallfont\textfont2=\smallsy\baselineskip=.8\baselineskip}
181
182 % newcolumn - force a new column. Use sparingly, probably only for
183 % the first column of a page, which should have a title anyway.
184 \outer\def\newcolumn{\vfill\eject}
185
186 % title - page title. Argument is title text.
187 \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus .5ex}
188
189 % section - new major section. Argument is section name.
190 \outer\def\section#1{\par\filbreak
191 \vskip 3ex plus 2ex minus 2ex {\headingfont #1}\mark{#1}%
192 \vskip 2ex plus 1ex minus 1.5ex}
193
194 \newdimen\keyindent
195
196 % beginindentedkeys...endindentedkeys - key definitions will be
197 % indented, but running text, typically used as headings to group
198 % definitions, will not.
199 \def\beginindentedkeys{\keyindent=1em}
200 \def\endindentedkeys{\keyindent=0em}
201 \endindentedkeys
202
203 % paralign - begin paragraph containing an alignment.
204 % If an \halign is entered while in vertical mode, a parskip is never
205 % inserted. Using \paralign instead of \halign solves this problem.
206 \def\paralign{\vskip\parskip\halign}
207
208 % \<...> - surrounds a variable name in a code example
209 \def\<#1>{{\it #1\/}}
210
211 % kbd - argument is characters typed literally. Like the Texinfo command.
212 \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows
213
214 % beginexample...endexample - surrounds literal text, such a code example.
215 % typeset in a typewriter font with line breaks preserved
216 \def\beginexample{\par\leavevmode\begingroup
217 \obeylines\obeyspaces\parskip0pt\tt}
218 {\obeyspaces\global\let =\ }
219 \def\endexample{\endgroup}
220
221 % key - definition of a key.
222 % \key{description of key}{key-name}
223 % prints the description left-justified, and the key-name in a \kbd
224 % form near the right margin.
225 \def\key#1#2{\leavevmode\hbox to \hsize{\vtop
226 {\hsize=.75\hsize\rightskip=1em
227 \hskip\keyindent\relax#1}\kbd{#2}\hfil}}
228
229 \newbox\metaxbox
230 \setbox\metaxbox\hbox{\kbd{M-x }}
231 \newdimen\metaxwidth
232 \metaxwidth=\wd\metaxbox
233
234 % metax - definition of a M-x command.
235 % \metax{description of command}{M-x command-name}
236 % Tries to justify the beginning of the command name at the same place
237 % as \key starts the key name. (The "M-x " sticks out to the left.)
238 \def\metax#1#2{\leavevmode\hbox to \hsize{\hbox to .75\hsize
239 {\hskip\keyindent\relax#1\hfil}%
240 \hskip -\metaxwidth minus 1fil
241 \kbd{#2}\hfil}}
242
243 % threecol - like "key" but with two key names.
244 % for example, one for doing the action backward, and one for forward.
245 \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&\kbd{#2}\hfil\quad
246 &\kbd{#3}\hfil\quad\cr}
247
248 % I cannot figure out how to make all dired-x
249 % commands fit on a page in two-column format
250 \def\dx{{\bf (DX)}}
251
252 %**end of header
253 \f
254
255 \title{Referenèní karta pro Dired}
256
257 \centerline{(urèeno pro Dired v GNU Emacsu 21.x)}
258 \centerline{Pøíkazy oznaèené \dx{} vy¾adují dired-x}
259
260 % trim this down to fit everything on one page
261 % \section{General}
262 % In dired, you can edit a list of the files in a directory (and optionally
263 % its subdirectories in the `ls -lR' format).
264
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).
271
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.
275
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.
283
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.
286
287 \section{Spu¹tìní a ukonèení Dired}
288
289 \key{spu¹tìní dired}{C-x d}
290 \key{spu¹tìní dired v adresáøi s aktuálním souborem}{C-x C-j \dx}
291 \key{ukonèení dired}{q}
292
293 \section{Pøíkazy pro pøesuny}
294
295 \key{zpìt na pøedchozí øádku}{p}
296 \key{vpøed na následující øádku}{n}
297 \key{nahoru na pøedchozí adresáø}{<}
298 \key{dolù na následující adresáø}{>}
299 \key{na dal¹í oznaèený soubor}{M-\}}
300 \key{na pøedchozí oznaèený soubor}{M-\{}
301 \key{zpìt na pøedchozí podadresáø}{M-C-p}
302 \key{vpøed na dal¹í podadresáø}{M-C-n}
303 \key{na nadøazený adresáø}{^}
304 \key{jdi na první podadresáø}{M-C-d}
305
306 \section{Pøíkazy pomocí my¹i}
307 \metax{otevøi soubor}{Mouse_Button_2}
308 \metax{zobraz menu}{Control-Mouse_Button_3}
309
310 \section{Okam¾ité akce nad soubory}
311
312 \key{otevøi aktuální soubor}{f}
313 \key{otevøi aktuální soubor pouze pro ètení}{v}
314 \key{otevøi aktuální soubor v jiném oknì}{o}
315 \key{otevøi aktuální soubor v jiném rámci}{w}
316 \key{zobraz aktuální soubor}{C-u o}
317 \key{vytvoø nový podadresáø}{+}
318 \key{porovnej soubor pod kurzorem s oznaèeným}{=}
319
320 \section{Znaèení a odznaèení souborù}
321
322 \key{oznaè soubor nebo podadresáø pro dal¹í pøíkazy}{m}
323 \key{odznaè soubor nebo soubory podadresáøe}{u}
324 \key{zru¹ oznaèení v¹ech souborù v bufferu}{M-delete}
325 \key{oznaè soubory se zadanou pøíponou}{* .}
326 \key{oznaè v¹echny adresáøe}{* /}
327 \key{oznaè v¹echny symbolické odkazy}{* @}
328 \key{oznaè v¹echny spustitelné soubory}{* *}
329 \key{invertuj oznaèení}{* t}
330 \key{oznaè v¹echny soubory v aktuálním podadresáøi}{* s}
331 \key{oznaè soubory vyhovující regulárnímu výrazu}{* \%}
332 \key{zmìò znaèku na jiné písmeno}{* c}
333 \key{oznaè soubory, pro které elispový výraz vrací t}{* ( \dx}
334
335 \section{Nápovìda}
336
337 \key{zobraz nápovìdu}{h}
338 \key{pøehled pøíkazù dired}{?}
339
340 \section{Pøíkazy nad oznaèenými soubory}
341
342 \key{kopíruj soubor(y)}{C}
343 \key{pøejmenuj soubor nebo pøesuò soubory}{R}
344 \key{zmìò vlastníka souboru(ù)}{O}
345 \key{zmìò skupinu souboru(ù)}{G}
346 \key{zmìò pøístupová práva souboru(ù)}{M}
347 \key{vytiskni soubor(y)}{P}
348 \key{zmìò název souboru(ù) na malá písmena}{\% l}
349 \key{zmìò název souboru(ù) na velká písmena}{\% u}
350 \key{sma¾ oznaèené soubory}{X}
351 \key{proveï uuencode nebo uudecode souboru(ù)}{U}
352 \key{zkomprimuj nebo dekomprimuj soubor(y)}{Z}
353 \key{spus» info na soubor}{I \dx}
354 \key{vytvoø symbolický(é) odkaz(y)}{S}
355 \key{vytvoø relativní symbolické odkazy}{Y}
356 \key{vytvoø pevný odkaz}{H}
357 \key{prohledej soubory na regulární výraz}{A}
358 \key{nahraï regulární výrazy}{Q}
359 \key{pøelo¾ soubory (byte-compile)}{B}
360 \key{naèti soubory (load-file)}{L}
361 \key{spus» pøíkaz na soubor(y)}{!}
362
363 \section{Oznaèení souborù pro smazání}
364 \leftline{\bf Odznaèující pøíkazy ma¾ou znaèku pro smazání}
365 \key{oznaè soubor pro smazání}{d}
366 \key{odstraò znaèku pro smazání}{delete}
367 \key{oznaè v¹echny zálohy (soubory konèící na \~{})}{\~{}}
368 \key{oznaè v¹echny zálohy (auto-save)}{\#}
369 \key{oznaè rùzné doèasné soubory}{\&}
370 \key{oznaè èíslované zálohy (konèící na .\~{}1\~{} apod.)}{.}
371 \key{proveï výmaz souborù oznaèených ke smazání}{x}
372 \key{oznaè soubory vyhovující regulárnímu výrazu}{\% d}
373
374 \section{Modifikace Dired bufferu}
375
376 \key{vlo¾ do tohoto bufferu podadresáø}{i}
377 \key{odstraò oznaèené soubory z bufferu}{k}
378 \key{odstraò z bufferu výpis podadresáøe}{C-u k}
379 \key{znovu naèti adresáøe (znaèky se zachovají)}{g}
380 \key{pøepni tøídìní adresáøe podle jména/data}{s}
381 \key{uprav volby pøíkazu ls}{C-u s}
382 \key{obnov znaèky, skryté øádky apod.}{C-_}
383 \key{skryj v¹echny podadresáøe}{M-\$}
384 \key{skryj nebo odkryj v¹echny podadresáøe}{\$}
385
386 \section{Pøíkazy s regulárními výrazy}
387
388 \key{oznaè soubory vyhovující regulárnímu výrazu}{\% m}
389 \key{kopíruj oznaèené soubory obsahující regexp}{\% C}
390 \key{pøejmenuj oznaèené soubory vyhovující regexp}{\% R}
391 \key{pevný odkaz}{\% H}
392 \key{symbolický odkaz}{\% S}
393 \key{symbolický odkaz s relativní cestou}{\% Y}
394 \key{oznaè pro smazání}{\% d}
395
396 \section{Dired a Find}
397 \metax{otevøi v dired soubory vyhovující vzorku}{M-x find-name-dired}
398 \metax{otevøi v dired soubory obsahující vzorek}{M-x find-grep-dired}
399 \metax{otevøi v dired soubory podle výstupu \kbd{find}}{M-x find-dired}
400
401 %\copyrightnotice
402
403 \bye
404
405 % arch-tag: dd78e947-5b89-4e5b-8bab-b6003719dce5