Release 4.54
This commit is contained in:
parent
4c7908e4c2
commit
238fa70a6b
391
org
391
org
|
@ -5,7 +5,7 @@ START-INFO-DIR-ENTRY
|
|||
* Org Mode: (org). outline-based notes management and organizer
|
||||
END-INFO-DIR-ENTRY
|
||||
|
||||
This manual is for Org-mode (version 4.53).
|
||||
This manual is for Org-mode (version 4.54).
|
||||
|
||||
Copyright (C) 2004, 2005, 2006 Free Software Foundation
|
||||
|
||||
|
@ -27,7 +27,7 @@ File: org, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)
|
|||
Org Mode Manual
|
||||
***************
|
||||
|
||||
This manual is for Org-mode (version 4.53).
|
||||
This manual is for Org-mode (version 4.54).
|
||||
|
||||
Copyright (C) 2004, 2005, 2006 Free Software Foundation
|
||||
|
||||
|
@ -398,14 +398,14 @@ File: org, Node: Feedback, Prev: Activation, Up: Introduction
|
|||
|
||||
If you find problems with Org-mode, or if you have questions, remarks,
|
||||
or ideas about it, please contact the maintainer Carsten Dominik at
|
||||
<dominik@science.uva.nl>.
|
||||
<dominik at science dot uva dot nl>.
|
||||
|
||||
For bug reports, please provide as much information as possible,
|
||||
including the version information of Emacs (`C-h v emacs-version
|
||||
<RET>') and Org-mode (`C-h v org-version <RET>'), as well as the
|
||||
Org-mode related setup in `.emacs'. If an error occurs, a traceback
|
||||
can be very useful. Often a small example file helps, along with clear
|
||||
information about:
|
||||
Org-mode related setup in `.emacs'. If an error occurs, a backtrace
|
||||
can be very useful (see below on how to create one). Often a small
|
||||
example file helps, along with clear information about:
|
||||
|
||||
1. What exactly did you do?
|
||||
|
||||
|
@ -414,6 +414,33 @@ information about:
|
|||
3. What happened instead?
|
||||
Thank you for helping to improve this mode.
|
||||
|
||||
How to create a useful backtrace
|
||||
................................
|
||||
|
||||
If working with Org-mode produces an error with a message you don't
|
||||
understand, you may have hit a bug. The best way to report this is by
|
||||
providing, in addition to what was mentioned above, a _Backtrace_.
|
||||
This is information from the built-in debugger about where and how the
|
||||
error occurred. Here is how to produce a useful backtrace:
|
||||
|
||||
1. Start a fresh Emacs or XEmacs, and make sure that it will load the
|
||||
original Lisp code in `org.el' instead of the compiled version in
|
||||
`org.elc'. The backtrace contains much more information if it is
|
||||
produced with uncompiled code. To do this, either rename `org.elc'
|
||||
to something else before starting Emacs, or ask Emacs explicitly
|
||||
to load `org.el' by using the command line
|
||||
emacs -l /path/to/org.el
|
||||
|
||||
2. Go to the `Options' menu and select `Enter Debugger on Error'
|
||||
(XEmacs has this option in the `Troubleshooting' sub-menu).
|
||||
|
||||
3. Do whatever you have to do to hit the error. Don't forget to to
|
||||
document the steps you take.
|
||||
|
||||
4. When you hit the error, a `*Backtrace*' buffer will appear on the
|
||||
screen. Safe this buffer to a file (for example using `C-x C-w'
|
||||
and attach) it to your bug report.
|
||||
|
||||
|
||||
File: org, Node: Document structure, Next: Tables, Prev: Introduction, Up: Top
|
||||
|
||||
|
@ -502,7 +529,13 @@ the visibility in the buffer.
|
|||
Note that inside tables, `S-<TAB>' jumps to the previous field.
|
||||
|
||||
`C-c C-a'
|
||||
Show all.
|
||||
Show all.
|
||||
|
||||
`C-c C-r'
|
||||
Reveal context around point, showing the current entry, the
|
||||
following heading and the hierarchy above. Useful for working
|
||||
near a location exposed by a sparse tree command (*note Sparse
|
||||
trees::) or an agenda command (*note Agenda commands::).
|
||||
|
||||
When Emacs first visits an Org-mode file, the global state is set to
|
||||
OVERVIEW, i.e. only the top level headlines are visible. This can be
|
||||
|
@ -2736,19 +2769,37 @@ following keys:
|
|||
`C-g'
|
||||
Abort without installing changes.
|
||||
|
||||
`q'
|
||||
If `q' is not assigned to a tag, it aborts like `C-g'.
|
||||
|
||||
`!'
|
||||
Turn of groups of mutually exclusive tags. Use this to (as an
|
||||
exception) assign several tags from such a group.
|
||||
|
||||
`C-c'
|
||||
Toggle auto-exit after the next change (see below).
|
||||
|
||||
This method lets you assign tags to a headline with very few keys. With
|
||||
the above setup, you could clear the current tags and set `@HOME',
|
||||
`Laptop' and `PC' tags with just the following keys: `C-c C-c <SPC> h l
|
||||
p <RET>'. Switching from `@HOME' to `@WORK' would be done with `C-c
|
||||
C-c w <RET>'. Adding the non-predefined tag `Sarah' could be done with
|
||||
`C-c C-c <TAB> S a r a h <RET> <RET>'.
|
||||
C-c w <RET>' or alternatively with `C-c C-c C-c w'. Adding the
|
||||
non-predefined tag `Sarah' could be done with `C-c C-c <TAB> S a r a h
|
||||
<RET> <RET>'.
|
||||
|
||||
If you find that most of the time, you need only a single keypress to
|
||||
modify your list of tags, set the variable
|
||||
`org-fast-tag-selection-single-key'. Then you no longer have to press
|
||||
<RET> to exit fast tag selection - it will immediately exit after the
|
||||
first change. If you then occasionally need more keys, press `C-c' to
|
||||
turn off auto-exit for the current tag selection process.
|
||||
|
||||
---------- Footnotes ----------
|
||||
|
||||
(1) In `org-mode-alist' use `'(:startgroup)' and `'(:endgroup)',
|
||||
respectively. Several groups are allowed.
|
||||
|
||||
(2) Keys will automatically assigned to tags which have no
|
||||
(2) Keys will automatically be assigned to tags which have no
|
||||
configured keys.
|
||||
|
||||
|
||||
|
@ -4906,14 +4957,6 @@ A.1 Third-party extensions for Org-mode
|
|||
|
||||
The following extensions for Org-mode have been written by other people:
|
||||
|
||||
`org-mouse.el' by Piotr Zielinski
|
||||
This package implements extended mouse functionality for Org-mode.
|
||||
It allows you to cycle visibility and to edit the document
|
||||
structure with the mouse. Best of all, it provides a
|
||||
context-sensitive menu on <mouse-3> that changes depending on the
|
||||
context of a mouse-click. `org-mouse.el' is freely available at
|
||||
`http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el'.
|
||||
|
||||
`org-publish.el' by David O'Toole
|
||||
This package provides facilities for publishing related sets of
|
||||
Org-mode files together with linked files like images as a
|
||||
|
@ -4925,6 +4968,18 @@ The following extensions for Org-mode have been written by other people:
|
|||
downloaded from David's site:
|
||||
`http://dto.freeshell.org/e/org-publish.el'.
|
||||
|
||||
`org-mouse.el' by Piotr Zielinski
|
||||
This package implements extended mouse functionality for Org-mode.
|
||||
It allows you to cycle visibility and to edit the document
|
||||
structure with the mouse. Best of all, it provides a
|
||||
context-sensitive menu on <mouse-3> that changes depending on the
|
||||
context of a mouse-click. As of Org-mode version 4.53,
|
||||
`org-mouse.el' is part of the Org-mode distribution. It is not
|
||||
yet part of Emacs, however, a delay caused by the preparations for
|
||||
the 22.1 release. In the mean time, `org-mouse.el' can be
|
||||
downloaded from Piotr's site:
|
||||
`http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el'.
|
||||
|
||||
`org-blog.el' by David O'Toole
|
||||
A blogging plug-in for `org-publish.el'.
|
||||
`http://dto.freeshell.org/notebook/OrgMode.html'.
|
||||
|
@ -5152,6 +5207,7 @@ Index
|
|||
* ASCII export: ASCII export. (line 6)
|
||||
* author: Feedback. (line 6)
|
||||
* autoload: Activation. (line 6)
|
||||
* backtrace of an error: Feedback. (line 27)
|
||||
* BBDB links: External links. (line 6)
|
||||
* block agenda: Block agenda. (line 6)
|
||||
* bold text: Enhancing text. (line 15)
|
||||
|
@ -5349,12 +5405,12 @@ Index
|
|||
* options, for publishing: Publishing options. (line 6)
|
||||
* ordered lists: Plain lists. (line 6)
|
||||
* org-agenda, command: Weekly/Daily agenda. (line 9)
|
||||
* org-blog.el: Extensions. (line 25)
|
||||
* org-blogging.el: Extensions. (line 29)
|
||||
* org-blog.el: Extensions. (line 29)
|
||||
* org-blogging.el: Extensions. (line 33)
|
||||
* org-mode, turning on: Activation. (line 22)
|
||||
* org-mouse.el: Extensions. (line 8)
|
||||
* org-mouse.el: Extensions. (line 17)
|
||||
* org-publish-project-alist: Project alist. (line 6)
|
||||
* org-publish.el: Extensions. (line 14)
|
||||
* org-publish.el: Extensions. (line 8)
|
||||
* orgtbl-mode: orgtbl-mode. (line 6)
|
||||
* outline tree: Headlines. (line 6)
|
||||
* outline-mode: Outlines. (line 6)
|
||||
|
@ -5634,6 +5690,7 @@ Key Index
|
|||
(line 20)
|
||||
* C-c C-q: Built-in table editor.
|
||||
(line 119)
|
||||
* C-c C-r: Visibility cycling. (line 32)
|
||||
* C-c C-s <1>: Agenda commands. (line 136)
|
||||
* C-c C-s: Creating timestamps. (line 48)
|
||||
* C-c C-t <1>: Clocking work time. (line 26)
|
||||
|
@ -5787,150 +5844,150 @@ Node: Summary10777
|
|||
Node: Installation13689
|
||||
Node: Activation15067
|
||||
Node: Feedback16316
|
||||
Node: Document structure17085
|
||||
Node: Outlines17859
|
||||
Node: Headlines18519
|
||||
Node: Visibility cycling19142
|
||||
Ref: Visibility cycling-Footnote-120617
|
||||
Ref: Visibility cycling-Footnote-220675
|
||||
Node: Motion20725
|
||||
Node: Structure editing21509
|
||||
Node: Archiving23825
|
||||
Node: ARCHIVE tag24383
|
||||
Node: Moving subtrees26176
|
||||
Node: Sparse trees27217
|
||||
Ref: Sparse trees-Footnote-129348
|
||||
Ref: Sparse trees-Footnote-229440
|
||||
Node: Plain lists29555
|
||||
Ref: Plain lists-Footnote-133080
|
||||
Ref: Plain lists-Footnote-233437
|
||||
Node: Tables33619
|
||||
Node: Built-in table editor34167
|
||||
Node: Narrow columns41775
|
||||
Ref: Narrow columns-Footnote-143714
|
||||
Node: Table calculations43760
|
||||
Node: Formula syntax45080
|
||||
Ref: Formula syntax-Footnote-147985
|
||||
Node: Lisp formulas48285
|
||||
Node: Column formulas49074
|
||||
Node: Advanced features50836
|
||||
Node: Named-field formulas54090
|
||||
Node: Editing/debugging formulas54730
|
||||
Node: Appetizer56488
|
||||
Node: orgtbl-mode57591
|
||||
Node: table.el58082
|
||||
Node: Hyperlinks59059
|
||||
Node: Link format59832
|
||||
Node: Internal links61125
|
||||
Ref: Internal links-Footnote-163114
|
||||
Node: Radio targets63246
|
||||
Node: CamelCase links63961
|
||||
Node: External links64555
|
||||
Node: Handling links66686
|
||||
Ref: Handling links-Footnote-171338
|
||||
Ref: Handling links-Footnote-271575
|
||||
Node: Link abbreviations71649
|
||||
Node: Search options73328
|
||||
Ref: Search options-Footnote-175106
|
||||
Node: Custom searches75187
|
||||
Node: Remember76235
|
||||
Node: TODO items79925
|
||||
Node: TODO basics80907
|
||||
Node: TODO extensions82434
|
||||
Node: Workflow states83229
|
||||
Node: TODO types84097
|
||||
Ref: TODO types-Footnote-185755
|
||||
Node: Per file keywords85837
|
||||
Ref: Per file keywords-Footnote-187291
|
||||
Node: Priorities87492
|
||||
Node: Breaking down tasks88736
|
||||
Ref: Breaking down tasks-Footnote-189256
|
||||
Node: Checkboxes89352
|
||||
Node: Timestamps92088
|
||||
Node: Time stamps92549
|
||||
Ref: Time stamps-Footnote-196038
|
||||
Node: Creating timestamps96154
|
||||
Node: The date/time prompt98779
|
||||
Ref: The date/time prompt-Footnote-1100472
|
||||
Node: Custom time format100578
|
||||
Node: Progress logging102137
|
||||
Node: Closing items102666
|
||||
Node: Clocking work time103570
|
||||
Ref: Clocking work time-Footnote-1107196
|
||||
Node: Tags107322
|
||||
Node: Tag inheritance108084
|
||||
Node: Setting tags109021
|
||||
Ref: Setting tags-Footnote-1112537
|
||||
Ref: Setting tags-Footnote-2112649
|
||||
Node: Tag searches112729
|
||||
Node: Agenda views114729
|
||||
Node: Agenda files116822
|
||||
Ref: Agenda files-Footnote-1117782
|
||||
Ref: Agenda files-Footnote-2117931
|
||||
Node: Agenda dispatcher118124
|
||||
Node: Weekly/Daily agenda119741
|
||||
Node: Calendar/Diary integration120706
|
||||
Node: Global TODO list122044
|
||||
Node: Matching headline tags124204
|
||||
Node: Timeline125262
|
||||
Node: Presentation and sorting125925
|
||||
Node: Categories126703
|
||||
Node: Time-of-day specifications127367
|
||||
Node: Sorting of agenda items129345
|
||||
Node: Agenda commands130627
|
||||
Node: Custom agenda views136515
|
||||
Node: Storing searches137190
|
||||
Node: Block agenda139102
|
||||
Node: Setting Options140332
|
||||
Node: Batch processing143044
|
||||
Node: Embedded LaTeX144174
|
||||
Ref: Embedded LaTeX-Footnote-1145266
|
||||
Node: Math symbols145456
|
||||
Node: Subscripts and Superscripts146221
|
||||
Node: LaTeX fragments147065
|
||||
Ref: LaTeX fragments-Footnote-1149173
|
||||
Node: Processing LaTeX fragments149435
|
||||
Node: CDLaTeX mode150381
|
||||
Ref: CDLaTeX mode-Footnote-1152865
|
||||
Node: Exporting153013
|
||||
Node: ASCII export154327
|
||||
Node: HTML export155617
|
||||
Node: XOXO export158453
|
||||
Node: iCalendar export158892
|
||||
Node: Text interpretation160715
|
||||
Node: Comment lines161194
|
||||
Node: Enhancing text161665
|
||||
Node: Export options163357
|
||||
Node: Publishing165024
|
||||
Ref: Publishing-Footnote-1165820
|
||||
Node: Configuration166016
|
||||
Node: Project alist166734
|
||||
Node: Sources and destinations167800
|
||||
Node: Selecting files168530
|
||||
Node: Publishing action169278
|
||||
Node: Publishing options170511
|
||||
Node: Publishing links172663
|
||||
Node: Project page index174176
|
||||
Node: Sample configuration174954
|
||||
Node: Simple example175446
|
||||
Node: Complex example176119
|
||||
Node: Triggering publication178195
|
||||
Node: Miscellaneous178880
|
||||
Node: Completion179514
|
||||
Node: Customization180985
|
||||
Node: In-buffer settings181570
|
||||
Node: The very busy C-c C-c key185190
|
||||
Node: Clean view186834
|
||||
Node: TTY keys189411
|
||||
Node: Interaction191020
|
||||
Node: Cooperation191417
|
||||
Node: Conflicts193284
|
||||
Node: Bugs194876
|
||||
Node: Extensions and Hacking196499
|
||||
Node: Extensions196985
|
||||
Node: Dynamic blocks198555
|
||||
Node: History and Acknowledgments200482
|
||||
Node: Index205490
|
||||
Node: Key Index232505
|
||||
Node: Document structure18395
|
||||
Node: Outlines19169
|
||||
Node: Headlines19829
|
||||
Node: Visibility cycling20452
|
||||
Ref: Visibility cycling-Footnote-122203
|
||||
Ref: Visibility cycling-Footnote-222261
|
||||
Node: Motion22311
|
||||
Node: Structure editing23095
|
||||
Node: Archiving25411
|
||||
Node: ARCHIVE tag25969
|
||||
Node: Moving subtrees27762
|
||||
Node: Sparse trees28803
|
||||
Ref: Sparse trees-Footnote-130934
|
||||
Ref: Sparse trees-Footnote-231026
|
||||
Node: Plain lists31141
|
||||
Ref: Plain lists-Footnote-134666
|
||||
Ref: Plain lists-Footnote-235023
|
||||
Node: Tables35205
|
||||
Node: Built-in table editor35753
|
||||
Node: Narrow columns43361
|
||||
Ref: Narrow columns-Footnote-145300
|
||||
Node: Table calculations45346
|
||||
Node: Formula syntax46666
|
||||
Ref: Formula syntax-Footnote-149571
|
||||
Node: Lisp formulas49871
|
||||
Node: Column formulas50660
|
||||
Node: Advanced features52422
|
||||
Node: Named-field formulas55676
|
||||
Node: Editing/debugging formulas56316
|
||||
Node: Appetizer58074
|
||||
Node: orgtbl-mode59177
|
||||
Node: table.el59668
|
||||
Node: Hyperlinks60645
|
||||
Node: Link format61418
|
||||
Node: Internal links62711
|
||||
Ref: Internal links-Footnote-164700
|
||||
Node: Radio targets64832
|
||||
Node: CamelCase links65547
|
||||
Node: External links66141
|
||||
Node: Handling links68272
|
||||
Ref: Handling links-Footnote-172924
|
||||
Ref: Handling links-Footnote-273161
|
||||
Node: Link abbreviations73235
|
||||
Node: Search options74914
|
||||
Ref: Search options-Footnote-176692
|
||||
Node: Custom searches76773
|
||||
Node: Remember77821
|
||||
Node: TODO items81511
|
||||
Node: TODO basics82493
|
||||
Node: TODO extensions84020
|
||||
Node: Workflow states84815
|
||||
Node: TODO types85683
|
||||
Ref: TODO types-Footnote-187341
|
||||
Node: Per file keywords87423
|
||||
Ref: Per file keywords-Footnote-188877
|
||||
Node: Priorities89078
|
||||
Node: Breaking down tasks90322
|
||||
Ref: Breaking down tasks-Footnote-190842
|
||||
Node: Checkboxes90938
|
||||
Node: Timestamps93674
|
||||
Node: Time stamps94135
|
||||
Ref: Time stamps-Footnote-197624
|
||||
Node: Creating timestamps97740
|
||||
Node: The date/time prompt100365
|
||||
Ref: The date/time prompt-Footnote-1102058
|
||||
Node: Custom time format102164
|
||||
Node: Progress logging103723
|
||||
Node: Closing items104252
|
||||
Node: Clocking work time105156
|
||||
Ref: Clocking work time-Footnote-1108782
|
||||
Node: Tags108908
|
||||
Node: Tag inheritance109670
|
||||
Node: Setting tags110607
|
||||
Ref: Setting tags-Footnote-1114805
|
||||
Ref: Setting tags-Footnote-2114917
|
||||
Node: Tag searches115000
|
||||
Node: Agenda views117000
|
||||
Node: Agenda files119093
|
||||
Ref: Agenda files-Footnote-1120053
|
||||
Ref: Agenda files-Footnote-2120202
|
||||
Node: Agenda dispatcher120395
|
||||
Node: Weekly/Daily agenda122012
|
||||
Node: Calendar/Diary integration122977
|
||||
Node: Global TODO list124315
|
||||
Node: Matching headline tags126475
|
||||
Node: Timeline127533
|
||||
Node: Presentation and sorting128196
|
||||
Node: Categories128974
|
||||
Node: Time-of-day specifications129638
|
||||
Node: Sorting of agenda items131616
|
||||
Node: Agenda commands132898
|
||||
Node: Custom agenda views138786
|
||||
Node: Storing searches139461
|
||||
Node: Block agenda141373
|
||||
Node: Setting Options142603
|
||||
Node: Batch processing145315
|
||||
Node: Embedded LaTeX146445
|
||||
Ref: Embedded LaTeX-Footnote-1147537
|
||||
Node: Math symbols147727
|
||||
Node: Subscripts and Superscripts148492
|
||||
Node: LaTeX fragments149336
|
||||
Ref: LaTeX fragments-Footnote-1151444
|
||||
Node: Processing LaTeX fragments151706
|
||||
Node: CDLaTeX mode152652
|
||||
Ref: CDLaTeX mode-Footnote-1155136
|
||||
Node: Exporting155284
|
||||
Node: ASCII export156598
|
||||
Node: HTML export157888
|
||||
Node: XOXO export160724
|
||||
Node: iCalendar export161163
|
||||
Node: Text interpretation162986
|
||||
Node: Comment lines163465
|
||||
Node: Enhancing text163936
|
||||
Node: Export options165628
|
||||
Node: Publishing167295
|
||||
Ref: Publishing-Footnote-1168091
|
||||
Node: Configuration168287
|
||||
Node: Project alist169005
|
||||
Node: Sources and destinations170071
|
||||
Node: Selecting files170801
|
||||
Node: Publishing action171549
|
||||
Node: Publishing options172782
|
||||
Node: Publishing links174934
|
||||
Node: Project page index176447
|
||||
Node: Sample configuration177225
|
||||
Node: Simple example177717
|
||||
Node: Complex example178390
|
||||
Node: Triggering publication180466
|
||||
Node: Miscellaneous181151
|
||||
Node: Completion181785
|
||||
Node: Customization183256
|
||||
Node: In-buffer settings183841
|
||||
Node: The very busy C-c C-c key187461
|
||||
Node: Clean view189105
|
||||
Node: TTY keys191682
|
||||
Node: Interaction193291
|
||||
Node: Cooperation193688
|
||||
Node: Conflicts195555
|
||||
Node: Bugs197147
|
||||
Node: Extensions and Hacking198770
|
||||
Node: Extensions199256
|
||||
Node: Dynamic blocks201057
|
||||
Node: History and Acknowledgments202984
|
||||
Node: Index207992
|
||||
Node: Key Index235080
|
||||
|
||||
End Tag Table
|
||||
|
|
|
@ -164,7 +164,6 @@
|
|||
(skip-chars-backward ":A-Za-z")
|
||||
(skip-chars-backward "\t ")))
|
||||
|
||||
|
||||
(defun org-mouse-show-context-menu (event prefix)
|
||||
(interactive "@e \nP")
|
||||
(if (and (= (event-click-count event) 1)
|
||||
|
|
88
org.texi
88
org.texi
|
@ -3,7 +3,7 @@
|
|||
@setfilename ../info/org
|
||||
@settitle Org Mode Manual
|
||||
|
||||
@set VERSION 4.53
|
||||
@set VERSION 4.54
|
||||
@set DATE November 2006
|
||||
|
||||
@dircategory Emacs
|
||||
|
@ -15,8 +15,8 @@
|
|||
@set MAINTAINERSITE @uref{http://www.astro.uva.nl/~dominik/Tools/org/,maintainers webpage}
|
||||
@set AUTHOR Carsten Dominik
|
||||
@set MAINTAINER Carsten Dominik
|
||||
@set MAINTAINEREMAIL @email{dominik@@science.uva.nl}
|
||||
@set MAINTAINERCONTACT @uref{mailto:dominik@@science.uva.nl,contact the maintainer}
|
||||
@set MAINTAINEREMAIL @email{dominik at science dot uva dot nl}
|
||||
@set MAINTAINERCONTACT @uref{mailto:dominik at science dot uva dot nl,contact the maintainer}
|
||||
@c %**end of header
|
||||
@finalout
|
||||
|
||||
|
@ -461,8 +461,8 @@ For bug reports, please provide as much information as possible,
|
|||
including the version information of Emacs (@kbd{C-h v emacs-version
|
||||
@key{RET}}) and Org-mode (@kbd{C-h v org-version @key{RET}}), as well as
|
||||
the Org-mode related setup in @file{.emacs}. If an error occurs, a
|
||||
traceback can be very useful. Often a small example file helps, along
|
||||
with clear information about:
|
||||
backtrace can be very useful (see below on how to create one). Often a
|
||||
small example file helps, along with clear information about:
|
||||
|
||||
@enumerate
|
||||
@item What exactly did you do?
|
||||
|
@ -471,6 +471,38 @@ with clear information about:
|
|||
@end enumerate
|
||||
@noindent Thank you for helping to improve this mode.
|
||||
|
||||
@subsubheading How to create a useful backtrace
|
||||
|
||||
@cindex backtrace of an error
|
||||
If working with Org-mode produces an error with a message you don't
|
||||
understand, you may have hit a bug. The best way to report this is by
|
||||
providing, in addition to what was mentioned above, a @emph{Backtrace}.
|
||||
This is information from the built-in debugger about where and how the
|
||||
error occurred. Here is how to produce a useful backtrace:
|
||||
|
||||
@enumerate
|
||||
@item
|
||||
Start a fresh Emacs or XEmacs, and make sure that it will load the
|
||||
original Lisp code in @file{org.el} instead of the compiled version in
|
||||
@file{org.elc}. The backtrace contains much more information if it is
|
||||
produced with uncompiled code. To do this, either rename @file{org.elc}
|
||||
to something else before starting Emacs, or ask Emacs explicitly to load
|
||||
@file{org.el} by using the command line
|
||||
@example
|
||||
emacs -l /path/to/org.el
|
||||
@end example
|
||||
@item
|
||||
Go to the @code{Options} menu and select @code{Enter Debugger on Error}
|
||||
(XEmacs has this option in the @code{Troubleshooting} sub-menu).
|
||||
@item
|
||||
Do whatever you have to do to hit the error. Don't forget to to
|
||||
document the steps you take.
|
||||
@item
|
||||
When you hit the error, a @file{*Backtrace*} buffer will appear on the
|
||||
screen. Safe this buffer to a file (for example using @kbd{C-x C-w} and
|
||||
attach) it to your bug report.
|
||||
@end enumerate
|
||||
|
||||
@node Document structure, Tables, Introduction, Top
|
||||
@chapter Document Structure
|
||||
@cindex document structure
|
||||
|
@ -583,6 +615,12 @@ Note that inside tables, @kbd{S-@key{TAB}} jumps to the previous field.
|
|||
@kindex C-c C-a
|
||||
@item C-c C-a
|
||||
Show all.
|
||||
@kindex C-c C-r
|
||||
@item C-c C-r
|
||||
Reveal context around point, showing the current entry, the following
|
||||
heading and the hierarchy above. Useful for working near a location
|
||||
exposed by a sparse tree command (@pxref{Sparse trees}) or an agenda
|
||||
command (@pxref{Agenda commands}).
|
||||
@end table
|
||||
|
||||
When Emacs first visits an Org-mode file, the global state is set to
|
||||
|
@ -3007,7 +3045,7 @@ these lines to activate any changes.
|
|||
If at least one tag has a selection key, pressing @kbd{C-c C-c} will
|
||||
automatically present you with a special interface, listing inherited
|
||||
tags, the tags of the current headline, and a list of all legal tags
|
||||
with corresponding keys@footnote{Keys will automatically assigned to
|
||||
with corresponding keys@footnote{Keys will automatically be assigned to
|
||||
tags which have no configured keys.}. In this interface, you can use
|
||||
the following keys:
|
||||
|
||||
|
@ -3028,6 +3066,13 @@ Clear all tags for this line.
|
|||
Accept the modified set.
|
||||
@item C-g
|
||||
Abort without installing changes.
|
||||
@item q
|
||||
If @kbd{q} is not assigned to a tag, it aborts like @kbd{C-g}.
|
||||
@item !
|
||||
Turn of groups of mutually exclusive tags. Use this to (as an
|
||||
exception) assign several tags from such a group.
|
||||
@item C-c
|
||||
Toggle auto-exit after the next change (see below).
|
||||
@end table
|
||||
|
||||
@noindent
|
||||
|
@ -3035,10 +3080,17 @@ This method lets you assign tags to a headline with very few keys. With
|
|||
the above setup, you could clear the current tags and set @samp{@@HOME},
|
||||
@samp{Laptop} and @samp{PC} tags with just the following keys: @kbd{C-c
|
||||
C-c @key{SPC} h l p @key{RET}}. Switching from @samp{@@HOME} to
|
||||
@samp{@@WORK} would be done with @kbd{C-c C-c w @key{RET}}. Adding the
|
||||
non-predefined tag @samp{Sarah} could be done with @kbd{C-c C-c
|
||||
@key{TAB} S a r a h @key{RET} @key{RET}}.
|
||||
@samp{@@WORK} would be done with @kbd{C-c C-c w @key{RET}} or
|
||||
alternatively with @kbd{C-c C-c C-c w}. Adding the non-predefined tag
|
||||
@samp{Sarah} could be done with @kbd{C-c C-c @key{TAB} S a r a h
|
||||
@key{RET} @key{RET}}.
|
||||
|
||||
If you find that most of the time, you need only a single keypress to
|
||||
modify your list of tags, set the variable
|
||||
@code{org-fast-tag-selection-single-key}. Then you no longer have to
|
||||
press @key{RET} to exit fast tag selection - it will immediately exit
|
||||
after the first change. If you then occasionally need more keys, press
|
||||
@kbd{C-c} to turn off auto-exit for the current tag selection process.
|
||||
|
||||
@node Tag searches, , Setting tags, Tags
|
||||
@section Tag searches
|
||||
|
@ -5379,13 +5431,6 @@ functionality of Org-mode.
|
|||
The following extensions for Org-mode have been written by other people:
|
||||
|
||||
@table @asis
|
||||
@cindex @file{org-mouse.el}
|
||||
@item @file{org-mouse.el} by Piotr Zielinski
|
||||
This package implements extended mouse functionality for Org-mode. It
|
||||
allows you to cycle visibility and to edit the document structure with
|
||||
the mouse. Best of all, it provides a context-sensitive menu on
|
||||
@key{mouse-3} that changes depending on the context of a mouse-click.
|
||||
@file{org-mouse.el} is freely available at @url{http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el}.
|
||||
@cindex @file{org-publish.el}
|
||||
@item @file{org-publish.el} by David O'Toole
|
||||
This package provides facilities for publishing related sets of Org-mode
|
||||
|
@ -5396,6 +5441,17 @@ Org-mode distribution. It is not yet part of Emacs, however, a delay
|
|||
caused by the preparations for the 22.1 release. In the mean time,
|
||||
@file{org-publish.el} can be downloaded from David's site:
|
||||
@url{http://dto.freeshell.org/e/org-publish.el}.
|
||||
@cindex @file{org-mouse.el}
|
||||
@item @file{org-mouse.el} by Piotr Zielinski
|
||||
This package implements extended mouse functionality for Org-mode. It
|
||||
allows you to cycle visibility and to edit the document structure with
|
||||
the mouse. Best of all, it provides a context-sensitive menu on
|
||||
@key{mouse-3} that changes depending on the context of a mouse-click.
|
||||
As of Org-mode version 4.53, @file{org-mouse.el} is part of the
|
||||
Org-mode distribution. It is not yet part of Emacs, however, a delay
|
||||
caused by the preparations for the 22.1 release. In the mean time,
|
||||
@file{org-mouse.el} can be downloaded from Piotr's site:
|
||||
@url{http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el}.
|
||||
@cindex @file{org-blog.el}
|
||||
@item @file{org-blog.el} by David O'Toole
|
||||
A blogging plug-in for @file{org-publish.el}.@*
|
||||
|
|
BIN
orgcard.pdf
BIN
orgcard.pdf
Binary file not shown.
|
@ -1,5 +1,5 @@
|
|||
% Reference Card for Org Mode
|
||||
\def\orgversionnumber{4.53}
|
||||
\def\orgversionnumber{4.54}
|
||||
\def\year{2006}
|
||||
%
|
||||
%**start of header
|
||||
|
@ -284,6 +284,7 @@ are preserved on all copies.
|
|||
\key{rotate current subtree between states}{TAB}
|
||||
\key{rotate entire buffer between states}{S-TAB}
|
||||
\key{show the whole file}{C-c C-a}
|
||||
\key{reveal context around point}{C-c C-r}
|
||||
%\key{show branches}{C-c C-k}
|
||||
|
||||
\section{Motion}
|
||||
|
|
Loading…
Reference in New Issue