admin/make-manuals

admin/make-manuals

[Eli Zaretskii]

This is the first time I'm using this script.  It said "Making manuals
(slow)...", and then nothing else for about an hour(!).  Looking in
the manual/ directory it created, I see a single manual -- Emacs -- in
a single format, whose last file was created 7 minutes after the
script started.  Then it seemed to sit doing nothing, but using up
100% of the CPU.

I added some diagnostic printouts to the relevant functions in
admin.el, and watched them with "tail -f" (btw, why is the script by
default so silent about what it does? it isn't good karma for slow
scripts, IME) -- what I see is that manual-html-fix-index-2 is stuck
in this loop:

	(while (not done)
	  (cond ((re-search-forward "<tr><td.*&bull; \\(<a.*</a>\\)\
:</td><td>&nbsp;&nbsp;</td><td[^>]*>\\(.*\\)" (line-end-position) t)
		 (replace-match (format "<tr><td%s>\\1</td>\n<td>\\2"
					(if table-workaround
					    " bgcolor=\"white\"" "")))
		 (search-forward "</td></tr>")
		 (forward-line 1))
		((looking-at "<tr><th.*<pre class=\"menu-comment\">\n")
		 (replace-match "<tr><th colspan=\"2\" align=\"left\" \
style=\"text-align:left\">")

It is stuck there because none of the branches of 'cond' inside the
loop matches.

Am I doing something wrong, or is this a bug in admin.el?

I couldn't regenerate the manuals as part of Emacs 27.2 release, as
result of this.

Re: admin/make-manuals

[Glenn Morris]

It completes for me in 90 seconds, but I use makeinfo 4.13.
I imagine that you are using a newer version of makeinfo,
and that some of the details of the output have changed, and that
manual-html-fix-* needs updating.
(It was updated year ago for Texinfo 5.)

Re: admin/make-manuals

[Eli Zaretskii]

> From: Glenn Morris <rgm@gnu.org>
> Cc: emacs-devel@gnu.org
> Date: Thu, 25 Mar 2021 12:40:10 -0400
> 
> It completes for me in 90 seconds, but I use makeinfo 4.13.
> I imagine that you are using a newer version of makeinfo,

Of course.  Otherwise the Info manuals come out funny (don't pay
attention to UTF-8 etc.).  I had to upgrade.

> and that some of the details of the output have changed, and that
> manual-html-fix-* needs updating.
> (It was updated year ago for Texinfo 5.)

So I guess as long as this isn't fixed, we won't be able to update the
manuals on the Web site reliably?  Fixes will be very welcome, TIA.

P.S. Why do we even try to "fix" the HTML that comes out of Texinfo?

Re: admin/make-manuals

[Glenn Morris]

I uploaded the makeinfo 4.13 version without seeing your utf-8 comments.
Anyone should feel free to replace them.
I suggest making a bug report for Texinfo > 5 support in admin.el.

Re: admin/make-manuals

[Eli Zaretskii]

> From: Glenn Morris <rgm@gnu.org>
> Cc: emacs-devel@gnu.org
> Date: Thu, 25 Mar 2021 13:45:47 -0400
> 
> I uploaded the makeinfo 4.13 version without seeing your utf-8 comments.
> Anyone should feel free to replace them.

Thanks.

> I suggest making a bug report for Texinfo > 5 support in admin.el.

Done.