diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index e7cd308a1..e810bdda5 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -1,4 +1,4 @@ -# -*- mode: org; org-export-publishing-directory: "tmp"; fill-column: 65 -*- +# -*- mode: org; fill-column: 65 -*- #+STARTUP: hidestars @@ -20,7 +20,10 @@ ** Details *** Keybindings in Remember buffers can be configured - Remember buffers are normally in Org-mode, which makes it + + The remember buffers created with Org's extensions are in + Org-mode, which is nice to prepare snippets that will + actually be sotred in Org-mode files. However, this makes it hard to configure key bindings without modifying the Org-mode keymap. There is now a minor mode active in these buffers, `org-remember-mode', and its keymap org-remember-mode-map can @@ -33,55 +36,77 @@ (add-hook 'org-remember-mode-hook (lambda () - (define-key org-remember-mode-map "\C-x\C-s" 'org-remember-finalize))) + (define-key org-remember-mode-map + "\C-x\C-s" 'org-remember-finalize))) #+end_src - You can also use this to free the =C-c C-c= binding (by - binding this key to nil in the minor mode map), so that you - can use =C-c C-c= again to set tags. + If you wish, you can also use this to free the =C-c C-c= + binding (by binding this key to nil in the minor mode map), + so that you can use =C-c C-c= again to set tags. *** Support for ido completion - You can not get the completion interface from /ido.el/ for + + You can now get the completion interface from /ido.el/ for many of Org's internal completion commands by turning on the - variable `org-completion-use-ido'. =ido=mode= must also be + variable =org-completion-use-ido=. =ido=mode= must also be active before you can use this. -*** New face for datelines in agenda column view + +*** New face for date lines in agenda column view + When column view is active in the agenda, and when you have summarizing properties, the date lines become normal column lines and the separation between different days becomes harder to see. If this bothers you, you can now customize the face =org-agenda-column-dateline=. + *** Invisible targets become now anchors in headlines. + These anchors can be used to jump to a directly with an HTML link, just like the =sec-xxx= ids. For example, the following will make a http link - =//domain/path-to-my-file#dummy= work: + =//domain/path-to-my-file.html#dummy= work: #+begin_src org ,# <> ,*** a headline #+end_src -*** New contributed file org-exp-blocks.el +*** New contributed file /org-exp-blocks.el/ This new file implements special export behavior of - user-defined blocks, and it has some defaults to export - commends and ASCII graphics. + user-defined blocks. The currently supported blocks are - For ASCII art, it needs the java program ditaa.jar by Stathis - Sideris. Thanks to Stathis for this excellent program, and - for allowing us to bundle it with Org-mode. + - comment :: Comment blocks with author-specific markup + - ditaa :: conversion of ASCII art into pretty png files + using Stathis Sideris' /ditaa.jar/ program + - dot :: creation of graphs in the /dot/ language + - R :: Sweave type exporting using the R program + + For more details and examples, see the file commentary in + /org-exp-blocks.el/. Kudos to Eric Schulte for this new functionality, after - org-plot.el already his second major contribution. + org-plot.el already his second major contribution. Thanks to + Stathis for this excellent program, and for allowing us to + bundle it with Org-mode. + +*** New contributed file /org-eval-light.el/ + This module gives contrib over execution Emacs Lisp code + blocks included in a file. + + Thanks to Eric Schulte also for this file. *** Link translation You can now configure Org to understand many links created with the Emacs Planner package, so you can cut text from planner pages and paste them into Org-mode files without - having to re-write the links. The following customization es - needed to make this work + having to re-write the links. Among other things, this means + that the command =org-open-at-point-global= which follows + links not only in Org-mode, but in arbitrary files like + source code files etc, will work also with links created by + planner. The following customization es needed to make all of + this work #+begin_src emacs-lisp (setq org-link-translation-function @@ -828,1173 +853,6 @@ This was a request by Chris Randle. -* Version 6.06 - -** Overview - - - New, more CSS-like setup for HTML style information - - Attributes in hyperlinks, for example alt and title for images - - Simplified way to specify file links - - Modified behavior of time stamps in iCalendar export - - New way to compare times during a property search - - New option `org-open-directory-means-index' - - New parameters :prefix and :prefix1 for include files - - New option :index-style for org-publish - - New structure for the timestamp directory for org-publish. - -** Incompatible changes - -*** New structure for the timestamp directory for org-publish. - - The timestamp directory now uses SHA1 hashed versions of the - path to each publishing file. This should be a consistent - and system-independent way to handle things. The change - means that your next publishing command will publish each and - every file again, but just once, until new time stamps are in - place. - -** Details - -*** New setup for HTML style information - - In order to create a more CSS-like setup of the HTML style - information, the following changes have been made: - - The default style has moved to a constant, - =org-export-html-style-default= and should not be changed - anymore. - - The default of the variable =org-export-html-style= is now - just the empty string. This variable should receive - settings that are Org-wide. When using org-publish, this - variable is associated with the =:style= property and can - be used to establish project-wide settings. - - There is a new variable =org-export-html-style-extra= that - should be used for file-local settings. Org-publish can, if - necessary, access this variable with the =:style-extra= - property. - - When a file is published, the values of - - org-export-html-style-default - - org-export-html-style - - org-export-html-style-extra - are all inserted into the HTML header, in the given - sequence. - - This follows a proposal by Rustom Mody. - -*** Attributes in hyperlinks - - You can now set attributes in hyperlinks that will be used - when publishing to HTML. For example, if you want to use the - ALT and TITLE attributes of an inlined image, here is who to - do this: - - : [[./img/a.jpg{{alt="This is image A" title="Image with no action"}}]] - - Thanks to Charles Chen for this idea. - -*** Simplified way to specify file links - - In a link, you can now leave out the "file:" prefix if you - write an absolute file name like =/Users/dominik/.emacs= or - =~/.emacs=, or if you write a relative file name by using - =./= or =../= to start the file path. You cannot write a - plain file name, because plain text is interpreted as an - internal link. - - So for example, a link to an image /A.jpg/ with a thumbnail - /B.jpg/ can now be written like - -#+begin_src org -[[./A.jpg][./B.jpg] ] -#+end_src - -*** Changes in iCalendar export - - Deadline and scheduling time stamps are now treated - differently in iCalendar export. The default behavior is now - the following: - - - a DEADLINE that appears in an entry that is a TODO item is - used as the item's DUE date. Therefore, such a deadline - will no longer show up in the calendar. - - - a DEADLINE that appears in an item that is *not* a TODO - item is exported as an EVENT and will show up in the - calendar. - - - a SCHEDULED timestamp in a TODO item will be used as the - items DTSTART. Therefore, such a timestamp will not show - up in the calendar. - - - a SCHEDULED timestamp in an item that is not a TODO has no - effect on iCalendar export at all. It will be ignored. - - Of course this would not be Emacs if you could not configure - exactly what you want. Take a look at the variables - =org-icalendar-use-deadlines= and - =org-icalendar-use-scheduled= if you want to go back to the - old behavior or even do something completely different. - - Thanks to Karen Cooke for triggering this change. - -*** New way to compare times during a property search - - If the comparison value in a property search is a string that - is enclosed in angular brackets, a time comparison will be - done. For example - - : +DEADLINE>="<2008-12-24 15:20>" - - looks for entries with a deadline on or after that time. - Special allowed values are "" (with time) and "" - (date only). - - This is based on a request by Manish. - -*** New option `org-open-directory-means-index' - - When set, a link pointing to a directory will actually open - the index.org file in that directory. This is a good setting - inside a publishing project. When not set, you get a - finder/explorer window for that directory, or dired, - depending on system and setup. - - This follows a request by Richard Riley. - -*** New parameters :prefix and :prefix1 for include files - - These parameters specify prefixes for each line of included - text. :prefix1 is only for the first line, :prefix for all - other lines. - - This follows a proposal by Richard Riley. - -*** New option :index-style for org-publish - - This option can be used to switch the style of the index - produced by org-publish. Can be `list' (index is just an - itemized list of the titles of the files involved) or `tree' - (the directory structure of the source files is reflected in - the index). The default is `tree'. - - Thanks to Manuel Hermenegildo for the patch. - -*** In the Agenda, inclusion of archives can now be toggled - - Pressing =v= will toggle inclusion of trees with the - ARCHIVE tag, this includes obviously the archive sibling. - - Pressing `C-u v' will include trees with ARCHIVE tag, and - will also include all archive files that are currently - associated with your agenda files. - - This was triggered by a proposal by Manuel Hermenegildo. - -* Version 6.05 - -If I were to name my releases, this one would be called "Adam". -Adam, you definitely owe me a beer :-). And I owe you one, too - -thanks for all the great ideas. - -** Overview - - - Use cursor position in agenda for remember, scheduling and deadlines - - New API for mapping a function over all or selected entries - - Remember templates can be filed to beginning/end of a file - - Visiting a filed remember buffer immediately - - BBDB anniversaries are now links - - Column view in the agenda now cleans the ITEM field - - The format of section numbers in exported files is configurable - - Direct, single key access to allowed values in column view - - New hook to hack exported iCalendar files - - Log mode in agenda now shows end time for CLOCK line - -** Incompatible changes - -*** `C-c C-x C-k' now calls `org-mark-entry-for-agenda-action' - It used to call =org-cut-special=, but that is also at bound - to the key =C-c C-x C-w=. -** Details - -*** Making use of the cursor position in the agenda - - The date at the cursor in the agenda (and also in the - calendar) can now be used to schedule entries, or to set the - date in a remember template correctly. It is also designed - to make it easier to move an entry to a date picked in the - agenda. Thanks to Thomas Baumann for starting the thread - that led to this development. - -**** Calling remember with the cursor date in the agenda - - If you want to use the date at the agenda cursor in a - remember template, start remember from the agenda with the - keys =k r=. While the template is being filled in, the - default date for all time stamps, and also for all - interactive escapes like =%^t= is now the date at the cursor - in the agenda. The exact same command can also be used from - the calendar if you prefer that. - -**** Picking a date for scheduling/deadline in the agenda - - You may now pick the date for scheduling an item or for - setting a deadline in the agenda, where you have the best - overview over free time slots. This is a two step process. - - 1. First you pick the entry that should be acted upon. In - the agenda, you use the keys =k m=. In an org-mode file, - this is on =C-c C-x C-k=. - - 2. Then you find the agenda date you want to apply. When the - cursor is anywhere in the block belonging to that date, - press =k s= to schedule, or =k d= to put a deadline. The - agenda is not updated immediately, press =r= if you want - it to show the affected entry in the right place. - -*** New API for mapping a function over all or selected entries - - Org has sophisticated mapping capabilities to find all - entries satisfying certain criteria. Internally, this - functionality is used to produce agenda views, but there is - also an API that can be used to execute arbitrary functions - for each or selected entries. The main entry point for this - API is: - -#+begin_example --- Function: org-map-entries func &optional match scope &rest skip - Call FUNC at each headline selected by MATCH in SCOPE. - - FUNC is a function or a lisp form. The function will be - called without arguments, with the cursor positioned at - the beginning of the headline. The return values of all - calls to the function will be collected and returned as - a list. - - MATCH is a tags/property/todo match as it is used in the - agenda tags view. Only headlines that are matched by - this query will be considered during the iteration. - When MATCH is nil or t, all headlines will be visited by - the iteration. - - SCOPE determines the scope of this command, it can - specify a file, all agenda files, the current tree and - much more. - - The remaining args are treated as settings for the - skipping facilities of the scanner. -#+end_example - -The function given to that mapping routine can really do anything -you like. Here is a simple example that will turn all entries in -the current file with a tag =TOMORROW= into TODO entries with the -keyword =UPCOMING=. Entries in comment trees and in archive -trees will be ignored. - -#+begin_src emacs-lisp -(org-map-entries - '(org-todo "UPCOMING") - "+TOMORROW" 'file 'archive 'comment) -#+end_src - - The following example counts the number of entries with TODO -keyword =WAITING=, in all agenda files. - -#+begin_src emacs-lisp -(length (org-map-entries t "/+WAITING" nil 'agenda)) -#+end_src - -*** Changes in Remember templates - -**** Remember templates can now use the cursor date in the agenda - Use =k r= to start remember from the agenda, with enforcing - the cursor date as default for any time stamps created by - the template. - -**** Filing remember templates to the beginning or end of a file - You may now set the heading part of a remember template - definition to `top' or `bottom'. The template will then be - filed as a level 1 entry to the beginning or end of the - target file, respectively. Thanks to Adam Spiers for this - proposal. - -**** You can jump to the location of a note immediately after filing it - Just include the =%&= escape anywhere in the template. An - interesting combination now is to use =%!%&=, which will - immediately file and visit the note, which is equivalent to - generating the note directly in the target location. Thanks - to Adam Spiers for this proposal. - -*** BBDB anniversaries are now links. - If you are using =%%(bbdb-anniversaries)= to list - anniversaries in the agenda, you can now directly access the - entry that triggered a listed anniversary from the agenda. - Just click the anniversary - it is a link now. Thanks to - Thomas Baumann for a patch to this effect. - -*** Column view in the agenda now cleans the ITEM field - See the new variable - =org-agenda-columns-remove-prefix-from-item=. Thanks to Adam - Spiers for this proposal. - -*** The format of section number in exported files is configurable - - See the new variable `org-export-section-number-format'. - Thanks to Adam Spiers for this proposal. - -*** Direct access to allowed values in column view - - In column view, if you press a key 1-9 or 0, the - corresponding values from the list of allowed values for that - field at point will be directly selected. Thanks to Levin Du - for this proposal and a patch to this effect. - -*** New hook to hack exported iCalendar files - The new hook `org-before-save-iCalendar-file-hook' runs just - before the buffer with a created iCalendar export is saved. - This is what I settled for after a long discussion with Adam - Spiers about doing some special filtering automatically. - -*** Log mode in agenda now shows end time for CLOCK lines - When turning on log mode in the agenda with =l=, clock lines - will now also list the end time, not only the starting time. - Thanks to Tian Qiu for bringing this up again. -*** Fixes and additions for org-publish - - the :include and :index-title properties in org-publish - work now as advertized - - the #+TITLE of a page will be used in the index - - new :completion-function property can define a hook to be - run after publishing a file. - - Thanks to Manuel Hermenegildo for a patch to this effect. - -* Version 6.04 - -** Overview - -- Statistics cookies [/] and [%] for TODO entries -- Editing source code example in the proper mode -- iCalendar now defines proper UIDs for entries -- New properties for customizing subtree export - -** Incompatible changes - -- The default of the variable `org-tags-match-list-sublevels' is - now `t'. The main reason for this is that it is easier to - explain in the manual and will lead to fewer surprises. - -- The former CONTRIB directory is now called "contrib". This was - already the case in the git distribution, but the tar and zip - archives still did this wrong. - -** Details - -*** Statistics for TODO entries - -The [/] and [%] cookies have already provided statistics for -checkboxes. Now they do the same also for TODO entries. If a -headline contains either cookie, changing the TODO state of any -direct child will trigger an update of this cookie. Children -that are neither TODO nor DONE are ignored. - -There have already been requests to automatically switch the -parent headline to DONE when all children are done. I am not -making this a default feature, because one needs to make many -decisions about which keyword to use, etc. Instead of a complex -customization variable, I am providing a hook that can be used. -This hook will be called each time a TODO statistics cookie is -updated, with the cursor in the corresponding line. Each -function in the hook will receive two arguments, the number of -done entries, and the number of not-done entries, and you can use -the hook to change the state of the headline. Here is an example -implementation: - -#+begin_src emacs-lisp -(defun org-summary-todo (n-done n-not-done) - "Switch entry to DONE when all sub-entries are done, to TODO otherwise." - (let (org-log-done org-log-states) ; turn off logging - (org-todo (if (= n-not-done 0) "DONE" "TODO")))) - -(add-hook 'org-after-todo-statistics-hook 'org-summary-todo) -#+end_src - -*** Editing source code example in the proper mode - -If you are writing a document with source code examples, you can -include these examples into a =#+BEGIN_SRC lang ... #+END_SRC= or -(with the org-mtags module loaded) a == tag - of [[http://mwolson.org/static/doc/emacs-wiki.html#Lisp-Tricks][Emacs Wiki]] and [[http://mwolson.org/static/doc/muse/Embedded-Lisp.html#Embedded-Lisp][Muse]]. - - org-mtags.el :: This new modules allows you to use - Muse-like tags for some structure definitions in Org. - For example, instead of - :#+BEGIN_EXAMPLE - :... - :#+END_EXAMPLE - you can write - : - :... - : - In fact, I myself find these easier to type and to look - at. Also, it will allow you to more easily move text - and files back and forth between Org and Muse. For a - list of supported structure elements, see the commentary - in the file [[http://repo.or.cz/w/org-mode.git?a=blob_plain;f=contrib/lisp/org-mtags.el;hb=HEAD][commentary in the file org-mtags.el]]. - - If you load this module and use the "='. - - When the search term uses the operator with plain number like - =+Effort>=2.7=, then the property value is converted to a - number and a numerical comparison takes place. - - When the search term uses a string on the right hand side of - the operator, a string comparison is done: =+PRIORITY<"C".= - - Finally, if the right hand side is enclosed in curly braces, - a regexp match is done: =aaa={regexp}=. In this case you - should use only the `=' or `<>' operators, meaning "does - match" or "does not match", respectively. - - This was a triggered with a request by Dan Davison. - -*** Search commands can now include archive files. - - If the value of the customization variable - =org-agenda-text-search-extra-files= contains the symbol - =agenda-archives= as the first element in the list, all - archive files of all agenda files will be added to the list - of files to search. This is relevant for the search view - =C-c a s=, as well as for the agenda files multi-occur - command =C-c a /=. - -*** Clock tables can include the archive files - - There are new values for the =:scope= parameter of a clock - table. This can now be =file-with-archives= and - =agenda-with-archives=, in order to collect information not - only from the current file or all agenda files, but also from - all archive files that are currently used by these files. - -*** Orgtbl radio tables generalized. - - The options available for radio tables using orgtbl-mode have - been expanded. You may use several reception points and - formats for the same table, you may have special formatting - in the last line of the table, and many table parameters may - be functions, so that more general transformations are - possible. Jason Riedy provided a patch for this, and he will - hopefully come up with some examples. Thanks! - -* Version 6.01 - -This is a new major release, mostly because of structural changes -in Org. However, since this took a while, there is also a long -list of small improvements and some new significant features. - -** Overview - - - The Org distribution has a new structure - - New system for selecting modules to load - - New archiving mechanism: The Archive Sibling - - Support for Sebastian Rose's JavaScript org-info.js. - - Internal links work now better in HTML export - - Export commands can be done in the background - - Flexible setting of the time block shown by the clock table - - Clock table can be included in the agenda - - Support for ISO week dates (ISO 6801) - - Tag inheritance can be limited to a subset of all tags - - Entries can be sorted by TODO keyword - - And some more small fixes and improvements - -** Incompatible changes - -*** The Org distribution has a new structure - - In the distribution files as well as in the GIT repository, - the lisp files are now located in a subdirectory "lisp", and - the documentation files are located in a subdirectory "doc". - If you are running Org directly from the unpacked - distribution archive (zip or tar file, or GIT repository), - you need to modify your settings for load-path accordingly. - -** Details - -*** The Org distribution has a new structure - - In the distribution files as well as in the GIT repository, - the lisp files are now located in a subdirectory "lisp", and - the documentation files are located in a subdirectory "doc". - If you are running Org directly from the unpacked - distribution archive (zip or tar file, or GIT repository), - you need to modify your settings for load-path accordingly. - -*** Loading modules - - Org-mode has now a system for loading modules by simply - configuring an option that lists all the modules you want to - use. Customize the variable `org-modules'. That variable - lists both modules that are part of the Org-mode core (and in - this way part of Emacs), and modules that are contributed - packages. Contributed modules will only be available when - you have installed them properly (most likely by downloading - the distribution and adding /path/to/orgdir/contrib/lisp to - your load path). - -*** New archiving mechanism: The Archive Sibling - - There is a new method to archive entries in the current file: - By moving it to a sibling called the /Archive Sibling/. That - sibling has the heading "Archive" and also carries the - ARCHIVE tag. This can be a great way to do archiving inside - a project, to get parts of the project out of the way and to - wait with true archiving (moving to another file) until the - entire project is done. Archiving to a sibling keeps much of - the context, for example inherited tags and approximate tree - position in tact. - - The key binding for the is "C-c C-x A", and from the agenda - buffer you can simply use "A". - - Thanks to Ilya Shlyakhter for this rather clever idea. - -*** Support for Sebastian Rose's JavaScript org-info.js. - - This fascinating program allows a completely new viewing - experience for web pages created from Org files. The same - document can be viewed in different ways, and switching - between the views as well as navigation uses single-key - commands. - - One of the view types is an /Info-like/ interface where you - can jump through the sections of the document with the `n' - and `p' keys (and others). There is also a /folding/ - interface where you can fold the document much like you can - fold it in org-mode in Emacs, and cycle through the - visibility both locally and globally. - - To set this up, all you need to do is to make sure that - org-infojs.el gets loaded (customize the variable org-modules - to check). Then add this line to the buffer: - - : #+INFOJS_OPT: view:info - - In that line, you can configure the initial view and other - settings. Available views are =info= for the info-like - interface, and =overview=, =content=, and =showall= for the - folding interface. See the manual for more details. The - JavaScript program is served from - http://orgmode.org/org-info.js, and your exported HTML files - will automatically get it from there. However, you may want - to be independent of the existence and stability of - orgmode.org and install a copy locally. Then you need to - change the path from which the script is loaded, either by - using something like - - : #+INFOJS_OPT: view:info path:../scripts/org-info.js - - or by configuring the variable =org-infojs-options=. - - For details see the documentation provided by Sebastian Rose - together with org-info.js. - -*** Export improvements - - - The export of internal links to HTML now works a lot - better. Most internal links that work while editing an Org - file inside Emacs will now also work the the corresponding - HTML file. - - - You can run many of the export commands in the background - by using `C-c C-u C-c C-e' in order to start the process. - RIght now this will only work if "emacs" is the right - command to get to your Emacs executable - I hope to make - this less system dependent in the future. - - Both these are based on requests by Ilya Shlyakhter. - -*** Improvements to clocktable - - - The clocktable is now much more flexible and user friendly - when trying to specify the time block that should be - considered when constructing the table. - - The =:block= parameter to the table can now look like any - of these: - - | :block | meaning | - |--------------+-----------------------| - | 2008 | The entire year 2008 | - | 2008-04 | The month April 2008 | - | 2008-04-02 | The day April 2, 2008 | - | 2008-W14 | ISO-Week 14 in 2008 | - | today | Today | - | today-5 | The day five days ago | - | thisweek | The current week | - | thisweek-2 | Two weeks ago | - | thismonth | The current month | - | thismonth-12 | Same month, last year | - | lastmonth | Same as thismonth-1 | - - - What is more, you can now use the =S-left= and =S-right= - keys to shift the time block around. The cursor needs to - be in the =#+BEGIN: clocktable= line for this to work. If - the current block is =today=, =S-left= with switch to - yesterday. If the current block is =2008-W14=, =S-right= - will switch to the following week. - - - When the clocktable is collecting from several files, the - total time for each file will now also be listed. This was - a request from Bernt Hansen. - - - If you turn on the new clock report mode with the "R" key in - the agenda, a clock table will be attached to the agenda, - showing the clock report for the file scope and time - interval of the agenda view. To turn this on permanently, - configure the variable - =org-agenda-start-with-clock report-mode=. To modify the - properties of the table, in particular the =:maxlevel= - depth, configure =org-agenda-clockreport-parameter-plist=. - -*** Support for ISO week dates (ISO 6801) - - The agenda now shows the ISO week for the displayed dates, in - the form =W08= for week 8. - - The keys =d=, =w=, =m=, and =y= in the agenda view now accept - prefix arguments. Remember that in the agenda, you can - directly type a prefix argument by typing a number, no need - to press =C-u= first. The prefix argument may be used to - jump directly to a specific day of the year, ISO week, month, - or year, respectively. For example, =32 d= jumps to February - 1st, =9 w= to ISO week number 9. When setting day, week, or - month view, a year may be encoded in the prefix argument as - well. For example, =200712 w= will jump to week 12 in the - year 2007. If such a year specification has only one or two - digits, it will be mapped to the interval 1938-2037. - - When entering a date at the date prompt, you may now also - specify an ISO week. For example - - : w4 Monday of week 4 - : fri w4 Friday of week 4 - : w4-5 Same as above - : 2012 w4 fri Friday of week 4 in 2012. - : 2012-W04-5 Same as above - - So far I have not implemented the effect of - `org-read-date-prefer-future' on this functionality, because - it seemed too magic for me. I'd appreciate comments on this - issue: Should `org-read-date-prefer-future' also push dates - into the next year if the week you are entering has already - passed in the current year? For consistency I guess this - should be the case, but I cannot quite wrap my head around - it. - - I hope but am not entirely convinced that this will behave - sanely also during the first/last week of a year. Please - test extensively and report back. - - This was a request by Thomas Baumann. - -*** Improvements in Search View - - - Calling search view with a C-u prefix will make it match - only in TODO entries. - - - The single quote is no longer considered a word character - during search, so that searching for the word "Nasim" will - also match in "Nasim's". - - -*** Misc - - - Inheritance of tags can now be limited to a subset of all - tags, using the variable =org-use-tag-inheritance=. This - variable may now be a regular expression or a list to - select the inherited tags. Thanks to Michael Ekstrand for - this excellent proposal. - - The regexp option is also implemented for - =org-use-property-inheritance=, so that you can now select - properties for inheritance my name. - - - The INHERIT flag to the function =org-entry-get= can be set - to the symbol =selective=. If this is the case, then the - value of the property will be retrieved using inheritance - if and only if the setting in - =org-use-property-inheritance= selects the property for - inheritance. - - - There are now special faces for the date lines in the - agenda/timeline buffers, and another special face for days - that fall on a weekend: =org-agenda-date= and - =org-agenda-date-weekend=. Both these faces are initially - similar to the =org-agenda-structure= face, but you can - customize them freely. - - - When an entry already has a scheduling or deadline time - stamp, calling `C-c C-s' or `C-c C-d', respectively, will - now use that old date as the default, and you can can use - the "++4d" syntax to invoke shifts relative to that default - date. Simply pressing RET at the prompt will keep the - default date, not switch to today. - - This was an omission in the earlier implementation, spotted - by Wanrong Lin. Thanks! - - - File names in remember templates can be relative, if they - are, they will be interpreted relative to =org-directory=. - - - The handling of the clipboard when inserting into remember - templates is now much better, and gives more control on what - should be inserted with new %-escapes: - - - =%c= - Now always insert the head of the kill ring, never - the X clipboard. - - - =%x= - Insert the content of the X clipboard. This is the - first non-empty value from the PRIMARY, SECONDARY and - CLIPBOARD X clipboards. - - - =%^C= - This allows the user to choose between any of the - clipboard values available, the kill ring head, and the - initial region if set. - - - =%^L= - Like =%^C=, but this inserts an org link using the - selected value. - - Thanks to James TD Smith for this patch. - - - Table export to an internal file can now use a format - specification, similar to the formats that are used by - orgtbl radio tables. The default format is in the variable - =org-table-export-default-format=. You can use properties - =TABLE_EXPORT_FILE= and =TABLE_EXPORT_FORMAT= to specify the - file name to which the export should go, and a local - format. For example: - - : :PROPERTIES: - : :TABLE_EXPORT_FILE: ~/xx.txt - : :TABLE_EXPORT_FORMAT: orgtbl-to-generic :splice t :sep "\t" - : :END: - - Thanks to James TD Smith for this patch. - - - Entries can be sorted by TODO keyword, and the order is given - by the definition sequence of the TODO keywords in the - variable =org-todo-keywords=, or in the =#+TODO= line. Use - the "o" key when sorting with =C-c ^=. - - Thanks to James TD Smith for this patch. - - * Older changes For older Changes, see [[file:Changes_old.org]] diff --git a/ORGWEBPAGE/Changes_old.org b/ORGWEBPAGE/Changes_old.org index 73730923e..c497bf765 100644 --- a/ORGWEBPAGE/Changes_old.org +++ b/ORGWEBPAGE/Changes_old.org @@ -1,4 +1,4 @@ -# -*- mode: org; org-export-publishing-directory: "tmp"; fill-column: 65 -*- +# -*- mode: org; fill-column: 65 -*- #+STARTUP: hidestars @@ -10,6 +10,1173 @@ #+LINK_UP: index.html #+LINK_HOME: http://orgmode.org +* Version 6.06 + +** Overview + + - New, more CSS-like setup for HTML style information + - Attributes in hyperlinks, for example alt and title for images + - Simplified way to specify file links + - Modified behavior of time stamps in iCalendar export + - New way to compare times during a property search + - New option `org-open-directory-means-index' + - New parameters :prefix and :prefix1 for include files + - New option :index-style for org-publish + - New structure for the timestamp directory for org-publish. + +** Incompatible changes + +*** New structure for the timestamp directory for org-publish. + + The timestamp directory now uses SHA1 hashed versions of the + path to each publishing file. This should be a consistent + and system-independent way to handle things. The change + means that your next publishing command will publish each and + every file again, but just once, until new time stamps are in + place. + +** Details + +*** New setup for HTML style information + + In order to create a more CSS-like setup of the HTML style + information, the following changes have been made: + - The default style has moved to a constant, + =org-export-html-style-default= and should not be changed + anymore. + - The default of the variable =org-export-html-style= is now + just the empty string. This variable should receive + settings that are Org-wide. When using org-publish, this + variable is associated with the =:style= property and can + be used to establish project-wide settings. + - There is a new variable =org-export-html-style-extra= that + should be used for file-local settings. Org-publish can, if + necessary, access this variable with the =:style-extra= + property. + - When a file is published, the values of + - org-export-html-style-default + - org-export-html-style + - org-export-html-style-extra + are all inserted into the HTML header, in the given + sequence. + + This follows a proposal by Rustom Mody. + +*** Attributes in hyperlinks + + You can now set attributes in hyperlinks that will be used + when publishing to HTML. For example, if you want to use the + ALT and TITLE attributes of an inlined image, here is who to + do this: + + : [[./img/a.jpg{{alt="This is image A" title="Image with no action"}}]] + + Thanks to Charles Chen for this idea. + +*** Simplified way to specify file links + + In a link, you can now leave out the "file:" prefix if you + write an absolute file name like =/Users/dominik/.emacs= or + =~/.emacs=, or if you write a relative file name by using + =./= or =../= to start the file path. You cannot write a + plain file name, because plain text is interpreted as an + internal link. + + So for example, a link to an image /A.jpg/ with a thumbnail + /B.jpg/ can now be written like + +#+begin_src org +[[./A.jpg][./B.jpg] ] +#+end_src + +*** Changes in iCalendar export + + Deadline and scheduling time stamps are now treated + differently in iCalendar export. The default behavior is now + the following: + + - a DEADLINE that appears in an entry that is a TODO item is + used as the item's DUE date. Therefore, such a deadline + will no longer show up in the calendar. + + - a DEADLINE that appears in an item that is *not* a TODO + item is exported as an EVENT and will show up in the + calendar. + + - a SCHEDULED timestamp in a TODO item will be used as the + items DTSTART. Therefore, such a timestamp will not show + up in the calendar. + + - a SCHEDULED timestamp in an item that is not a TODO has no + effect on iCalendar export at all. It will be ignored. + + Of course this would not be Emacs if you could not configure + exactly what you want. Take a look at the variables + =org-icalendar-use-deadlines= and + =org-icalendar-use-scheduled= if you want to go back to the + old behavior or even do something completely different. + + Thanks to Karen Cooke for triggering this change. + +*** New way to compare times during a property search + + If the comparison value in a property search is a string that + is enclosed in angular brackets, a time comparison will be + done. For example + + : +DEADLINE>="<2008-12-24 15:20>" + + looks for entries with a deadline on or after that time. + Special allowed values are "" (with time) and "" + (date only). + + This is based on a request by Manish. + +*** New option `org-open-directory-means-index' + + When set, a link pointing to a directory will actually open + the index.org file in that directory. This is a good setting + inside a publishing project. When not set, you get a + finder/explorer window for that directory, or dired, + depending on system and setup. + + This follows a request by Richard Riley. + +*** New parameters :prefix and :prefix1 for include files + + These parameters specify prefixes for each line of included + text. :prefix1 is only for the first line, :prefix for all + other lines. + + This follows a proposal by Richard Riley. + +*** New option :index-style for org-publish + + This option can be used to switch the style of the index + produced by org-publish. Can be `list' (index is just an + itemized list of the titles of the files involved) or `tree' + (the directory structure of the source files is reflected in + the index). The default is `tree'. + + Thanks to Manuel Hermenegildo for the patch. + +*** In the Agenda, inclusion of archives can now be toggled + - Pressing =v= will toggle inclusion of trees with the + ARCHIVE tag, this includes obviously the archive sibling. + - Pressing `C-u v' will include trees with ARCHIVE tag, and + will also include all archive files that are currently + associated with your agenda files. + + This was triggered by a proposal by Manuel Hermenegildo. + +* Version 6.05 + +If I were to name my releases, this one would be called "Adam". +Adam, you definitely owe me a beer :-). And I owe you one, too - +thanks for all the great ideas. + +** Overview + + - Use cursor position in agenda for remember, scheduling and deadlines + - New API for mapping a function over all or selected entries + - Remember templates can be filed to beginning/end of a file + - Visiting a filed remember buffer immediately + - BBDB anniversaries are now links + - Column view in the agenda now cleans the ITEM field + - The format of section numbers in exported files is configurable + - Direct, single key access to allowed values in column view + - New hook to hack exported iCalendar files + - Log mode in agenda now shows end time for CLOCK line + +** Incompatible changes + +*** `C-c C-x C-k' now calls `org-mark-entry-for-agenda-action' + It used to call =org-cut-special=, but that is also at bound + to the key =C-c C-x C-w=. +** Details + +*** Making use of the cursor position in the agenda + + The date at the cursor in the agenda (and also in the + calendar) can now be used to schedule entries, or to set the + date in a remember template correctly. It is also designed + to make it easier to move an entry to a date picked in the + agenda. Thanks to Thomas Baumann for starting the thread + that led to this development. + +**** Calling remember with the cursor date in the agenda + + If you want to use the date at the agenda cursor in a + remember template, start remember from the agenda with the + keys =k r=. While the template is being filled in, the + default date for all time stamps, and also for all + interactive escapes like =%^t= is now the date at the cursor + in the agenda. The exact same command can also be used from + the calendar if you prefer that. + +**** Picking a date for scheduling/deadline in the agenda + + You may now pick the date for scheduling an item or for + setting a deadline in the agenda, where you have the best + overview over free time slots. This is a two step process. + + 1. First you pick the entry that should be acted upon. In + the agenda, you use the keys =k m=. In an org-mode file, + this is on =C-c C-x C-k=. + + 2. Then you find the agenda date you want to apply. When the + cursor is anywhere in the block belonging to that date, + press =k s= to schedule, or =k d= to put a deadline. The + agenda is not updated immediately, press =r= if you want + it to show the affected entry in the right place. + +*** New API for mapping a function over all or selected entries + + Org has sophisticated mapping capabilities to find all + entries satisfying certain criteria. Internally, this + functionality is used to produce agenda views, but there is + also an API that can be used to execute arbitrary functions + for each or selected entries. The main entry point for this + API is: + +#+begin_example +-- Function: org-map-entries func &optional match scope &rest skip + Call FUNC at each headline selected by MATCH in SCOPE. + + FUNC is a function or a lisp form. The function will be + called without arguments, with the cursor positioned at + the beginning of the headline. The return values of all + calls to the function will be collected and returned as + a list. + + MATCH is a tags/property/todo match as it is used in the + agenda tags view. Only headlines that are matched by + this query will be considered during the iteration. + When MATCH is nil or t, all headlines will be visited by + the iteration. + + SCOPE determines the scope of this command, it can + specify a file, all agenda files, the current tree and + much more. + + The remaining args are treated as settings for the + skipping facilities of the scanner. +#+end_example + +The function given to that mapping routine can really do anything +you like. Here is a simple example that will turn all entries in +the current file with a tag =TOMORROW= into TODO entries with the +keyword =UPCOMING=. Entries in comment trees and in archive +trees will be ignored. + +#+begin_src emacs-lisp +(org-map-entries + '(org-todo "UPCOMING") + "+TOMORROW" 'file 'archive 'comment) +#+end_src + + The following example counts the number of entries with TODO +keyword =WAITING=, in all agenda files. + +#+begin_src emacs-lisp +(length (org-map-entries t "/+WAITING" nil 'agenda)) +#+end_src + +*** Changes in Remember templates + +**** Remember templates can now use the cursor date in the agenda + Use =k r= to start remember from the agenda, with enforcing + the cursor date as default for any time stamps created by + the template. + +**** Filing remember templates to the beginning or end of a file + You may now set the heading part of a remember template + definition to `top' or `bottom'. The template will then be + filed as a level 1 entry to the beginning or end of the + target file, respectively. Thanks to Adam Spiers for this + proposal. + +**** You can jump to the location of a note immediately after filing it + Just include the =%&= escape anywhere in the template. An + interesting combination now is to use =%!%&=, which will + immediately file and visit the note, which is equivalent to + generating the note directly in the target location. Thanks + to Adam Spiers for this proposal. + +*** BBDB anniversaries are now links. + If you are using =%%(bbdb-anniversaries)= to list + anniversaries in the agenda, you can now directly access the + entry that triggered a listed anniversary from the agenda. + Just click the anniversary - it is a link now. Thanks to + Thomas Baumann for a patch to this effect. + +*** Column view in the agenda now cleans the ITEM field + See the new variable + =org-agenda-columns-remove-prefix-from-item=. Thanks to Adam + Spiers for this proposal. + +*** The format of section number in exported files is configurable + + See the new variable `org-export-section-number-format'. + Thanks to Adam Spiers for this proposal. + +*** Direct access to allowed values in column view + + In column view, if you press a key 1-9 or 0, the + corresponding values from the list of allowed values for that + field at point will be directly selected. Thanks to Levin Du + for this proposal and a patch to this effect. + +*** New hook to hack exported iCalendar files + The new hook `org-before-save-iCalendar-file-hook' runs just + before the buffer with a created iCalendar export is saved. + This is what I settled for after a long discussion with Adam + Spiers about doing some special filtering automatically. + +*** Log mode in agenda now shows end time for CLOCK lines + When turning on log mode in the agenda with =l=, clock lines + will now also list the end time, not only the starting time. + Thanks to Tian Qiu for bringing this up again. +*** Fixes and additions for org-publish + - the :include and :index-title properties in org-publish + work now as advertized + - the #+TITLE of a page will be used in the index + - new :completion-function property can define a hook to be + run after publishing a file. + + Thanks to Manuel Hermenegildo for a patch to this effect. + +* Version 6.04 + +** Overview + +- Statistics cookies [/] and [%] for TODO entries +- Editing source code example in the proper mode +- iCalendar now defines proper UIDs for entries +- New properties for customizing subtree export + +** Incompatible changes + +- The default of the variable `org-tags-match-list-sublevels' is + now `t'. The main reason for this is that it is easier to + explain in the manual and will lead to fewer surprises. + +- The former CONTRIB directory is now called "contrib". This was + already the case in the git distribution, but the tar and zip + archives still did this wrong. + +** Details + +*** Statistics for TODO entries + +The [/] and [%] cookies have already provided statistics for +checkboxes. Now they do the same also for TODO entries. If a +headline contains either cookie, changing the TODO state of any +direct child will trigger an update of this cookie. Children +that are neither TODO nor DONE are ignored. + +There have already been requests to automatically switch the +parent headline to DONE when all children are done. I am not +making this a default feature, because one needs to make many +decisions about which keyword to use, etc. Instead of a complex +customization variable, I am providing a hook that can be used. +This hook will be called each time a TODO statistics cookie is +updated, with the cursor in the corresponding line. Each +function in the hook will receive two arguments, the number of +done entries, and the number of not-done entries, and you can use +the hook to change the state of the headline. Here is an example +implementation: + +#+begin_src emacs-lisp +(defun org-summary-todo (n-done n-not-done) + "Switch entry to DONE when all sub-entries are done, to TODO otherwise." + (let (org-log-done org-log-states) ; turn off logging + (org-todo (if (= n-not-done 0) "DONE" "TODO")))) + +(add-hook 'org-after-todo-statistics-hook 'org-summary-todo) +#+end_src + +*** Editing source code example in the proper mode + +If you are writing a document with source code examples, you can +include these examples into a =#+BEGIN_SRC lang ... #+END_SRC= or +(with the org-mtags module loaded) a == tag + of [[http://mwolson.org/static/doc/emacs-wiki.html#Lisp-Tricks][Emacs Wiki]] and [[http://mwolson.org/static/doc/muse/Embedded-Lisp.html#Embedded-Lisp][Muse]]. + - org-mtags.el :: This new modules allows you to use + Muse-like tags for some structure definitions in Org. + For example, instead of + :#+BEGIN_EXAMPLE + :... + :#+END_EXAMPLE + you can write + : + :... + : + In fact, I myself find these easier to type and to look + at. Also, it will allow you to more easily move text + and files back and forth between Org and Muse. For a + list of supported structure elements, see the commentary + in the file [[http://repo.or.cz/w/org-mode.git?a=blob_plain;f=contrib/lisp/org-mtags.el;hb=HEAD][commentary in the file org-mtags.el]]. + + If you load this module and use the "='. + + When the search term uses the operator with plain number like + =+Effort>=2.7=, then the property value is converted to a + number and a numerical comparison takes place. + + When the search term uses a string on the right hand side of + the operator, a string comparison is done: =+PRIORITY<"C".= + + Finally, if the right hand side is enclosed in curly braces, + a regexp match is done: =aaa={regexp}=. In this case you + should use only the `=' or `<>' operators, meaning "does + match" or "does not match", respectively. + + This was a triggered with a request by Dan Davison. + +*** Search commands can now include archive files. + + If the value of the customization variable + =org-agenda-text-search-extra-files= contains the symbol + =agenda-archives= as the first element in the list, all + archive files of all agenda files will be added to the list + of files to search. This is relevant for the search view + =C-c a s=, as well as for the agenda files multi-occur + command =C-c a /=. + +*** Clock tables can include the archive files + + There are new values for the =:scope= parameter of a clock + table. This can now be =file-with-archives= and + =agenda-with-archives=, in order to collect information not + only from the current file or all agenda files, but also from + all archive files that are currently used by these files. + +*** Orgtbl radio tables generalized. + + The options available for radio tables using orgtbl-mode have + been expanded. You may use several reception points and + formats for the same table, you may have special formatting + in the last line of the table, and many table parameters may + be functions, so that more general transformations are + possible. Jason Riedy provided a patch for this, and he will + hopefully come up with some examples. Thanks! + +* Version 6.01 + +This is a new major release, mostly because of structural changes +in Org. However, since this took a while, there is also a long +list of small improvements and some new significant features. + +** Overview + + - The Org distribution has a new structure + - New system for selecting modules to load + - New archiving mechanism: The Archive Sibling + - Support for Sebastian Rose's JavaScript org-info.js. + - Internal links work now better in HTML export + - Export commands can be done in the background + - Flexible setting of the time block shown by the clock table + - Clock table can be included in the agenda + - Support for ISO week dates (ISO 6801) + - Tag inheritance can be limited to a subset of all tags + - Entries can be sorted by TODO keyword + - And some more small fixes and improvements + +** Incompatible changes + +*** The Org distribution has a new structure + + In the distribution files as well as in the GIT repository, + the lisp files are now located in a subdirectory "lisp", and + the documentation files are located in a subdirectory "doc". + If you are running Org directly from the unpacked + distribution archive (zip or tar file, or GIT repository), + you need to modify your settings for load-path accordingly. + +** Details + +*** The Org distribution has a new structure + + In the distribution files as well as in the GIT repository, + the lisp files are now located in a subdirectory "lisp", and + the documentation files are located in a subdirectory "doc". + If you are running Org directly from the unpacked + distribution archive (zip or tar file, or GIT repository), + you need to modify your settings for load-path accordingly. + +*** Loading modules + + Org-mode has now a system for loading modules by simply + configuring an option that lists all the modules you want to + use. Customize the variable `org-modules'. That variable + lists both modules that are part of the Org-mode core (and in + this way part of Emacs), and modules that are contributed + packages. Contributed modules will only be available when + you have installed them properly (most likely by downloading + the distribution and adding /path/to/orgdir/contrib/lisp to + your load path). + +*** New archiving mechanism: The Archive Sibling + + There is a new method to archive entries in the current file: + By moving it to a sibling called the /Archive Sibling/. That + sibling has the heading "Archive" and also carries the + ARCHIVE tag. This can be a great way to do archiving inside + a project, to get parts of the project out of the way and to + wait with true archiving (moving to another file) until the + entire project is done. Archiving to a sibling keeps much of + the context, for example inherited tags and approximate tree + position in tact. + + The key binding for the is "C-c C-x A", and from the agenda + buffer you can simply use "A". + + Thanks to Ilya Shlyakhter for this rather clever idea. + +*** Support for Sebastian Rose's JavaScript org-info.js. + + This fascinating program allows a completely new viewing + experience for web pages created from Org files. The same + document can be viewed in different ways, and switching + between the views as well as navigation uses single-key + commands. + + One of the view types is an /Info-like/ interface where you + can jump through the sections of the document with the `n' + and `p' keys (and others). There is also a /folding/ + interface where you can fold the document much like you can + fold it in org-mode in Emacs, and cycle through the + visibility both locally and globally. + + To set this up, all you need to do is to make sure that + org-infojs.el gets loaded (customize the variable org-modules + to check). Then add this line to the buffer: + + : #+INFOJS_OPT: view:info + + In that line, you can configure the initial view and other + settings. Available views are =info= for the info-like + interface, and =overview=, =content=, and =showall= for the + folding interface. See the manual for more details. The + JavaScript program is served from + http://orgmode.org/org-info.js, and your exported HTML files + will automatically get it from there. However, you may want + to be independent of the existence and stability of + orgmode.org and install a copy locally. Then you need to + change the path from which the script is loaded, either by + using something like + + : #+INFOJS_OPT: view:info path:../scripts/org-info.js + + or by configuring the variable =org-infojs-options=. + + For details see the documentation provided by Sebastian Rose + together with org-info.js. + +*** Export improvements + + - The export of internal links to HTML now works a lot + better. Most internal links that work while editing an Org + file inside Emacs will now also work the the corresponding + HTML file. + + - You can run many of the export commands in the background + by using `C-c C-u C-c C-e' in order to start the process. + RIght now this will only work if "emacs" is the right + command to get to your Emacs executable - I hope to make + this less system dependent in the future. + + Both these are based on requests by Ilya Shlyakhter. + +*** Improvements to clocktable + + - The clocktable is now much more flexible and user friendly + when trying to specify the time block that should be + considered when constructing the table. + + The =:block= parameter to the table can now look like any + of these: + + | :block | meaning | + |--------------+-----------------------| + | 2008 | The entire year 2008 | + | 2008-04 | The month April 2008 | + | 2008-04-02 | The day April 2, 2008 | + | 2008-W14 | ISO-Week 14 in 2008 | + | today | Today | + | today-5 | The day five days ago | + | thisweek | The current week | + | thisweek-2 | Two weeks ago | + | thismonth | The current month | + | thismonth-12 | Same month, last year | + | lastmonth | Same as thismonth-1 | + + + What is more, you can now use the =S-left= and =S-right= + keys to shift the time block around. The cursor needs to + be in the =#+BEGIN: clocktable= line for this to work. If + the current block is =today=, =S-left= with switch to + yesterday. If the current block is =2008-W14=, =S-right= + will switch to the following week. + + - When the clocktable is collecting from several files, the + total time for each file will now also be listed. This was + a request from Bernt Hansen. + + - If you turn on the new clock report mode with the "R" key in + the agenda, a clock table will be attached to the agenda, + showing the clock report for the file scope and time + interval of the agenda view. To turn this on permanently, + configure the variable + =org-agenda-start-with-clock report-mode=. To modify the + properties of the table, in particular the =:maxlevel= + depth, configure =org-agenda-clockreport-parameter-plist=. + +*** Support for ISO week dates (ISO 6801) + + The agenda now shows the ISO week for the displayed dates, in + the form =W08= for week 8. + + The keys =d=, =w=, =m=, and =y= in the agenda view now accept + prefix arguments. Remember that in the agenda, you can + directly type a prefix argument by typing a number, no need + to press =C-u= first. The prefix argument may be used to + jump directly to a specific day of the year, ISO week, month, + or year, respectively. For example, =32 d= jumps to February + 1st, =9 w= to ISO week number 9. When setting day, week, or + month view, a year may be encoded in the prefix argument as + well. For example, =200712 w= will jump to week 12 in the + year 2007. If such a year specification has only one or two + digits, it will be mapped to the interval 1938-2037. + + When entering a date at the date prompt, you may now also + specify an ISO week. For example + + : w4 Monday of week 4 + : fri w4 Friday of week 4 + : w4-5 Same as above + : 2012 w4 fri Friday of week 4 in 2012. + : 2012-W04-5 Same as above + + So far I have not implemented the effect of + `org-read-date-prefer-future' on this functionality, because + it seemed too magic for me. I'd appreciate comments on this + issue: Should `org-read-date-prefer-future' also push dates + into the next year if the week you are entering has already + passed in the current year? For consistency I guess this + should be the case, but I cannot quite wrap my head around + it. + + I hope but am not entirely convinced that this will behave + sanely also during the first/last week of a year. Please + test extensively and report back. + + This was a request by Thomas Baumann. + +*** Improvements in Search View + + - Calling search view with a C-u prefix will make it match + only in TODO entries. + + - The single quote is no longer considered a word character + during search, so that searching for the word "Nasim" will + also match in "Nasim's". + + +*** Misc + + - Inheritance of tags can now be limited to a subset of all + tags, using the variable =org-use-tag-inheritance=. This + variable may now be a regular expression or a list to + select the inherited tags. Thanks to Michael Ekstrand for + this excellent proposal. + + The regexp option is also implemented for + =org-use-property-inheritance=, so that you can now select + properties for inheritance my name. + + - The INHERIT flag to the function =org-entry-get= can be set + to the symbol =selective=. If this is the case, then the + value of the property will be retrieved using inheritance + if and only if the setting in + =org-use-property-inheritance= selects the property for + inheritance. + + - There are now special faces for the date lines in the + agenda/timeline buffers, and another special face for days + that fall on a weekend: =org-agenda-date= and + =org-agenda-date-weekend=. Both these faces are initially + similar to the =org-agenda-structure= face, but you can + customize them freely. + + - When an entry already has a scheduling or deadline time + stamp, calling `C-c C-s' or `C-c C-d', respectively, will + now use that old date as the default, and you can can use + the "++4d" syntax to invoke shifts relative to that default + date. Simply pressing RET at the prompt will keep the + default date, not switch to today. + + This was an omission in the earlier implementation, spotted + by Wanrong Lin. Thanks! + + - File names in remember templates can be relative, if they + are, they will be interpreted relative to =org-directory=. + + - The handling of the clipboard when inserting into remember + templates is now much better, and gives more control on what + should be inserted with new %-escapes: + + - =%c= - Now always insert the head of the kill ring, never + the X clipboard. + + - =%x= - Insert the content of the X clipboard. This is the + first non-empty value from the PRIMARY, SECONDARY and + CLIPBOARD X clipboards. + + - =%^C= - This allows the user to choose between any of the + clipboard values available, the kill ring head, and the + initial region if set. + + - =%^L= - Like =%^C=, but this inserts an org link using the + selected value. + + Thanks to James TD Smith for this patch. + + - Table export to an internal file can now use a format + specification, similar to the formats that are used by + orgtbl radio tables. The default format is in the variable + =org-table-export-default-format=. You can use properties + =TABLE_EXPORT_FILE= and =TABLE_EXPORT_FORMAT= to specify the + file name to which the export should go, and a local + format. For example: + + : :PROPERTIES: + : :TABLE_EXPORT_FILE: ~/xx.txt + : :TABLE_EXPORT_FORMAT: orgtbl-to-generic :splice t :sep "\t" + : :END: + + Thanks to James TD Smith for this patch. + + - Entries can be sorted by TODO keyword, and the order is given + by the definition sequence of the TODO keywords in the + variable =org-todo-keywords=, or in the =#+TODO= line. Use + the "o" key when sorting with =C-c ^=. + + Thanks to James TD Smith for this patch. + + * Version 5.23 ** Overview diff --git a/ORGWEBPAGE/index.org b/ORGWEBPAGE/index.org index d92db215b..f0d0d9776 100644 --- a/ORGWEBPAGE/index.org +++ b/ORGWEBPAGE/index.org @@ -92,7 +92,7 @@ Some more information about this can be found in the [[http://orgmode.org/worg/o small files, to save bandwidth. - If you really need it, you can also have the entire manual in a [[file:org.html][single monolithic file]]. - - Download the documentation in other formats: [[file:org.pdf][PDF]], [[file:org][Info]], or [[file:org.texi][TeXInfo]]. + - Download the documentation as a [[file:org.pdf][PDF document]]. - There is also a [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual][Japanese translation]] of the manual (version 4.60), produced by Takeshi Okano. - The Org manual is a GNU Manual released under the GFDL. If you