help-texinfo
[Top][All Lists]
Advanced
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: HTML <title> node names: Not emitting 'Top (Manual name)'

From: Eli Zaretskii
Subject: Re: HTML <title> node names: Not emitting 'Top (Manual name)'
Date: Sun, 17 Mar 2024 16:31:35 +0200 
> Date: Sun, 17 Mar 2024 12:29:01 +0100
> From: pertusus@free.fr
> Cc: Gavin Smith <gavinsmith0123@gmail.com>, arsen@aarsen.me,
>       help-texinfo@gnu.org
> 
> On Sat, Mar 16, 2024 at 09:29:59AM +0200, Eli Zaretskii wrote:
> > If and when we understand the rationale for that code, and you can
> > suggest how to achieve the same with texi2any customizations, I can
> > assure you that we in the Emacs maintenance will enthusiastically
> > consider switching to those customizations.
> 
> Here is a proposal for an init file.  The <div> placement in split case
> was not that easy to achieve.
> 
> It unveiled bugs in texi2any and showed the need for a new customization
> variable so it will only work correctly with the development
> version/next release.
> 
> I left the <link> in <head> that are removed by the admin.el script, as
> I think it is better to leave them in and my feeling is that their
> removal is not intended.  I also left the copyright in comment because
> to remove it would mean having the whole beginning of file code redone
> in the init file, which is possible, but much more of a burden for long
> term maintenance.  Also, even if you could prefer if this copyright
> comment was not there, I do not think that it is very important as it is
> a comment.
> 
> 
> A side note on the added link and meta, I kept them as is but for
>  "<link rev=\"made\" href=\"mailto:bug-gnu-emacs@gnu.org\";>
> I read on
> https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel
> that "made" is obsolete and should be replaced by "author" (although
> processors should already do that).
> 
> I also have a doubt on the ICBM meta, I am not familiar enough with Boston
> outskirts to know if the ICBM is still valid, but I think that it should be
> checked by someone who could know:
>  "<meta name=\"ICBM\" content=\"42.256233,-71.006581\">"

Thanks.

I'm really uneasy about adding this kind of stuff to Emacs, unless
someone comes on board who has much better command of Perl than I do,
and volunteers to maintain this.  Maybe Stefan Kangas (CC'ed), who
co-maintains Emacs with me, could be that person.  If not, I don't
think we should add to Emacs code that is more or less "black magic"
for us, because it will certainly need to be maintained in the future.

In addition, since this needs the next major release of Texinfo to
work correctly, we cannot start using this now anyway.  There's also
the question of supporting old versions of Texinfo; while Texinfo 4
sounds too old (although we have positive indications that at least
one of the active Emacs developers still uses it) and could be perhaps
dropped for this job, I think we do still want to support Texinfo 6
and maybe also Texinfo 5.  I'm not sure how this init file suggestion
works for previous releases of Texinfo, and if it doesn't, what to do
about that (probably leave the admin.el stuff in place?).

I took the liberty of CC'ing Glenn Morris, who worked on those parts
of admin.el at the time and probably knows the reasons for at least
some of the edits it does, in the hope that he could chime in and
comment on these issues.
reply via email to
[Prev in Thread] Current Thread [Next in Thread]