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.  If a Gnus frame existed before call it using
> +~gnus-other-frame~. Using the function also ensures that
> +~org-link-frame-setup~ no longer overrides the existing Gnus frame.
> +
> +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.

This still feels confusing (sorry that I keep asking, but I need to
make sure that the entry is useful for the existing users).

> =org-link-gnus= Ensure that other frame is alive before selecting it

By looking at this line, I feel like reading a commit log. It is not
what we should put in ORG-NEWS. As a user, I expected ORG-NEWS heading
to highlight what change has been introduced and why I need to care.

"ensure that frame is alive" sounds like some bug being fixed, but not
like a change to pay attention to.

I actually doubt that we need to talk about `gnus-other-frame-object' at
all. In the past, if `gnus-other-frame-object' were a dead frame, users
would see an error. Now, we still show an error, albeit more
descriptive. Nothing major to pay attention to.

Isn't the potentially breaking change done in `org-gnus-no-new-news'
behavior? The logic there is certainly changed, but it is hard to me to
know how to explain it best to gnus users.

> +*** ~org-gnus-no-new-news-other-frame~ to open Gnus in other frame without 
> fetching news
> +New function to call ~org-gnusw-no-news~ to with ~t~ so it always will
> +open Gnus with ~gnus-other-frame~ regardless if used previously or not.
> +The function can be useful in a frame orientated setup to be used
> +in ~org-link-frame-setup~.

What about

*** New function ~org-gnus-no-new-news-other-frame~ (to be used in 
~org-link-frame-setup~)

The new function is like ~org-gnus-no-new-news~, but always opens the
link in other frame.

-- 
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