Björn Bidar <bjorn.bi...@thaodan.de> writes:

> +*** =org-link-gnus= Ensure that other frame is alive before selecting it
> +Ensure that the Gnus frame is alive before selecting it if it was
> +activated before.  Call ~gnus-other-frame~ in case it
> +was used to call Gnus before, i.e. if ~gnus-other-frame-object~ is
> +not ~nil~.  The side effect of that is that the original Gnus frame
> +is reused when the frame is setup instead of being replaced
> +when Gnus was activated using ~gnus~ instead ~gnus-other-frame~
> +as it should when there is a Gnus frame.

This is confusing.
What we need to say in the news is (1) what changed; (2) whether users
need to act.

The current wording does not clearly highlight what has been changed.
Explaining the internal logic is not very helpful, IMHO.

> +Existing ~org-link-frame-setup~ functions for Gnus links have
> +to be adjusted to ensure that ~gnus-other-frame-object~ contains
> +a frame which is alive.  Check the default ~org-gnus-no-news~
> +function for more.

Do they really have to be adjusted? If ~gnus-other-frame-object~ is nil,
isn't the new code going to work as earlier? Or do I misunderstand something?

> +*** ~org-link-frame-setup~ include new option to open Gnus in other frame
> +Include ~org-gnus-no-new-news-other-frame~ as an option to always
> +call Gnus using ~gnus-other-frame~ regardless if it had been previously
> +used or not.  The function can be useful in a frame orientated setup.

I'd put this into "new funcstions" section, highlighting the new
~org-gnus-no-new-news-other-frame~ function and only telling that it can
be used within ~org-link-frame-setup~ in detailed explanation.

-- 
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>

Reply via email to