Repair the export of source code line references in LaTeX
[rgr-org-mode.git] / doc / orgcard.tex
blob4a4268e4a120d5cf626fa1af86eb90de6d21d4f9
1 % Reference Card for Org Mode
2 \def\orgversionnumber{6.34a}
3 \def\versionyear{2010} % latest update
4 \def\year{2010} % latest copyright year
6 %**start of header
7 \newcount\columnsperpage
8 \newcount\letterpaper
10 % This file can be printed with 1, 2, or 3 columns per page (see below).
11 % Specify how many you want here.
13 \columnsperpage=3
15 % Set letterpaper to 0 for A4 paper, 1 for letter (US) paper. Useful
16 % only when columnsperpage is 2 or 3.
18 \letterpaper=0
20 % Nothing else needs to be changed below this line.
21 % Copyright (C) 1987, 1993, 1996, 1997, 2001, 2002, 2003, 2004, 2005,
22 % 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
24 % This file is part of GNU Emacs.
26 % GNU Emacs is free software: you can redistribute it and/or modify
27 % it under the terms of the GNU General Public License as published by
28 % the Free Software Foundation, either version 3 of the License, or
29 % (at your option) any later version.
31 % GNU Emacs is distributed in the hope that it will be useful,
32 % but WITHOUT ANY WARRANTY; without even the implied warranty of
33 % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
34 % GNU General Public License for more details.
36 % You should have received a copy of the GNU General Public License
37 % along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
39 % This file is intended to be processed by plain TeX (TeX82).
41 % The final reference card has six columns, three on each side.
42 % This file can be used to produce it in any of three ways:
43 % 1 column per page
44 % produces six separate pages, each of which needs to be reduced to 80%.
45 % This gives the best resolution.
46 % 2 columns per page
47 % produces three already-reduced pages.
48 % You will still need to cut and paste.
49 % 3 columns per page
50 % produces two pages which must be printed sideways to make a
51 % ready-to-use 8.5 x 11 inch reference card.
52 % For this you need a dvi device driver that can print sideways.
53 % Which mode to use is controlled by setting \columnsperpage above.
55 % To compile and print this document:
56 % tex refcard.tex
57 % dvips -t landscape refcard.dvi
59 % Author:
60 % Stephen Gildea
61 % Internet: gildea@stop.mail-abuse.org
63 % Thanks to Paul Rubin, Bob Chassell, Len Tower, and Richard Mlynarik
64 % for their many good ideas.
66 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
67 \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
68 Permissions on back. v\orgversionnumber}}
70 \def\copyrightnotice{
71 \vskip 1ex plus 100 fill\begingroup\small
72 \centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
73 \centerline{v\orgversionnumber{} for Org-Mode \orgversionnumber{}, \versionyear}
74 \centerline{Author: Philip Rooke}
75 \centerline{based on refcard design and format by Stephen Gildea}
77 Permission is granted to make and distribute copies of
78 this card provided the copyright notice and this permission notice
79 are preserved on all copies.
81 \endgroup}
83 % make \bye not \outer so that the \def\bye in the \else clause below
84 % can be scanned without complaint.
85 \def\bye{\par\vfill\supereject\end}
87 \newdimen\intercolumnskip %horizontal space between columns
88 \newbox\columna %boxes to hold columns already built
89 \newbox\columnb
91 \def\ncolumns{\the\columnsperpage}
93 \message{[\ncolumns\space
94 column\if 1\ncolumns\else s\fi\space per page]}
96 \def\scaledmag#1{ scaled \magstep #1}
98 % This multi-way format was designed by Stephen Gildea October 1986.
99 % Note that the 1-column format is fontfamily-independent.
100 \if 1\ncolumns %one-column format uses normal size
101 \hsize 4in
102 \vsize 10in
103 \voffset -.7in
104 \font\titlefont=\fontname\tenbf \scaledmag3
105 \font\headingfont=\fontname\tenbf \scaledmag2
106 \font\smallfont=\fontname\sevenrm
107 \font\smallsy=\fontname\sevensy
109 \footline{\hss\folio}
110 \def\makefootline{\baselineskip10pt\hsize6.5in\line{\the\footline}}
111 \else %2 or 3 columns uses prereduced size
112 \if 1\the\letterpaper
113 \hsize 3.2in
114 \vsize 7.95in
115 \hoffset -.75in
116 \voffset -.745in
117 \else
118 \hsize 3.2in
119 \vsize 7.65in
120 \hoffset -.25in
121 \voffset -.745in
123 \font\titlefont=cmbx10 \scaledmag2
124 \font\headingfont=cmbx10 \scaledmag1
125 \font\smallfont=cmr6
126 \font\smallsy=cmsy6
127 \font\eightrm=cmr8
128 \font\eightbf=cmbx8
129 \font\eightit=cmti8
130 \font\eighttt=cmtt8
131 \font\eightmi=cmmi8
132 \font\eightsy=cmsy8
133 \textfont0=\eightrm
134 \textfont1=\eightmi
135 \textfont2=\eightsy
136 \def\rm{\eightrm}
137 \def\bf{\eightbf}
138 \def\it{\eightit}
139 \def\tt{\eighttt}
140 \if 1\the\letterpaper
141 \normalbaselineskip=.8\normalbaselineskip
142 \else
143 \normalbaselineskip=.7\normalbaselineskip
145 \normallineskip=.8\normallineskip
146 \normallineskiplimit=.8\normallineskiplimit
147 \normalbaselines\rm %make definitions take effect
149 \if 2\ncolumns
150 \let\maxcolumn=b
151 \footline{\hss\rm\folio\hss}
152 \def\makefootline{\vskip 2in \hsize=6.86in\line{\the\footline}}
153 \else \if 3\ncolumns
154 \let\maxcolumn=c
155 \nopagenumbers
156 \else
157 \errhelp{You must set \columnsperpage equal to 1, 2, or 3.}
158 \errmessage{Illegal number of columns per page}
159 \fi\fi
161 \intercolumnskip=.46in
162 \def\abc{a}
163 \output={% %see The TeXbook page 257
164 % This next line is useful when designing the layout.
165 %\immediate\write16{Column \folio\abc\space starts with \firstmark}
166 \if \maxcolumn\abc \multicolumnformat \global\def\abc{a}
167 \else\if a\abc
168 \global\setbox\columna\columnbox \global\def\abc{b}
169 %% in case we never use \columnb (two-column mode)
170 \global\setbox\columnb\hbox to -\intercolumnskip{}
171 \else
172 \global\setbox\columnb\columnbox \global\def\abc{c}\fi\fi}
173 \def\multicolumnformat{\shipout\vbox{\makeheadline
174 \hbox{\box\columna\hskip\intercolumnskip
175 \box\columnb\hskip\intercolumnskip\columnbox}
176 \makefootline}\advancepageno}
177 \def\columnbox{\leftline{\pagebody}}
179 \def\bye{\par\vfill\supereject
180 \if a\abc \else\null\vfill\eject\fi
181 \if a\abc \else\null\vfill\eject\fi
182 \end}
185 % we won't be using math mode much, so redefine some of the characters
186 % we might want to talk about
187 %\catcode`\^=12
188 \catcode`\_=12
190 % we also need the tilde, for file names.
191 \catcode`\~=12
193 \chardef\\=`\\
194 \chardef\{=`\{
195 \chardef\}=`\}
197 \hyphenation{mini-buf-fer}
199 \parindent 0pt
200 \parskip 1ex plus .5ex minus .5ex
202 \def\small{\smallfont\textfont2=\smallsy\baselineskip=.8\baselineskip}
204 % newcolumn - force a new column. Use sparingly, probably only for
205 % the first column of a page, which should have a title anyway.
206 \outer\def\newcolumn{\vfill\eject}
208 % title - page title. Argument is title text.
209 \outer\def\title#1{{\titlefont\centerline{#1}}\vskip 1ex plus .5ex}
211 % section - new major section. Argument is section name.
212 \outer\def\section#1{\par\filbreak
213 \vskip 3ex plus 2ex minus 2ex {\headingfont #1}\mark{#1}%
214 \vskip 2ex plus 1ex minus 1.5ex}
216 \newdimen\keyindent
218 % beginindentedkeys...endindentedkeys - key definitions will be
219 % indented, but running text, typically used as headings to group
220 % definitions, will not.
221 \def\beginindentedkeys{\keyindent=1em}
222 \def\endindentedkeys{\keyindent=0em}
223 \endindentedkeys
225 % paralign - begin paragraph containing an alignment.
226 % If an \halign is entered while in vertical mode, a parskip is never
227 % inserted. Using \paralign instead of \halign solves this problem.
228 \def\paralign{\vskip\parskip\halign}
230 % \<...> - surrounds a variable name in a code example
231 \def\<#1>{{\it #1\/}}
233 % kbd - argument is characters typed literally. Like the Texinfo command.
234 \def\kbd#1{{\tt#1}\null} %\null so not an abbrev even if period follows
236 % beginexample...endexample - surrounds literal text, such a code example.
237 % typeset in a typewriter font with line breaks preserved
238 \def\beginexample{\par\leavevmode\begingroup
239 \obeylines\obeyspaces\parskip0pt\tt}
240 {\obeyspaces\global\let =\ }
241 \def\endexample{\endgroup}
243 % key - definition of a key.
244 % \key{description of key}{key-name}
245 % prints the description left-justified, and the key-name in a \kbd
246 % form near the right margin.
247 \def\key#1#2{\leavevmode\hbox to \hsize{\vtop
248 {\hsize=.75\hsize\rightskip=1em
249 \hskip\keyindent\relax#1}\kbd{#2}\hfil}}
251 \newbox\metaxbox
252 \setbox\metaxbox\hbox{\kbd{M-x }}
253 \newdimen\metaxwidth
254 \metaxwidth=\wd\metaxbox
256 % metax - definition of a M-x command.
257 % \metax{description of command}{M-x command-name}
258 % Tries to justify the beginning of the command name at the same place
259 % as \key starts the key name. (The "M-x " sticks out to the left.)
260 \def\metax#1#2{\leavevmode\hbox to \hsize{\hbox to .75\hsize
261 {\hskip\keyindent\relax#1\hfil}%
262 \hskip -\metaxwidth minus 1fil
263 \kbd{#2}\hfil}}
265 % threecol - like "key" but with two key names.
266 % for example, one for doing the action backward, and one for forward.
267 \def\threecol#1#2#3{\hskip\keyindent\relax#1\hfil&\kbd{#2}\hfil\quad
268 &\kbd{#3}\hfil\quad\cr}
270 %**end of header
273 \title{Org-Mode Reference Card (1/2)}
275 \centerline{(for version \orgversionnumber)}
277 \section{Getting Started}
279 %\vskip -2mm
280 %\beginexample%
281 %(add-to-list 'auto-mode-alist '("\\\\.org\$" . org-mode))
282 %(define-key global-map "\\C-cl" 'org-store-link)$^1$
283 %(define-key global-map "\\C-ca" 'org-agenda)$^1$
284 %\endexample
286 \metax{To read the on-line documentation try}{M-x org-info}
288 \section{Visibility Cycling}
290 \key{rotate current subtree between states}{TAB}
291 \key{rotate entire buffer between states}{S-TAB}
292 \key{restore property-dependent startup visibility}{C-u C-u TAB}
293 \metax{show the whole file, including drawers}{C-u C-u C-u TAB}
294 \key{reveal context around point}{C-c C-r}
296 \section{Motion}
298 \key{next/previous heading}{C-c C-n/p}
299 \key{next/previous heading, same level}{C-c C-f/b}
300 \key{backward to higher level heading}{C-c C-u}
301 \key{jump to another place in document}{C-c C-j}
302 \key{previous/next plain list item}{S-UP/DOWN$^3$}
304 \section{Structure Editing}
306 \key{insert new heading/item at current level}{M-RET}
307 \key{insert new heading after subtree}{C-RET}
308 \key{insert new TODO entry/checkbox item}{M-S-RET}
309 \key{insert TODO entry/ckbx after subtree}{C-S-RET}
310 \key{turn (head)line into item, cycle item type}{C-c -}
311 \key{turn item/line into headline}{C-c *}
312 \key{promote/demote heading}{M-LEFT/RIGHT}
313 \metax{promote/demote current subtree}{M-S-LEFT/RIGHT}
315 \metax{move subtree/list item up/down}{M-S-UP/DOWN}
316 \metax{sort subtree/region/plain-list}{C-c \^{}}
317 \metax{clone a subtree}{C-c C-x c}
318 \metax{refile subtree}{C-c C-w}
319 \metax{kill/copy subtree}{C-c C-x C-w/M-w}
320 \metax{yank subtree}{C-c C-x C-y or C-y}
321 \metax{narrow buffer to subtree / widen}{C-x n s/w}
323 \section{Archiving}
325 \key{archive subtree using the default command}{C-c C-x C-a}
326 \key{move subtree to archive file}{C-c C-x C-s}
327 \key{toggle ARCHIVE tag / to ARCHIVE sibling}{C-c C-x a/A}
328 \key{force cycling of an ARCHIVEd tree}{C-TAB}
330 \section{Filtering and Sparse Trees}
332 \key{construct a sparse tree by various criteria}{C-c /}
333 \key{view TODO's in sparse tree}{C-c C-v}
334 \key{global TODO list in agenda mode}{C-c a t$^1$}
335 \key{time sorted view of current org file}{C-c a L}
337 \section{Tables}
339 {\bf Creating a table}
341 %\metax{insert a new Org-mode table}{M-x org-table-create}
342 \metax{just start typing, e.g.}{|Name|Phone|Age RET |- TAB}
343 \key{convert region to table}{C-c |}
344 \key{... separator at least 3 spaces}{C-3 C-c |}
346 {\bf Commands available inside tables}
348 The following commands work when the cursor is {\it inside a table}.
349 Outside of tables, the same keys may have other functionality.
351 {\bf Re-aligning and field motion}
353 \key{re-align the table without moving the cursor}{C-c C-c}
354 \key{re-align the table, move to next field}{TAB}
355 \key{move to previous field}{S-TAB}
356 \key{re-align the table, move to next row}{RET}
357 \key{move to beginning/end of field}{M-a/e}
359 {\bf Row and column editing}
361 \key{move the current column left}{M-LEFT/RIGHT}
362 \key{kill the current column}{M-S-LEFT}
363 \key{insert new column to left of cursor position}{M-S-RIGHT}
365 \key{move the current row up/down}{M-UP/DOWN}
366 \key{kill the current row or horizontal line}{M-S-UP}
367 \key{insert new row above the current row}{M-S-DOWN}
368 \key{insert hline below (\kbd{C-u} : above) current row}{C-c -}
369 \key{insert hline and move to line below it}{C-c RET}
370 \key{sort lines in region}{C-c \^{}}
372 {\bf Regions}
374 \metax{cut/copy/paste rectangular region}{C-c C-x C-w/M-w/C-y}
375 %\key{copy rectangular region}{C-c C-x M-w}
376 %\key{paste rectangular region}{C-c C-x C-y}
377 \key{fill paragraph across selected cells}{C-c C-q}
379 {\bf Miscellaneous}
381 \key{to limit column width to \kbd{N} characters, use}{...| <N> |...}
382 \key{edit the current field in a separate window}{C-c `}
383 \key{make current field fully visible}{C-u TAB}
384 \metax{export as tab-separated file}{M-x org-table-export}
385 \metax{import tab-separated file}{M-x org-table-import}
386 \key{sum numbers in current column/rectangle}{C-c +}
388 {\bf Tables created with the \kbd{table.el} package}
390 \key{insert a new \kbd{table.el} table}{C-c ~}
391 \key{recognize existing table.el table}{C-c C-c}
392 \key{convert table (Org-mode $\leftrightarrow$ table.el)}{C-c ~}
394 {\bf Spreadsheet}
396 Formulas typed in field are executed by \kbd{TAB},
397 \kbd{RET} and \kbd{C-c C-c}. \kbd{=} introduces a column
398 formula, \kbd{:=} a field formula.
400 \key{Example: Add Col1 and Col2}{|=\$1+\$2 |}
401 \key{... with printf format specification}{|=\$1+\$2;\%.2f|}
402 \key{... with constants from constants.el}{|=\$1/\$c/\$cm |}
403 \metax{sum from 2nd to 3rd hline}{|:=vsum(@II..@III)|}
404 \key{apply current column formula}{| = |}
406 \key{set and eval column formula}{C-c =}
407 \key{set and eval field formula}{C-u C-c =}
408 \key{re-apply all stored equations to current line}{C-c *}
409 \key{re-apply all stored equations to entire table}{C-u C-c *}
410 \key{iterate table to stability}{C-u C-u C-c *}
411 \key{rotate calculation mark through \# * ! \^ \_ \$}{C-\#}
412 \key{show line, column, formula reference}{C-c ?}
413 \key{toggle grid / debugger}{C-c \}/\{}
415 \newcolumn
416 {\it Formula Editor}
418 \key{edit formulas in separate buffer}{C-c '}
419 \key{exit and install new formulas}{C-c C-c}
420 \key{exit, install, and apply new formulas}{C-u C-c C-c}
421 \key{abort}{C-c C-q}
422 \key{toggle reference style}{C-c C-r}
423 \key{pretty-print Lisp formula}{TAB}
424 \key{complete Lisp symbol}{M-TAB}
425 \key{shift reference point}{S-cursor}
426 \key{shift test line for column references}{M-up/down}
427 \key{scroll the window showing the table}{M-S-up/down}
428 \key{toggle table coordinate grid}{C-c \}}
430 \section{Links}
432 \key{globally store link to the current location}{C-c l$^1$}
433 \key{insert a link (TAB completes stored links)}{C-c C-l}
434 \key{insert file link with file name completion}{C-u C-c C-l}
435 \key{edit (also hidden part of) link at point}{C-c C-l}
437 \key{open file links in emacs}{C-c C-o}
438 \key{...force open in emacs/other window}{C-u C-c C-o}
439 \key{open link at point}{mouse-1/2}
440 \key{...force open in emacs/other window}{mouse-3}
441 \key{record a position in mark ring}{C-c \%}
442 \key{jump back to last followed link(s)}{C-c \&}
443 \key{find next link}{C-c C-x C-n}
444 \key{find previous link}{C-c C-x C-p}
445 \key{edit code snippet of file at point}{C-c '}
447 {\bf Internal Links}
449 \key{\kbd{<<My Target>>}}{\rm target}
450 \key{\kbd{<<<My Target>>>}}{\rm radio target$^2$}
451 \key{\kbd{[[*this text]]}}{\rm find headline}
452 \metax{\kbd{[[this text]]}}{\rm find target or text in buffer}
453 \metax{\kbd{[[this text][description]]}}{\rm optional link text}
455 {\bf External Links}
457 \key{\kbd{file:/home/dominik/img/mars.jpg}}{\rm file, absolute}
458 \key{\kbd{file:papers/last.pdf}}{\rm file, relative}
459 \key{\kbd{file:projects.org::*that text}}{\rm find headline}
460 \key{\kbd{file:projects.org::find me}}{\rm find trgt/string}
461 %\key{\kbd{file:projects.org::/regexp/}}{\rm regexp search}
462 \key{\kbd{http://www.astro.uva.nl/~dominik}}{\rm on the web}
463 \key{\kbd{mailto:adent@galaxy.net}}{\rm Email address}
464 \key{\kbd{news:comp.emacs}}{\rm Usenet group}
465 \key{\kbd{bbdb:Richard Stallman}}{\rm BBDB person}
466 \key{\kbd{gnus:group}}{\rm GNUS group}
467 \key{\kbd{gnus:group\#id}}{\rm GNUS message}
468 \key{\kbd{vm|wl|mhe|rmail:folder}}{\rm Mail folder}
469 \key{\kbd{vm|wl|mhe|rmail:folder\#id}}{\rm Mail message}
470 \key{\kbd{info:emacs:Regexps}}{\rm Info file:node}
471 \key{\kbd{shell:ls *.org}}{\rm shell command}
472 \key{\kbd{elisp:(calendar)}}{\rm elisp form}
473 \metax{\kbd{[[external link][description]]}}{\rm optional link text}
474 %\key{\kbd{vm://myself@some.where.org/folder\#id}}{\rm VM remote}
477 % \section{Remember-mode Integration}
479 % See the manual for how to make remember.el use Org-mode links and
480 % files. The note-finishing command \kbd{C-c C-c} will first prompt for
481 % an org file. In the file, find a location with:
483 % \key{rotate subtree visibility}{TAB}
484 % \key{next heading}{DOWN}
485 % \key{previous heading}{UP}
487 % Insert the note with one of the following:
489 % \key{as sublevel of heading at cursor}{RET}
490 % \key{right here (cursor not on heading)}{RET}
491 % \key{before current heading}{LEFT}
492 % \key{after current heading}{RIGHT}
493 % \key{shortcut to end of buffer (cursor at buf-start)}{RET}
494 % \key{Abort}{q}
496 \section{Completion}
498 In-buffer completion completes TODO keywords at headline start, TeX
499 macros after ``{\tt \\}'', option keywords after ``{\tt \#-}'', TAGS
500 after ``{\tt :}'', and dictionary words elsewhere.
502 \key{complete word at point}{M-TAB}
505 \newcolumn
506 \title{Org-Mode Reference Card (2/2)}
508 \centerline{(for version \orgversionnumber)}
510 \section{TODO Items and Checkboxes}
512 \key{rotate the state of the current item}{C-c C-t}
513 \metax{select next/previous state}{S-LEFT/RIGHT}
514 \metax{select next/previous set}{C-S-LEFT/RIGHT}
515 \key{toggle ORDERED property}{C-c C-x o}
516 \key{view TODO items in a sparse tree}{C-c C-v}
517 \key{view 3rd TODO keyword's sparse tree}{C-3 C-c C-v}
519 \key{set the priority of the current item}{C-c , [ABC]}
520 \key{remove priority cookie from current item}{C-c , SPC}
521 \key{raise/lower priority of current item}{S-UP/DOWN$^3$}
522 %\key{lower priority of current item}{S-DOWN$^3$}
524 %\key{\kbd{\#+SEQ_TODO: TODO TRY BLUFF DONE}}{\rm todo workflow}
525 %\key{\kbd{\#+TYP_TODO: Phil home work DONE}}{\rm todo types}
527 \key{insert new checkbox item in plain list}{M-S-RET}
528 \key{toggle checkbox(es) in region/entry/at point}{C-c C-x C-b}
529 \key{toggle checkbox at point}{C-c C-c}
530 %\metax{checkbox statistics cookies: insert {\tt [/]} or {\tt [\%]}}{}
531 \key{update checkbox statistics (\kbd{C-u} : whole file)}{C-c \#}
533 \section{Tags}
535 \key{set tags for current heading}{C-c C-q}
536 \key{realign tags in all headings}{C-u C-c C-q}
537 \key{create sparse tree with matching tags}{C-c \\}
538 \key{globally (agenda) match tags at cursor}{C-c C-o}
540 \section{Properties and Column View}
542 \key{set property/effort}{C-c C-x p/e}
543 \key{special commands in property lines}{C-c C-c}
544 \key{next/previous allowed value}{S-left/right}
545 \key{turn on column view}{C-c C-x C-c}
546 \key{capture columns view in dynamic block}{C-c C-x i}
548 \key{quit column view}{q}
549 \key{show full value}{v}
550 \key{edit value}{e}
551 \metax{next/previous allowed value}{n/p or S-left/right}
552 \key{edit allowed values list}{a}
553 \key{make column wider/narrower}{> / <}
554 \key{move column left/right}{M-left/right}
555 \key{add new column}{M-S-right}
556 \key{Delete current column}{M-S-left}
559 \section{Timestamps}
561 \key{prompt for date and insert timestamp}{C-c .}
562 \key{like \kbd{C-c} . but insert date and time format}{C-u C-c .}
563 \key{like \kbd{C-c .} but make stamp inactive}{C-c !} % FIXME
564 \key{insert DEADLINE timestamp}{C-c C-d}
565 \key{insert SCHEDULED timestamp}{C-c C-s}
566 \key{create sparse tree with all deadlines due}{C-c / d}
567 \key{the time between 2 dates in a time range}{C-c C-y}
568 \key{change timestamp at cursor by $\pm 1$ day}{S-RIGHT/LEFT$^3$}
569 \key{change year/month/day at cursor by $\pm 1$}{S-UP/DOWN$^3$}
570 \key{access the calendar for the current date}{C-c >}
571 \key{insert timestamp matching date in calendar}{C-c <}
572 \key{access agenda for current date}{C-c C-o}
573 \key{select date while prompted}{mouse-1/RET}
574 %\key{... select date in calendar}{mouse-1/RET}
575 %\key{... scroll calendar back/forward one month}{< / >}
576 %\key{... forward/backward one day}{S-LEFT/RIGHT}
577 %\key{... forward/backward one week}{S-UP/DOWN}
578 %\key{... forward/backward one month}{M-S-LEFT/RIGHT}
579 \key{toggle custom format display for dates/times}{C-c C-x C-t}
581 \newcolumn
583 {\bf Clocking time}
585 \key{start clock on current item}{C-c C-x C-i}
586 \key{stop/cancel clock on current item}{C-c C-x C-o/x}
587 \key{display total subtree times}{C-c C-x C-d}
588 \key{remove displayed times}{C-c C-c}
589 \key{insert/update table with clock report}{C-c C-x C-r}
591 \section{Agenda Views}
593 \key{add/move current file to front of agenda}{C-c [}
594 \key{remove current file from your agenda}{C-c ]}
595 \key{cycle through agenda file list}{C-'}
596 \key{set/remove restriction lock}{C-c C-x </>}
598 \key{compile agenda for the current week}{C-c a a$^1$}
599 \key{compile global TODO list}{C-c a t$^1$}
600 \key{compile TODO list for specific keyword}{C-c a T$^1$}
601 \key{match tags, TODO kwds, properties}{C-c a m$^1$}
602 \key{match only in TODO entries}{C-c a M$^1$}
603 \key{find stuck projects}{C-c a \#$^1$}
604 \key{show timeline of current org file}{C-c a L$^1$}
605 \key{configure custom commands}{C-c a C$^1$}
606 %\key{configure stuck projects}{C-c a !$^1$}
607 \key{agenda for date at cursor}{C-c C-o}
609 {\bf Commands available in an agenda buffer}
611 {\bf View Org file}
613 \key{show original location of item}{SPC/mouse-3}
614 %\key{... also available with}{mouse-3}
615 \key{show and recenter window}{L}
616 \key{goto original location in other window}{TAB/mouse-2}
617 %\key{... also available with}{mouse-2}
618 \key{goto original location, delete other windows}{RET}
619 \key{show subtree in indirect buffer, ded.\ frame}{C-c C-x b}
620 \key{toggle follow-mode}{F}
622 {\bf Change display}
624 \key{delete other windows}{o}
625 \key{view mode dispatcher}{v}
626 \key{switch to day/week/month/year view}{d w vm vy}
627 \key{toggle diary entries / time grid / habits}{D / G / K}
628 \key{toggle entry text / clock report}{E / R}
629 \key{toggle display of logbook entries}{l / v l/L}
630 \key{toggle inclusion of archived trees/files}{v a/A}
631 \key{refresh agenda buffer with any changes}{r / g}
632 \key{filter with respect to a tag}{/}
633 \key{save all org-mode buffers}{s}
634 \key{display next/previous day,week,...}{f / b}
635 \key{goto today / some date (prompt)}{. / j}
637 {\bf Remote editing}
639 \key{digit argument}{0-9}
640 \key{change state of current TODO item}{t}
641 \key{kill item and source}{C-k}
642 \key{archive default}{\$ / a}
643 \key{refile the subtree}{C-c C-w}
644 \key{set/show tags of current headline}{: / T}
645 \key{set effort property (prefix=nth)}{e}
646 \key{set / compute priority of current item}{, / P}
647 \key{raise/lower priority of current item}{S-UP/DOWN$^3$}
648 \key{run an attachment command}{C-c C-a}
649 \key{schedule/set deadline for this item}{C-c C-s/d}
650 \key{change timestamp to one day earlier/later}{S-LEFT/RIGHT$^3$}
651 \key{change timestamp to today}{>}
652 \key{insert new entry into diary}{i}
653 \newcolumn
654 \key{start/stop/cancel the clock on current item}{I / O / X}
655 \key{jump to running clock entry}{J}
656 \key{mark / unmark / execute bulk action}{m / u / B}
658 {\bf Misc}
660 \key{follow one or offer all links in current entry}{C-c C-o}
662 {\bf Calendar commands}
664 \key{find agenda cursor date in calendar}{c}
665 \key{compute agenda for calendar cursor date}{c}
666 \key{show phases of the moon}{M}
667 \key{show sunrise/sunset times}{S}
668 \key{show holidays}{H}
669 \key{convert date to other calendars}{C}
671 {\bf Quit and Exit}
673 \key{quit agenda, remove agenda buffer}{q}
674 \key{exit agenda, remove all agenda buffers}{x}
676 \section{LaTeX and cdlatex-mode}
678 \key{preview LaTeX fragment}{C-c C-x C-l}
679 \key{expand abbreviation (cdlatex-mode)}{TAB}
680 \key{insert/modify math symbol (cdlatex-mode)}{` / '}
681 \key{insert citation using RefTeX}{C-c C-x [}
683 \section{Exporting and Publishing}
685 Exporting creates files with extensions {\it .txt\/} and {\it .html\/}
686 in the current directory. Publishing puts the resulting file into
687 some other place.
689 \key{export/publish dispatcher}{C-c C-e}
691 \key{export visible part only}{C-c C-e v}
692 \key{insert template of export options}{C-c C-e t}
693 \key{toggle fixed width for entry or region}{C-c :}
695 %{\bf HTML formatting}
697 %\key{make words {\bf bold}}{*bold*}
698 %\key{make words {\it italic}}{/italic/}
699 %\key{make words \underbar{underlined}}{_underlined_}
700 %\key{sub- and superscripts}{x\^{}3, J_dust}
701 %\key{\TeX{}-like macros}{\\alpha, \\to}
702 %\key{typeset lines in fixed width font}{start with :}
703 %\key{tables are exported as HTML tables}{start with |}
704 %\key{links become HTML links}{http:... etc}
705 %\key{include html tags}{@<b>...@</b>}
707 %{\bf Export options}
709 %Include additional information for export by putting these anywhere in the
710 %org file. Use {\tt M-TAB} completion to make sure to get the right
711 %keywords. {\tt M-TAB} again just after keyword is complete inserts examples.
713 %\key{the title to be shown}{\#+TITLE:}
714 %\key{the author}{\#+AUTHOR:}
715 %\key{authors email address}{\#+EMAIL:}
716 %\key{language code for html}{\#+LANGUAGE:}
717 %\key{free text description of file}{\#+TEXT:}
718 %\key{... which can carry over multiple lines}{\#+TEXT:}
719 %\key{settings for the export process}{\#+OPTIONS:}
721 %\key{set number of headline levels for export}{H:2}
722 %\key{turn on/off section numbers}{num:t}
723 %\key{turn on/off table of contents}{toc:t}
724 %\key{turn on/off linebreak preservation}{\\n:nil}
725 %\key{turn on/off quoted html tags}{@:t}
726 %\key{turn on/off fixed width sections}{::t}
727 %\key{turn on/off tables}{|:t}
728 %\key{turn on/off \TeX\ syntax for sub/super-scripts}{\^{}:t}
729 %\key{turn on/off emphasised text}{*:nil}
730 %\key{turn on/off \TeX\ macros}{TeX:t}
732 {\bf Comments: Text not being exported}
734 Text before the first headline is not considered part of the document
735 and is therefore never exported.
736 Lines starting with \kbd{\#} are comments and are not exported.
737 Subtrees whose header starts with COMMENT are never exported.
739 \key{toggle COMMENT keyword on entry}{C-c ;}
741 \section{Dynamic Blocks}
743 \key{update dynamic block at point}{C-c C-x C-u}
744 \metax{update all dynamic blocks}{C-u C-c C-x C-u}
746 \section{Notes}
747 $^1$ This is only a suggestion for a binding of this command. Choose
748 your own key as shown under INSTALLATION.
750 $^2$ After changing a \kbd{\#+KEYWORD} or \kbd{<<<target>>>} line,
751 press \kbd{C-c C-c} with the cursor still in the line to update.
753 $^3$ Keybinding affected by {\tt org-support-shift-select} and {\tt
754 org-replace-disputed-keys}.
756 \copyrightnotice
758 \bye
760 % Local variables:
761 % compile-command: "tex refcard"
762 % End:
764 % arch-tag: 139f6750-5cfc-49ca-92b5-237fe5795290