Version 1.1.1 of package Logos has just been released in GNU ELPA.
You can now find it in M-x list-packages RET.
Logos describes itself as:
============================
Simple focus mode and extras
============================
More at https://elpa.gnu.org/packages/logos.html
## Summary:
# Logos (logos.el)
This package provides a simple approach to setting up a "focus mode"
for Emacs. It uses the `page-delimiter` (typically the `^L`
character) or the `outline-regexp` together with some commands to move
between pages whether narrowing is in effect or not. It also provides
some optional stylistic tweaks which come into effect when the
buffer-local `logos-focus-mode` is enabled. The manual shows how to
extend the code to achieve the desired result.
## Recent NEWS:
━━━━━━━━━━━━━━━━━━━━━
CHANGE LOG OF LOGOS
━━━━━━━━━━━━━━━━━━━━━
The newest release is at the top. For further details, please consult
the manual: <https://protesilaos.com/emacs/logos>.
Version 1.1.0 on 2023-06-20
═══════════════════════════
The `logos-focus-mode-extra-functions' has a new name
─────────────────────────────────────────────────────
It is now called `logos-focus-mode-hook' to conform with the
conventions surrounding Emacs Lisp packaging. The old name is
deprecated and will be removed in the future. The relevant warnings
are in place to inform users of the change.
The `logos-focus-mode-extra-functions' had the unfortunate connotation
of being an irregular hook, i.e. one that runs with arguments.
Whereas this one is a regular hook that passes no arguments to the
functions it calls. Quoting from the Emacs Lisp Reference Manual:
If the hook variable’s name does not end with ‘-hook’,
that indicates it is probably an “abnormal hook”. These
differ from normal hooks in two ways: they can be called
with one or more arguments, and their return values can be
used in some way. The hook’s documentation says how the
functions are called and how their return values are used.
Any functions added to an abnormal hook must follow the
hook’s calling convention. By convention, abnormal hook
names end in ‘-functions’.
To read the manual, evaluate this inside of Emacs:
┌────
│ (info "(elisp) Hooks")
└────
The `logos-page-delimiter' variable/function is now public
──────────────────────────────────────────────────────────
Renaming the `logos-page-delimiter' function and variable is necessary
as both can safely be included in user-defined code.
In the context of Elisp packaging, a "private" symbol is denoted by a
double dash in its name. Such code is intended for internal use: it
may be redefined or altogether removed without further notice.
Whereas a "public" symbol comes with the implicit guarantee that the
developer will take good care to preserve its behaviour and/or
document any breaking changes.
Functions that set state have a more descriptive name
─────────────────────────────────────────────────────
This concerns `logos--mode', hereby renamed to `logos-set-mode-arg',
and `logos--set', which is now called `logos-set-buffer-local-value'.
The intent is to make the code public as well as to better describe
what it does already at the naming level.
As always, the relevant arrangements are in place to notify users of
the change.
The Git repository also includes a README.md
────────────────────────────────────────────
The project has a `README.org' file which contains the project's
documentation and is exported to the Info page format. A new
`README.md' is supplied as well to provide the basics of what `logos'
is, link to its video demo, and further resources.
Thanks to Dave Abrahams for asking me to put a video demo in the
README. This inspired me to update this repository to be in the style
of the others I also maintain. Dave's comment was made in issue 12 on
the GitHub mirror: <https://github.com/protesilaos/logos/issues/12>.
Version 1.0.0 on 2022-10-19
═══════════════════════════
⁃ Revised the fallback condition of the user option
`logos-outline-regexp-alist' (it comes into effect when the
`logos-outlines-are-pages' is non-nil).
The previous value did not account for the buffer-local values of
`outline-regexp' or `page-delimiter', nor did it adapt to any
changes in their respective values. Instead, it would capture
whatever the value was at the time of the symbol's declaration.
We remove the `t' condition altogether and instead handle the
fallback value internally. Logos will return the current
… …