Commit Graph

1116 Commits

Author SHA1 Message Date
Eric Schulte 6b5953818b doc: fixes to "yasnippet" sub-section in Conflicts
* doc/org.texi (Conflicts): Changed "yasnippets" to "yasnippet" and
  added extra whitespace around functions to be consistent with the
  rest of the section.
2011-01-14 06:30:36 -07:00
Carsten Dominik a2ec41c79a Implement a global skipping condition
* lisp/org-agenda.el (org-agenda-skip-function-global): New option.
(org-agenda-skip-eval): New function.
(org-agenda-skip): Use `org-agenda-skip-eval' and also check for the
global skipping condition.

This was a request by John Wiegley
2011-01-14 11:28:41 +01:00
Eric Schulte ca0e61d784 doc: improved documentation of optional #+call: line header arguments
* doc/org.texi (Evaluating code blocks):  Expanded discussion of
  #+call: line syntax.
  (Header arguments in function calls):  Expanded discussion of #+call:
  line syntax.
2011-01-11 17:51:45 -07:00
Eric Schulte b092d31d68 doc: passing variables to #+call: lines
* doc/org.texi (Evaluating code blocks): More explicit about how to
  pass variables to #+call lines.
2011-01-11 17:32:51 -07:00
Eric Schulte 9318030ba3 doc: link to 14.8.2 from 14.9 -- Thanks to Leo Alekseyev for suggesting
* doc/org.texi (Results of evaluation): Link to the :results header
  argument list from the "Results of evaluation" section.
2011-01-11 10:34:19 -07:00
Eric Schulte 59773dbef8 doc: additional information about resolving org-mode/yasnippet conflicts
Thanks to Jeff Horn for compiling this patch.

* doc/org.texi (Conflicts): Adding additional information about
  resolving org/yasnippet conflicts
2011-01-11 10:18:48 -07:00
Carsten Dominik bd11460542 Make file and path accessible in capture templates
* lisp/org-capture.el (org-capture-templates): Add %f and %F escapes
(org-capture): Add more information to capture property list
(org-capture-fill-template): Handle %f and %F escapes
2011-01-07 15:28:57 +01:00
David Maus 252d244466 Document style-include-scripts publishing project property
* doc/org.texi (Publishing options): Document style-include-scripts
publishing project property.
2011-01-06 20:52:54 +01:00
Carsten Dominik dd23461349 Implement next-error and previous-error functionality for sparse trees
* lisp/org.el (org-occur-next-match): New function.
(org-mode): Set the variable `next-error-function'.
(org-highlight-new-match): Add an `org-type' property to the overlays.
* doc/org.texi (Sparse trees): Document the next-error / previous-error
functionality.

After a sparse tree construction, `M-g n' and `M-g p' will now jump to
the location of matches.
2011-01-06 12:36:22 +01:00
Tom Dye c3cd82d577 Improved documentation of code block caches
* doc/org.texi (cache): Improved documentation of code block caches.
2011-01-05 09:17:44 -07:00
Tom Dye c867ce2c02 Documentation of multi-line header arguments.
* doc/org.texi (Code block specific header arguments): Documentation
  of multi-line header arguments.
2011-01-05 09:09:29 -07:00
Bastien Guerry de39bf05be org.texi: use message-mode instead of mail-mode in examples.
Message-mode is the default mode for composing emails in Emacs
since 2009-07-14.  See Stefan's message in Emacs lisp/ChangeLog:

2009-07-14  Stefan Monnier  <monnier@iro.umontreal.ca>

* simple.el (mail-user-agent): Default to the upwardly-UI-compatible
  and more featureful message-mode.
2011-01-04 17:48:35 +01:00
Bastien Guerry c66d94fe18 org.texi: mention the ability to add several tags thru C-c C-q TAB.
C-c C-q TAB now accepts several tags when separated by a comma.
2011-01-04 15:17:50 +01:00
Bastien Guerry aa157b5cb8 org.texi: Remove wrong quotes in lisp example.
This was spotted by Steve Hafner.
2011-01-03 19:44:07 +01:00
Bastien Guerry dfe713d08a org.texi: update links to http://orgmode.org (php->html). 2011-01-03 19:33:28 +01:00
Dan Davison a33a4003a1 Manual: edits to Working With Source Code chapter
- Clarify that switches and header arguments are optional
- Document `org-src-fontify-natively'
2010-12-24 11:40:08 +00:00
Eric Schulte ece347e32c org-babel-confirm-evaluate: better doc and code when using function as
Thanks to Vladimir Alexiev for submitting this patch

* lisp/ob.el (org-babel-confirm-evaluate): Fix for the case when
  org-confirm-babel-evaluate is a function (used to always ask no matter
  what the function returns).
* doc/org.texi (Code evaluation security): Add example for using a
  function.
2010-12-21 09:37:19 -07:00
Eric Schulte 00dd6c3cb2 documentation of the :sep header argument for code blocks 2010-12-21 14:19:25 +00:00
Eric Schulte 44392f1a41 documentation of the :file header argument for code blocks 2010-12-21 14:19:25 +00:00
Carsten Dominik 2d47a109b2 Modify activation section in manual 2010-12-20 15:38:40 +01:00
Carsten Dominik af33cb709a Fix bug with capture to datetree
* lisp/org-capture.el (org-capture-set-target-location): Use `current-time'.
2010-12-20 15:14:00 +01:00
Eric Schulte 5f1850af40 documentation of new attr_latex options for tables
* doc/org.texi (Tables in LaTeX export): Documentation of new
  attr_latex options for tables.
2010-12-17 14:00:51 -07:00
Carsten Dominik 3324942408 Link to book edition of manual, and update news 2010-12-17 16:08:38 +01:00
John Wiegley 14350cac34 Added FILE meta-property 2010-12-14 02:02:40 -05:00
Carsten Dominik 7666ba421f Version number back to 7.4 2010-12-10 18:49:40 +01:00
Carsten Dominik 76a25715c9 Bump version number to 7.5 2010-12-10 18:43:10 +01:00
Carsten Dominik 9df61b6c3e Fix typos 2010-12-10 11:12:56 +01:00
Carsten Dominik 77e51ec5b8 Improve wording
Patch by Brian Gough
2010-12-10 11:07:27 +01:00
Carsten Dominik 972b0a581e Use @LaTeX macro 2010-12-09 22:44:14 +01:00
Carsten Dominik 9e87fc670a Fix plain text that looks better with markup 2010-12-09 22:31:11 +01:00
Carsten Dominik 1cf808c744 Fix commas that should be full stops, semicolons or emdashes 2010-12-09 22:27:19 +01:00
Carsten Dominik d9db1c114d Use kbd font 2010-12-09 22:11:16 +01:00
Carsten Dominik 35817ab9ba Fix missing word in math formatting section 2010-12-09 22:09:08 +01:00
Carsten Dominik 6e49bb7c67 Use emdashes 2010-12-09 22:07:06 +01:00
Carsten Dominik b1f01f926c Proofreading credits for Brian Gough and Niels Giesen 2010-12-06 15:12:58 +01:00
Carsten Dominik 6388a8cd57 Cleanup the refcard 2010-12-06 10:54:30 +01:00
Carsten Dominik 71d9592fbc Some more minor fixes for the refcard 2010-12-06 10:51:04 +01:00
Carsten Dominik 6535babc34 Minor fixes to refcard 2010-12-06 09:54:30 +01:00
Carsten Dominik 970b2f7b88 Allow to jump to capture template after finalizing
* lisp/org-capture.el (org-capture-finalize): New prefix argument
STAY-WITH-CAPTURE.
(org-capture-refile): Improve docstring.
* doc/org.texi (Using capture): Document using prefix arguments for
finalizing capture.
2010-12-06 09:32:24 +01:00
Carsten Dominik cf766fb781 Document the prefix commands for capture
* doc/org.texi (Using capture): Document the prefix commands for capture.
2010-12-06 09:16:37 +01:00
Carsten Dominik 0d77381472 Document prefix argument for the bulk scatter command
* doc/org.texi (Agenda commands): Document prefix argument for the bulk
scatter command.
2010-12-06 09:09:10 +01:00
John Wiegley df4b79e051 Fixed a typo in the doc/org.texi manual 2010-12-06 00:25:13 -05:00
Carsten Dominik 13637b018f Brian's UTF-8 changes 2010-12-05 12:34:08 +01:00
Carsten Dominik dea921c8a7 Merge branch 't/patch425' into brian 2010-12-04 19:12:46 +01:00
Carsten Dominik 1cb57f37fd Merge branch 't/patch423' into brian 2010-12-04 19:12:35 +01:00
Carsten Dominik 3c98036f2a Merge branch 't/patch422' into brian 2010-12-04 19:12:34 +01:00
Carsten Dominik 8b0c323608 Merge branch 't/patch421' into brian 2010-12-04 19:12:30 +01:00
Brian Gough 2f9e1e48b8 correct grammar 2010-12-04 19:11:41 +01:00
Brian Gough 5e38e053f5 make Nth consistent 2010-12-04 19:10:12 +01:00
Brian Gough 57dd2fd7a9 mismatched quotes 2010-12-04 19:09:50 +01:00
Brian Gough 09ec91b1db more typos 2010-12-04 19:09:20 +01:00
Brian Gough 3420bb04d5 correct doc typos
Hi

Here is a patch for some proofreading corrections for the Org manual.
This is just an sample to check if it is in suitable format.  We have
a lot more corrections to come.

Because there are more than 20 lines affected I'm assuming we will
need to do copyright assignments.  If not I can send all the patches
now.  Alternatively would you prefer us to wait until the assignment
is done?

I haven't included a changelog entry since these are just for typos
etc and don't make any major changes to the meaning of the text.

Credit to my colleague Barry Gidden for the proofreading, he did the
real work on this.
2010-12-04 19:08:47 +01:00
Carsten Dominik 6578203623 Document John's modifications to bulk commands 2010-12-04 00:37:48 +01:00
Julien Danjou 0d0edd6d21 org-agenda: rework ndays and span handling
* org-agenda.el (org-agenda-custom-commands-local-options):
Allow org-agenda-span to be a symbol.
(org-agenda-ndays): Make obsolete.
(org-agenda-span): New variable superseding org-agenda-ndays.
(org-agenda-menu): Use org-agenda-current-span.
(org-agenda-current-span): New local variable storing current
span.
(org-agenda-list): Take a span instead of ndays as argument.
This function is now responsible for computing the ndays based
on span.
(org-agenda-ndays-to-span): Return span only if number of days
really matches.
(org-agenda-span-to-ndays): New function.
(org-agenda-manipulate-query): Use org-agenda-compute-starting-span.
(org-agenda-goto-today): Use org-agenda-compute-starting-span.
(org-agenda-later): Do not give compute a new span, use the
current one.
(org-agenda-day-view, org-agenda-week-view)
(org-agenda-month-view, org-agenda-year-view): Stop touching
org-agenda-ndays.
(org-agenda-change-time-span): Only compute starting-span.
(org-agenda-compute-starting-span): New function derived from
the old org-agenda-compute-time-span.
(org-agenda-set-mode-name): Compute mode based on
org-agenda-current-span.
(org-agenda-span-name): New function.

* org-mouse.el: Replace Replace org-agenda-ndays by
org-agenda-current-span.

* org.texi, orgguide.texi: Replace org-agenda-ndays by
org-agenda-span. Add a paragraph about org-agenda-span and say that
org-agenda-ndays is now deprecated.

This patch is pretty huge, so I'll give a bit of context about it.

I'm weird, but I used org-agenda-ndays set to 14. Unfortunately, this
settings was interpreted as a month view. Pressing 'f' key to see later,
would show me the next month, which was not at all what I wanted.

On the same idea, day view or week view would change my org-agenda-ndays
settings, which I think is not a good idea. Changing user setting is *bad*.
:-)

So I rewrote the things this way:
- Rename org-agenda-span to org-agenda-current-span
 Which has the same meaning has before, except it can be numeric.
- Rename org-agenda-ndays to org-agenda-span
 I think the name is better choosen. You can set it to a symbol instead of
 only a numeric value. That means you can set it to 'month and it will show
 you the number of days of the current month in your agenda. Better than
 30. But you can still set it to 30, or 31, or whatever you want.
- Do not change org-agenda-span. Never.
- Use org-agenda-current-span for navigation.
 That means if you press 'f', it will shows you really the next
 org-agenda-current-span ndays, and not something based on "I think you
 want a weekly view".
2010-12-03 13:07:31 +01:00
Carsten Dominik 12b153ed8b Implement clocktables for quarters
* lisp/org-clock.el (org-day-of-week): New function.
(org-quarter-to-date): New function.
(org-clock-special-range): Implement quarters.

Patch by Erwin Vrolijk
2010-11-29 11:27:47 +01:00
Julien Danjou 9de7ad3593 Add org-agenda-todo-ignore-timestamp
* lisp/org-agenda.el: Add org-agenda-todo-ignore-timestamp.
(org-agenda-check-for-timestamp-as-reason-to-ignore-todo-item):
Honor org-agenda-todo-ignore-timestamp.
* doc/org.texi: Mention org-agenda-todo-ignore-timestamp.

Signed-off-by: Julien Danjou <julien@danjou.info>
2010-11-29 10:25:22 +01:00
Carsten Dominik 6e98e5dd0f Add some more acknowledgements 2010-11-26 19:08:30 +01:00
Carsten Dominik 2613f27f8e More acknowledgements 2010-11-26 08:14:21 +01:00
Carsten Dominik 80a6674178 BEAMER export: Allow overlay options for column environments
* lisp/org-beamer.el (org-beamer-sectioning): Allow overlay arguments for
the column as well.
* doc/org.texi (Beamer class export): Document that also overlay arguments
can be passed to the column environment.

Eric Fraga writes:

> I am trying to create a beamer slide which has two columns.  The second
> column should only appear after a while (the 6th uncovering operation).
> In latex, I would do:
>
> : \begin{column}<6->{0.4\textwidth}
>
> say.  In org, I would expect to be able to get this latex code generated
> by the following:
>
> --8<---------------cut here---------------start------------->8---
> ***** column heading			      :BMCOL:B_block:
>      :PROPERTIES:
>      :BEAMER_col: 0.4
>      :BEAMER_envargs: c<6->
>      :BEAMER_extra:
>      :BEAMER_env: block
>      :END:
> --8<---------------cut here---------------end--------------->8---
>
> according to the info documentation (Beamer class export).
>
> However, this does not work: the "c<6->" is placed verbatim in
> the \begin{block} that comes after the \begin{column}.  Furthermore, if
> I ask for the heading to be ignored (instead of defining a block), the
> envargs are lost completely!
2010-11-26 08:02:58 +01:00
Carsten Dominik 341e9ce1d7 Date tree capture with prompt for date
* doc/org.texi (Template elements): Document the new entry type.

* lisp/org-capture.el (org-capture-templates): Add new option to customize
type and docstring.
(org-capture-set-target-location): Interpret the file+datetree+prompt
entry.
2010-11-25 17:00:57 +01:00
Carsten Dominik cc01ef59f2 Minor fixes for the manual 2010-11-24 12:16:43 +01:00
Puneeth Chaganti 29e2b27b5a Document the :recursive option for org-publish
Hi,

Here's a patch to document the recursive option for org-publish. It's
a documentation TODO on Worg.
2010-11-22 21:38:56 +01:00
Eric Schulte 88947588bc lists are now a data type recognized by code blocks
* lisp/ob-ref.el (org-babel-ref-resolve): Recognize `list' as a unique
  type of data
  (org-babel-ref-at-ref-p): Recognize `list' as a unique type of data

* lisp/ob.el (org-babel-read-result): Recognize `list' as a unique
  type of data
  (org-babel-read-list): A function to read a textual Org-mode list
  into an emacs-lisp list.
  (org-babel-insert-result): Recognizes the "list" result param to
  insert data as an Org-mode list.
  (org-babel-result-end): Find the end of an Org-mode list.
  (org-babel-merge-params): Add "list" as a result param.

* doc/org.texi (results): Documentation of the new "list" results
  header argument.
2010-11-17 16:47:55 -07:00
Carsten Dominik cae52eb288 Merge branch 'master' of git+ssh://repo.or.cz/srv/git/org-mode 2010-11-17 08:58:52 +01:00
Carsten Dominik e2567e9e93 Add link to MathJax site 2010-11-17 08:58:49 +01:00
Carsten Dominik 9b8118c48c Fix typo 2010-11-16 17:28:13 +01:00
Carsten Dominik 5dd4d30be5 Merge branch 'master' of git+ssh://repo.or.cz/srv/git/org-mode 2010-11-16 08:55:39 +01:00
Carsten Dominik a05f317553 Minor documentation updates 2010-11-16 08:55:32 +01:00
Puneeth Chaganti 249ae99b18 Include an .org file and lower the level of all its headers
* doc/org.texi (Include files): Document :minlevel.
* lisp/org-exp.el (org-export-handle-include-files): Support :minlevel
property.
(org-get-file-contents): New argument minlevel to demote included
content.

On Sat, Nov 13, 2010 at 1:12 AM, Carsten Dominik
<carsten.dominik@gmail.com> wrote:
>
> On Nov 10, 2010, at 3:46 AM, Jianshi Huang wrote:
>
>> Hi,
>>
>> I know I can include any file using #+INCLUDE.
>>
>> I need to include several org files, but they were edited
>> independently as a complete document.
>>
>> Now I want to lower the levels of headers in these org files
>> automatically during inclusion. Is there a way to do that?
>
> No. But since #+include accepts arguments, it could be implemented,
> something like
>
> #+include "aaa.org" :minlevel 4
>
> or so. I would accept a good patch to this effect.

Here's a patch. I tested it with a simple document and works fine.

Thanks,
Puneeth
2010-11-15 11:15:53 +01:00
Carsten Dominik 0adcd5d619 Fix typo 2010-11-14 03:54:16 -06:00
Carsten Dominik c2a366ac5a Add command names for chapters 4-7 2010-11-13 10:09:15 -06:00
Carsten Dominik 8c31cce753 Merge branch 'command-name-fixes' 2010-11-13 07:08:20 -06:00
Carsten Dominik 6fee2ffa57 Add command names for the table functions 2010-11-12 12:14:55 -06:00
Bastien Guerry 6630edbd0f Set version number to 7.3 2010-11-07 14:52:14 +01:00
Carsten Dominik d96c998019 Fix issue with narrowing and links in clocktables
* lisp/org-clock.el (org-clocktable-write-default): Better handling of
narrowing.

Liang Wang writes:

> After I upgrade orgmode to latest version, clock report shows link
> text literally.
>
> For example,
>
>   [[file:/home/liang/gtd/todo.org::Task...
>
> Unfortunately, in this way, I can not see what this task actually is.
> I have to temporarily disable link in clock report.
2010-11-06 16:16:49 -04:00
Carsten Dominik 9dd2eebba4 Fix some command names 2010-11-06 15:59:01 -04:00
Carsten Dominik 874467d6b6 org-sparse-tree command name
Patch by Andreas Rhler
2010-11-05 18:02:52 +01:00
Carsten Dominik 0020380614 Add command names for Capture/refile/archive chapter 2010-11-05 17:07:42 +01:00
Carsten Dominik 4d0252b8ac Merge branch 'add-more-command-names' 2010-11-05 06:53:20 +01:00
Carsten Dominik 8d993aef42 Add command names for publishing and export 2010-11-05 06:53:02 +01:00
Carsten Dominik da0f4997fb Merge branch 'master' of git+ssh://repo.or.cz/srv/git/org-mode 2010-11-04 16:46:25 +01:00
Julien Danjou aaffdb4732 org-agenda: add support for category icons
Signed-off-by: Julien Danjou <julien@danjou.info>

* doc/org.texi (Categories): Document category icons.
* lisp/org-agenda.el (org-agenda-prefix-format): Insert place holder for icon.
(org-agenda-category-icon-alist): New option.
(org-agenda-get-category-icon): New function.
(org-format-agenda-item): Support for icons.
(org-compile-prefix-format): Support for icons.
2010-11-04 13:01:37 +01:00
Carsten Dominik 73fc8241da Merge branch 'add-agenda-command-names' 2010-11-04 09:26:06 +01:00
Carsten Dominik a21ef85233 Manual: Add command names for agenda keys
This patch also defines a number of macros to typeset keys.  Too many,
maybe, because at first I wanted to be able to include all the
previous typesetting.  I think I will try to reduce the number
eventually - but for now this is it.
2010-11-04 09:24:59 +01:00
Eric Schulte 913fdd4527 fixed typo in the manual -- Thanks to Eric S Fraga for pointing this out
* doc/org.texi (noweb): typo
2010-11-03 09:33:22 -06:00
Carsten Dominik f0d2bcb1bf Add command names to the clocking chapter 2010-11-02 17:54:02 +01:00
Carsten Dominik 1197b73769 Minor fixes 2010-11-02 09:24:06 +01:00
Carsten Dominik 350b75be63 Rewrite of the clock table code
* lisp/org.el (org-shorten-string): New function.
* lisp/org-exp.el (org-export-convert-protected-spaces): New function.
(org-export-preprocess-string): Call
`org-export-convert-protected-spaces' to handle new hard spaces.

* lisp/org-clock.el (org-clocktable): New customization group.
(org-clocktable-defaults): New option.
(org-clock-clocktable-formatter): New option.
(org-clock-clocktable-default-properties): New option.
(org-dblock-write:clocktable): Rewrite to split out functionality
into separate functions.
(org-clocktable-write-default):
(org-clocktable-indent-string):
(org-clock-get-table-data): New functions.
* lisp/org-agenda.el (org-agenda-list):
(org-agenda-redo):
(org-agenda-clockreport-mode):
(org-agenda-set-mode-name): Rewrite to implement filtered clock tables.
* doc/org.texi (Clocking commands):
(The clock table): New sections.
(Agenda commands): Document filtered clock reports.
2010-11-02 08:47:23 +01:00
Bastien Guerry 52c87c93b2 Merge branch 't/patch352' 2010-10-29 17:03:03 +02:00
Noorul Islam 491a39825b Worg: link broken
2010/10/28 Sébastien Vauban <wxhgmqzgwmuf@spammotel.com>:
> Hello,
>
> In page http://orgmode.org/guide/Working-With-Source-Code.html,
> see "further reading": link "chapter 14" broken (recursive, BTW?).
>

Fix recursive link

* doc/orgguide.texi: Remove broken recursive link

Thanks and Regards
Noorul
2010-10-29 17:02:57 +02:00
Andreas Röhler 61ea499e74 20101029_orgtexi_names.patch
org-return
2010-10-29 16:54:09 +02:00
Carsten Dominik 82af72eef7 Push version number to 7.02trans 2010-10-29 09:11:46 +02:00
Andreas Röhler b61b10847d 20101028_orgtexi_names.patch - (2) 2010-10-28 16:00:04 +02:00
Bastien Guerry 132131b57b doc/org.texi: Fix missing menu item for the Countdown timer section 2010-10-27 19:56:08 +02:00
Andreas Röhler 8471886cee 20101027_orgtexi_names.patch 2010-10-27 18:40:55 +02:00
Noorul Islam a9e338c01e Fix typo
make doc/org is failing because of syntax error.

* doc/org.texi: Fix typo

Thanks and Regards
Noorul
2010-10-27 18:39:39 +02:00
Bastien Guerry 840570c2a3 Update Changes.org and org.texi to reflect changes in org-timer.el
Update org.texi with a new section: Countdown timer.
Update ORGWEBPAGE/Changes.org with a section about timer/clock.
Also fix a small typo in a org-timer.el.
2010-10-27 18:20:27 +02:00
Nicolas Goaziou 3cee2ee2a3 Document list changes in manual 2010-10-27 09:27:58 +02:00
Carsten Dominik 7635429d44 New capture property :kill-buffer
* lisp/org-capture.el (org-capture-templates): New capture
property `:kill-buffer'. (org-capture-finalize): Kill target buffer
if that is desired.
(org-capture-target-buffer): Remember if we have to make the buffer.

Proposal by Samuel Wales.
2010-10-26 17:46:48 +02:00
Carsten Dominik 29ec63acc5 Manual: Document that capture refiling is sensitive to the cursor position
* doc/org.texi (Using capture): Explain that refiling is sensitive
to cursor position.
2010-10-26 10:50:48 +02:00