summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNicolas Goaziou <mail@nicolasgoaziou.fr>2020-05-14 23:56:52 +0200
committerNicolas Goaziou <mail@nicolasgoaziou.fr>2020-05-14 23:56:52 +0200
commit817acdcdfb83f7e73a676ec44291ceec6ba6bb5d (patch)
tree1902b043a3e8d3baf747cd9f938155e6512b1a5f
parent99bb514f7fce8aade73fed257417575a5121299e (diff)
downloadorg-mode-817acdcdfb83f7e73a676ec44291ceec6ba6bb5d.tar.gz
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.
-rw-r--r--doc/org-manual.org24
1 files changed, 15 insertions, 9 deletions
diff --git a/doc/org-manual.org b/doc/org-manual.org
index 4e7cf2f..673bb11 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -7911,8 +7911,8 @@ See the docstring of the variable for more information.
It is often useful to associate reference material with an outline
node. Small chunks of plain text can simply be stored in the subtree
of a project. Hyperlinks (see [[*Hyperlinks]]) can establish associations
-with files that live elsewhere on your computer or in the cloud, like
-emails or source code files belonging to a project.
+with files that live elsewhere on a local, or even remote, computer,
+like emails or source code files belonging to a project.
Another method is /attachments/, which are files located in a
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:
:DESCRIPTION: How to access attachment commands
:END:
-By default, org-attach will use ID properties when adding attachments
-to outline nodes. This makes working with attachments fully
-automated. There is no decision needed for folder-name or location.
-ID-based directories are by default located in the =data/= directory,
-which lives in the same directory where your Org file lives[fn:89].
-For more control over the setup, see [[*Attachment options]].
+
+By default, Org attach uses ID properties when adding attachments to
+outline nodes. This makes working with attachments fully automated.
+There is no decision needed for folder-name or location. ID-based
+directories are by default located in the =data/= directory, which
+lives in the same directory where your Org file lives[fn:89].
When attachments are made using ~org-attach~ a default tag =ATTACH= is
added to the node that gets the attachments.
+For more control over the setup, see [[*Attachment options]].
+
The following commands deal with attachments:
- {{{kbd(C-c C-a)}}} (~org-attach~) ::
@@ -8041,6 +8043,7 @@ The following commands deal with attachments:
:PROPERTIES:
:DESCRIPTION: Configuring the attachment system
:END:
+
There are a couple of options for attachments that are worth
mentioning.
@@ -8059,7 +8062,7 @@ mentioning.
#+vindex: org-attach-use-inheritance
By default folders attached to an outline node are inherited from
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
the node hierarchy makes a lot of sense in most cases. Especially
when using attachment links (see [[*Attachment links]]). The following
@@ -8145,6 +8148,7 @@ default settings.
:PROPERTIES:
:DESCRIPTION: Hyperlink access to attachments
:END:
+
Attached files and folders can be referenced using attachment links.
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!
@@ -8163,6 +8167,7 @@ See [[*External Links]] for more information about these links.
:PROPERTIES:
:DESCRIPTION: Everything safely stored away
:END:
+
If the directory attached to an outline node is a Git repository, Org
can be configured to automatically commit changes to that repository
when it sees them.
@@ -8180,6 +8185,7 @@ the following to your Emacs config:
:END:
#+cindex: attach from Dired
#+findex: org-attach-dired-to-subtree
+
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)
to be attached and another window with point in the subtree that shall