Commit Graph

1561 Commits

Author SHA1 Message Date
Nicolas Goaziou 40f390574c org.texi: Update internal links documentation
* doc/org.texi (Internal links): Document #+NAME keyword and
  cross-referencing during export.
* doc/orgguide.texi (Internal links): Add a note about
  cross-referencing.
2013-04-07 01:21:43 +02:00
Nicolas Goaziou 0ed17115a1 org.texi: Update documentation about included files
* doc/org.texi (Include files): Remove reference to :prefix1
  and :prefix.  Give more details for :minlevel.
2013-04-07 00:14:55 +02:00
Bastien Guerry 5fc6764c1f org.texi (System-wide header arguments): Don't use "customizing" for setting a variable
* org.texi (System-wide header arguments): Don't use
"customizing" for setting a variable.  Also remove comments.

Thanks to Andreas Röhler for reporting this.
2013-04-05 20:08:16 +02:00
Vladimir Lomov 29a75d0473 org.texi: Fix typo introduced in cf5e96
TINYCHANGE
2013-04-05 11:31:36 +02:00
Ippei FURUHASHI bd8ff1aade doc/org.texi: Document applying current TBLFM to table
* org.texi (Editing and debugging formulas): Add an example
when a table has multiple #+TBLFM lines.
2013-04-05 08:37:51 +02:00
Eric Schulte cf5e96c8e1 documentation of the new :post header argument
* doc/org.texi (post): Documentation and an example of usage.
2013-04-04 06:41:56 -06:00
Bastien Guerry 0066737092 org-agenda.el: Minor typo fix and docstring enhancement
* org-agenda.el (org-agenda-start-on-weekday): Fix typo.
(org-agenda-start-day): Enhance docstring.

* org.texi (Weekly/daily agenda): Add `org-agenda-start-day'
and `org-agenda-start-on-weekday' to the variable index and
document them.
2013-04-03 18:28:30 +02:00
Eric Schulte 81d354b6c3 simplify the discussion of :var causing execution 2013-04-03 09:17:34 -06:00
Aaron Ecay 09e52738e9 Document how :var introduces code block dependencies.
* doc/org.texi: Document how :var introduces code block dependencies.
2013-04-03 09:17:26 -06:00
Eric Schulte 2f39a704cf removing alternate code block variable syntax
* doc/org.texi (var): Remove the "Alternate argument syntax" section
  from the documentation.
* lisp/ob-core.el (org-babel-src-name-w-name-regexp): Update the regexp
  used to match code block names.
  (org-babel-get-src-block-info): Remove the code used to parse this
  alternate variable specification syntax.
2013-04-03 09:17:00 -06:00
Nicolas Goaziou 60170dfe3b org.texi: Small fixes 2013-03-27 22:55:45 +01:00
Nicolas Goaziou 32b89c0b09 org.texi: Fix typo
* doc/org.texi (Table of contents): Fix typo.
2013-03-27 17:38:18 +01:00
Bastien Guerry 44b218d2d7 doc/org.texi: Fix typo in 225289 2013-03-25 12:13:19 +01:00
Bastien Guerry 78959943e2 Merge branch 'master-group-tags2' 2013-03-25 06:59:23 +01:00
Bastien Guerry 225289c2db doc/org.texi: Reflect changes from the new export engine
* org.texi (Sparse trees, Agenda commands)
(@LaTeX{} fragments, Selective export, Export options)
(Export options, Export options, The export dispatcher)
(ASCII/Latin-1/UTF-8 export, ASCII/Latin-1/UTF-8 export)
(HTML Export commands, HTML Export commands)
(@LaTeX{}/PDF export commands, @LaTeX{}/PDF export commands)
(ODT export commands, ODT export commands, iCalendar export)
(Publishing options, Publishing options)
(Triggering publication, In-buffer settings): Update to
reflect changes from the new export engine.
2013-03-25 05:41:59 +01:00
Bastien Guerry 7f2f845700 orgguide.texi (Tag searches): New section
* orgguide.texi (Tag searches): New section.
2013-03-25 05:41:59 +01:00
Bastien Guerry 2c9d486740 org.texi (Matching tags and properties): Explain group tags expansion as regular expressions
* org.texi (Matching tags and properties): More examples.
Explain group tags expansion as regular expressions.
2013-03-25 05:41:59 +01:00
Bastien Guerry a7fd28b4b6 org.texi (Tag groups): New section
* org.texi (Tag groups): New section.
2013-03-25 05:41:59 +01:00
Bastien Guerry 63f22cb4bc org.texi (Setting tags): Tiny formatting fixes
* org.texi (Setting tags): Tiny formatting fixes.
2013-03-25 05:41:58 +01:00
Nicolas Goaziou 42e1a6351d org-element: Allow to escape escaping character before a comma
* lisp/org-element.el (org-element-macro-parser): Allow to escape
  escaping character before a comma.  Also do not trim spaces at
  argument boundaries.
* doc/org.texi (Macro replacement): Update documentation about
  possible locations and escaping mechanism.
* testing/lisp/test-org-element.el: Add tests.

With this patch, macro's arguments are read as the following:

  "a,b"     -> '("a" "b")
  "a\,b"    -> '("a,b")
  "a\\,b"   -> '("a\" "b")
  "a\\\,b"  -> '("a\,b")
  "a\\\\,b" -> '(a"\\" "b")

Note that with the patch, you only need to escape backslashes before
a comma:

  "a\\b\,c" -> '("a\\b,c")
2013-03-23 20:42:34 +01:00
Bastien Guerry f373bca58b Rename some list variables
* org-element.el (org-element-paragraph-separate): Use
new name `org-list-allow-alphabetical'.

* org-list.el (org-list-allow-alphabetical): Rename from
`org-alphabetical-lists'.
(org-list-empty-line-terminates-plain-lists): Rename from
`org-empty-line-terminates-plain-lists'.
(org-checkbox-hierarchical-statistics): Rename from
`org-hierarchical-checkbox-statistics'.

* org.texi (Plain lists, Checkboxes): Use non-obsolete
variable names.
2013-03-23 17:45:15 +01:00
Bastien Guerry 6ae1718df5 org-clock.el: New :mstart parameter for clocktables
* doc/org.texi (The clock table): Document :mstart.

* lisp/org-clock.el (org-clocktable-defaults): Add :mstart
parameter.
(org-clock-special-range): New argument mstart.
(org-dblock-write:clocktable, org-dblock-write:clocktable)
(org-clocktable-write-default, org-clocktable-steps)
(org-clock-get-table-data): Handle the :mstart parameter.

Thanks to Peder Stray for coming up with this idea and for
proposing a first implementation.
2013-03-15 11:17:12 +01:00
Bastien Guerry 11f1c56e94 doc/org.texi: Document the "agenda*" agenda view
* doc/org.texi (Storing searches): Add "agenda" and "agenda*" to
the concept index.  Include example for these agenda views.
(Special agenda views): Mention the "agenda*" agenda view.
2013-03-13 19:53:07 +01:00
Bastien Guerry c1e437bbe9 org-agenda.el: Implement agenda filtering by regexp with "|"
* org-faces.el (org-agenda-filter-tags)
(org-agenda-diary, org-agenda-calendar-event)
(org-agenda-calendar-sexp): Minor code clean up.
(org-agenda-filter-category): Docstring fix.
(org-agenda-filter-category): New face.

* org-agenda.el (org-agenda-local-vars): Add
`org-agenda-re-filter-overlays' and `org-agenda-regexp-filter'.
(org-agenda-mode-map): Use "|" for
`org-agenda-filtered-by-regexp'.
(org-agenda-re-filter-overlays): New variable.
(org-agenda-mark-filtered-text): Use
`org-agenda-re-filter-overlays'.
(org-agenda-finalize, org-agenda-redo): Allow regexp filtering.
(org-agenda-filter-by-category): Set `org-agenda-category-filter'
here instead of within `org-agenda-apply-filter'.
(org-agenda-regexp-filter): New variable.
(org-agenda-filter-by-regexp): New function to filter agenda
buffers by regexp.
(org-agenda-filter-make-matcher): Make matcher for regexp filters.
(org-agenda-filter-apply): Don't set `org-agenda-tag-filter' and
`org-agenda-category-filter'.  Maybe apply regexp filter.
(org-agenda-filter-hide-line): Add docstring.  Hide
regexp-filtered lines.
(org-agenda-filter-show-all-tag, org-agenda-filter-show-all-cat):
Add docstring.
(org-agenda-filter-show-all-regexp): New function.
(org-agenda-set-mode-name): Add regexp-filter information.
(org-agenda-custom-commands-local-options): Add regexp filter.
(org-agenda-regexp-filter-preset): New variable.
(org-agenda-prepare): Use the new variable.

* org.texi (Agenda commands): Document `org-agenda-filter-by-regexp'.
2013-03-13 19:26:41 +01:00
Bastien Guerry b5a8538232 doc/org.texi (Repeated tasks): Document how to ignore a repeater when using both a scheduled and a deadline timetamp
* doc/org.texi (Repeated tasks): Document how to ignore a repeater
when using both a scheduled and a deadline timetamp.
2013-03-12 19:07:40 +01:00
Bastien Guerry 36a09801a3 doc/org.texi: (Initial visibility, Catching invisible edits): New subsections
* doc/org.texi (Global and local cycling): Wrap in a new subsection.
(Initial visibility, Catching invisible edits): New subsections.
2013-03-12 13:05:35 +01:00
Bastien Guerry 8f2baafa89 doc/org.texi: Start some tables after a blank line 2013-03-12 12:51:11 +01:00
Bastien Guerry 7235e92d6c doc/org.texi (Visibility cycling): Mention `org-agenda-inhibit-startup' in a footnote
* doc/org.texi (Visibility cycling): Mention that
`org-agenda-inhibit-startup' will prevent visibility setting when
the agenda opens an Org file for the first time.
2013-03-12 12:46:51 +01:00
Bastien Guerry 03f2b130c0 doc/org.texi (Org syntax): New section
* doc/org.texi (Org syntax): New section.
2013-03-12 12:40:23 +01:00
Bastien Guerry 975329f904 doc/org.texi (Orgstruct mode): Document `orgstruct-heading-prefix-regexp'
* doc/org.texi (Orgstruct mode): Document
`orgstruct-heading-prefix-regexp'.
2013-03-12 12:20:13 +01:00
Bastien Guerry dce08205fa org.texi (Speeding up your agendas): New section
* org.texi (Speeding up your agendas): New section.
2013-03-11 23:04:34 +01:00
Bastien Guerry 7a6a4fc697 org.texi (Top, Summary, Exporting): Fix typos
* org.texi (Top, Summary, Exporting): Fix typos.
2013-03-08 17:13:19 +01:00
Bastien Guerry 7ac698c867 org.texi (Installation): Detail instructions when installing through ELPA
* org.texi (Installation): When installing Org from ELPA, users
should do this from an Emacs session where no .org file has been
visited.
2013-03-08 16:52:59 +01:00
Bastien Guerry 72879342d8 org.texi (History and Acknowledgments): Mention that Jambunathan rewrote the HTML exporter
* org.texi (History and Acknowledgments): Mention that Jambunathan
rewrote the HTML exporter.
2013-03-08 07:45:30 +01:00
Bastien Guerry b7c7764188 org.texi (History and Acknowledgments): Remove Jambunathan from my own acknowledgments
* org.texi (History and Acknowledgments): Remove Jambunathan from
my own acknowledgments.
2013-03-06 23:41:21 +01:00
Bastien Guerry 516f0df844 Update HTML options names in the manual and ox-html.el.
* org.texi (CSS support): (In-buffer settings): Update HTML options
names.

* ox-html.el (html): Update HTML options names.
2013-03-04 17:56:37 +01:00
Bastien Guerry fac8191daf Various fixes related to `org-insert-heading'.
* org.el (org-previous-line-empty-p): New parameter to allow
checking next line.  Add a docstring.
(org-insert-heading): Handle two universal prefix arguments as
advertized in the docstring.  Don't insert new lines when
creating a heading after the first heading in the current
subtree.
(org-insert-heading-respect-content): New optional argument
arg, passed to `org-insert-heading'.

* org.texi (Structure editing): Update documentation for
`org-insert-heading-or-item'.
(Plain lists, Relative timer): Update index entry.

* org-mobile.el (org-mobile-edit): Use correct parameters for
`org-insert-heading-respect-content'.
2013-03-03 13:38:26 +01:00
Bastien Guerry 1dfc45554a Merge ox-infojs.el into ox-html.el
* org-pcomplete.el
(pcomplete/org-mode/file-option/infojs_opt): Use
`org-html-infojs-opts-table'.

* ox-html.el (org-html-infojs-opts-table):
(org-html-use-infojs, org-html-infojs-options)
(org-html-infojs-template): Move from ox-jsinfo.el.
Rename using the org-html- prefix.
(org-html-infojs-install-script): Move from ox-infojs.el.

* ox-infojs.el: Delete.

* org.texi (JavaScript support): Update variable names.
2013-03-01 14:26:55 +01:00
Bastien Guerry f9cc5e72d9 org.texi (comments): Minor formatting fix
* org.texi (comments): Minor formatting fix.
2013-02-28 10:18:14 +01:00
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