> From: Ship Mints <shipmints@gmail.com>
> Date: Fri, 21 Mar 2025 16:02:34 -0400
> Cc: 77157@debbugs.gnu.org
>
> Please tell in the doc string that changing the style in the middle of
> an Emacs session must be done via Customize or by using setopt, but
> not by setting the variable directly (unless uniquify--set-option is
> then invoked).
>
> Eli, how is this wording which I'll put in each docstring?
>
> "To reflect a change to this option's value in your live buffer names,
> use `customize' interactively, or use `setopt' in Elisp, both of which
> call `uniquify--set-option' (setq will not do that for you)."
We usually use the following style for such variables:
Setting this variable directly will not usually take effect;
use either \\[customize] or `setopt', or call `uniquify--set-option'
or restart `uniquify-mode' after setting the variable directly.
I'll adapt this language. Uniquify isn't implemented as a mode. It's a rename buffer hook in buffer.c and depends on 'uniquify-buffer-name-style' to have a defined style.
Even the function 'uniquify-unload-function' doesn't attempt to remove the hook (it probably should set 'uniquify-buffer-name-style' to nil as part of its business). It's not even clear if unload ever gets called by anyone. Perhaps a candidate to obsolete.