Commit Graph

1572 Commits

Author SHA1 Message Date
Nicolas Goaziou 86563e0119 org-element: OPTIONAL_TITLE becomes ALT_TITLE property
* lisp/org-element.el (org-element-headline-parser):
  Rename :optional-title into :alt-title.
* lisp/ox.el (org-export-get-alt-title): Renamed from
  `org-export-get-optional-title'.
* lisp/ox-ascii.el (org-ascii--build-title): Apply name change.
* lisp/ox-html.el (org-html--format-toc-headline): Apply name change.
* lisp/ox-latex.el (org-latex-headline): Apply name change.
* lisp/ox-texinfo.el (org-texinfo--get-node,
  org-texinfo--generate-menu-items): Apply name change.
* testing/lisp/test-ox.el: Update tests.
* doc/org.texi (Table of contents): Update documentation.
2013-02-27 00:03:59 +01:00
Nicolas Goaziou 7440f1a019 org.texi: Document lists of listings and lists of tables
* doc/org.texi (Table of contents): Document lists of listings and
  lists of tables.
2013-02-24 16:13:39 +01:00
Nicolas Goaziou ca060f7be7 Require 2 blank lines to separate footnote definition
* lisp/org-element.el (org-element-footnote-definition-parser):
  Require 2 blank lines to separate footnote definition.
* lisp/org-footnote.el (org-footnote-at-definition-p): Require 2 blank
  lines to separate footnote definition.
* doc/org.texi: Update documentation for footnotes.
* testing/lisp/test-org-element.el: Update tests.
* testing/lisp/test-org-footnote.el: Add tests.

Footnote definitions can still be separated with other footnote
definitions and headlines. This change allows to have multiple
paragraphs in a footnote definition without resorting to the "\par"
trick.
2013-02-24 14:44:07 +01:00
Nicolas Goaziou ed7464b6b6 org.texi: Remove "Initial text" node 2013-02-24 00:46:46 +01:00
Nicolas Goaziou cf9bc7819b org.texi: Add documentation for optional title
* doc/org.texi (Table of contents): Add documentation for optional
  title and #+TOC: keyword.
2013-02-24 00:31:57 +01:00
Bastien Guerry b52ae35536 org.texi (@LaTeX{} fragments): Minor enhancement
* org.texi (@LaTeX{} fragments): Minor enhancement.
2013-02-23 13:50:31 +01:00
Bastien Guerry 4ca6766a8e org.texi: Update the list contributions
* org.texi: Update the list contributions.
2013-02-23 09:55:26 +01:00
Suvayu Ali 8058e6601e Fix typo in org.texi that broke compilation 2013-02-22 14:40:51 +01:00
Bastien Guerry e62f615108 org.texi (Agenda commands): Enhance docstring.
* org.texi (Agenda commands): Exporting the agenda to an .org
file will not copy the subtrees and the inherited tags.
2013-02-22 14:03:49 +01:00
Bastien Guerry 63260d0a73 org.texi (Publishing action, Complex example): Fix names of publishing functions
* org.texi (Publishing action, Complex example): Fix names of
publishing functions.
2013-02-22 13:41:22 +01:00
Bastien Guerry e96ba7c4ac org.texi: Delete documentation for the Freemind exporter
* org.texi (Top, Exporting): Delete references to Freemind.
(Freemind export): Delete section.
2013-02-22 12:05:35 +01:00
Bastien Guerry 1b0eda810c org.texi: Delete XOXO documentation
* org.texi (Top, Exporting): Delete references to the XOXO export.
(XOXO export): Delete section.
2013-02-22 11:57:14 +01:00
Bastien Guerry 4e9dbf1d02 org.texi (Capture): Mention that org-remember.el is not supported anymore
* org.texi (Capture): Mention that org-remember.el is not
supported anymore.
2013-02-22 11:52:19 +01:00
Bastien Guerry 3680007e7f org.texi: Delete documentation about the TaskJuggler export.
* org.texi (Top, Exporting, Beamer class export): Delete
references to the TaskJuggler export.
(History and Acknowledgments): Mention that the TaskJuggler
has been rewritten by Nicolas and now lives in the contrib/
directory of Org's distribution.
(TaskJuggler export): Delete.

The Taskjuggler documentation has been moved to Worg:
http://orgmode.org/worg/exporters/taskjuggler.html

TaskJuggler will now in the contrib/ directory of the Org
distribution, like other non-mainstream export format.
2013-02-22 11:32:24 +01:00
Bastien Guerry 5864432451 org.texi: Update the maintainer contact info
* org.texi: Update the maintainer contact info.
2013-02-15 18:41:46 +01:00
Bastien Guerry 9fa715b7f7 org.el: Fix the names of the HTML export and publishing options
* org.texi (HTML preamble and postamble)
(Tables in HTML export, Images in HTML export)
(Math formatting in HTML export, CSS support)
(@LaTeX{} and PDF export, Publishing options): Fix the names
of the HTML export and publishing options.
2013-02-15 18:40:38 +01:00
Bastien Guerry 5d467d6f8a org.texi: Fix LaTeX options names
* org.texi (Literal examples, Export options)
(@LaTeX{} and PDF export, Header and sectioning)
(Publishing options): Fix LaTeX options names.
2013-02-15 15:28:35 +01:00
Bastien Guerry 6aa8829a1a Merge branch 'maint' 2013-02-14 10:40:04 +01:00
Bastien Guerry 981c6db3d7 Enhance doc wrt interactions between `org-startup-folded' and `org-agenda-inhibit-startup'
* org.el (org-startup-folded):
* org.texi (Visibility cycling): Suggest to set
`org-agenda-inhibit-startup' to nil if user wants the startup
visibility settings to be honored in any circumstances.

Thanks to Tassilo for pointing this.
2013-02-14 10:39:54 +01:00
Bastien Guerry 04c6ad7774 org.texi: Fix references to HTML_LINK_* and HTML_STYLE keywords
* org.texi (Export options, CSS support, In-buffer settings):
Fix references to HTML_LINK_* and HTML_STYLE keywords.
2013-02-14 10:07:55 +01:00
Bastien Guerry 3ddaf2c33a org.texi: Fix references to #+SELECT_TAGS and #+EXCLUDE_TAGS and remove reference to #+XSLT
* org.texi (Export options, In-buffer settings): Fix
references to #+SELECT_TAGS and #+EXCLUDE_TAGS and remove
reference to #+XSLT.
2013-02-14 09:52:17 +01:00
Bastien Guerry 7a4d026b67 Remove references to the DocBook exporter
* org.el (org-emphasis-alist, org-protecting-blocks):
* org-src.el (org-edit-src-find-region-and-lang):
* org-list.el (org-list-forbidden-blocks):
* org-footnote.el (org-footnote-forbidden-blocks): Remove
references to the deleted DocBook exporter.

* org.texi (Top, Markup, Initial text, Images and tables)
(@LaTeX{} fragments, @LaTeX{} fragments, Exporting)
(Export options, JavaScript support, Beamer class export):
Remove references to the DocBook export, which has been
deleted.
(History and Acknowledgments): Mention that DocBook has been
deleted, suggest to use the Texinfo exporter instead, then to
convert the .texi to DocBook with makeinfo.
(Links in ODT export, Tables in ODT export): Fix indices.
2013-02-14 09:48:36 +01:00
Grégoire Jadi fadd2e3a32 Document the new startup keyword to preview LaTeX fragments
* doc/org.texi (Previewing @LaTeX{} fragments): Document the
startup keywords to use for previewing LaTeX fragments or not.
(Summary of in-buffer settings): Improve formatting and add an
entry for the variable `org-startup-with-latex-preview'.
2013-02-14 09:16:20 +01:00
Grégoire Jadi ac624b4d4a Update documentation of buffer-wide properties
* doc/org.texi (Property syntax): Recall the user to refresh the org
  buffer when properties are set on a per-file basis.

TINYCHANGE
2013-02-13 18:27:03 +01:00
Bastien Guerry c57b4286ed org.texi (Deadlines and scheduling): Add documentation about delays for scheduled tasks
* org.texi (Deadlines and scheduling): Add a variable to the index.
Add documentation about delays for scheduled tasks.
2013-02-13 17:47:06 +01:00
Bastien Guerry 5ab647af64 Merge branch 'maint'
Conflicts:
	doc/org.texi
2013-02-13 12:10:45 +01:00
Bastien Guerry 718b210009 Backport typo fixes from Emacs revno 111250 by Paul Eggert. 2013-02-13 12:09:56 +01:00
Bastien Guerry b05259ee9b org.texi (Emphasis and monospace): Mention `org-fontify-emphasized-text' and `org-emphasis-regexp-components'
* org.texi (Emphasis and monospace): Mention
`org-fontify-emphasized-text' and
`org-emphasis-regexp-components'.

Thanks to Roland Winkler for suggesting this.
2013-02-11 15:01:35 +01:00
Bastien Guerry 521d47b019 Merge branch 'maint' 2013-02-09 11:59:27 +01:00
Bastien Guerry 1056fc3f60 org.texi (Progress logging, Checkboxes): Fix typos
* org.texi (Progress logging, Checkboxes): Fix typos.

Thanks to Gregory Benjamin for this.
2013-02-09 11:59:17 +01:00
Bastien Guerry 8ee885cb97 org.texi (References): Small enhancement
* org.texi (References): Small enhancement.
2013-02-07 09:12:22 +01:00
Bastien Guerry e81ed15d7d Merge branch 'maint' 2013-01-30 17:46:54 +01:00
Bastien Guerry 4890bbed8c org.texi (References): Clarify an example
* org.texi (References): Clarify an example.

Thanks to Xue Fuqiao, Eric S Fraga and H. Dieter Wilhelm
for sorting this out.
2013-01-30 17:46:35 +01:00
Bastien Guerry 751e4e4202 org.texi (Column width and alignment): Make the example visually more clear
* org.texi (Column width and alignment): Make the example
visually more clear.

Thanks to Joost Helberg for suggesting this.
2013-01-26 11:47:14 +01:00
Bastien Guerry af49713a95 Merge branch 'maint' 2013-01-24 12:27:59 +01:00
Bastien Guerry d11c9acc66 org.texi (Installation): Enhance instructions again
* org.texi (Installation): Enhance instructions again.
2013-01-24 12:27:55 +01:00
Bastien Guerry a9da9c6550 Merge branch 'maint' 2013-01-23 14:58:33 +01:00
Bastien Guerry a7c0ea1a86 org.texi (Org-Plot): Update link
* org.texi (Org-Plot): Update link.

Thanks to Xue Fuqiao for reporting this.
2013-01-23 14:58:29 +01:00
Bastien Guerry e79349ad78 org.texi (Built-in table editor): Tiny enhancement
* org.texi (Checkboxes, Radio lists): Fix typos.

Thanks to Xue Fuqiao for pointing this.
2013-01-22 16:03:19 +01:00
Bastien Guerry 0aae38f8fa Merge branch 'maint' 2013-01-22 16:01:01 +01:00
Bastien Guerry ecd9a1cc21 org.texi (Checkboxes, Radio lists): Fix typos
* org.texi (Checkboxes, Radio lists): Fix typos.
2013-01-22 16:00:56 +01:00
Yasushi SHOJI 0499f0a939 org-clock.el: New option `org-clock-x11idle-program-name'
* org-clock.el (org-clock-x11idle-program-name): New option.
(org-x11idle-exists-p, org-x11-idle-seconds): Use it.

* org.texi (Resolving idle time): Document
`org-clock-x11idle-program-name'.

Debian and other OSes already have a program called 'xprintidle',
which does the same thing as x11idle. It also handles the DPMS bug[1]
some version of X servers have.

In order to use an alternative, introduce a customizable variable
'org-clock-x11idle-program-name' to hold the actual command name.

[1] http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=502226
2013-01-11 23:16:45 +01:00
Bastien Guerry 9265513c5e Merge branch 'maint' 2013-01-11 13:34:30 +01:00
Bastien Guerry d5268b051b org.texi (Installation): Simplify
* org.texi (Installation): Simplify.
2013-01-11 13:32:34 +01:00
Eric Schulte f8f5489071 mention elisp as special rowname case.
* doc/org.texi (rownames): Mention elisp as special rowname case.
2013-01-09 10:22:13 -07:00
Bastien Guerry 81959fc8c0 Merge branch 'maint' 2013-01-09 12:53:04 +01:00
François Allisson 31e765a105 org.texi: Update documentation on internal link handling
* org.texi (Handling links): Update the mention to the
obsolete variable `org-link-to-org-use-id' with a mention to
the newer variable `org-id-link-to-org-use-id'.  Mention the
need to load the org-id library.

TINYCHANGE
2013-01-09 12:52:52 +01:00
Bastien Guerry 832b6e66ea Merge branch 'maint' 2013-01-08 22:33:52 +01:00
Bastien Guerry 8c5a46c35d doc/org.texi: Update copyright year. 2013-01-08 22:33:33 +01:00
Bastien Guerry 57f4e17f99 Merge branch 'maint' 2013-01-08 16:19:39 +01:00
Bastien Guerry c8c217aa55 org.texi: Document `org-mark-element' and `org-mark-subtree'
* org.texi (Structure editing): Document `org-mark-element'
and `org-mark-subtree'.
(Tag inheritance): Document `org-agenda-use-tag-inheritance'.

Thanks to Nathaniel Cunningham for requesting this.
2013-01-08 16:19:31 +01:00
Bastien Guerry 679dce0fda Merge branch 'maint' 2013-01-08 15:26:17 +01:00
Bastien Guerry 31c1aeabae Various small fixes 2013-01-08 15:26:04 +01:00
Eric Schulte 5328e1cd02 no hline pre-processing for elisp code blocks
* doc/org.texi (hlines): Note that :hline has no effect for Emacs Lisp
  code blocks.
2013-01-07 23:38:15 -07:00
Bastien Guerry 5c8cc17d39 Merge branch 'maint' 2013-01-07 18:21:39 +01:00
Bastien Guerry 571d80dad9 org.texi (Pushing to MobileOrg): Fix footnote about the use of symbolic links in `org-directory'
* org.texi (Pushing to MobileOrg): Fix footnote about the use
of symbolic links in `org-directory'.
2013-01-07 18:21:29 +01:00
Bastien Guerry b54d6f5965 Merge branch 'maint'
Conflicts:
	lisp/org-agenda.el
	lisp/org.el
	testing/lisp/test-org-element.el
2013-01-07 16:19:37 +01:00
Bastien Guerry b27a020a83 `org-float' is now obsolete
* org-agenda.el (org-float): Don't alias `org-float'.

* org.texi (Timestamps, Deadlines and scheduling): Use
`diary-float' instead of the now obsolete alias `org-float'.

* test-org-element.el
(test-org-element/timestamp-interpreter): Ditto.
2013-01-07 13:01:36 +01:00
Bastien Guerry b43ee80cb8 Merge branch 'maint' 2013-01-06 15:10:52 +01:00
Bastien Guerry 50ba6031c4 Backport patch from revno#r111145 from the Emacs-24 branch 2013-01-06 15:05:35 +01:00
Bastien Guerry 0c75ce3034 Merge branch 'maint' 2013-01-06 14:56:50 +01:00
Bastien Guerry 76684b5606 org.texi (Pushing to MobileOrg): Mention that `org-directory' should not contain symbolic links
* org.texi (Pushing to MobileOrg): Mention that `org-directory'
should not contain symbolic links.

Thanks to James Harkins for reporting this problem.
2013-01-06 14:56:36 +01:00
Bastien Guerry 5352d9b155 Merge branch 'maint' 2013-01-06 07:40:36 +01:00
Bastien Guerry 129ecf99fa org.texi (TODO basics): Fix description of TODO keywords cycling
* org.texi (TODO basics): Add `org-use-fast-todo-selection' to
the variable index.
(TODO basics): Fix description of TODO keywords cycling.

Thanks to Brian van den Broek for reporting this.
2013-01-06 07:36:36 +01:00
Bastien Guerry 8a401f8175 Merge branch 'maint' 2013-01-06 06:17:18 +01:00
Bastien Guerry bbc9ea09e4 Revert "Backport revno#111138 from the emacs-24 branch"
This reverts commit 7fe67bb942.

Thanks to Takaaki ISHIKAWA for reporting this.
Also see http://mid.gmane.org/fkobh39l4z.fsf%40fencepost.gnu.org
2013-01-06 06:15:30 +01:00
Bastien Guerry 5217d18a7a Merge branch 'maint' 2013-01-05 18:39:48 +01:00
Bastien Guerry 7fe67bb942 Backport revno#111138 from the emacs-24 branch
* org.texi (Advanced features): Add missing argument for @item.
(Property searches): Use @backslashchar{} in macro argument.
2013-01-05 18:39:40 +01:00
Bastien Guerry 576f43b743 Merge branch 'maint' 2013-01-04 17:23:27 +01:00
Bastien Guerry 5e17a990f5 org.texi (Storing searches): Add index entries and a note about {*-tree} agenda views
* org.texi (Storing searches): Add index entries and a note
about {*-tree} agenda views.

Thanks to Alan Schmitt for indirectly pointing at this doc problem.
2013-01-04 17:14:25 +01:00
Michael Brand a77442b37b Use nan for empty fields in Calc formulas
* doc/org.texi (Formula syntax for Calc): Add explanation and example
for empty field.
* lisp/org-table.el (org-table-eval-formula): Use `keep-empty' in more
places.
(org-table-make-reference): Use nan (not a number) for empty fields in
Calc formulas.
* testing/lisp/test-org-table.el: Adapt expected for several
ert-deftest.
(test-org-table/empty-field): New examples dealing with empty fields.
(test-org-table/copy-field): New ert-deftest with examples dealing with
empty fields.

This makes it possible to write spreadsheet Calc formulas that check
for empty fields:  To sum the first two columns unless one or both
empty:
$3 = if("$1" = "nan" || "$2" = "nan", string(""), $1 + $2); E
2012-12-29 14:33:52 +01:00
Michael Brand f5dd9a8a7a Add ERTs for basic spreadsheet functionality
* doc/org.texi (Formula syntax for Calc): Extend explanations of
format specifiers.
* testing/lisp/test-org-table.el: Various new ert-deftest, mark with
TODO what needs to be fixed.
2012-12-29 14:33:52 +01:00
Bastien Guerry 0bca49801e org-clock.el: Implement a new parameter :wstart to define the week start day
* org-clock.el (org-clock-special-range): New parameter
'weekstart to define the week start day.
(org-clock-special-range, org-dblock-write:clocktable)
(org-dblock-write:clocktable, )
(org-clocktable-write-default, org-clocktable-steps)
(org-clock-get-table-data): Use the new parameter.
(org-clocktable-defaults): Set monday as the starting day of
the week by setting :wstart to 1.

* org.texi (The clock table): Document :wstart as a way to set
the starting day of the week.

Thanks to Raghavendra D Prabhu for suggesting this feature.
2012-12-29 12:35:18 +01:00
Bastien Guerry 5fa52d9a93 org.el: Add new startup keywords
* org.el (org-startup-options): New startup keywords.
(org-log-into-drawer): Update docstring to explain how to set this
variable through the startup keyword "logdrawer" and "nologdrawer".
(org-log-states-order-reversed): Document the new startup keywords
"logstatesreversed" and "nologstatesreversed".

* org.texi (In-buffer settings): Document new startup keywords.
Thanks to John J Foerch for this idea.
2012-12-23 18:51:24 +01:00
Bastien Guerry e815ab5f8e Merge branch 'master-fixes' 2012-12-23 00:34:49 +01:00
Bastien Guerry b6eede54b2 Merge branch 'maint' 2012-12-23 00:34:42 +01:00
Bastien Guerry c846f024c1 Fix more instances of missing dashes. 2012-12-22 23:29:03 +01:00
Bastien Guerry 6e1521f13b org.texi and orgguide.texi: Hyphen and dash fixes.
See revno 111060 by Paul Eggert from the emacs-24 bzr branch.
2012-12-22 21:30:27 +01:00
Bastien Guerry 5987fd5f08 org.texi (Include files): Tiny formatting fix
* org.texi (Include files): Tiny formatting fix.
2012-12-22 19:49:00 +01:00
Bastien Guerry beea46fab5 Merge branch 'maint' 2012-12-15 06:39:42 +01:00
Bastien Guerry 0b44eb6961 Add doclicense.texi to include the GNU FDL license and fix the copyright notice.
The GNU FDLv1.3 is now included in both the manual and the guide.
The Back-Cover Texts does not mention that you can buy copies from
the FSF as this is not true.
2012-12-15 06:39:33 +01:00
Bastien Guerry 6af6e957df Merge branch 'maint' 2012-12-14 11:35:57 +01:00
Bastien Guerry cd249629de org.texi: Update copyright notice.
There are no invariant sections and no cover texts.

See http://www.gnu.org/prep/maintain/html_node/License-Notices-for-Documentation.html
for details on why we don't need invariant sections and cover texts.
2012-12-14 11:35:45 +01:00
Bastien Guerry 31d24aa213 Merge branch 'maint' 2012-12-13 11:58:54 +01:00
Bastien Guerry 82db0aab3b org.texi: Fix typos. 2012-12-13 11:58:42 +01:00
Bastien Guerry 47ea16660e Merge branch 'maint' 2012-12-12 10:14:59 +01:00
Bastien Guerry 1c13115780 org.texi: Small reformatting.
* org.texi (Summary, Code block specific header arguments)
(Code block specific header arguments)
(Header arguments in function calls, var, noweb)
(Results of evaluation, Code evaluation security): Small
reformatting: add a blank line before some example.
2012-12-12 08:54:30 +01:00
Bastien Guerry 7abad97db7 org.texi: Fix indendation of Elisp code examples.
* org.texi (System-wide header arguments)
(Header arguments in Org mode properties, Conflicts)
(Dynamic blocks, Using the mapping API): Fix indendation of
Elisp code examples.
2012-12-12 08:50:00 +01:00
Bastien Guerry 48703624d5 Merge branch 'maint'
Conflicts:
	doc/org.texi
2012-12-09 23:48:29 +01:00
Bastien Guerry e5ea08f01b doc/org.texi: Fix minor whitespace issues after "." in manual.
See revno: 110998 by Paul Eggert in Emacs repo.

revno: 110998
fixes bug: http://debbugs.gnu.org/12973
committer: Paul Eggert <eggert@cs.ucla.edu>
branch nick: emacs-24
timestamp: Wed 2012-12-05 14:27:56 -0800
message: Fix minor whitespace issues after "." in manual.
2012-12-09 23:46:25 +01:00
Ivan Vilata i Balaguer 513507ee74 Allow relative times in clocktable tstart and tend options
* lisp/org-clock.el (org-clock-get-table-data): Pass tstart and tend
time strings through `org-matcher-time' to allow relative times besides
absolute ones, convert result to encoded time.
* doc/org.texi (The clock table): Document acceptance of relative times
in tstart and tend, link to syntax description and provide example.

Inspired in the original relative times proposal by Ilya Shlyakhter,
this is less invasive and it doesn't modify core functions, thus it
avoids the original's infinite recursion when hitting normal dates in
other locations.

TINYCHANGE
2012-11-30 16:07:13 +01:00
Ryo TAKAISHI fb143b6787 org-capture: Expand keywords within %(sexp) placeholder in template
* lisp/org-capture.el: (org-capture--expand-keyword-in-embedded-elisp): New function.
(org-capture-expand-embedded-elisp): Use new function.
2012-11-05 01:29:25 +01:00
Bastien Guerry 70e4a89a5d Merge branch 'maint' 2012-10-27 21:44:21 +02:00
Bastien Guerry 4aa416876b org.texi (Comment lines): Fix description of the comment syntax
* org.texi (Comment lines): Fix description of the comment
syntax.

Thanks to Rafael Laboissiere for reporting this.
2012-10-27 21:44:09 +02:00
Bastien Guerry 4c3527d2e6 Merge branch 'maint' 2012-10-27 09:08:35 +02:00
Bastien Guerry 1fe4e9ecc7 org.texi (Installation): Mention "make test" in the correct section
* org.texi (Installation): Mention "make test" in the correct
section.

Thanks to Uvius for reporting this problem.
2012-10-27 09:08:28 +02:00
Bastien Guerry acbbe2d5b2 Fix typo in refcard and whitespaces in org.texi. 2012-10-26 15:59:06 +02:00
Bastien Guerry 66cc45e670 org.texi: Delete trailing whitespaces. 2012-10-24 15:00:27 +02:00
Jarmo Hurri e375cfd834 Table lookup functions
* lisp/org-table.el: added macro org-define-lookup-function and the
calls to this macro that generate the lookup functions
org-lookup-first, org-lookup-last and org-lookup-all
* doc/org.texi: documented lookup functions
2012-10-24 14:59:33 +02:00
Nicolas Goaziou a67ed0f59d Merge branch 'maint' 2012-10-15 21:33:44 +02:00