Re: master 6ae3f7e: Add a section about bug-reference-mode.

Re: master 6ae3f7e: Add a section about bug-reference-mode.

[Michael Albinus]

tsdh@gnu.org (Tassilo Horn) writes:

Hi,

> branch: master
> commit 6ae3f7e889434eb8f76cc376d2939c66eb470855
> Author: Tassilo Horn <tsdh@gnu.org>
> Commit: Tassilo Horn <tsdh@gnu.org>
>
>     * doc/emacs/maintaining.texi (Maintaining): Add a section about
>     bug-reference-mode.

Since debbugs is a GNU ELPA package, I believe it would be appropriate
to add a reference to debbugs-browse-mode, part of the debbugs
package. This mode avoids to open a browser, and keeps everything inside
Emacs.

See the "(debbugs-ug) Minor Mode" Info node for details.

Comments?

Best regards, Michael.

Re: master 6ae3f7e: Add a section about bug-reference-mode.

[Tassilo Horn]

Michael Albinus <michael.albinus@gmx.de> writes:

Hi Michael,

>> branch: master
>> commit 6ae3f7e889434eb8f76cc376d2939c66eb470855
>> Author: Tassilo Horn <tsdh@gnu.org>
>> Commit: Tassilo Horn <tsdh@gnu.org>
>>
>>     * doc/emacs/maintaining.texi (Maintaining): Add a section about
>>     bug-reference-mode.
>
> Since debbugs is a GNU ELPA package, I believe it would be appropriate
> to add a reference to debbugs-browse-mode, part of the debbugs
> package.

You mean, the emacs manual should link to the debbugs user manual?  Is
that even possible given that this might not be installed?

> This mode avoids to open a browser, and keeps everything inside Emacs.
>
> See the "(debbugs-ug) Minor Mode" Info node for details.
>
> Comments?

debbugs.el already adds an entry to `browse-url-default-handlers' for
this purpose.  So is `debbugs-browse-mode' just a crutch for "older"
emacsen (where "older" means "released")?

In any case, feel free to enhance/extend the documentation.  I'm also
planning to extend it a bit with respect to the auto-setup feature but
haven't had the time to do so yet (hopefully weekend).

Bye,
Tassilo

Re: master 6ae3f7e: Add a section about bug-reference-mode.

[Eli Zaretskii]

> From: Michael Albinus <michael.albinus@gmx.de>
> Date: Thu, 20 May 2021 13:07:06 +0200
> Cc: Tassilo Horn <tsdh@gnu.org>
> 
> > branch: master
> > commit 6ae3f7e889434eb8f76cc376d2939c66eb470855
> > Author: Tassilo Horn <tsdh@gnu.org>
> > Commit: Tassilo Horn <tsdh@gnu.org>
> >
> >     * doc/emacs/maintaining.texi (Maintaining): Add a section about
> >     bug-reference-mode.
> 
> Since debbugs is a GNU ELPA package, I believe it would be appropriate
> to add a reference to debbugs-browse-mode, part of the debbugs
> package. This mode avoids to open a browser, and keeps everything inside
> Emacs.
> 
> See the "(debbugs-ug) Minor Mode" Info node for details.
> 
> Comments?

I guess we should have it in both places.

Re: master 6ae3f7e: Add a section about bug-reference-mode.

[Michael Albinus]

Tassilo Horn <tsdh@gnu.org> writes:

> Hi Michael,

Hi Tassilo,

>> Since debbugs is a GNU ELPA package, I believe it would be appropriate
>> to add a reference to debbugs-browse-mode, part of the debbugs
>> package.
>
> You mean, the emacs manual should link to the debbugs user manual?  Is
> that even possible given that this might not be installed?

If debbugs is installed, it shall work. Otherwise, it is a dead link.

> debbugs.el already adds an entry to `browse-url-default-handlers' for
> this purpose.  So is `debbugs-browse-mode' just a crutch for "older"
> emacsen (where "older" means "released")?

That setting is one way. debbugs-browse-mode, as I have described now,
is more general, and it allows to enable/disable debbugs-browse.

> In any case, feel free to enhance/extend the documentation.  I'm also
> planning to extend it a bit with respect to the auto-setup feature but
> haven't had the time to do so yet (hopefully weekend).

I've pushed a paragraph, w/o explicit reference to debbugs-ug.

> Bye,
> Tassilo

Best regards, Michael.