GNU bug report logs - #51239
emptyish web page found via google 'auctex emacs'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 51239 in the body.
You can then email your comments to 51239 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: bruce robertson <brucer42 <at> gmail.com>
To: bug-auctex <at> gnu.org
Subject: emptyish web page found via google 'auctex emacs'
Date: Sat, 16 Oct 2021 07:40:13 -0700

[Message part 1 (text/plain, inline)]

https://www.gnu.org/software/auctex/manual/auctex/Editing-Facilities.html#Editing-Facilities
is pretty much empty whereas
https://www.gnu.org/software/auctex/manual/auctex/Editing.html#Editing
seems to be useful


-- 
λέγει αὐτῷ Ἰησοῦς Ἐγώ εἰμι ἡ ὁδὸς καὶ ἡ ἀλήθεια καὶ ἡ ζωή· οὐδεὶς ἔρχεται
πρὸς τὸν Πατέρα εἰ μὴ δι' ἐμοῦ. ΚΑΤΑ ΙΩΑΝΝΗΝ

[Message part 2 (text/html, inline)]

Message #10 received at 51239-done <at> debbugs.gnu.org (full text, mbox):

From: Mosè Giordano <mose <at> gnu.org>
To: bruce robertson <brucer42 <at> gmail.com>
Cc: 51239-done <at> debbugs.gnu.org
Subject: Re: bug#51239: emptyish web page found via google 'auctex emacs'
Date: Sat, 16 Oct 2021 16:17:02 +0100

Hi Bruce,

that's how texi2html works, I don't think we can do much about that.
You may want to read the "all-in-one-page" manual instead the one
"split-into-every-single-possibly-empty-section":
https://www.gnu.org/software/auctex/manual/auctex.html#Editing-Facilities

Bye,
Mosè



On Sat, 16 Oct 2021 at 15:41, bruce robertson <brucer42 <at> gmail.com> wrote:
>
> https://www.gnu.org/software/auctex/manual/auctex/Editing-Facilities.html#Editing-Facilities
> is pretty much empty whereas
> https://www.gnu.org/software/auctex/manual/auctex/Editing.html#Editing
> seems to be useful
>
>
> --
> λέγει αὐτῷ Ἰησοῦς Ἐγώ εἰμι ἡ ὁδὸς καὶ ἡ ἀλήθεια καὶ ἡ ζωή· οὐδεὶς ἔρχεται πρὸς τὸν Πατέρα εἰ μὴ δι' ἐμοῦ. ΚΑΤΑ ΙΩΑΝΝΗΝ
> _______________________________________________
> bug-auctex mailing list
> bug-auctex <at> gnu.org
> https://lists.gnu.org/mailman/listinfo/bug-auctex

Message #13 received at 51239 <at> debbugs.gnu.org (full text, mbox):

From: Ikumi Keita <ikumi <at> ikumi.que.jp>
To: 51239 <at> debbugs.gnu.org, mose <at> gnu.org
Cc: brucer42 <at> gmail.com
Subject: Re: bug#51239: emptyish web page found via google 'auctex emacs'
Date: Sun, 17 Oct 2021 01:22:10 +0900

Hi Mosè,

>>>>> Mosè Giordano <mose <at> gnu.org> writes:
> that's how texi2html works, I don't think we can do much about that.

It seems that texi2html was declared as obsolete a decade ago and the
developer recommends to switch to makeinfo[1]. Maybe we should consider
to switch and seek for a way to generate less emptyish html pages by
makeinfo.

[1] https://www.nongnu.org/texi2html/

At least the current doc/Makefile generates such pages by makeinfo when
I issue "make html/index.html" in doc directory. (makeinfo is chosen by
Makefile when texi2html is missing and makeinfo is available.)

Regards,
Ikumi Keita

Message #16 received at 51239 <at> debbugs.gnu.org (full text, mbox):

From: Mosè Giordano <mose <at> gnu.org>
To: 51239 <at> debbugs.gnu.org, Mosè Giordano <mose <at> gnu.org>, 
 bruce robertson <brucer42 <at> gmail.com>
Subject: Re: bug#51239: emptyish web page found via google 'auctex emacs'
Date: Mon, 18 Oct 2021 01:28:39 +0100

Dear Keita,

On Sat, 16 Oct 2021 at 17:22, Ikumi Keita <ikumi <at> ikumi.que.jp> wrote:
>
> Hi Mosè,
>
> >>>>> Mosè Giordano <mose <at> gnu.org> writes:
> > that's how texi2html works, I don't think we can do much about that.
>
> It seems that texi2html was declared as obsolete a decade ago and the
> developer recommends to switch to makeinfo[1]. Maybe we should consider
> to switch and seek for a way to generate less emptyish html pages by
> makeinfo.
>
> [1] https://www.nongnu.org/texi2html/
>
> At least the current doc/Makefile generates such pages by makeinfo when
> I issue "make html/index.html" in doc directory. (makeinfo is chosen by
> Makefile when texi2html is missing and makeinfo is available.)

You have to build with something like "make www-doc TAG=12.3".  It
looks like that adapting the workflow to makeinfo would require quite
some work and I'm not even sure that anything will change at all with
regard to splitting.

Maybe the only thing one could do is to add some text to section
"1.3.1 Functions for editing TeX files" to not have it completely
empty?  But still, there is technically not much wrong, it's that that
section is really empty and users need to press the next button to
read the next section.

Bye,
Mosè

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.