Commit graph

1161 commits

Author SHA1 Message Date
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
Nicolas Goaziou 9ec8510687 org.texi: minor corrections 2011-02-19 01:16:59 +01:00
Nicolas Goaziou af6037a695 Documentation changes for lists 2011-02-18 12:45:11 +01:00
Manuel Giraud 5f7654c6cf org-publish: sitemap doc
Hi,

Some documentation for new sitemap options.

>From 3a846a674a33a5f2a0a2404b88331942e2012779 Mon Sep 17 00:00:00 2001
From: Manuel Giraud <manuel.giraud@univ-nantes.fr>
Date: Mon, 14 Feb 2011 11:34:04 +0100
Subject: [PATCH] org.texi: documentation of sitemap's entry options
2011-02-14 21:56:18 +01:00
Bastien Guerry 9b23f082ea lisp/org-clock.el: allow to set the language through a new :lang parameter.
* org-clock.el (org-clock-clocktable-language-setup): New
custom variable.
(org-clocktable-defaults): Set the default language.
(org-clocktable-write-default): Use the new variable.
2011-02-13 13:57:06 +01:00
Bastien Guerry 0f40214ec1 org.texi: fix wrong reference to logredeadline and the likes. 2011-02-12 23:26:13 +01:00
Bastien 08650cbb5c Allow (currentfile) for capture templates.
* org-capture.el (org-capture-templates): document currentfile
for capture template.
(org-capture-templates): Allow to use currentfile for capture
templates.
(org-capture-set-target-location): Handle currentfile as a way
to setting the capture buffer.

* org.texi (Template elements): document currentfile for
capture templates.
2011-02-12 19:07:52 +01:00
Bastien Guerry af72eecf3a org.texi: update the info links syntax. 2011-02-11 13:40:52 +01:00
Bastien Guerry da8dc7bba7 Rewrite the handling of HTML preamble/postamble.
* org-html.el (org-export-html-auto-preamble)
(org-export-html-auto-postamble): Remove.
(org-export-html-preamble, org-export-html-postamble): Turn
into custom variables.  Update the docstrings.
(org-export-html-preamble-format)
(org-export-html-postamble-format): New custom variables.
(org-export-as-html): Use org-export-html-postamble-format and
org-export-html-preamble-format.
(org-export-html-title-format): delete.

* org-exp.el (org-export-plist-vars): Remove
:auto-preamble and :auto-postamble.  Rename :preamble and
:postamble to :html-preamble and :html-postamble.

* org-publish.el (org-publish-project-alist): Remove
:auto-preamble and :auto-postamble.  Rename :preamble and
:postamble to :html-preamble and :html-postamble.

* org.texi (Publishing options): replace :preamble and
:auto-preamble by :html-preamble (same for postamble.)
2011-02-11 01:27:15 +01:00
Valentin Wüstholz 39d5acd33c org-latex.el: match horizontal rules with HTML regexp
Also a slight update of the manual about horizontal rules.
2011-02-10 17:03:31 +01:00
Bastien Guerry eba3bee3db Mention org-agenda-tags-column. 2011-02-10 16:56:37 +01:00
Bastien Guerry 064423e9c7 org.texi: fix typo. 2011-02-09 17:27:22 +01:00
Manuel Giraud 334cf2038d Adds sort options when publishing the sitemap
This patch adds sort options to the sitemap.  In addition to
alphabetical order, one can choose chronological or anti-chronological
ordering of sitemap entries.  To retrieve file date, it tries to parse
the "#+date" keyword and if not present defaults to file modification
time.
2011-02-08 17:51:17 +01:00
Christoph Groth 2214788528 org-bbdb: allow anniversaries with unknown years
Anniversaries in BBDB can be now also specified in the format MM-DD
next to YYYY-MM-DD.
2011-02-08 16:57:53 +01:00
Bastien Guerry 712031900f doc/org.texi: Fix tiny bug. 2011-02-03 00:06:01 +01:00
Bastien Guerry 6849e48308 Fix minor typo about org-attach-open keybinding.
Thanks to Julian Gehring for spotting this.
2011-02-02 23:14:57 +01:00
Bastien Guerry b3c3746d92 New function org-narrow-to-block.
* org.el (org-narrow-to-block): New function to narrow to block.
Bound this function to `C-x n b'.
* org.texi (Dynamic blocks, Structure editing): Mention
the function `org-narrow-to-block'.

This is inspired by a request by Leonidas Tsampros.
2011-02-02 11:47:41 +01:00
Osamu Okano a017fca37f Various docstrings typo fixes by Osamu OKANO. 2011-02-01 13:05:13 +01:00
Brian Gough 8083344c86 add index entries 2011-02-01 12:37:43 +01:00
Brian Gough 93f7595f31 explain how to check the default version of Org 2011-02-01 12:35:59 +01:00
Brian Gough 653459d774 typo/grammar fix for .done CSS explanation 2011-02-01 12:34:35 +01:00
Brian Gough 63a1395be9 use code font for example footnote labels 2011-02-01 12:33:21 +01:00
Brian Gough f10558cc4f put emacs functions in code font 2011-02-01 12:32:02 +01:00
Brian Gough 5f51fe1cb1 make "time stamps" consistent with timestamps 2011-02-01 12:28:39 +01:00
Brian Gough 53125463be tangling is not a widely-known term, describe it as literate programming 2011-02-01 12:26:21 +01:00
Bastien Guerry df23e58b48 Rename org-complete.el to org-pcomplete.el to avoid file-name clash.
On Jan 26, 2011, at 10:34 AM, Eli Zaretskii wrote:

> The file org-complete.el, added about a month ago, causes a file-name
> clash with org-compat.el after 8+3 truncation.  This causes trouble
> when unpacking Emacs tarballs on DOS filesystems.

Also rename org-complete-* functions in org-pcomplete.el and remove a
wrong reference to org-complete in doc/org.texi.

We still use org-complete-* namespace for the custom group and the
custom variables.
2011-01-31 18:40:05 +01:00
Bastien Guerry 4688a2a962 org.texi: minor rephrasing.
Patch http://patchwork.newartisans.com/patch/459/ by Brian Gough was
marked as "accepted" on patchwork but did not appear in org.texi.  I
fixed this manually.
2011-01-27 11:02:31 +01:00
Brian Gough dc60db96c9 use @result{} instead of --> (looks nicer) 2011-01-26 18:33:07 +01:00
Carsten Dominik 1cb39b23f9 Merge branch 'master' of orgmode.org:org-mode 2011-01-26 10:58:38 +01:00
Eric Schulte 65ac69c016 doc: updating list of code block supported languages
* doc/org.texi (Languages): Updating list of code block supported
  languages.
2011-01-25 15:22:19 -07:00
Carsten Dominik 0faba848bd Fix documentation bug: CATEGORY is special property, but allowed in drawer
* doc/org.texi (Special properties): CATEGORY is a special property,
but it may also used in the drawer.
2011-01-24 09:37:52 +01:00
Carsten Dominik e879e284d4 Mention MobileOrg for Android in the guide 2011-01-21 11:55:01 +01:00
Carsten Dominik b7cfc159a3 Fix spacing after e.g. and i.e. in the guide 2011-01-21 10:14:28 +01:00
Carsten Dominik c466a9a759 Fix spacing after i.e. and e.g. 2011-01-21 10:11:56 +01:00
Eric Schulte 71650a1d1d doc: adding documentation of the :mkdirp tangling header argument
* doc/org.texi (mkdirp): Documentation of the :mkdirp header argument
2011-01-19 20:35:39 -07:00
Julien Danjou dc55710b60 Add command to reset agenda time span
* org-agenda.el (org-agenda-reset-view): New function.
(org-agenda-view-mode-dispatch): Bind space to org-agenda-reset-view.

Signed-off-by: Julien Danjou <julien@danjou.info>

* doc/org.texi (Agenda commands): Document `v SPC'.

* doc/orgcard.tex: Document v SPC
2011-01-18 11:14:20 +01:00
Carsten Dominik 1abfaf4917 Remove some unneeded lines in org.texi 2011-01-18 10:50:46 +01:00
Bastien Guerry 135085b2c2 doc/org.texi: slight rewriting on using #+INCLUDE with lines ranges 2011-01-18 01:25:15 +01:00
Puneeth Chaganti 7b399fe128 How do I include text between a range of line numbers with #INCLUDE
Hi Carsten,

On Sat, Jan 8, 2011 at 11:35 PM, Carsten Dominik
<carsten.dominik@gmail.com> wrote:
> Hi Puneeth,
>
> can cou please augment the patch with a propert ChangeLog-like entry, and
> with documentation for the manual, and then resubmit?

Here is a patch with a ChangeLog entry and documentation for the
manual. Please tell me if it looks OK. Also, I hope using
git-format-patch is the right way to send this page. If not, what is
the right way?

Thanks,
Puneeth

>From 4a9be5b1a7a19c5d092ed14a86d29ad83122e9a8 Mon Sep 17 00:00:00 2001
From: Puneeth Chaganti <punchagan@gmail.com>
Date: Sun, 9 Jan 2011 00:48:51 +0530
Subject: [PATCH] Include only specified range of line numbers of a file

* doc/org.texi (Include files): Document :lines.
* lisp/org-exp.el (org-export-handle-include-files): Support :lines
property.
(org-get-file-contents): New argument lines to include specify a range
of lines to include.

On Fri, Jan 7, 2011 at 1:29 PM, Puneeth <punchagan@gmail.com> wrote:
> On Fri, Jan 7, 2011 at 10:03 AM, Venkatesh Choppella
> <venkatesh.choppella@iiit.ac.in> wrote:
>> I would like to include a part of a file (between a given range of
>> line numbers) instead of the whole file.  Is there a way to do that
>> in org-mode?
>
> It isn't possible to include files using line numbers, as of now.
> Here's a quick patch that would add this feature.  I have tested it
> with small files and works fine. Can somebody tell me if it looks
> good?
>
> :lines "5-10"  will include the lines from 5 to 10, 10 excluded.
> :lines "-10"  will include the lines from 1 to 10, 10 excluded.
> :lines "5-"  will include the lines from 1 to the end of the file.
>
> HTH,
> Puneeth
2011-01-18 01:02:04 +01:00
Vincent Belaïche ce131e286c Doors links
> Date: Fri, 14 Jan 2011 23:18:21 +0100
> From: mail@christianmoe.com
> To: emacs-orgmode@gnu.org
> Subject: Re: [Orgmode] Doors links
>
> Hi,
>
> Try these:
>
> [[info:org:Link abbreviations]]
>
> [[info:org:Adding%20hyperlink%20types][info:org:Adding hyperlink types]]
>
> Yours,
> Christian
>
[...]

Thanks, I will try that ! I think that the trick deserves a forward link
in the documentation. I made a patch to the doc, attached.

   Vincent.
2011-01-17 19:23:03 +01:00
Eric Schulte 821082b5b0 doc: documentation of the ":comments noweb" code block header argument
* doc/org.texi (comments): Documentation of the ":comments noweb" code
  block header argument.
2011-01-16 08:24:19 -07:00
Bastien Guerry 8be17c8c62 org.texi: more small typos. 2011-01-15 19:36:34 +01:00
Bastien Guerry 3e476a3ba2 org.texi: fix small typo. 2011-01-15 19:35:53 +01:00
Carsten Dominik c747c7f7fb Merge branch 'global-skipping-condition' 2011-01-15 12:43:20 +01:00
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