bug#22651: Up: GNU Guix doc produces 404 page not found

bug#22651: Up: GNU Guix doc produces 404 page not found

[myglc2]

Start on https://www.gnu.org/software/guix/download/
click 'Installation instructions.' and 'Up' 3 times
lands on 'https://www.gnu.org/software/guix/manual/dir/index.html'
which produces '404 - Page Not Found' error

bug#22651: Up: GNU Guix doc produces 404 page not found

[Alex Kost]

myglc2 (2016-02-13 20:06 +0300) wrote:

> Start on https://www.gnu.org/software/guix/download/
> click 'Installation instructions.' and 'Up' 3 times
> lands on 'https://www.gnu.org/software/guix/manual/dir/index.html'
> which produces '404 - Page Not Found' error

This is not a Guix bug.  It happens with any html manual on gnu.org.
For example, try to press "Up (dir)" here:

  https://www.gnu.org/software/guile/manual/html_node/index.html

or here:

  https://www.gnu.org/software/emacs/manual/html_node/erc/index.html

You'll get the same 404.  These pages are automatically generated from
texinfo manuals.  See also a similar issue at
<https://debbugs.gnu.org/22543>.

-- 
Alex

bug#22651: Up: GNU Guix doc produces 404 page not found

[carl hansen]

[-- Attachment #1: Type: text/plain, Size: 1012 bytes --]

On Mon, Feb 15, 2016 at 11:49 AM, Alex Kost <alezost@gmail.com> wrote:

> myglc2 (2016-02-13 20:06 +0300) wrote:
>
> > Start on https://www.gnu.org/software/guix/download/
> > click 'Installation instructions.' and 'Up' 3 times
> > lands on 'https://www.gnu.org/software/guix/manual/dir/index.html'
> > which produces '404 - Page Not Found' error
>
> This is not a Guix bug.  It happens with any html manual on gnu.org.
> For example, try to press "Up (dir)" here:
>
>   https://www.gnu.org/software/guile/manual/html_node/index.html
>
> or here:
>
>   https://www.gnu.org/software/emacs/manual/html_node/erc/index.html
>
> You'll get the same 404.  These pages are automatically generated from
> texinfo manuals.  See also a similar issue at
> <https://debbugs.gnu.org/22543>.
>
> --
> Alex
>

 http://www.gnu.org/software/guix/manual/
works.
BUT
it says:
"last updated November 04, 2015"
So cronjob on gnu.org that updates to the lastest version is not working.
Might
be the answer to the problem about , too.

[-- Attachment #2: Type: text/html, Size: 2361 bytes --]

bug#22651: Up: GNU Guix doc produces 404 page not found

[Thompson, David]

On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234@gmail.com> wrote:
>
> it says:
> "last updated November 04, 2015"
> So cronjob on gnu.org that updates to the lastest version is not working.
> Might
> be the answer to the problem about , too.

There is no such cron job for this.  The documentation *is* up-to-date
with the latest version, which is 0.9.0.

- Dave

bug#22651: Up: GNU Guix doc produces 404 page not found

[carl hansen]

[-- Attachment #1: Type: text/plain, Size: 810 bytes --]

On Mon, Feb 15, 2016 at 3:10 PM, Thompson, David <dthompson2@worcester.edu>
wrote:

> On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234@gmail.com>
> wrote:
> >
> > it says:
> > "last updated November 04, 2015"
> > So cronjob on gnu.org that updates to the lastest version is not
> working.
> > Might
> > be the answer to the problem about , too.
>
> There is no such cron job for this.  The documentation *is* up-to-date
> with the latest version, which is 0.9.0.
>
> - Dave
>
I thought the manual was accumulating patches as things proceed. And,
website
says "0.9.0", but when I do "info guix" I get:
"This document describes GNU Guix version 0.9.1, a functional package
management tool written for the GNU system."
so apparently there are changes
happening that are not appearing on the web page.

[-- Attachment #2: Type: text/html, Size: 1438 bytes --]

bug#22651: Up: GNU Guix doc produces 404 page not found

[Leo Famulari]

On Mon, Feb 15, 2016 at 04:59:00PM -0800, carl hansen wrote:
> On Mon, Feb 15, 2016 at 3:10 PM, Thompson, David <dthompson2@worcester.edu>
> wrote:
> 
> > On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234@gmail.com>
> > wrote:
> > >
> > > it says:
> > > "last updated November 04, 2015"
> > > So cronjob on gnu.org that updates to the lastest version is not
> > working.
> > > Might
> > > be the answer to the problem about , too.
> >
> > There is no such cron job for this.  The documentation *is* up-to-date
> > with the latest version, which is 0.9.0.
> >
> > - Dave
> >
> I thought the manual was accumulating patches as things proceed. And,
> website
> says "0.9.0", but when I do "info guix" I get:
> "This document describes GNU Guix version 0.9.1, a functional package
> management tool written for the GNU system."
> so apparently there are changes
> happening that are not appearing on the web page.

Please see <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=22687>.

bug#22651: "Up (dir)" HTML link is 404

[Ludovic Courtès]

Hello,

Following the “Up (dir)” from:

  https://www.gnu.org/software/guix/manual/html_node/index.html#Top

leads to:

  https://www.gnu.org/software/guix/manual/dir/index.html

which is 404.

Can htmlxref.cnf specify what the “dir” URL should be?

If so, what about hosting a “dir” somewhere on gnu.org and have the
default htmlxref.cnf that comes with Texinfo point to that?

Thanks,
Ludo’.

bug#22651: "Up (dir)" HTML link is 404

[Gavin Smith]

On 3 May 2016 at 21:54, Ludovic Courtès <ludo@gnu.org> wrote:
> Hello,
>
> Following the “Up (dir)” from:
>
>   https://www.gnu.org/software/guix/manual/html_node/index.html#Top
>
> leads to:
>
>   https://www.gnu.org/software/guix/manual/dir/index.html
>
> which is 404.
>
> Can htmlxref.cnf specify what the “dir” URL should be?

It could do, but am not sure if it is a good idea. For one thing, a
page with a list of manuals is not a Texinfo manual, so having an
htmlxref.cnf line for this is an exception, which is slightly
confusing and could cause problems. For example, if you refer to the
node "(dir)Top" this would tend to go to a page called "index.html",
which may not be what the page is called. A more important problem is
that a page with a list of GNU manuals on it would only be an
appropriate "Up" link for GNU manuals.

The way to deal with this broken link at the moment is to use the
TOP_NODE_UP customization variable, like

 makeinfo --html -c TOP_NODE_UP_URL=/manual/ ...

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/First-Node.html#First-Node


>
> If so, what about hosting a “dir” somewhere on gnu.org and have the
> default htmlxref.cnf that comes with Texinfo point to that?
>
> Thanks,
> Ludo’.
>

bug#22651: "Up (dir)" HTML link is 404

[Ludovic Courtès]

[-- Attachment #1: Type: text/plain, Size: 441 bytes --]

Hi,

Gavin Smith <gavinsmith0123@gmail.com> skribis:

> The way to deal with this broken link at the moment is to use the
> TOP_NODE_UP customization variable, like
>
>  makeinfo --html -c TOP_NODE_UP_URL=/manual/ ...
>
> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/First-Node.html#First-Node

That sounds good, I didn’t know about this variable.

I propose to submit this patch to Gnulib’s gendocs.sh:


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: Type: text/x-patch, Size: 936 bytes --]

--- a/build-aux/gendocs.sh
+++ b/build-aux/gendocs.sh
@@ -2,9 +2,9 @@
 # gendocs.sh -- generate a GNU manual in many formats.  This script is
 #   mentioned in maintain.texi.  See the help message below for usage details.
 
-scriptversion=2015-04-16.10
+scriptversion=2016-05-05.14
 
-# Copyright 2003-2015 Free Software Foundation, Inc.
+# Copyright 2003-2016 Free Software Foundation, Inc.
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -142,7 +142,7 @@ EMAIL=webmasters@gnu.org  # please override with --email
 commonarg= # passed to all makeinfo/texi2html invcations.
 dirargs=   # passed to all tools (-I dir).
 dirs=      # -I directories.
-htmlarg="--css-ref=/software/gnulib/manual.css"
+htmlarg="--css-ref=/software/gnulib/manual.css -c TOP_NODE_UP_URL=/manual/"
 infoarg=--no-split
 generate_ascii=true
 generate_html=true

[-- Attachment #3: Type: text/plain, Size: 30 bytes --]


WDYT?

Thanks,
Ludo’.

bug#22651: "Up (dir)" HTML link is 404

[Gavin Smith]

On 5 May 2016 at 13:47, Ludovic Courtès <ludo@gnu.org> wrote:
> That sounds good, I didn’t know about this variable.
>
> I propose to submit this patch to Gnulib’s gendocs.sh:
>
>
>
> WDYT?

Looks fine to me.

bug#22651: [PATCH] gendocs.sh: Fix "dir" link in HTML output

[Ludovic Courtès]

Hello!

This patch aims to fix “dir” links in HTML output, as discussed at
<https://lists.gnu.org/archive/html/bug-texinfo/2016-05/msg00005.html>.

If there are no objections, I’d like to commit it within a couple
of days.

Thanks,
Ludo’.

Ludovic Courtès (1):
  gendocs.sh: Set default TOP_NODE_UP_URL in HTML output.

 build-aux/gendocs.sh | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

-- 
2.7.4

bug#22651: fixed, please close.

[ng0]

see subject.

thanks
-- 
              ng0

bug#22651:

[ng0]

bug#22651: fixed, please close.

[Ludovic Courtès]

ng0 <ngillmann@runbox.com> skribis:

> see subject.

Just email the -done email address as I’m doing here.  :-)

Thanks for helping out with bug triage, it’s greatly needed!

Ludo’.