GNU-devel ELPA - org-transclusion

* 2.0.0-rc (as of 2026-01-03)

  - Breaking Change ::

    We have done significant refactoring for the INTERNAL workings of
    transclusion logic. The intent was two-fold:

    1. Affect only internal workings. No user-facing commands and user options
       should be affected.

    2. Make custom/personal transclusion logic easy. Now transclusion should
       work as long as the Org link navigates to the link-target buffer. For
       example, the author has tested this with `orgit-file` link via `orgit`
       package (https://github.com/magit/orgit) and `notmuch:id:` link via
       `ol-notmuch` (https://github.com/tarsius/ol-notmuch), both packages by
       Jonas Bernoulli.

    No user-facing features should be affected, however, we are calling it out
    as a breaking change because:

    - The change is significant including dropping of a major function and
      changes of function signature, and
    - We are aware that some users have developed their own custom transclusion
      functions.

    We plan to increase the version nubmer to 2.0.0 to indicate this breaking
    change included in this release.

    The significant changes include the following:

    - Deprecated (and removed from the main transclusion logic):
      `org-transclusion-add-payload'

    - `org-transclusion-content-insert` signature changed to `(content)`

    - Refactored `org-transclusion-content-format-functions`.

    - Fixed extension setup hooks (`org-transclusion-*-extension-functions`)

    - All the extensions included in the package have been refactored to be
      aligned with these changes.

  - Features ::

    - New `org-transclusion-transient' feature for easier command access via
      `org-transclusion-transient-menu' command.

    - New `org-transclusion-insert' command. The command lets you insert
      #+TRANSCLUDE: from a link at point or new link to a blank line.

    - New user option `org-transclusion-insert-link-functions`, allowing
      customization of link insertion behavior for `org-transclusion-insert'
      (Commit `47ff265`).

    - Improved fringe & indentation (contribution by gggion). Significant
      refactoring to improve how fringes are displayed, especially when working
      with `org-indent-mode` and in terminal (`-nw`) environments.

    - Noweb chunk support (contribution by Andreas Matthias). You can now
      transclude specific chunks from noweb files. See the user manual for
      detail.

    - New translclusion `"auto"` value for `:level` property. Leaving the
      property value blank also behaves as `"auto"` It sets the level of the
      transcluded headlines to be one level deeper than the current headline.

    - New transclusion property `no-first-heading`. It will remove the first
      headline of a subtree. This is useful when you wish to merge a subtree
      into another headline.

  - Fixes ::

    - fix: #261 Extensions have been refactored into proper minor modes, making
      them easily removable and togglable. Setup hooks are now cleaner and
      reversible.

    - fix: #237 `ID` links with search options (compatible with Org 9.7+). You
      can also use Org-link's `::number` search-option. `::/regex/` does not
      fail but as it normally opens an "Occur" buffer which expects an user
      interaction, and thus does not work as intended. Commits 4764739, c910289

    - Fix: removing transclusions would incorrectly flag the buffer as modified
      Commit 59fe5cc.

    - fix: #177 Infinite loop when saving buffer with transclusions. See commit
      f6fd666 for detail.

* 1.4.0 (2024-05-20)

  - Features ::

    Transclude content over network protocols like http:// (with
    org-transclusion-http: https://git.sr.ht/ushin/org-transclusion-http) and
    hyper:// (with hyperdrive-org-transclusion:
    https://git.sr.ht/~ushin/hyperdrive-org-transclusion).  Splitting
    org-transclusion-add into two parts enables functions in
    org-transclusion-add-functions to be asynchronous.
...
...