Org API

The dispatcher for attachment commands. Shows a list of commands and prompts for another key to execute a command.

Move/copy/link file into the attachment directory of the current task. If visit-dir is non-nil, visit the directory with dired. method may be cp, mv, ln, or lns default taken from org-attach-method.

Attach a file by copying it.

Attach a file by creating a hard link to it. Beware that this does not work on systems that do not support hard links. On some systems, this apparently does copy the file instead.

Attach a file by creating a symbolic link to it.

Beware that this does not work on systems that do not support symbolic links. On some systems, this apparently does copy the file instead.

Attach a file by moving (renaming) it.

Check if we have enough information to root the attachment directory. When dir is given, check also if it is already absolute. Otherwise, assume that it will be relative, and check if org-attach-directory is absolute, or if at least the current buffer has a file name. Throw an error if we cannot root the directory.

Commit changes to git if org-attach-directory is properly initialized. This checks for the existence of a ".git" directory in that directory.

Delete all attachments from the current task. This actually deletes the entire attachment directory. A safer way is to open the directory in dired and delete from there.

Delete a single attachment.

Return the directory associated with the current entry. This first checks for a local property ATTACH_DIR, and then for an inherited property ATTACH_DIR_INHERIT. If neither exists, the default mechanism using the entry ID will be invoked to access the unique directory for the current entry. If the directory does not exist and create-if-not-exists-p is non-nil, the directory and (if necessary) the corresponding ID will be created.

Return the full path to the current entry's attachment file file. Basically, this adds the path to the attachment directory.

Return a file link pointing to the current entry's attachment file file. Basically, this adds the path to the attachment directory, and a "file:" prefix.

Return a list of files in the attachment directory. This ignores files starting with a ".", and files ending in "~".

Create a new attachment file for the current task. The attachment is created as an Emacs buffer.

Open an attachment of the current task. If there are more than one attachment, you will be prompted for the file name. This command will open the file using the settings in org-file-apps and in the system-specific variants of this variable. If in-emacs is non-nil, force opening in Emacs.

Open attachment, force opening in Emacs. See org-attach-open.

Show the attachment directory of the current task in dired.

Show the attachment directory of the current task. This will attempt to use an external program to show the directory.

Set the ATTACH_DIR property of the current entry. The property defines the directory that is used for attachments of the entry.

Set the ATTACH_DIR_INHERIT property of the current entry. The property defines the directory that is used for attachments of the entry and any children that do not explicitly define (by setting the ATTACH_DIR property) their own attachment directory.

Add a link to org-stored-link when attaching a file. Only do this when org-attach-store-link-p is non-nil.

Synchronize the current tasks with its attachments. This can be used after files have been added externally.

Turn the autotag on or (if off is set) off.

Turn the autotag off.