Re: multiple online manual versions

[Mike Frysinger]

On 29 Jan 2022 15:56, Karl Berry wrote:
>     https://www.gnu.org/software/automake/manual/index-full.html
> 
> It looks nice, but the plethora of versions becomes rather an
> undifferentiated mass. Maybe make each major release its own
> <table>, as in:
> 
> <p>Automake 1.16 releases:
> <table>
> 1.16* versions
> </table>
> 
> <p>Automake 1.15 releases:
> <table>
> 1.15* versions
> </table>
> 
> Just to break it up a little.

hmm, i put a blank row inbetween the major versions instead.  if they're
separate tables, then the column & table widths aren't maintained between
tables, so you end up with slightly shifted & different sized tables.

if you think the blank rows are a bit too tight still, i could easily
make them the same height as the other rows by putting a nbsp in.

> Also, some simple intro text seems desirable (edit as you see fit):
> 
>  <p>Below are links to the manual for all released versions
>  of <a href="/software/automake/">GNU Automake</a>.
>  The <a href="/software/automake/manual/">current manual</a>
>  is also available separately.
> 
> And maybe an outro too:
> 
>  <p>Above are links to the manual for all released versions
>  of <a href="/software/automake/">GNU Automake</a>.
> 
> Wdyt?

sure

> The copyright at the bottom says 2020. I don't know if that means
> gendocs.sh needs updating, or the template, or something on the web
> site, but something somewhere should be changed to 2022. Can you check?

it's a couple of things

gnulib's gendocs template is out of date upstream:
https://lists.gnu.org/archive/html/bug-gnulib/2022-01/msg00179.html

and our copy is out of date (even before that):
automake$ grep Copyright lib/gendocs_template 
Copyright (C) 2006-2021 Free Software Foundation, Inc.
<p>Copyright &copy; 2020 Free Software Foundation, Inc.</p>

so i guess once gnulib merges my update, i'll pull it into automake, and
commit the changes to all the indexes.
-mike

signature.asc
Description: PGP signature