On Thu, Jan 08, 2026 at 04:50:19PM +0100, Thérèse Godefroy wrote:
> > It seems to me that it may be unsustainable for one person (you) to
> > maintain CSS for all these manuals.  The style.css file is full
> > of code that is specific for particular manuals.  I would expect the
> > developers of those manuals to take responsibility for setting CSS
> > for their manuals.
> 
> The fact is they don't. Often there is no consistency within a manual.
> What should be fixed in that case is the .texi file. But then you need
> to get hold of the developer. This can take much longer (if it succeeds
> at all) than twisting the CSS to fix the inconsistencies.
> 
> Fortunately, very few manuals have tables or images. They are the ones I
> tried to fix. I don't expect very old ones like PSPP to change in the
> near future, so the maintenance should be rather simple.
> 

I have a couple of further issues to report:

* Vertical spacing in indices is excessive.  See for example
https://www.gnu.org/software/emacs/manual/html_node/elisp/Index.html#Index_fn_letter-A.
There is no need for the extra whitespace between index entries.
It means fewer entries are visible on the screen at once.

(I check this in Chromium with DevTools which allows you to easily
disable CSS rules.)

This comes from the rule in style.css:

td, th {
   padding: .4em .6em;
   text-align: left;
   background: white;   /* In case overflow extends outside <body>. */
}

In recent versions of Texinfo at least, <td> elements with index
entries are distinguished with the "printindex-index-entry" class,
which could be used to exclude indices from this rule, if the rule
is to be kept.

* No underlining is needed on <abbr> even if the "title" attribute
is present, as the expansion appears afterwards in brackets.  There's no
point in prompting the user to hover their mouse over the abbreviation
to get an expansion as a tooltip when the expansion is right there
after the abbreviation.  E.g. in "Comput. J. (Computer Journal)",
the "Comput. J." text would be underlined and hovering over it would
display a "Computer Journal" tooltip.


  • Seve... Gavin Smith
    • ... Bruno Haible via Bug reports for the GNU Texinfo documentation system
      • ... Thérèse Godefroy
        • ... Patrice Dumas
          • ... Thérèse Godefroy
            • ... Gavin Smith
              • ... Thérèse Godefroy
                • ... Gavin Smith

Reply via email to