update of packages
This commit is contained in:
@@ -15,7 +15,7 @@
|
||||
@copying
|
||||
This manual is for Org version 9.6.
|
||||
|
||||
Copyright @copyright{} 2004--2022 Free Software Foundation, Inc.
|
||||
Copyright @copyright{} 2004--2023 Free Software Foundation, Inc.
|
||||
|
||||
@quotation
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
@@ -1776,11 +1776,12 @@ After the drawer.
|
||||
@findex org-insert-drawer
|
||||
You can interactively insert a drawer at point by calling
|
||||
@code{org-insert-drawer}, which is bound to @kbd{C-c C-x d}. With an
|
||||
active region, this command puts the region inside the drawer. With
|
||||
a prefix argument, this command calls @code{org-insert-property-drawer},
|
||||
which creates a @samp{PROPERTIES} drawer right below the current headline.
|
||||
Org mode uses this special drawer for storing properties (see
|
||||
@ref{Properties and Columns}). You cannot use it for anything else.
|
||||
active region, this command puts the region inside the drawer. With a
|
||||
prefix argument, this command calls non-interactive function
|
||||
@code{org-insert-property-drawer}, which creates a @samp{PROPERTIES} drawer
|
||||
right below the current headline. Org mode uses this special drawer
|
||||
for storing properties (see @ref{Properties and Columns}). You cannot use
|
||||
it for anything else.
|
||||
|
||||
Completion over drawer keywords is also possible using
|
||||
@kbd{M-@key{TAB}}@footnote{Many desktops intercept @kbd{M-@key{TAB}} to switch windows.
|
||||
@@ -1929,7 +1930,7 @@ necessary.
|
||||
|
||||
@item @kbd{M-x org-table-blank-field}
|
||||
@findex org-table-blank-field
|
||||
Blank the field at point.
|
||||
Blank the current table field or active region.
|
||||
|
||||
@item @kbd{S-@key{TAB}} (@code{org-table-previous-field})
|
||||
@kindex S-TAB
|
||||
@@ -5116,7 +5117,7 @@ all children are done, you can use the following setup:
|
||||
@lisp
|
||||
(defun org-summary-todo (n-done n-not-done)
|
||||
"Switch entry to DONE when all subentries are done, to TODO otherwise."
|
||||
(let (org-log-done org-log-states) ; turn off logging
|
||||
(let (org-log-done org-todo-log-states) ; turn off logging
|
||||
(org-todo (if (= n-not-done 0) "DONE" "TODO"))))
|
||||
|
||||
(add-hook 'org-after-todo-statistics-hook #'org-summary-todo)
|
||||
@@ -5882,7 +5883,7 @@ With point in a property drawer, this executes property commands.
|
||||
Set a property in the current entry. Both the property and the
|
||||
value can be inserted using completion.
|
||||
|
||||
@item @kbd{S-@key{RIGHT}} (@code{org-property-next-allowed-values})
|
||||
@item @kbd{S-@key{RIGHT}} (@code{org-property-next-allowed-value})
|
||||
@itemx @kbd{S-@key{LEFT}} (@code{org-property-previous-allowed-value})
|
||||
@kindex S-RIGHT
|
||||
@kindex S-LEFT
|
||||
@@ -6573,8 +6574,8 @@ or years (y). The following shows up in the agenda every Wednesday:
|
||||
@findex org-block
|
||||
|
||||
For more complex date specifications, Org mode supports using the
|
||||
special expression diary entries implemented in the Emacs Calendar
|
||||
package@footnote{When working with the standard diary expression functions, you
|
||||
special expression diary entries implemented in the
|
||||
@ref{Special Diary Entries,Emacs Calendar package,,emacs,}@footnote{When working with the standard diary expression functions, you
|
||||
need to be very careful with the order of the arguments. That order
|
||||
depends evilly on the variable @code{calendar-date-style}. For example, to
|
||||
specify a date December 1, 2005, the call might look like
|
||||
@@ -6585,7 +6586,8 @@ these functions, namely @code{org-date}, @code{org-anniversary}, @code{org-cycli
|
||||
~org-block}. These work just like the corresponding @code{diary-}
|
||||
functions, but with stable ISO order of arguments (year, month, day)
|
||||
wherever applicable, independent of the value of
|
||||
@code{calendar-date-style}.}. For example, with optional time:
|
||||
@code{calendar-date-style}.}.
|
||||
For example, with optional time:
|
||||
|
||||
@example
|
||||
* 22:00-23:00 The nerd meeting on every 2nd Thursday of the month
|
||||
@@ -9435,7 +9437,9 @@ a @code{day}, @code{week}, @code{month} or @code{year}. For weekly agendas, the
|
||||
is to start on the previous Monday (see
|
||||
@code{org-agenda-start-on-weekday}). You can also set the start date using
|
||||
a date shift: @samp{(setq org-agenda-start-day "+10d")} starts the agenda
|
||||
ten days from today in the future.
|
||||
ten days from today in the future. @code{org-agenda-start-on-weekday}
|
||||
takes precedence over @code{org-agenda-start-day} in weekly and bi-weekly
|
||||
agendas.
|
||||
|
||||
Remote editing from the agenda buffer means, for example, that you can
|
||||
change the dates of deadlines and appointments from the agenda buffer.
|
||||
@@ -10848,9 +10852,9 @@ Mark all visible agenda entries for bulk action.
|
||||
|
||||
Unmark entry for bulk action.
|
||||
|
||||
@item @kbd{U} (@code{org-agenda-bulk-remove-all-marks})
|
||||
@item @kbd{U} (@code{org-agenda-bulk-unmark-all})
|
||||
@kindex U
|
||||
@findex org-agenda-bulk-remove-all-marks
|
||||
@findex org-agenda-bulk-unmark-all
|
||||
|
||||
Unmark all marked entries for bulk action.
|
||||
|
||||
@@ -12359,9 +12363,9 @@ a non-@code{nil} value, Org prompts in the minibuffer. To switch back to
|
||||
the hierarchical menu, press @kbd{?}.
|
||||
|
||||
@table @asis
|
||||
@item @kbd{C-c C-e} (@code{org-export})
|
||||
@item @kbd{C-c C-e} (@code{org-export-dispatch})
|
||||
@kindex C-c C-e
|
||||
@findex org-export
|
||||
@findex org-export-dispatch
|
||||
|
||||
Invokes the export dispatcher interface. The options show default
|
||||
settings. The @kbd{C-u} prefix argument preserves options from
|
||||
@@ -12886,7 +12890,7 @@ with the custom ID @samp{theory}, you can use
|
||||
The following command allows navigating to the included document:
|
||||
|
||||
@table @asis
|
||||
@item @kbd{C-c '} (@code{org-edit~special})
|
||||
@item @kbd{C-c '} (@code{org-edit-special})
|
||||
@kindex C-c '
|
||||
@findex org-edit-special
|
||||
|
||||
@@ -14449,7 +14453,7 @@ A sample Org file with the above headers:
|
||||
@vindex org-export-default-language
|
||||
@LaTeX{} packages @samp{babel} or @samp{polyglossia} can also be loaded in a
|
||||
document. The ``AUTO'' string will be replaced in both cases by the
|
||||
appropiate value for the @samp{LANGUAGE} keyword, if present in the
|
||||
appropriate value for the @samp{LANGUAGE} keyword, if present in the
|
||||
document, or by the value of @code{org-export-default-language}. Let's see
|
||||
some examples in one or another case.
|
||||
|
||||
@@ -15084,9 +15088,9 @@ executable. Without it, export cannot finish.
|
||||
@subsection ODT export commands
|
||||
|
||||
@table @asis
|
||||
@item @kbd{C-c C-e o o} (@code{org-export-to-odt})
|
||||
@item @kbd{C-c C-e o o} (@code{org-odt-export-to-odt})
|
||||
@kindex C-c C-e o o
|
||||
@findex org-export-to-odt
|
||||
@findex org-odt-export-to-odt
|
||||
Export as OpenDocument Text file.
|
||||
|
||||
@cindex @samp{EXPORT_FILE_NAME}, property
|
||||
@@ -16765,7 +16769,12 @@ can remove every headline in the buffer during export like this:
|
||||
"Remove all headlines in the current buffer.
|
||||
BACKEND is the export back-end being used, as a symbol."
|
||||
(org-map-entries
|
||||
(lambda () (delete-region (point) (line-beginning-position 2)))))
|
||||
(lambda ()
|
||||
(delete-region (point) (line-beginning-position 2))
|
||||
;; We need to tell `org-map-entries' to not skip over heading at
|
||||
;; point. Otherwise, it would continue from _next_ heading. See
|
||||
;; the docstring of `org-map-entries' for details.
|
||||
(setq org-map-continue-from (point)))))
|
||||
|
||||
(add-hook 'org-export-before-parsing-hook #'my-headline-removal)
|
||||
@end lisp
|
||||
@@ -16842,7 +16851,7 @@ is the type targeted by the filter. Valid types are:
|
||||
@tab verse-block
|
||||
@end multitable
|
||||
|
||||
Here is an example filter that replaces non-breaking spaces ~ ~ in the
|
||||
Here is an example filter that replaces non-breaking spaces @code{ } in the
|
||||
Org buffer with @samp{~} for the @LaTeX{} back-end.
|
||||
|
||||
@lisp
|
||||
@@ -19106,7 +19115,8 @@ evaluating untrusted code blocks by prompting for a confirmation.
|
||||
|
||||
@table @asis
|
||||
@item @samp{yes}
|
||||
Org always evaluates the source code without asking permission.
|
||||
Org evaluates the source code, possibly asking permission according
|
||||
to @code{org-confirm-babel-evaluate}.
|
||||
|
||||
@item @samp{never} or @samp{no}
|
||||
Org never evaluates the source code.
|
||||
@@ -19475,7 +19485,7 @@ Usage example: @samp{:results none}.
|
||||
@item @samp{discard}
|
||||
Ignore the results completely. This option is similar to @samp{none},
|
||||
but no processing is performed on the return value. Calling the
|
||||
code block programatically (see @ref{How to evaluate source code}) or by
|
||||
code block programmatically (see @ref{How to evaluate source code}) or by
|
||||
reference (see @ref{Passing arguments} and @ref{Noweb Reference Syntax}) will
|
||||
always yield nil.
|
||||
|
||||
@@ -19756,7 +19766,7 @@ a octal shorthand is defined, @samp{oXXX} (@samp{o} for octal). Using this, our
|
||||
read-only example is @samp{:tangle-mode o444}. Omitting the @samp{o} prefix will
|
||||
cause the argument to be interpreted as an integer, which can lead to
|
||||
unexpected results (@samp{444} is the same as @samp{o674}).
|
||||
Two other shorthands are recognised, ls-style strings like
|
||||
Two other shorthands are recognized, ls-style strings like
|
||||
@samp{rw-r--r--}, and chmod-style permissions like @samp{g+w}.
|
||||
Note that chmod-style permissions are based on
|
||||
@code{org-babel-tangle-default-file-mode}, which is @samp{#o544} by default.
|
||||
@@ -19764,7 +19774,7 @@ Note that chmod-style permissions are based on
|
||||
When @samp{:tangle-mode} and @samp{:shebang} are both specified, the give
|
||||
@samp{:tangle-mode} will override the permissions from @samp{:shebang}. When
|
||||
multiple source code blocks tangle to a single file with conflicting
|
||||
@samp{:tangle-mode} header arguments, Org's behaviour is undefined.
|
||||
@samp{:tangle-mode} header arguments, Org's behavior is undefined.
|
||||
|
||||
@cindex @samp{no-expand}, header argument
|
||||
By default Org expands code blocks during tangling. The @samp{no-expand}
|
||||
@@ -21136,15 +21146,23 @@ corresponding variables are @code{org-footnote-define-inline},
|
||||
@end multitable
|
||||
|
||||
@vindex org-hide-block-startup
|
||||
To hide blocks on startup, use these keywords. The
|
||||
corresponding variable is @code{org-hide-block-startup}.
|
||||
@vindex org-hide-drawer-startup
|
||||
To hide blocks or drawers on startup, use these keywords. The
|
||||
corresponding variables are @code{org-hide-block-startup} and
|
||||
@code{org-hide-drawer-startup}.
|
||||
|
||||
@multitable {aaaaaaaaaaaaaa} {aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}
|
||||
@multitable {aaaaaaaaaaaaaaa} {aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa}
|
||||
@item @samp{hideblocks}
|
||||
@tab Hide all begin/end blocks on startup.
|
||||
@item @samp{nohideblocks}
|
||||
@tab Do not hide blocks on startup.
|
||||
@item @samp{hidedrawers}
|
||||
@tab Hide all begin/end blocks on startup.
|
||||
@item @samp{nohidedrawers}
|
||||
@tab Do not hide blocks on startup.
|
||||
@end multitable
|
||||
@end table
|
||||
|
||||
|
||||
@vindex org-pretty-entities
|
||||
The display of entities as UTF-8 characters is governed by the
|
||||
@@ -21157,6 +21175,7 @@ variable @code{org-pretty-entities} and the keywords
|
||||
@tab Leave entities plain.
|
||||
@end multitable
|
||||
|
||||
@table @asis
|
||||
@item @samp{#+TAGS: TAG1(c1) TAG2(c2)}
|
||||
@cindex @samp{TAGS}, keyword
|
||||
@vindex org-tag-alist
|
||||
@@ -21164,9 +21183,7 @@ These lines (several such lines are allowed) specify the valid tags
|
||||
in this file, and (potentially) the corresponding @emph{fast tag
|
||||
selection} keys. The corresponding variable is @code{org-tag-alist}.
|
||||
|
||||
@item @samp{#+TODO:}
|
||||
@itemx @samp{#+SEQ_TODO:}
|
||||
@itemx @samp{#+TYP_TODO:}
|
||||
@item @samp{#+TODO:}, @samp{#+SEQ_TODO:}, @samp{#+TYP_TODO:}
|
||||
@cindex @samp{SEQ_TODO}, keyword
|
||||
@cindex @samp{TODO}, keyword
|
||||
@cindex @samp{TYP_TODO}, keyword
|
||||
@@ -21380,12 +21397,12 @@ embedded calculations. See @ref{Embedded Mode,GNU Emacs Calc Manual,,calc,}.
|
||||
@vindex org-table-formula-constants
|
||||
|
||||
Org can use names for constants in formulas in tables. Org can also
|
||||
use calculation suffixes for units, such as @samp{M} for @samp{Mega}. For
|
||||
a standard collection of such constants, install the @samp{constants}
|
||||
use calculation suffixes for units, such as @samp{M} for @samp{Mega}. For a
|
||||
standard collection of such constants, install the @samp{constants}
|
||||
package. Install version 2.0 of this package, available at
|
||||
@uref{http://www.astro.uva.nl/~dominik/Tools}. Org checks if the function
|
||||
@code{constants-get} has been autoloaded. Installation instructions are
|
||||
in the file @samp{constants.el}.
|
||||
@uref{https://github.com/cdominik/constants-for-Emacs}. Org checks if the
|
||||
function @code{constants-get} has been autoloaded. Installation
|
||||
instructions are in the file @samp{constants.el}.
|
||||
|
||||
@item @samp{cdlatex.el} by Carsten Dominik
|
||||
@cindex @file{cdlatex.el}
|
||||
@@ -24106,4 +24123,4 @@ that are mentioned in the manual. For a more complete list, use
|
||||
|
||||
@printindex vr
|
||||
|
||||
@bye
|
||||
@bye
|
||||
|
||||
Reference in New Issue
Block a user