Commit Graph

1159 Commits

Author SHA1 Message Date
Carsten Dominik d6aba4db77 Fix braces bug in manual. 2011-05-11 12:33:41 +02:00
Manuel Giraud d90f1c29b4 Document Sitemap sans extension
* doc/org.texi (Sitemap): Document `:sitemap-sans-extension' property.
2011-05-11 10:18:59 +02:00
Carsten Dominik bffdfeb7fc Implement a minor mode for the editor following the cursor through the table
* doc/org.texi (Built-in table editor): Document the table field follow mode.
* lisp/org-table.el (org-table-exit-follow-field-mode-when-leaving-table):
New option.
(org-table-check-inside-data-field): New optional argument `noerror'.
When set, the function will only return nil instead of throwing an
error.
(org-table-edit-field): Interpret double prefix argument, and improve
the properties of the editing window.
(org-table-follow-field-mode): New minor mode.
(org-table-follow-fields-with-editor): New function.

The main purpose of this functionality is to make working with table
with long fields simpler, by always showing the full content of the
current field.  This functionality is based on the following
mailing list thread

http://thread.gmane.org/gmane.emacs.orgmode/41584

and contains ideas by Jonny, Juan Pechiar, and Michael Brand.
2011-05-11 10:11:45 +02:00
Thomas S. Dye cd05598dcd Optional \caption argument for LaTeX export
Aloha all,

The attached patch initializes the existing variable shortn, adds it to
two caption situations in addition to the one already coded, and adds
some description to the manual.

With this patch, #+CAPTION: [Short caption]{Long caption.} in the
Org-mode source exports to \caption[Short caption]{Long caption.} in the
LaTeX export, which is, I think, as it should be.

Many thanks to Nick Dokos who made me understand why earlier patches
hadn't shown up on the patchwork server (wrong mime type, evil mail
client).  This one sent with gnus and fingers crossed.

All the best,
Tom

>From 9dc65f7e598dd171ebce9448cd39c4062f7cafff Mon Sep 17 00:00:00 2001
From: Tom Dye <tsd@tsdye.com>
Date: Sun, 8 May 2011 06:56:25 -1000
Subject: [PATCH] optional caption arguments in LaTeX export
2011-05-08 22:15:45 +02:00
Carsten Dominik eb2a890f10 Minor fix in manual 2011-05-06 17:34:51 +02:00
Tom Dye b45bef8ffa Refer to language specific Babel header arguments 2011-05-05 14:53:20 -06:00
Carsten Dominik e98237927f Document the capture property :table-line-pos 2011-05-05 09:58:31 +02:00
Robert P. Goldman 62c12cc50f Add an easy template for index (i)
* lisp/org.el (org-structure-template-alist):  Add an easy template
for index (i), and move include file to I from i.
* doc/org.texi (Easy Templates): Document new template.

Notes about this patch:
1.  It breaks some old user-visible behavior, since <i changes meaning.
    Per Nick's posting, we expect that if index is used, it will be used
    more commonly than include file.  However, since this is a custom,
    behavior could be changed.  Indeed, we could put index on capital
    I with a suggestion that users who are indexing should swap in their
    customizations.
2.  I modified the docstring for org-structure-template-alist, which did
    not explain the function of the "?" in the string.  Someone should
    check and verify I didn't get this wrong.
3.  There doesn't seem to be a Muse tag equivalent for #+index, so I
    just made the Muse equivalent of #+index be #+index.  I don't know
    org-mtags enough to know if this is appropriate.
2011-05-04 09:49:31 +02:00
Robert P. Goldman a8b6fa0bf3 Add a cross-reference from "Literal Examples" to "Easy Templates."
* doc/org.texi (Literal examples): Add a cross-reference
from "Literal Examples" to "Easy Templates."

Easy templates are especially useful for entering the begin and end pairs
that arise in supplying literal examples.
2011-05-02 11:17:45 +02:00
Carsten Dominik 7bab535b79 Add a link to documentation
* doc/org.texi (The clock table): Add link to match syntax.
2011-05-02 09:10:50 +02:00
Carsten Dominik 02441ed433 Implement clock consistency check functionality for agenda
* lisp/org-agenda.el (org-agenda-clock-consistency-checks): New option.
(org-agenda-list): Handle display change to clock check.
(org-agenda-get-progress): Show only clock entries if we are doing the
consistency check.
(org-agenda-show-clocking-issues): New function.
(org-agenda-check-clock-gap): New function.
(org-agenda-view-mode-dispatch): Offer consistency check.
(org-agenda-log-mode): Handle switch to clock only display.
(org-agenda-set-mode-name): Show lighter for Clockcheck.
* lisp/org.el (org-hh:mm-string-to-minutes): Accept an integer argument
and return it unchanged.
* doc/org.texi (Agenda commands): Document clock consistency checks.
* doc/orgcard.tex: Document key for clock consistency check.
2011-04-24 17:17:25 +02:00
Robert P. Goldman a285debf5c Fixed shell script example in "Emacs Lisp evaluation of variables."
The variable names in the header arguments and in the sh code didn't line
up.  Made them agree.
2011-04-22 08:06:26 -06:00
Bastien Guerry 6f2113b85c doc/org.texi: Fix typo.
Thanks to Xiao-Yong Jin for pointing this out.
2011-04-19 11:23:55 +02:00
Carsten Dominik 89de03cb8e Document the use of \vert in table fields
* doc/org.texi (Built-in table editor): Document that \vert represents
a vertical bar in a table field.
2011-04-17 16:41:40 +02:00
Carsten Dominik b99ab9250b Fix typo 2011-04-14 05:50:55 +02:00
Carsten Dominik b58db4e438 Add missing brace 2011-04-14 04:50:25 +02:00
Carsten Dominik e20166eb29 Fix the bulk scatter command to always schedule
* lisp/org-agenda.el (org-agenda-bulk-action): Allow bulk scatter
in all possible agenda views.  Use `org-agenda-schedule' instead of
`org-agenda-date-later'.

The bulk scatter command so far shifted the date that was causing an
entry to appear in the agenda.  However, the true intend was to
reschedule onto dates in the near future.  This patch fixes this
issue.  A side effect is that you can now bulk scatter tasks that to
not yet have a date, for example also tasks picked from the TODO
list.
2011-04-14 00:10:56 +02:00
Bastien Guerry 97ae094960 Merge branch 'master' of orgmode.org:org-mode 2011-04-09 09:24:41 +02:00
Eric Schulte 9fc5577646 doc: link from markup->literate-examples to working-with-source-code
* doc/org.texi (Literal examples): Link from "Markup" > "Literate
  Examples" to "Working with Source Code"
2011-04-08 15:54:54 -06:00
Puneeth Chaganti c717044a7c * doc/org.texi (Agenda commands): Doc for function option to bulk action. 2011-04-08 19:21:33 +02:00
Bastien Guerry a92aaf4db0 doc/org.texi: minor update.
Document `org-agenda-append-agenda' and `org-agenda-bulk-mark-regexp'.
2011-04-08 18:32:20 +02:00
Carsten Dominik 8a831e8f6c Introduce a new org-capture escape for arbitrarily defined time strings
* lisp/org-capture.el (org-capture-fill-template): Resolve new %<...>
template escape.
(org-capture-templates): Document new %<...> template escape.
* doc/org.texi (Template expansion): Document new %<...> template escape.
2011-04-06 08:49:12 +02:00
Nicolas Goaziou 346ef1f65f small documentation fix on checkboxes 2011-04-02 17:27:32 +02:00
Carsten Dominik 57c379bb26 Clean up the new options to remove tasks on export 2011-03-30 05:27:43 +02:00
Carsten Dominik b4e2ef4cb9 Allow to exclude tasks from being exported
* doc/org.texi (Selective export): Document exclusion of any tasks from
export.
* lisp/org-exp.el (org-export-with-tasks): New option.
(org-export-plist-vars): Add :tasks property.
2011-03-30 00:48:29 +02:00
Carsten Dominik 6d40eb3809 Implement export without DONE tasks
* doc/org.texi (Selective export): Document how to exclude DONE tasks
from export.
(Publishing options): Document the properties to be used to turn off
export of DONE tasks.
* lisp/org-ascii.el (org-export-as-ascii):
* lisp/org-docbook.el (org-export-as-docbook):
* lisp/org-html.el (org-export-as-html):
* lisp/org-latex.el (org-export-as-latex): Pass the :done-tasks property
to the export preprocessor.
* lisp/org-exp.el (org-export-with-done-tasks): New option.
(org-export-plist-vars): Add entry for :done-tasks.
(org-export-preprocess-string): Call `org-export-remove-done-tasks'.
(org-export-remove-done-tasks): New function.
2011-03-29 17:29:24 +02:00
Carsten Dominik 3dd4745752 Tables: Make @< and $< point to row/column 1 in a stable way 2011-03-17 06:50:39 +01:00
Carsten Dominik f4387417c4 Improve handling of years with limitations on representable dates
* lisp/org.el (org-read-date-force-compatible-dates): New option.
(org-read-date, org-read-date-analyze): Check representable date range.
* doc/org.texi (The date/time prompt): Document date range protection.

New variable `org-read-date-force-compatible-dates' to control
handling of dates.
2011-03-15 20:01:33 +01:00
Eric Schulte d0a4ed53f1 ob: new header argument `padline' controls newline padding around tangled code
* lisp/ob-tangle.el (org-babel-spec-to-string): Check value of padline
  on tangling, no longer use the now-removed variable
  `org-babel-tangle-pad-newline'.
* lisp/ob.el (org-babel-header-arg-names): Add padline to the list of
  header argument names.
  (org-babel-default-header-args): Set the default value of padline to
  "yes".
  (org-babel-merge-params): Cleaned up the merge logic, added padline.
* doc/org.texi (padline): Documentation of the new padline header
  argument.
2011-03-15 11:16:09 -06:00
Bastien Guerry fa37f767c9 doc/org.texi: Update on HTML preamble and postamble. 2011-03-15 16:18:23 +01:00
emacs 11a10bdfe7 Update website to show 7.5 as current release 2011-03-07 14:27:39 +00:00
Bastien Guerry 54c638523d org-capture.el: Rename :no-clock-out to :clock-keep.
(org-capture-templates): Rename :no-clock-out to :clock-keep.
(org-capture): Use :clock-keep instead of :no-clock-out.

Thanks to Bernt Hansen for the suggestion.
2011-03-07 15:21:13 +01:00
Bastien Guerry b969081ebd org-capture.el: new :no-clock-out template option.
* org-capture.el (org-capture-templates): New option
:no-clock-out.
(org-capture): Use the new option.

* org.texi (Template elements): document the new template
option :no-clock-out.
2011-03-07 11:43:58 +01:00
Nicolas Goaziou a93f576033 Documentation fixes 2011-03-06 20:19:15 +01:00
Bastien Guerry 145d1bf7e5 org.texi: use "x" as a key for the org-capture example.
"\C-cc" is already the recommended key for org-capture.
2011-03-06 18:23:18 +01:00
Bastien Guerry 6238e18a71 org.texi: fix typo about defining an org-capture key. 2011-03-06 18:22:13 +01:00
Bastien Guerry 030960559e org-capture.el: remove (currentfile) as a file specification in templates.
You can already use a function like (buffer-file-name) to get the currently
visited file.  So (currentfile) is not necessary.
2011-03-06 17:31:56 +01:00
Nick Dokos 18c1bcf645 typo in org.texi
Nick
2011-03-05 01:46:06 +01:00
Bastien Guerry 5953798522 Clean handling :html-pre/postamble options wrt author/email/creator-info.
* org-html.el (org-export-html-preamble)
(org-export-html-postamble): now default to `nil'.
(org-export-as-html): when :html-pre/postamble is nil, fall
back on the default pre/postamble, which depends on the
:author-info, :email-info, :creator-info options.

* org-exp.el (org-export-plist-vars): reorder the alist.

* org.texi (Export options): better document :html-preamble
and :html-postamble: setting these options will override any
:author-info, :email-info and :creator-info options for the
HTML export.
2011-03-04 16:32:10 +01:00
Carsten Dominik 236cdb292a Document the change of the default value `org-table-use-standard-references' 2011-03-03 22:16:35 +01:00
Carsten Dominik 5631a309ab Use @> and $> for referring to last row and column 2011-03-03 22:16:35 +01:00
Bastien Guerry c431fef47a doc/org.texi: tell where Org put SCHEDULED and DEADLINE.
Org puts this information on the line right after the headline.
If the user adds information between this line and the headline,
especially timestamps, then Org might be confused.  Ask the user
not to put information there.
2011-03-03 12:21:25 +01:00
Carsten Dominik 8237c9ae6d Implement table formulas that apply to field ranges, fix minor issues
* lisp/org-table.el (org-table-fedit-finish): Read more general LHS of formulas.
(org-table-formula-handle-@L): New function to hanle @L references.
(org-table-current-ncol): New variable.
(org-table-line-to-dline): New function.
(org-table-get-stored-formulas): Accept range formulas as matches.
(org-table-get-specials): Compute and store the number of columns.
(org-table-get-range): New optional argument CORNERS-ONLY, to retrieve
only the region marked by the range, not the content.
(org-table-recalculate): Call `org-table-expand-lhs-ranges' to expand
range targets.  Also check for duplicate access to fields.
(org-table-expand-lhs-ranges): New funktion.
(org-table-get-remote-range): Bind `org-table-current-ncol' to protect
the caller's value.
(org-table-edit-formulas): Support highlighting of range targets.
(org-table-field-info): Handle renge formulas.

* doc/org.texi (Field and range formulas): Renamed from "Field formulas".
Document the use of range operators as targets.
(References): Document the new @L reference.
2011-03-02 18:32:19 +01:00
Eric Schulte c6fd3f1a8b doc: adding "[" to list of characters triggering elisp evaluation
* doc/org.texi (var): Adding "[" to list of characters triggering
  elisp evaluation.
2011-03-02 07:50:57 -07:00
Eric Schulte 41550be424 doc: documentation of Emacs Lisp evaluation during variable assignment
* doc/org.texi (var): Documentation of Emacs Lisp evaluation during
  variable assignment.
2011-03-01 09:57:54 -07:00
Eric Schulte 280d5826c3 doc: add references from :colnames and :rownames to indexing into variables
* doc/org.texi (colnames): Reference indexing into variables, and note
  that colnames are *not* removed before indexing occurs.
  (rownames): Reference indexing into variables, and note that
  rownames are *not* removed before indexing occurs.
2011-02-27 21:01:59 -07:00
Eric Schulte b02ada7cd0 doc: clarification of indexing into tabular variables
* doc/org.texi (var): Clarification of indexing into tabular
  variables.
2011-02-27 17:23:12 -07:00
Eric Schulte 1d1654896e doc: documentation of the `:results wrap' header argument
* doc/org.texi (results): Documentation of the `:results wrap' header
  argument.
2011-02-27 12:58:54 -07:00
Bastien Guerry 67a7ba3ea3 doc/org.texi: Note about a limitation of the LaTeX exporter.
* org.texi (LaTeX and PDF export): add a note about a
limitation of the LaTeX export: the org file has to be
properly structured.
2011-02-26 17:35:24 +01:00
Carsten Dominik c654620d73 Allow file names in capture templates to be functions, forms, or variables
* lisp/org-capture.el (org-capture-expand-file): New function.
(org-capture-target-buffer):
(org-capture-set-target-location): Use `org-capture-expand-file'.

* doc/org.texi (Template elements): Document that files can be given
as function, form, or variable.
2011-02-22 10:10:22 +01:00