Re: Guile web page docs

[Ludovic Courtès]

Hi,

Neil Jerram <address@hidden> writes:

> address@hidden (Ludovic Courtès) writes:
>
>> Neil Jerram <address@hidden> writes:
>>
>>> I noticed that the docs on the Guile web pages are a bit out of date.
>>> The 1.8 ones are behind those in 1.8.7 (the latest release).
>>
>> http://www.gnu.org/software/guile/manual/html_node/index.html appears to
>> correspond to 1.8.7.
>
> Yes, but amusingly this copy of the manual is only linked from the
> "support for many SRFIs" link on
> http://www.gnu.org/software/guile/guile.html, and from inside Daniel's
> tutorial.

And from http://gnu.org/manual/ .

> If you follow the more prominent links from
> http://www.gnu.org/software/guile/, you get to
> http://www.gnu.org/software/guile/docs/docs-1.8/guile-ref/index.html,
> which is still at version 1.8.1.
>
> So, anyway, I think we agree that this needs sorting out!

Indeed.  I think I’ve always been updating the one at guile/manual,
since it’s the usual way to place GNU manuals, but I must have forgotten
to check the links under guile/.  I’d be in favor or removing ‘docs-1.8’
and keeping just ‘manual’.  What do you think?

>> (BTW, Gnulib has a new script to automate updates to
>> www.gnu.org/software/PROJECT/manual.)
>
> Right; I assume you mean gendocs.sh.

I was thinking about the ‘gnu-web-doc-update’ module.

>> I hadn't done it so far, mostly because 1.9 is alpha, and I think
>> gnu.org/software/guile/manual should point to the current stable series.
>> That said, perhaps we could put them in a sub-directory.
>
> Yes, that's what I had in mind, linked from
> http://www.gnu.org/software/guile/docs/docs.html.

OK.

> Do you have strong views on whether we should use current Git or the
> latest pre-release?  I don't think it matters much, and current Git is
> marginally easier.

Either way is fine with me.

Thank you!

Ludo’.