Commit graph

499 commits

Author SHA1 Message Date
Protesilaos Stavrou 4d5063f68a
Update to version 0.3.0 2022-07-11 19:37:16 +03:00
Protesilaos Stavrou a40658ed13
Refine face attribute of denote-link-backlink-button
Thanks to Jean-Philippe Gagné Guay for the feedback:
<https://github.com/protesilaos/denote/pull/45#issuecomment-1180046543>.
2022-07-11 10:17:31 +03:00
Protesilaos Stavrou 089b0bea0e
Fix typo in the manual 2022-07-11 07:54:20 +03:00
Protesilaos Stavrou 41600033a9
Update docs of convenience interactive commands
They now reflect what is covered in their respective doc strings.

Thanks to Jean-Philippe Gagné Guay for the feedback in issue 41 over at
the GitHub mirror: <https://github.com/protesilaos/denote/issues/41>.
2022-07-11 07:51:23 +03:00
Protesilaos Stavrou bce2c1b567
Fix index of 'denote' arguments
Thanks to Jean-Philippe Gagné Guay for pointing this out:
<https://github.com/protesilaos/denote/issues/41#issuecomment-1179960596>.
2022-07-11 07:43:23 +03:00
Protesilaos Stavrou fcd182f0ff
Add 'denote-directory' Info link to silos 2022-07-11 07:40:03 +03:00
Protesilaos Stavrou 21d0485649
Update sample configuration 2022-07-11 07:35:47 +03:00
Protesilaos Stavrou 5761ec5f89
BREAKING update journal samples for current 'denote'
We changed the 'denote' command to always expect a list for its KEYWORDS
argument.  If you were passing a single string, please update it to a
list with a string instead.  Also read the updated doc string of the
'denote' command.
2022-07-11 07:31:58 +03:00
Protesilaos Stavrou 60915b3104
Merge branch 'refactor-denote-prompts' 2022-07-11 07:30:28 +03:00
Protesilaos Stavrou 2c0727eb37
Add :link to manual in 'denote-prompts' definition 2022-07-11 07:29:16 +03:00
Protesilaos Stavrou d1a3fe3989
Revise manual on note creation; add denote-prompts 2022-07-11 07:28:36 +03:00
Protesilaos Stavrou 8ea2a7b65d
Tweak denote-prompts doc string 2022-07-11 07:12:31 +03:00
Protesilaos Stavrou b4b08f28e5
Improve denote-prompts reference to other commands 2022-07-11 07:12:11 +03:00
Protesilaos Stavrou 084bd4656e
Clarify interactivity for 'denote-prompts' 2022-07-11 07:04:25 +03:00
Protesilaos Stavrou 840ffc522f
Reword and expand doc string of 'denote-prompts' 2022-07-11 06:57:20 +03:00
Protesilaos Stavrou 23cebf0fe5
Simplify 'denote' doc string about TITLE arg 2022-07-11 06:48:27 +03:00
Protesilaos Stavrou cb863db07d
Change order of arguments in 'denote'
This was discussed with Jean-Philippe Gagné Guay in issue 41 over at the
GitHub mirror: <https://github.com/protesilaos/denote/issues/41>.
2022-07-11 06:44:59 +03:00
Protesilaos Stavrou 4cae3d4262
Rename args in 'denote' for consistency
This was discussed with Jean-Philippe Gagné Guay in issue 41 over at the
GitHub mirror: <https://github.com/protesilaos/denote/issues/41>.
2022-07-11 06:44:52 +03:00
Protesilaos Stavrou 934c8c362f
Acknowledge pRot0ta1p for commit ddcd44a
The discussion took place in issue 43 over at the GitHub mirror:
<https://github.com/protesilaos/denote/issues/43>.
2022-07-11 06:31:47 +03:00
Protesilaos Stavrou ae9e39c306
Merge pull request #45 from jeanphilippegg/backlink-button-face
Specify existing face for backlink buttons.
2022-07-11 06:12:08 +03:00
Protesilaos Stavrou eba6fb1b3c
Merge pull request #46 from jeanphilippegg/expand-denote-directory
Expand file name of denote-directory
2022-07-11 06:09:01 +03:00
Jean-Philippe Gagné Guay ddcd44a031 Expand file name of denote-directory 2022-07-10 22:07:17 -04:00
Jean-Philippe Gagné Guay 15ef234157 Specify existing face for backlink buttons.
This prevent error messages.
2022-07-10 21:33:43 -04:00
Protesilaos Stavrou b6363b4b9c
Merge pull request #44 from jeanphilippegg/delete-dups
Delete duplicates in denote-retrieve--files-in-xref
2022-07-10 23:46:47 +03:00
Jean-Philippe Gagné Guay 18ae2a6847 Delete duplicates in denote-retrieve--files-in-xref 2022-07-10 16:03:08 -04:00
Jean-Philippe Gagné Guay 99d1cbb23d
Remove else part in denote--file-name-relative-to-denote-directory 2022-07-10 22:42:10 +03:00
Protesilaos Stavrou a285d4df6a
Merge pull request #42 from jeanphilippegg/refactor-denote-prompts
Remove else part in denote--file-name-relative-to-denote-directory
2022-07-10 22:37:57 +03:00
Protesilaos Stavrou 3074133f68
Fix how xrefs are analysed
The previous implementation was returning a relative path if the notes'
directory was declared a project, per project.el.  The relative path was
not a valid value for our purposes.

Thanks to Jean-Philippe Gagné Guay for the feedback and brainstorming in
issue 42 over at the GitHub mirror:
<https://github.com/protesilaos/denote/pull/42>.
2022-07-10 22:35:48 +03:00
Protesilaos Stavrou 71b56a6b0f
Refine interactive spec of 'denote' command
Thanks to Jean-Philippe Gagné Guay for the feedback in issue 41 over at
the GitHub mirror: <https://github.com/protesilaos/denote/issues/41>.

Co-authored-by: Jean-Philippe Gagné Guay <jeanphilippe150@gmail.com>
2022-07-10 19:07:13 +03:00
Protesilaos Stavrou 0683a1937c
Document 'denote-directory' silos
This is an extension of what is mentioned in the doc string of
'denote-directory'.
2022-07-10 15:21:45 +03:00
Protesilaos Stavrou a283cc1139
Revert "Avoid errors with string value for keywords"
This reverts commit 92e15886d5.

That is not the right approach, as it can cause problems elsewhere.
2022-07-10 11:01:26 +03:00
Protesilaos Stavrou 92e15886d5
Avoid errors with string value for keywords
This is done in order not to break user-level custom code, such as what
we had in the manual:

    (defun prot/denote-journal ()
      "Create an entry tagged 'journal', while prompting for a title."
      (interactive)
      (denote
       (denote--title-prompt)
       "journal"))
2022-07-10 10:32:32 +03:00
Protesilaos Stavrou c56ddd3fb9
Update doc string of 'denote' command 2022-07-10 10:32:17 +03:00
Protesilaos Stavrou f4c3f1c2d5
Expand denote-prompts doc string 2022-07-10 07:53:11 +03:00
Protesilaos Stavrou 10e815c3fe
Refine denote-prompts Custom UI type
This makes it work as intended in the interface of M-x customize (and
related).
2022-07-10 07:44:57 +03:00
Protesilaos Stavrou c2c0d74dc1
Fix typo in denote-prompts doc string 2022-07-10 07:43:14 +03:00
Protesilaos Stavrou 218f7132bf
Remove private denote--prompts function
We no longer need it, after commits 9163443, 9dbfd37, 3f51ba3, 564c139.

Thanks to Jean-Philippe Gagné Guay for the discussion about this in
issue 41 over at the GitHub mirror:
<https://github.com/protesilaos/denote/issues/41>.
2022-07-10 07:40:44 +03:00
Jean-Philippe Gagné Guay b94537cd94 Remove else part in denote--file-name-relative-to-denote-directory 2022-07-10 00:38:32 -04:00
Protesilaos Stavrou d8ae24a80f
Merge branch 'main' into refactor-denote-prompts 2022-07-10 07:06:49 +03:00
Protesilaos Stavrou 6041e38ee5
Add note about backlinking facility and Xref 2022-07-09 13:58:04 +03:00
Protesilaos Stavrou 2c48f2b7b4
Add custom id to a heading in the manual
We use those in the HTML export, but also for internal links.
2022-07-09 13:57:34 +03:00
Protesilaos Stavrou 267cd2e7ca
Acknowledge Benjamin Kästner for commit 3c295fc
The change is below the ~15 line threshold and thus does not require
copyright assignment to the Free Software Foundation.
2022-07-09 13:56:48 +03:00
Benjamin Kästner 3c295fc162
Add entry to FAQ about xref's search failures on Windows
Even though 'denote' itself does not require external programs, some
of Emacs' features require external programs.  The 'xref' package is
one of those features.

While some of xref's features do not need any external applications,
the function 'xref-matches-in-files' used in 'denote-retrieve--xrefs'
will use 'xref-search-program' and by that also the associative list
'xref-search-program-alist' to find the actual shell command.  As
`-in-files` the suffix implies, the shell command needs to understand
multiple file names, which is the reason for 'xargs' in the pipe.

Since there is no Windows native alternative for 'xargs', the user
needs to install one of the many packages like msys64, MinGW, or Git,
that provide the necessary tools within their installation.
Afterwards, the path has to be added to the ~%PATH%~ environment
variable.  Note that 'exec-path' is not enough, since the shell proxy
on Windows, 'cmdproxy.exe', does not know about that Lisp-only
variable.

Either setting the PATH variable within Emacs as shown in the
changeset or setting the PATH variable within Windows' settings should
suffice and therefore get rid of this issue.
2022-07-09 13:52:16 +03:00
Protesilaos Stavrou 39d85280ee
Define obsolete alias of fontification var
This is a follow-up to commit 3f2e078, which was contributed on the
GitHub mirror as pull request 40:
<https://github.com/protesilaos/denote/pull/40>.
2022-07-09 06:55:20 +03:00
Protesilaos Stavrou e7de7baaa4
Merge pull request #40 from jeanphilippegg/file-name-permutations
Adjust fontification
2022-07-09 06:51:19 +03:00
Jean-Philippe Gagné Guay 3f2e0788a9 Adjust fontification 2022-07-08 19:33:52 -04:00
Protesilaos Stavrou f1e08702e5
Make fontification more robust (revise f13fdd4) 2022-07-08 12:50:05 +03:00
Protesilaos Stavrou f13fdd439c
Fix false positives in fontification regexp
Discussion on the GitHub mirror starts after this point:
<https://github.com/protesilaos/denote/pull/38#issuecomment-1178547317>.

Co-authored-by: Jean-Philippe Gagné Guay <jeanphilippe150@gmail.com>
2022-07-08 10:06:30 +03:00
Protesilaos Stavrou 29a5a2d966
Remove face override from keywords separator
It breaks Dired's fontification of marked entries.  It would have been
nice to keep it though.  Maybe there is another way.
2022-07-08 07:33:26 +03:00
Protesilaos Stavrou 5abcd2fe87
Remove needless face override from delimiter
Commit 564c139 made it superfluous.
2022-07-08 07:32:43 +03:00