manual: Small rewording

* doc/org-manual.org (Attachments): Avoid using "cloud" term.
(Attachment defaults and dispatcher): Use present tense.
(Attachment options): Use Org attach instead of symbol org-attach.
This commit is contained in:
Nicolas Goaziou 2020-05-14 23:56:52 +02:00
parent 99bb514f7f
commit 817acdcdfb
1 changed files with 15 additions and 9 deletions

View File

@ -7911,8 +7911,8 @@ See the docstring of the variable for more information.
It is often useful to associate reference material with an outline It is often useful to associate reference material with an outline
node. Small chunks of plain text can simply be stored in the subtree node. Small chunks of plain text can simply be stored in the subtree
of a project. Hyperlinks (see [[*Hyperlinks]]) can establish associations of a project. Hyperlinks (see [[*Hyperlinks]]) can establish associations
with files that live elsewhere on your computer or in the cloud, like with files that live elsewhere on a local, or even remote, computer,
emails or source code files belonging to a project. like emails or source code files belonging to a project.
Another method is /attachments/, which are files located in a Another method is /attachments/, which are files located in a
directory belonging to an outline node. Org uses directories either directory belonging to an outline node. Org uses directories either
@ -7922,16 +7922,18 @@ named by a unique ID of each entry, or by a =DIR= property.
:PROPERTIES: :PROPERTIES:
:DESCRIPTION: How to access attachment commands :DESCRIPTION: How to access attachment commands
:END: :END:
By default, org-attach will use ID properties when adding attachments
to outline nodes. This makes working with attachments fully By default, Org attach uses ID properties when adding attachments to
automated. There is no decision needed for folder-name or location. outline nodes. This makes working with attachments fully automated.
ID-based directories are by default located in the =data/= directory, There is no decision needed for folder-name or location. ID-based
which lives in the same directory where your Org file lives[fn:89]. directories are by default located in the =data/= directory, which
For more control over the setup, see [[*Attachment options]]. lives in the same directory where your Org file lives[fn:89].
When attachments are made using ~org-attach~ a default tag =ATTACH= is When attachments are made using ~org-attach~ a default tag =ATTACH= is
added to the node that gets the attachments. added to the node that gets the attachments.
For more control over the setup, see [[*Attachment options]].
The following commands deal with attachments: The following commands deal with attachments:
- {{{kbd(C-c C-a)}}} (~org-attach~) :: - {{{kbd(C-c C-a)}}} (~org-attach~) ::
@ -8041,6 +8043,7 @@ The following commands deal with attachments:
:PROPERTIES: :PROPERTIES:
:DESCRIPTION: Configuring the attachment system :DESCRIPTION: Configuring the attachment system
:END: :END:
There are a couple of options for attachments that are worth There are a couple of options for attachments that are worth
mentioning. mentioning.
@ -8059,7 +8062,7 @@ mentioning.
#+vindex: org-attach-use-inheritance #+vindex: org-attach-use-inheritance
By default folders attached to an outline node are inherited from By default folders attached to an outline node are inherited from
parents according to ~org-use-property-inheritance~. If one instead parents according to ~org-use-property-inheritance~. If one instead
want to set inheritance specifically for org-attach that can be done want to set inheritance specifically for Org attach that can be done
using ~org-attach-use-inheritance~. Inheriting documents through using ~org-attach-use-inheritance~. Inheriting documents through
the node hierarchy makes a lot of sense in most cases. Especially the node hierarchy makes a lot of sense in most cases. Especially
when using attachment links (see [[*Attachment links]]). The following when using attachment links (see [[*Attachment links]]). The following
@ -8145,6 +8148,7 @@ default settings.
:PROPERTIES: :PROPERTIES:
:DESCRIPTION: Hyperlink access to attachments :DESCRIPTION: Hyperlink access to attachments
:END: :END:
Attached files and folders can be referenced using attachment links. Attached files and folders can be referenced using attachment links.
This makes it easy to refer to the material added to an outline node. This makes it easy to refer to the material added to an outline node.
Especially if it was attached using the unique ID of the entry! Especially if it was attached using the unique ID of the entry!
@ -8163,6 +8167,7 @@ See [[*External Links]] for more information about these links.
:PROPERTIES: :PROPERTIES:
:DESCRIPTION: Everything safely stored away :DESCRIPTION: Everything safely stored away
:END: :END:
If the directory attached to an outline node is a Git repository, Org If the directory attached to an outline node is a Git repository, Org
can be configured to automatically commit changes to that repository can be configured to automatically commit changes to that repository
when it sees them. when it sees them.
@ -8180,6 +8185,7 @@ the following to your Emacs config:
:END: :END:
#+cindex: attach from Dired #+cindex: attach from Dired
#+findex: org-attach-dired-to-subtree #+findex: org-attach-dired-to-subtree
It is possible to attach files to a subtree from a Dired buffer. To It is possible to attach files to a subtree from a Dired buffer. To
use this feature, have one window in Dired mode containing the file(s) use this feature, have one window in Dired mode containing the file(s)
to be attached and another window with point in the subtree that shall to be attached and another window with point in the subtree that shall