Commit Graph

1381 Commits

Author SHA1 Message Date
Bastien Guerry 952abb2c46 org.texi: Small precision.
I'm not sponsoring the hosting costs of orgmode.org, this
is taken care by Jason Dunsmore.
2012-01-28 13:34:32 +01:00
Bastien Guerry 471ddbd14e Improve `org-insert-drawer' and related documentation.
* org.el (org-insert-property-drawer): Not an interactive
command anymore.
(org-insert-drawer): With a prefix argument, insert a property
drawer.  Check for headline within the region before inserting
the drawer.  Don't include special drawers in the completion
table.
(org-mode-map): New keybinding `C-c C-x d' for
`org-insert-drawer'.

* org.texi (Drawers): How to insert/complete drawers.

Thanks to Nicolas Goaziou for the discussion and the patch.
2012-01-26 09:18:10 +01:00
Bastien Guerry 94dbe6ea89 org.texi: fix typo.
Thanks to Takaaki ISHIKAWA for spotting this.
2012-01-25 07:16:46 +01:00
Bastien Guerry a0bee00428 org.texi: add a note about using C-u SPC in the agenda view. 2012-01-25 07:11:57 +01:00
Gregor Zattler efc3bdf3f3 Document max number of stars in clocking section
Clocking only works with all headings indented with less than `30'
stars (hardcoded `lmax' value in `org-clock-sum').
2012-01-24 17:11:08 +01:00
Gregor Zattler 9578537edf Document max number of stars in headings in manual
Clocking only works with headings indented with less than `30' stars
(hardcoded `lmax' value in `org-clock-sum').
2012-01-24 17:10:44 +01:00
Eric Schulte 2395c3eff1 Merge branch 'origin-maint' 2012-01-24 00:02:52 -07:00
Eric Schulte 11d31e89c4 replace org-babel-noweb-separator variable with :noweb-sep header argument
* doc/org.texi (noweb-sep): Document new header argument.
* lisp/ob.el (org-babel-common-header-args-w-values): Add new header
  argument.
  (org-babel-expand-noweb-references): Use header argument rather than
  customization variable.
2012-01-23 23:57:51 -07:00
Eric Schulte fce92180d1 Merge branch 'origin-maint' 2012-01-23 19:43:28 -07:00
Eric Schulte 269a509615 customizable noweb reference separator
* lisp/ob.el (org-babel-noweb-separator): Custom variable for
  accumulated noweb references.
  (org-babel-expand-noweb-references): Allow separator for noweb
  references.
* doc/org.texi (noweb-ref): Documentation of this new custom variable.
2012-01-23 19:42:06 -07:00
Bastien Guerry 8a7799473c orgguide.texi: Fix small typo.
Thanks to Guido Arnold for spotting this.
2012-01-23 16:14:34 +01:00
Konrad Hinsen f2a9d83824 Support for links to IMAP folders in org-vm.el 2012-01-20 17:06:04 +01:00
Bastien Guerry 9d045aa169 Merge branch 'maint' 2012-01-15 10:31:01 +01:00
Michael Brand aa321a3ed5 doc timestamp for diary-style sexp entries 2012-01-15 10:30:37 +01:00
Bastien Guerry a7389dff1e Docfix: using `org-sort' with a double prefix doesn't delete duplicates.
Thanks to Paweł Menich for spotting this.
2012-01-12 16:13:57 +01:00
Bastien Guerry df9e196edb Docfix: using `org-sort' with a double prefix doesn't delete duplicates.
Thanks to Paweł Menich for spotting this.
2012-01-12 16:13:33 +01:00
Thomas Dye d4c146be58 Fix typo on manual pointed out by Francois Pinard 2012-01-12 08:38:01 +01:00
Eric Schulte 81f0b56207 update the new :wrap documentation to match the current implementation
* doc/org.texi (wrap): Update the new :wrap documentation to match the
  current implementation.
2012-01-11 19:41:57 -07:00
Thomas Dye e9898f419c * doc/org.texi: added documentation for :wrap 2012-01-11 19:26:20 -07:00
Thomas Dye 03aae6bd07 * doc/org.texi: #+RESULTS now user-configurable 2012-01-11 15:41:47 -07:00
Thomas Dye 0ad3e3b822 * doc/org.texi: #+RESULTS now user-configurable 2012-01-11 15:38:36 -07:00
Thomas Dye 5cd59a87c1 * doc/org.texi: Documented :noweb no-export 2012-01-11 12:01:26 -07:00
Bastien Guerry 53eb6088a2 orgguide.texi: Use uppercase for env/options keywords.
Also rename #+srcname to #+NAME.
2012-01-11 16:31:58 +01:00
Bastien Guerry 454ee2346e org.texi: Use uppercase for #+results too.
Using lowercase for environment keywords is not as readable
as using uppercase.  Using lowercase just for #+results looks
weird -- instead, we use uppercase for *all* environment and
option keywords, explicitely explaining that the user can use
either lowercase or uppercase in their file.
2012-01-11 16:31:13 +01:00
Bastien Guerry 7e08a81b5b org.texi: fix tiny typo.
Thanks to Paul Eggert for this fix in Emacs trunk.
2012-01-11 08:33:22 +01:00
Bastien Guerry d2b3db915a Consistent capitalisation of option and environment keywords.
Also explain this convention.

Two exceptions: #+results, as it is dynamically inserted and
has always been lowercase, and #+BEGIN_LaTeX, with mixed case
to respect Lamport's will.  But all these keywords can be
written with lower/upper/mixed case.

Thanks to François Pinard for raising this issue.
2012-01-10 20:29:07 +01:00
Eric Schulte 8bce3b7ec3 Merge branch 'origin-maint' 2012-01-10 09:46:17 -07:00
Thomas Dye bebf66c652 * doc/org.texi: Edit :noweb no header argument for correctness 2012-01-10 09:45:56 -07:00
Bastien Guerry d93495a5e6 org.texi: Fix spelling mistakes.
Thanks to Paul Eggert for this fixes in Emacs trunk.
2012-01-10 11:40:20 +01:00
Bastien Guerry 128357b6f4 org.texi: replace `org-sort-entries-or-items' by `org-sort'.
Thanks to Paweł Menich for spotting this.
2012-01-09 11:07:10 +01:00
Bastien Guerry 95bee5a62b org.texi: Update the approximate number of Org variables.
* org.texi (Customization): Update the approximate number of
Org variables.
2012-01-09 10:53:19 +01:00
Eric Schulte 59df6a9ba0 Merge branch 'origin-maint' 2012-01-08 09:16:42 -07:00
Thomas Dye a57f228a1c * doc/org.texi: :results wrap produces a drawer instead of a begin_results block 2012-01-08 09:15:37 -07:00
Bastien Guerry 6a6274706f Fix copyright in orgguide.texi. 2012-01-05 11:25:57 +01:00
Bastien Guerry e44d2975ff Fix copyright (to 2012) year and Org version (to 7.8.03). 2012-01-03 18:47:01 +01:00
Bastien Guerry 2b3534a81f Release 7.8.03 2012-01-03 08:31:59 +00:00
Eric Schulte c2ee31fa44 documentation of *org-babel-use-quick-and-dirty-noweb-expansion*
* doc/org.texi (Noweb reference syntax): Adding documentation of
  the *org-babel-use-quick-and-dirty-noweb-expansion* variable.
2012-01-02 11:10:48 -07:00
Bastien Guerry b120a7b35d Add a note about :noweb-ref.
Thanks to Tomas Grigera for a preliminary patch.
2012-01-02 15:28:07 +01:00
Bastien Guerry f9293eae2a Document the new behavior of `C-u C-c C-c' on checkboxes.
* org.texi (Checkboxes): Document the new behavior of `C-u C-c
C-c' on checkboxes.
2011-12-31 17:47:53 +01:00
Bastien Guerry 8c36e92f88 Implement category filtering.
* org-agenda.el (org-agenda-filter-preset): New alias.
(org-agenda-filter-by-category): New command.
(org-agenda-mode-map): Add the new command.
(org-agenda-custom-commands-local-options): Add category
filter preset.
(org-agenda-mark-filtered-text): Mark both tag and filter
overlays.
(org-agenda-category-filter-preset): New variable.
(org-finalize-agenda, org-agenda-redo)
(org-agenda-filter-make-matcher, org-agenda-filter-apply):
Handle both category and tag filters.
(org-agenda-filter-show-all-tag): Rename from
`org-agenda-filter-by-tag-show-all'.
(org-agenda-filter-show-all-cat): New function.
(org-agenda-set-mode-name): Show the category filter in the
modeline.

* org-faces.el (org-agenda-filter-category): New face.

* org.texi (Agenda commands): Update documentation about the
new category filtering feature.

This feature has been requested by several people -- thanks
to all of them for mentioning this possibility.
2011-12-31 17:10:44 +01:00
Bastien Guerry e9e249ea49 New option `org-export-date-timestamp-format'.
* org-exp.el (org-export-date-timestamp-format): New option to
define the way a timestamp in #+DATE will be exported.
(org-infile-export-plist): Use the new option.

Thanks to Torsten Wagner for this idea.
2011-12-28 17:12:25 +01:00
Bastien Guerry 5e07acb67c org.texi: Split the table to fix the display of items.
* org.texi (Plain lists): Split the table to fix the display
of items.

Thanks to Elias Assarsson for spotting this, and to Takaaki
ISHIKAWA for providing a preliminary patch.
2011-12-26 14:24:08 +01:00
Bastien Guerry b28da12e2f Use CD@LaTeX{} instead of CDLa@TeX. 2011-12-25 09:43:30 +01:00
Bastien Guerry 2a6c549ecb Normalize the use of @LaTeX{} in the Org compact guide. 2011-12-25 09:42:08 +01:00
Bastien Guerry 5a4676b9ca org.texi: Normalize the use of @LaTeX{} in the manual.
Thanks to Elias Assarsson for mentioning this problem.
2011-12-25 09:36:20 +01:00
Bastien Guerry 314e2647d7 org.texi (Plain lists): Fix misplaced explantion.
* org.texi (Plain lists): Fix misplaced explantion.

Thanks to Takaaki ISHIKAWA for spotting this and for
a patch to this effect.
2011-12-21 19:41:41 +01:00
Bastien Guerry 6783f13109 * org.texi (Plain lists, Agenda files): Add index entries. 2011-12-20 23:22:29 +01:00
Julian Gehring a3d29c0794 Manual: Consistently use 'Org mode'
* doc/org.texi: Use 'Org mode' instead of alternatives like
'Org-mode' or 'org-mode', as suggested in Phil's notes
('doc/Documentation_Standards.org').
2011-12-20 23:09:29 +01:00
Bastien Guerry 5db83d89f0 org.texi: Fix small typo.
Thanks to Paul Eggert for fixing this in Emacs first.
2011-12-14 23:26:23 +01:00
Bernt Hansen fb8cd0297c * doc/org.texi (Agenda commands): Document org-clock-report-include-clocking-task
Add reference to this variable when describing the agenda clock report.
2011-12-14 19:14:47 +01:00
Bastien Guerry 490d6ace10 Update website to show 7.8.02 as current release 2011-12-13 00:34:34 +00:00
Bastien Guerry 4ecf626ee7 Update website to show 7.8.01 as current release 2011-12-12 23:24:11 +00:00
Julian Gehring 4fb95b4eb2 Org manual: Fix double-spaces at the end of sentences
Org manual: Fix double-spaces at the end of sentences

* doc/org.texi: End sentences with two spaces.

>From 19e39b67f4a8dbee3f1015f636fac4f77e59d3c2 Mon Sep 17 00:00:00 2001
From: Julian Gehring <julian.gehring@googlemail.com>
Date: Mon, 12 Dec 2011 19:19:20 +0100
Subject: [PATCH] Org manual: Fix double-spaces at the end of sentences

* doc/org.texi: End sentences with two spaces.
2011-12-12 20:10:38 +01:00
Julian Gehring b7507e4d4e Orgcard: Correct markup in 'Timestamps' section
Orgcard: Correct markup in 'Timestamps' section

* doc/orgcard.tex: Correct one markup in 'Timestamps' section

>From 756e4eb6aca0e1b72f8fa55537005d2b617b83f8 Mon Sep 17 00:00:00 2001
From: Julian Gehring <julian.gehring@googlemail.com>
Date: Mon, 12 Dec 2011 12:29:46 +0100
Subject: [PATCH] Orgcard: Correct markup in 'Timestamps' section

* doc/orgcard.tex: Correct one markup in 'Timestamps' section
2011-12-12 20:09:16 +01:00
Bastien Guerry f30ade0151 Update website to show 7.8 as current release 2011-12-12 17:08:28 +00:00
suvayu ali c9ac829394 Improving bug reporting documentation
Hi Bastien and others,

Lately I have been seeing a lot of bug reports sent using the
org-submit-bug-report. The reporter usually reports the bug from a
session they have been using with their full blown customisations. And
often they are requested to reproduce the bug with emacs -Q. So I
thought it would be easier if the manual mentioned this little detail.
A patch is attached.

Hope this helps.

PS: I marked the patch as TINY CHANGE.
2011-12-12 17:34:06 +01:00
Jambunathan K c609ef0625 org.texi: Corrections to ODT section
Thanks to Christian Moe for proof-reading the manual and suggesting
corrections.
2011-12-12 10:01:14 +05:30
Michael Brand 2091083323 Bugfix open 1 link from list; doc more link types
* doc/org.texi (External links): Document the link types file+sys and
file+emacs, slightly narrow used page width.
* lisp/org.el (org-offer-links-in-entry): Make list when assigning a
single link.

"M-1 C-c C-o" or (org-open-at-point 1) or (org-offer-links-in-entry 1)
on a headline followed by two links enters Lisp error.  Both changes
are remainders of the commit release_6.33f-189-g3e0c61d.
2011-12-11 18:18:40 +01:00
Bastien Guerry 58d5fb1d5d Minor example fix.
Thanks to Dov Grobgeld for spotting this.
2011-12-11 14:25:16 +01:00
Jambunathan K ebd450a170 org.texi (Custom Table Styles - An Illustration): New node
Also improve various menus.
2011-12-11 14:08:28 +05:30
Jambunathan K cbd4bd7bdb org.texi (Validating OpenDocument XML): New node 2011-12-11 04:34:29 +05:30
Jambunathan K 69aa8884ed org.texi: Improve ODT section 2011-12-10 18:13:30 +01:00
Jambunathan K dc9e33b0a5 org.texi: Improve ODT section 2011-12-10 18:13:26 +01:00
Jambunathan K 57185cc6d9 org.texi: Improve ODT section 2011-12-10 18:13:23 +01:00
Jambunathan K 11af1b1678 org.texi: Refine ODT section 2011-12-10 18:13:20 +01:00
Jambunathan K 4ab52c962f doc/org.texi: Update ODT section 2011-12-10 18:13:17 +01:00
Bastien Guerry 3aaa5203fd org.texi: Fix typos.
Thanks to Paul Eggert for spotting this and fixing it in Emacs.
2011-12-04 11:44:23 +01:00
Eric Schulte e6ea9c59a0 note that colnames behavior may differ across languages
* doc/org.texi (colnames): Note that colnames behavior may differ
  across languages.
2011-11-28 11:23:42 -07:00
Bastien Guerry da2ecd24cd org.texi (Weekly/daily agenda, Agenda commands): Fix typos.
* org.texi (Weekly/daily agenda, Agenda commands): Fix typos.

Thanks to Paul Eggert for spotting this.
2011-11-28 15:17:15 +01:00
Thomas Dye 38f70b7e25 * doc/org.texi: Augmented discussion of babel property inheritance. Put footnote outside sentence ending period. 2011-11-23 12:39:44 -07:00
Eric Schulte a998cae722 the :eval header argument now takes 4(6) possible values
* doc/org.texi (eval): Documenting the full range of :eval header
  argument values.
* lisp/ob.el (org-babel-confirm-evaluate): Adding support for new
  range of :eval header arguments.
* testing/lisp/test-ob.el (test-ob/eval-header-argument): Testing the
  :eval header argument.
2011-11-22 07:32:39 -07:00
Eric Schulte edef1fa5ca ":eval non-export" inhibits evaluation during export
* doc/org.texi (eval): Documentation of the new :eval option.
* lisp/ob.el (org-babel-confirm-evaluate): Inhibit evaluation during
  export when eval is set to "non-export".
2011-11-21 18:19:45 -07:00
Eric Schulte f312e9a6b3 More documentation of accumulated properties 2011-11-21 10:02:38 -07:00
Thomas Dye 6bab435cb2 * doc/org.texi: Add accumulated properties 2011-11-21 10:02:38 -07:00
Eric Schulte e3ec968fc7 changing documentation to reflect changing source code -- spaces around "=" 2011-11-20 10:09:18 -07:00
Thomas Dye a12e99aefc * doc/org.texi: Documented no spaces in name=assign, another correction to :var table 2011-11-20 10:08:33 -07:00
Thomas Dye f8d8f81e79 * doc/org.texi: Changed DATA to NAME in Working With Source Code section 2011-11-15 11:21:04 -07:00
Tom Dye 015e41fa2a * doc/org.texi: Minor change to :var table 2011-11-15 08:56:25 -07:00
Tom Dye 3c832c9e81 * doc/org.texi: More changes to :var table (some examples were wrong) 2011-11-15 08:56:25 -07:00
Tom Dye 90aa84ffc1 * doc/org.texi: Cleaned up :var table 2011-11-15 08:56:25 -07:00
Eric Schulte 0b0c5cd26f fixed whitespace errors in org.texi 2011-11-15 08:56:25 -07:00
Eric Schulte 40700eee29 documentation now builds successfully 2011-11-15 08:56:24 -07:00
Eric Schulte a3f781be12 Tom's documentation updates for the new code block syntax 2011-11-15 08:56:24 -07:00
Jason Dunsmore 3e6ac9dfe2 org.texi: Clarify documentation regarding TODO state change logging. 2011-11-09 14:06:09 -06:00
Carsten Dominik 278d5afa2f Allow time stampes without day name
* lisp/org-clock.el (org-clock-in):
(org-clock-find-position): Make space after date optional.
* lisp/org.el (org-set-regexps-and-options):
(org-ts-regexp):
(org-ts-regexp-both):
(org-ts-regexp1):
(org-ctrl-c-ctrl-c): Make `C-c C-c' on date fix the time stamp

* doc/org.texi (Creating timestamps): Document the effect of `C-c C-c'
on a timestamp.
2011-11-09 18:55:27 +01:00
Bastien Guerry 5f1bd9f9b7 org.texi: Add @cindex for "appointment".
* org.texi (Timestamps, Weekly/daily agenda)
(Weekly/daily agenda): Add @cindex for "appointment".
2011-10-29 12:53:52 +02:00
Eric Schulte 47e27c28b6 adding two new links to the template for inserting empty code blocks
* doc/org.texi (Literal examples): A new link to the template for
  inserting empty code blocks.
  (Structure of code blocks): A new link to the template for inserting
  empty code blocks.
2011-10-24 19:42:58 -06:00
Rafael Laboissiere 7f85ab17b6 Accurate description of info hyperlink format
Hyperlinks in the form "info:file#node" work with plain spaces in the
"node" part and do not need to have spaces encoded as %20.  This is
the case for me, who is using the Debian emacs-snapshot package,
version 20110926-1.

TINYCHANGE
2011-10-22 11:15:51 +02:00
Rafael Laboissiere cba42a44b2 Add footnote on how the hyperlink text is searched in Org files
* org.texi (External links): Add footnote on how the behavior of the
text search in Org files are controled by the variable
org-link-search-must-match-exact-headline.

This change is necessary in order to avoid misleading the user as
regards of the behavior of the search, in particular because the
default value of org-link-search-must-match-exact-headline is
'query-to-create.

TINYCHANGE
2011-10-22 11:15:47 +02:00
Carsten Dominik 0c8b9711a3 Agenda: Add missing option, document time stamp movement to future
* lisp/org-agenda.el (org-agenda-move-date-from-past-immediately-to-today):
New option.
(org-agenda-date-later): Improve the logical structure.

* doc/org.texi (Agenda commands): Document that S-right on a line
representing a past date will immediately shift that date to today.
2011-10-22 08:39:54 +02:00
Eric Schulte 94873e2767 Update documentation to reflect removal of #+PROPERTIES
* doc/org.texi (Buffer-wide header arguments): Update documentation to
  reflect removal of #+PROPERTIES.
2011-10-20 15:30:07 -06:00
Eric Schulte 04a978fde5 removing #+BABEL: lines in favor of general #+PROPERTIES: lines
* lisp/ob.el (org-babel-params-from-buffer): Removing #+BABEL: lines
  in favor of general #+PROPERTIES: lines.

* doc/org.texi (Buffer-wide header arguments): Removing documentation
  of the defunct #+BABEL: structure.
2011-10-20 13:42:31 -06:00
Carsten Dominik 8ffd320c69 Doc: Document that trees tagged with ARCHIVE still contribute to clocktable
* doc/org.texi (The clock table): Mention that ACHIVED trees contribute
to the clock table.
2011-10-16 13:12:26 +02:00
Eric Schulte 4a7dd1e087 binding new code block header argument helper function to C-c C-v h 2011-10-08 16:38:32 -06:00
Carsten Dominik eed6b353d2 Manual: Better yasnippet config info
* doc/org.texi (Conflicts): Better yasnippet config info

Patch by Sylvain Rousseau.
TINYCHANGE
2011-10-08 18:32:16 +02:00
Achim Gratz ccc99317de backport copyright and license headers from Emacs trunk 2011-08-24 22:32:38 +02:00
Bastien Guerry f893659b27 org.texi: Document the restriction about field and column names. 2011-08-23 16:34:35 +02:00
Bastien Guerry 98ae074c8a org.texi: Explicitely mention the default values for select/exclude tags.
* org.texi (Selective export): Explicitely mention the default
values for `org-export-select-tags', `org-export-exclude-tags'.

TINYCHANGE
2011-08-23 16:17:56 +02:00
Tom Dye 5303994d9a * doc/org.texi: Added a line to specify that header arguments are lowercase. 2011-08-21 12:32:01 -06:00
Tom Dye ec18abdddd * doc/org.texi: :var requires default value when declared 2011-08-19 10:44:53 -06:00