emacs-elpa-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[elpa] externals/org-remark 6abbb84733: docs: user manual org-remark-not


From: ELPA Syncer
Subject: [elpa] externals/org-remark 6abbb84733: docs: user manual org-remark-notes-file-name
Date: Sun, 13 Feb 2022 11:57:44 -0500 (EST)

branch: externals/org-remark
commit 6abbb847339603860a97028f8b9fc346411844e2
Author: Noboru Ota <me@nobiot.com>
Commit: Noboru Ota <me@nobiot.com>

    docs: user manual org-remark-notes-file-name
---
 docs/org-remark.org | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/org-remark.org b/docs/org-remark.org
index d6a24287d1..846a88f419 100644
--- a/docs/org-remark.org
+++ b/docs/org-remark.org
@@ -194,7 +194,7 @@ Without this global minor mode, you would need to remember 
to activate ~org-rema
 #+cindex: Marginal notes file
 #+cindex: Org-remark properties for highlights
 
-When you mark a part of text with a highlighter pen function, Org-remark will 
automatically create a *marginal notes file*. By default, it will be named 
~marginalia.org~ and created in the same directory as the file you are editing 
([[#customizing][Customizing]]).
+When you mark a part of text with a highlighter pen function, Org-remark will 
automatically create a *marginal notes file*. By default, it will be named 
~marginalia.org~ and created in the same directory as the file you are editing 
([[#customizing][Customizing]]; see ~org-remark-notes-file-name~).
 
 The important thing to note is that Org-remark uses following properties in 
the property drawer of the headline to remember the highlights:
 
@@ -231,6 +231,8 @@ Org-remark displays the marginal notes buffer narrowed to 
the highlight the curs
 
 *** How to Store Marginal Notes in the Source File
 
+#+vindex: org-remark-notes-file-name
+
 The location of the marginal notes file is specified by user option 
~org-remark-notes-file-name~ and its default is "marginalia.org". This means 
the marginal notes file will reside in the same directory as the source files 
as a separate file.
 
 ~org-remark-notes-file-name~ can also take a function as a value, so you have 
a wide range of customizability. In ~customize~, the default function to be 
used is ~org-remark-notes-file-name-function~. It adds =-notes.org= as a suffix 
to the source file's name without the extension. For example, for a file named 
=my-main-file.txt=,  Org-remark will store highlights in  
=my-main-file-notes.org=.
@@ -328,8 +330,7 @@ Org-remark's user options are available in the 
customization group ~org-remark~.
 
 - Option: ~org-remark-notes-file-name~ ::
   Name of the file where we store highlights and marginal notes. It can be 
either a string or function.
-  If it is a string, it should be a file name to the marginal notes
-file. The default is =marginalia.org=.  The default will result in one 
marginal notes file per directory.  Ensure that it is an Org file.
+  If it is a string, it should be a file name to the marginal notes file. The 
default is =marginalia.org=.  The default will result in one marginal notes 
file per directory.  Ensure that it is an Org file.
   If it is a function, the default function is 
~org-remark-notes-file-name-function~.  It returns a file name like this: 
=FILE-notes.org= by adding =-notes.org= as a suffix to the file name without 
the extension.
 
 - Option: ~org-remark-notes-display-buffer-action~ ::
@@ -354,7 +355,7 @@ file. The default is =marginalia.org=.  The default will 
result in one marginal
 
 - Undo highlight does not undo it :: Overlays are not part of the undo list; 
you cannot undo highlighting. Use ~org-remark-remove~ or ~org-remark-delete~ 
commands instead.
 
-- Moving source files and remark file :: Moving your files and remark file to 
another directory does not update the source paths and file names stored in the 
marginal notes file. One way to keep the links between the source files and 
marginal notes files is to use relative file names with 
~org-remark-source-file-name~ (default).
+- Moving source files and marginal notes files :: Moving your files and remark 
file to another directory does not update the source paths and file names 
stored in the marginal notes file. One way to keep the links between the source 
files and marginal notes files is to use relative file names with 
~org-remark-source-file-name~ (default).
 
 * Credits
 



reply via email to

[Prev in Thread] Current Thread [Next in Thread]