emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] emacs/doc/misc ChangeLog org.texi


From: Carsten Dominik
Subject: [Emacs-diffs] emacs/doc/misc ChangeLog org.texi
Date: Thu, 01 Oct 2009 08:03:02 +0000

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Carsten Dominik <cdominik>      09/10/01 08:03:02

Modified files:
        doc/misc       : ChangeLog org.texi 

Log message:
        2009-10-01  Carsten Dominik  <address@hidden>
        
                * org.texi (Pushing to MobileOrg): Document `org-mobile-files'.
                (Processing LaTeX fragments): Document that the size of images 
can be
                changes using the variable `org-format-latex-options'.
                (The date/time prompt, Timestamps): Be more accurate over ISO 
format
                dates and times.
                (Visibility cycling): Document showeverything keyword.
                (In-buffer settings): Document showeverything keyword.
                (Setting up the staging area): Fix the example.
                (MobileOrg): New section.
                (Agenda commands, Exporting Agenda Views): Document exporting 
the
                agenda view to Org files.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/ChangeLog?cvsroot=emacs&r1=1.322&r2=1.323
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/org.texi?cvsroot=emacs&r1=1.52&r2=1.53

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/ChangeLog,v
retrieving revision 1.322
retrieving revision 1.323
diff -u -b -r1.322 -r1.323
--- ChangeLog   28 Sep 2009 14:27:48 -0000      1.322
+++ ChangeLog   1 Oct 2009 08:03:02 -0000       1.323
@@ -1,3 +1,17 @@
+2009-10-01  Carsten Dominik  <address@hidden>
+
+       * org.texi (Pushing to MobileOrg): Document `org-mobile-files'.
+       (Processing LaTeX fragments): Document that the size of images can be
+       changes using the variable `org-format-latex-options'.
+       (The date/time prompt, Timestamps): Be more accurate over ISO format
+       dates and times.
+       (Visibility cycling): Document showeverything keyword.
+       (In-buffer settings): Document showeverything keyword.
+       (Setting up the staging area): Fix the example.
+       (MobileOrg): New section.
+       (Agenda commands, Exporting Agenda Views): Document exporting the
+       agenda view to Org files.
+
 2009-09-28  Michael Albinus  <address@hidden>
 
        * tramp.texi (History): Add IMAP support.

Index: org.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/org.texi,v
retrieving revision 1.52
retrieving revision 1.53
diff -u -b -r1.52 -r1.53
--- org.texi    2 Sep 2009 13:05:59 -0000       1.52
+++ org.texi    1 Oct 2009 08:03:02 -0000       1.53
@@ -3,8 +3,8 @@
 @setfilename ../../info/org
 @settitle The Org Manual
 
address@hidden VERSION 6.30c
address@hidden DATE September 2009
address@hidden VERSION 6.31a
address@hidden DATE October 2009
 
 @c Version and Contact Info
 @set MAINTAINERSITE @uref{http://orgmode.org,maintainers webpage}
@@ -109,6 +109,7 @@
 * Publishing::                  Create a web site of linked Org files
 * Miscellaneous::               All the rest which did not fit elsewhere
 * Hacking::                     How to hack your way around
+* MobileOrg::                   Viewing and capture on a mobile device
 * History and Acknowledgments::  How Org came into being
 * Main Index::                  An index of Org's concepts and features
 * Key Index::                   Key bindings and where they are described
@@ -271,7 +272,7 @@
 * Presentation and sorting::    How agenda items are prepared for display
 * Agenda commands::             Remote editing of Org trees
 * Custom agenda views::         Defining special searches and views
-* Exporting Agenda Views::
+* Exporting Agenda Views::      Writing a view to a file
 * Agenda column view::          Using column view for collected entries
 
 The built-in agenda views
@@ -420,6 +421,12 @@
 * Translator functions::        Copy and modify
 * Radio lists::                 Doing the same for lists
 
+MobileOrg
+
+* Setting up the staging area::  Where to interact with the mobile device
+* Pushing to MobileOrg::        Uploading Org files and agendas
+* Pulling from MobileOrg::      Integrating captured and flagged items
+
 @end detailmenu
 @end menu
 
@@ -506,9 +513,9 @@
 @cindex installation
 @cindex XEmacs
 
address@hidden:} @i{If Org is part of the Emacs distribution or an
-XEmacs package, please skip this section and go directly to
address@hidden
address@hidden:} @i{If you are using a version of Org that is part of the Emacs
+distribution or an XEmacs package, please skip this section and go directly
+to @ref{Activation}.}
 
 If you have downloaded Org from the Web, either as a distribution @file{.zip}
 or @file{.tar} file, or as a Git archive, you must take the following steps
@@ -532,13 +539,17 @@
 (setq load-path (cons "~/path/to/orgdir/contrib/lisp" load-path))
 @end example
 
address@hidden users now need to install the file @file{noutline.el} from
address@hidden 2
address@hidden
+XEmacs users now need to install the file @file{noutline.el} from
 the @file{xemacs} sub-directory of the Org distribution.  Use the
-command:}
+command:
 
 @example
address@hidden install-noutline}
+     make install-noutline
 @end example
address@hidden cartouche
address@hidden 2
 
 @noindent Now byte-compile the Lisp files with the shell command:
 
@@ -566,14 +577,15 @@
 make install-info-debian
 @end example
 
address@hidden Then add to @file{.emacs}:
-
+Then add the following line to @file{.emacs}.  It is needed so that
+Emacs can autoload functions that are located in files not immediately loaded
+when Org-mode starts.
 @lisp
-;; This line only if Org is not part of the X/Emacs distribution.
 (require 'org-install)
 @end lisp
 
 Do not forget to activate Org as described in the following section.
address@hidden
 
 @node Activation, Feedback, Installation, Introduction
 @section Activation
@@ -882,6 +894,7 @@
 @cindex @code{overview}, STARTUP keyword
 @cindex @code{content}, STARTUP keyword
 @cindex @code{showall}, STARTUP keyword
address@hidden @code{showeverything}, STARTUP keyword
 
 When Emacs first visits an Org file, the global state is set to
 OVERVIEW, @ie only the top level headlines are visible.  This can be
@@ -893,6 +906,7 @@
 #+STARTUP: overview
 #+STARTUP: content
 #+STARTUP: showall
+#+STARTUP: showeverything
 @end example
 
 @cindex property, VISIBILITY
@@ -2968,6 +2982,11 @@
 accurately enough, you can write custom functions to select the search string
 and to do the search for particular file types---see @ref{Custom searches}.
 The key binding @kbd{C-c l} is only a suggestion---see @ref{Installation}.
+
address@hidden address@hidden
+When the cursor is in an agenda view, the created link points to the
+entry referenced by the current line.
+
 @c
 @kindex C-c C-l
 @cindex link completion
@@ -4028,7 +4047,9 @@
 @samp{:notes:}, and @samp{:action:} even though the final heading is not
 explicitly marked with those tags.  You can also set tags that all entries in
 a file should inherit just as if these tags were defined in a hypothetical
-level zero that surrounds the entire file.
+level zero that surrounds the entire file.  Use a line like address@hidden
+with all these in-buffer settings, pressing @kbd{C-c C-c} activates any
+changes in the line.}:
 
 @cindex #+FILETAGS
 @example
@@ -4613,7 +4634,7 @@
 values.
 
 @example
-:COLUMNS:  %20ITEM %9Approved(Approved?)@address@hidden %Owner %11Status 
address@hidden note that the COLUMNS definition must be on a single line---it 
is wrapped here only because of formatting constraints.}
+:COLUMNS:  %25ITEM %9Approved(Approved?)@address@hidden %Owner %11Status 
address@hidden note that the COLUMNS definition must be on a single line---it 
is wrapped here only because of formatting constraints.}
                    address@hidden:@} %CLOCKSUM
 :Owner_ALL:    Tammy Mark Karl Lisa Don
 :Status_ALL:   "In progress" "Not started yet" "Finished" ""
@@ -4831,13 +4852,13 @@
 @cindex deadlines
 @cindex scheduling
 
-A timestamp is a specification of a date (possibly with a time or a range
-of times) in a special format, either @samp{<2003-09-16 Tue>} or
+A timestamp is a specification of a date (possibly with a time or a range of
+times) in a special format, either @samp{<2003-09-16 Tue>} or
 @samp{<2003-09-16 Tue 09:39>} or @samp{<2003-09-16 Tue
-12:00-12:30>address@hidden is the standard ISO date/time format.  To
-use an alternative format, see @ref{Custom time format}.}.  A timestamp
-can appear anywhere in the headline or body of an Org tree entry.  Its
-presence causes entries to be shown on specific dates in the agenda
+12:00-12:30>address@hidden is inspired by the standard ISO 6801 date/time
+format.  To use an alternative format, see @ref{Custom time format}.}.  A
+timestamp can appear anywhere in the headline or body of an Org tree entry.
+Its presence causes entries to be shown on specific dates in the agenda
 (@pxref{Weekly/daily agenda}).  We distinguish:
 
 @table @var
@@ -4985,21 +5006,20 @@
 @cindex time, reading in minibuffer
 
 @vindex org-read-date-prefer-future
-When Org mode prompts for a date/time, the default is shown as an ISO
-date, and the prompt therefore seems to ask for an ISO date.  But it
-will in fact accept any string containing some date and/or time
-information, and it is really smart about interpreting your input.  You
+When Org mode prompts for a date/time, the default is shown in default
+date/time format, and the prompt therefore seems to ask for a specific
+format.  But it will in fact accept any string containing some date and/or
+time information, and it is really smart about interpreting your input.  You
 can, for example, use @kbd{C-y} to paste a (possibly multi-line) string
-copied from an email message.  Org mode will find whatever information
-is in there and derive anything you have not specified from the
address@hidden date and time}.  The default is usually the current date
-and time, but when modifying an existing timestamp, or when entering
-the second stamp of a range, it is taken from the stamp in the buffer.
-When filling in information, Org mode assumes that most of the time you
-will want to enter a date in the future: if you omit the month/year and
-the given day/month is @i{before} today, it will assume that you mean a
-future address@hidden the variable
address@hidden
+copied from an email message.  Org mode will find whatever information is in
+there and derive anything you have not specified from the @emph{default date
+and time}.  The default is usually the current date and time, but when
+modifying an existing timestamp, or when entering the second stamp of a
+range, it is taken from the stamp in the buffer.  When filling in
+information, Org mode assumes that most of the time you will want to enter a
+date in the future: if you omit the month/year and the given day/month is
address@hidden today, it will assume that you mean a future address@hidden the
+variable @code{org-read-date-prefer-future}.}.
 
 For example, let's assume that today is @b{June 13, 2006}.  Here is how
 various inputs will be interpreted, the items filled in by Org mode are
@@ -6148,7 +6168,7 @@
 * Presentation and sorting::    How agenda items are prepared for display
 * Agenda commands::             Remote editing of Org trees
 * Custom agenda views::         Defining special searches and views
-* Exporting Agenda Views::
+* Exporting Agenda Views::      Writing a view to a file
 * Agenda column view::          Using column view for collected entries
 @end menu
 
@@ -7395,10 +7415,10 @@
 Write the agenda view to a file.  Depending on the extension of the selected
 file name, the view will be exported as HTML (extension @file{.html} or
 @file{.htm}), Postscript (extension @file{.ps}), PDF (extension @file{.pdf}),
-or plain text (any other extension).  When called with a @kbd{C-u} prefix
-argument, immediately open the newly created file.  Use the variable
address@hidden to set options for @file{ps-print} and
-for @file{htmlize} to be used during export.
+Org-mode (extension @file{.org}), and plain text (any other extension).  When
+called with a @kbd{C-u} prefix argument, immediately open the newly created
+file.  Use the variable @code{org-agenda-exporter-settings} to set options
+for @file{ps-print} and for @file{htmlize} to be used during export.
 
 @tsubheading{Quit and Exit}
 @kindex q
@@ -7622,13 +7642,13 @@
 @cindex exporting agenda views
 @cindex agenda views, exporting
 @vindex org-agenda-exporter-settings
-Write the agenda view to a file.  Depending on the extension of the
-selected file name, the view will be exported as HTML (extension
address@hidden or @file{.htm}), Postscript (extension @file{.ps}),
-iCalendar (extension @file{.ics}), or plain text (any other extension).
-Use the variable @code{org-agenda-exporter-settings} to
-set options for @file{ps-print} and for @file{htmlize} to be used during
-export, for example
+Write the agenda view to a file.  Depending on the extension of the selected
+file name, the view will be exported as HTML (extension @file{.html} or
address@hidden), Postscript (extension @file{.ps}), iCalendar (extension
address@hidden), Org-mode (extension @file{.org}), or plain text (any other
+extension).  Use the variable @code{org-agenda-exporter-settings} to set
+options for @file{ps-print} and for @file{htmlize} to be used during export,
+for example
 
 @vindex org-agenda-add-entry-text-maxlines
 @vindex htmlize-output-type
@@ -7951,6 +7971,12 @@
 Remove the overlay preview images.
 @end table
 
address@hidden org-format-latex-options
+You can customize the variable @code{org-format-latex-options} to influence
+some aspects of the preview. In particular, the @code{:scale} (and for HTML
+export, @code{:html-scale}) property can be used to adjust the size of the
+preview images.
+
 During HTML export (@pxref{HTML export}), all address@hidden fragments are
 converted into images and inlined into the document if the following
 setting is active:
@@ -8107,13 +8133,13 @@
 @subheading Headings and sections
 @cindex headings and sections, markup rules
 
address@hidden org-headline-levels
address@hidden org-export-headline-levels
 The outline structure of the document as described in @ref{Document
 Structure}, forms the basis for defining sections of the exported document.
 However, since the outline structure is also used for (for example) lists of
 tasks, only the first three outline levels will be used as headings.  Deeper
 levels will become itemized lists.  You can change the location of this
-switch globally by setting the variable @code{org-headline-levels}, or on a
+switch globally by setting the variable @code{org-export-headline-levels}, or 
on a
 per-file basis with a line
 
 @cindex #+OPTIONS
@@ -8451,7 +8477,8 @@
 @cindex #+BEGIN_COMMENT
 
 Lines starting with @samp{#} in column zero are treated as comments and will
-never be exported.  Also entire subtrees starting with the word
+never be exported. If you want an indented line to be treated as a comment,
+start it with @samp{#+ }.  Also entire subtrees starting with the word
 @samp{COMMENT} will never be exported.  Finally, regions surrounded by
 @samp{#+BEGIN_COMMENT} ... @samp{#+END_COMMENT} will not be exported.
 
@@ -9027,13 +9054,13 @@
          showall   @r{Folding interface, all headlines and text visible.}
 sdepth:  @r{Maximum headline level that will still become an independent}
          @r{section for info and folding modes.  The default is taken from}
-         @address@hidden (= the @code{H} switch in @code{#+OPTIONS}).}
-         @r{If this is smaller than in @code{org-headline-levels}, each}
+         @address@hidden (= the @code{H} switch in @code{#+OPTIONS}).}
+         @r{If this is smaller than in @code{org-export-headline-levels}, each}
          @r{info/folding section can still contain child headlines.}
 toc:     @r{Should the table of content @emph{initially} be visible?}
          @r{Even when @code{nil}, you can always get to the "toc" with 
@kbd{i}.}
 tdepth:  @r{The depth of the table of contents.  The defaults are taken from}
-         @r{the variables @code{org-headline-levels} and 
@code{org-export-with-toc}.}
+         @r{the variables @code{org-export-headline-levels} and 
@code{org-export-with-toc}.}
 ftoc:    @r{Does the css of the page specify a fixed position for the "toc"?}
          @r{If yes, the toc will never be displayed as a section.}
 ltoc:    @r{Should there be short contents (children) in each section?}
@@ -10152,10 +10179,12 @@
 @cindex @code{overview}, STARTUP keyword
 @cindex @code{content}, STARTUP keyword
 @cindex @code{showall}, STARTUP keyword
address@hidden @code{showeverything}, STARTUP keyword
 @example
 overview   @r{top-level headlines only}
 content    @r{all headlines}
-showall    @r{no folding at all, show everything}
+showall          @r{no folding of any entries}
+showeverything   @r{show even drawer contents}
 @end example
 
 @vindex org-startup-indented
@@ -10678,7 +10707,8 @@
 
 @end table
 
address@hidden Hacking, History and Acknowledgments, Miscellaneous, Top
+
address@hidden Hacking, MobileOrg, Miscellaneous, Top
 @appendix Hacking
 @cindex hacking
 
@@ -11444,19 +11474,6 @@
 @}
 @end example
 
-
-
-
-
-
-
-
-
-
-
-
-
-
 @node Using the property API, Using the mapping API, Extracting agenda 
information, Hacking
 @section Using the property API
 @cindex API, for properties
@@ -11636,7 +11653,130 @@
 (length (org-map-entries t "/+WAITING" 'agenda))
 @end lisp
 
address@hidden History and Acknowledgments, Main Index, Hacking, Top
address@hidden MobileOrg, History and Acknowledgments, Hacking, Top
address@hidden MobileOrg
address@hidden iPhone
address@hidden MobileOrg
+
address@hidden is an application for the @i{iPhone/iPod Touch} series of
+devices, developed by Richard Moreland.  Instead of trying to implement the
+full feature set of Org and fighting with synchronization issues, this
+application chooses a different path.  @i{MobileOrg} provides offline viewing
+and capture support for an Org-mode system rooted on a ``real'' computer.
+Synchronization issues are avoided by making @i{MobileOrg} only @i{write} to
+a special capture file, that is only @i{read} by the computer-based system.
+
+This appendix describes the support Org has for creating agenda views in a
+format that can be displayed by @i{MobileOrg}, and for integrating notes
+captured by @i{MobileOrg} into the main system.  It does not cover the
+operation of @i{MobileOrg} itself (see @uref{http://ncogni.to/mobileorg/}).
+
address@hidden
+* Setting up the staging area::  Where to interact with the mobile device
+* Pushing to MobileOrg::        Uploading Org files and agendas
+* Pulling from MobileOrg::      Integrating captured and flagged items
address@hidden menu
+
address@hidden Setting up the staging area, Pushing to MobileOrg, MobileOrg, 
MobileOrg
address@hidden Setting up the staging area
+
+Org-mode has commands to prepare a directory with files for @i{MobileOrg},
+and to read captured notes from there.  If Emacs can directly write to the
+WebDAV directory accessed by @i{MobileOrg}, all you need to do is to point to
+this directory using the variable @code{org-mobile-directory}.
+
+If Emacs cannot access the WebDAV directory directly, you can use a local
+directory for staging.  Other means must then be used to keep this directory
+in sync with the WebDAV directory.  In the following example, files are
+staged in @file{~/stage}, and Org-mode hooks take care of moving files to and
+from the WebDAV directory using @file{scp}.
+
address@hidden
+(setq org-mobile-directory "~/stage/")
+(add-hook 'org-mobile-post-push-hook
+  (lambda ()
+   (shell-command "scp ~/stage/* user@@webdavhost:mobile/")))
+(add-hook 'org-mobile-pre-pull-hook
+  (lambda ()
+   (shell-command "scp user@@webdavhost:mobile/mobileorg.org ~/stage/ ")))
+(add-hook 'org-mobile-post-pull-hook
+  (lambda ()
+   (shell-command "scp ~/stage/mobileorg.org user@@webdavhost:mobile/")))
address@hidden example
+
address@hidden Pushing to MobileOrg, Pulling from MobileOrg, Setting up the 
staging area, MobileOrg
address@hidden Pushing to MobileOrg
+
+This operation copies all files currently listed in @code{org-mobile-files}
+to the directory @code{org-mobile-directory}.  By default this list contains
+all agenda files (as listed in @code{org-agenda-files}), but additional files
+can be included by customizing @code{org-mobiles-files}.  The push operation
+also creates (in the same directory) a special Org file @file{agendas.org}.
+This file is an Org-mode style outline, containing every custom agenda view
+defined by the user.  While creating the agendas, Org-mode will
address@hidden the variable @code{org-mobile-force-id-on-agenda-items}.}
+an ID property on all entries referenced by the agendas, so that these
+entries can be uniquely identified if @i{MobileOrg} flags them for further
+action.  Finally, Org writes the file @file{index.org}, containing links to
+all other files.  If @i{MobileOrg} is configured to request this file from
+the WebDAV server, all agendas and Org files will be downloaded to the
+iPhone.  To speed up the download, MobileOrg will only read files whose
address@hidden automatically in the file @file{checksums.dat}}
+have changed.
+
address@hidden Pulling from MobileOrg,  , Pushing to MobileOrg, MobileOrg
address@hidden Pulling from MobileOrg
+
+When @i{MobileOrg} synchronizes with the WebDAV server, it not only pulls the
+Org files for viewing.  It also appends captured entries and pointers to
+flagged entries to the file @file{mobileorg.org} on the server.  Org has
+a @emph{pull} operation that integrates this information into an inbox file
+and operates on the pointers to flagged entries.  Here is how it works:
+
address@hidden
address@hidden
+Org moves all entries found in
address@hidden@address@hidden will be empty after this
+operation.} and appends them to the file pointed to by the variable
address@hidden  Each captured entry will be a top-level
+entry in the inbox file.
address@hidden
+After moving the entries, Org will attempt to act on the flags.  Some flags
+specify simple operations that will be executed directly and without user
+interaction.  Examples are marking an entry as DONE and/or archiving
address@hidden specified by the variable @code{org-archive-default-action}}.
+All other flagged entries will receive a tag @code{:FLAGGED:}, so that they
+can be easily found again.  When there is a problem finding the entry that
+should be flagged, the pointer entry will remain in the inbox and will be
+marked with an error message.
address@hidden
+Org will then generate an agenda view with all flagged entries.  The user
+should then go through these entries and do whatever actions are necessary.
+If a note has been stored while flagging an entry in @i{MobileOrg}, that note
+will be displayed in the echo area when the cursor is on the corresponding
+agenda line.
address@hidden @kbd
address@hidden ?
address@hidden ?
+Pressing @kbd{?} in that special agenda will display the full flagging note in
+another window and also push it onto the kill ring.  So you could use @kbd{?
+z C-y C-c C-c} to store that flagging note as a normal note in the entry.
+Pressing @kbd{?} twice in succession will offer to remove the
address@hidden:FLAGGED:} tag along with the recorded flagging note (which is 
stored
+in a property).
address@hidden table
address@hidden enumerate
+
address@hidden C-c a ?
+If you are not able to process all flagged entries directly, you can always
+return to this agenda view using @kbd{C-c a ?}.  Note, however, that there is
+a subtle difference.  The view created automatically by @kbd{M-x
+org-mobile-pull RET} is guaranteed to search all files that have been
+addressed by the last pull.  This might include a file that is not currently
+in your list of agenda files.  If you later use @kbd{C-c a ?} to regenerate
+the view, only the current agenda files will be searched.
+
address@hidden History and Acknowledgments, Main Index, MobileOrg, Top
 @appendix History and Acknowledgments
 @cindex acknowledgments
 @cindex history
@@ -11763,6 +11903,8 @@
 @i{Stefan Monnier} provided a patch to keep the Emacs-Lisp compiler
 happy.
 @item
address@hidden Moreland} wrote @i{MobileOrg} for the iPhone.
address@hidden
 @i{Rick Moynihan} proposed allowing multiple TODO sequences in a file
 and being able to quickly restrict the agenda to a subtree.
 @item
@@ -11901,3 +12043,5 @@
 @c fill-column: 77
 @c End:
 
+
address@hidden  LocalWords:  webdavhost pre




reply via email to

[Prev in Thread] Current Thread [Next in Thread]