gnu-emacs-sources
[Top][All Lists]
Advanced

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

[GNU ELPA] Denote version 1.0.0


From: ELPA update
Subject: [GNU ELPA] Denote version 1.0.0
Date: Fri, 30 Sep 2022 05:03:31 -0400

Version 1.0.0 of package Denote has just been released in GNU ELPA.
You can now find it in M-x package-list RET.

Denote describes itself as:
  Simple notes with an efficient file-naming scheme

More at https://elpa.gnu.org/packages/denote.html

Recent NEWS:

                         ━━━━━━━━━━━━━━━━━━━━━━
                          CHANGE LOG OF DENOTE
                         ━━━━━━━━━━━━━━━━━━━━━━


This document contains the release notes for each tagged commit on the
project's main git repository: <https://git.sr.ht/~protesilaos/denote>.

The newest release is at the top.  For further details, please consult
the manual: <https://protesilaos.com/emacs/denote>.


Version 1.0.0 on 2022-09-30
═══════════════════════════

  This is the first major release of Denote.  A part of the changes
  documented herein is for advanced users or developers who wish to
  extend Denote with their custom code.  Though we first cover what
  applies to everyone.


Changes for all users
─────────────────────

  ⁃ The custom Org hyperlink type of `denote:' can be visited from
    outside the `denote-directory'.  We now provide the necessary glue
    code that Org needs to store these `denote:' links.  Storing them
    can be done with an `org-capture' template or via the command
    `org-store-link'.  Use this to, for example, capture a TODO that
    references one of your notes.

    `denote:' links work for as long as the referenced file is somewhere
    in the `denote-directory' or one of its subdirectories.

    Thanks to Marc Fargas for the contribution.  Marc did not need to
    assign copyright to the Free Software Foundation, as the patch was
    within the ~15 line limit that is permissible.

    The contribution was discussed on the mailing list:
    <https://lists.sr.ht/~protesilaos/denote/patches/35137>.  A prior
    exchange took place in issue 104 over at the GitHub mirror:
    <https://github.com/protesilaos/denote/issues/104>.

    Some further tweaks were made to the relevant function.  Thanks to
    Elias Storms for reporting on the mailing list a bug which revealed
    a regression I introduced to the Org link storing mechanism:
    
<https://lists.sr.ht/~protesilaos/denote/%3C15D55F4B-64D1-4083-AD5E-B5BACA8F1909%40ap.be%3E>.

  ⁃ Following from above, the command `denote-link-find-file' finds
    files reliably, regardless of where the link is stored.  All it
    needs is for the target file to be inside the `denote-directory'.

    I discovered this while exchanging views with Marc Fargas regarding
    the aforementioned patch:
    <https://lists.sr.ht/~protesilaos/denote/patches/35137>.

  ⁃ The command `denote-link-buttonize-buffer', which "buttonizes"
    `denote:' links in plain text and Markdown files, now performs its
    task regardless of where the current file is stored.  Those links
    work for as long as the file they reference is somewhere inside the
    `denote-directory'.

  ⁃ The commands `denote-link-after-creating', `denote-link-or-create'
    provide a convenience for users who need to create link to notes
    that may not exist yet.  The idea is that one is expounding on a
    given topic and wants to create a link to a relevant issue.  They
    are not sure if they have written anything about it yet, so they
    invoke the relevant command.  Consult their doc strings or read the
    manual:
    
<https://protesilaos.com/emacs/denote#h:9e41e7df-2aac-4835-94c5-659b6111e6de>.

    Thanks to user sienic for suggesting the idea and for testing the
    prototypes.  And thanks to Juanjo Presa for participating in the
    discussion to share the view that this functionality should be part
    of denote.el.  This happened in issue 96 over at the GitHub mirror:
    <https://github.com/protesilaos/denote/issues/96>.

  ⁃ The command `denote-open-or-create' offers the convenience of
    visiting a file, if it exists, else prompting for its creation.
    Thanks to Alan Schmitt for the contribution.  The patch was sent on
    the mailing list:
    
<https://lists.sr.ht/~protesilaos/denote/%3C87fsgvddny.fsf%40protesilaos.com%3E>.
    It is within the limit of what is allowed without assigning
    copyright to the Free Software Foundation, though Alan has done the
    relevant paperwork.

  ⁃ The manual expands on two sections: (1) Variants of
  …  …



reply via email to

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