Variable: org-link-context-for-files

org-link-context-for-files is a customizable variable defined in ol.el.gz.

Value

t

Documentation

Non-nil means file links from org-store-link contain context.

A search string is added to the file name with "::" as separator and used to find the context when the link is activated by the command org-open-at-point. When this option is t, the entire active region is be placed in the search string of the file link. If set to a positive integer N, only the first N lines of context are stored.

Using a prefix argument to the command org-store-link (C-u (universal-argument) M-x org-store-link (org-store-link)) negates this setting for the duration of the command.

Aliases

org-context-in-file-links (obsolete since 9.3)

Source Code

;; Defined in /usr/src/emacs/lisp/org/ol.el.gz
(defcustom org-link-context-for-files t
  "Non-nil means file links from `org-store-link' contain context.
\\<org-mode-map>
A search string is added to the file name with \"::\" as separator
and used to find the context when the link is activated by the command
`org-open-at-point'.  When this option is t, the entire active region
is be placed in the search string of the file link.  If set to a
positive integer N, only the first N lines of context are stored.

Using a prefix argument to the command `org-store-link' \
\(`\\[universal-argument] \\[org-store-link]')
negates this setting for the duration of the command."
  :group 'org-link-store
  :type '(choice boolean integer)
  :safe (lambda (val) (or (booleanp val) (integerp val))))