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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 22651 in the body.
You can then email your comments to 22651 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: myglc2 <myglc2 <at> gmail.com>
To: bug-guix <at> gnu.org
Subject: Up: GNU Guix doc produces 404 page not found
Date: Sat, 13 Feb 2016 12:06:54 -0500

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

Message #8 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Alex Kost <alezost <at> gmail.com>
To: myglc2 <myglc2 <at> gmail.com>
Cc: 22651 <at> debbugs.gnu.org
Subject: Re: bug#22651: Up: GNU Guix doc produces 404 page not found
Date: Mon, 15 Feb 2016 22:49:45 +0300

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

Message #11 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: carl hansen <carlhansen1234 <at> gmail.com>
To: Alex Kost <alezost <at> gmail.com>
Cc: myglc2 <myglc2 <at> gmail.com>, 22651 <at> debbugs.gnu.org
Subject: Re: bug#22651: Up: GNU Guix doc produces 404 page not found
Date: Mon, 15 Feb 2016 12:06:25 -0800

[Message part 1 (text/plain, inline)]

On Mon, Feb 15, 2016 at 11:49 AM, Alex Kost <alezost <at> 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.

[Message part 2 (text/html, inline)]

Message #14 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: "Thompson, David" <dthompson2 <at> worcester.edu>
To: carl hansen <carlhansen1234 <at> gmail.com>
Cc: Alex Kost <alezost <at> gmail.com>, myglc2 <myglc2 <at> gmail.com>,
 22651 <at> debbugs.gnu.org
Subject: Re: bug#22651: Up: GNU Guix doc produces 404 page not found
Date: Mon, 15 Feb 2016 18:10:11 -0500

On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234 <at> 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

Message #17 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: carl hansen <carlhansen1234 <at> gmail.com>
To: "Thompson, David" <dthompson2 <at> worcester.edu>
Cc: Alex Kost <alezost <at> gmail.com>, myglc2 <myglc2 <at> gmail.com>,
 22651 <at> debbugs.gnu.org
Subject: Re: bug#22651: Up: GNU Guix doc produces 404 page not found
Date: Mon, 15 Feb 2016 16:59:00 -0800

[Message part 1 (text/plain, inline)]

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

> On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234 <at> 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.

[Message part 2 (text/html, inline)]

Message #20 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Leo Famulari <leo <at> famulari.name>
To: carl hansen <carlhansen1234 <at> gmail.com>
Cc: Alex Kost <alezost <at> gmail.com>, myglc2 <myglc2 <at> gmail.com>, "Thompson,
 David" <dthompson2 <at> worcester.edu>, 22651 <at> debbugs.gnu.org
Subject: Re: bug#22651: Up: GNU Guix doc produces 404 page not found
Date: Mon, 15 Feb 2016 20:22:17 -0500

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 <at> worcester.edu>
> wrote:
> 
> > On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234 <at> 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>.

Message #23 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: ludo <at> gnu.org (Ludovic Courtès)
To: bug-texinfo <at> gnu.org
Cc: 22651 <at> debbugs.gnu.org
Subject: "Up (dir)" HTML link is 404
Date: Tue, 03 May 2016 22:54:22 +0200

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’.

Message #26 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Gavin Smith <gavinsmith0123 <at> gmail.com>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: Texinfo <bug-texinfo <at> gnu.org>, 22651 <at> debbugs.gnu.org
Subject: Re: "Up (dir)" HTML link is 404
Date: Wed, 4 May 2016 19:07:20 +0100

On 3 May 2016 at 21:54, Ludovic Courtès <ludo <at> 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’.
>

Message #29 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: ludo <at> gnu.org (Ludovic Courtès)
To: Gavin Smith <gavinsmith0123 <at> gmail.com>
Cc: Texinfo <bug-texinfo <at> gnu.org>, 22651 <at> debbugs.gnu.org
Subject: Re: "Up (dir)" HTML link is 404
Date: Thu, 05 May 2016 14:47:58 +0200

[Message part 1 (text/plain, inline)]

Hi,

Gavin Smith <gavinsmith0123 <at> 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:

[Message part 2 (text/x-patch, inline)]

--- 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 <at> 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

[Message part 3 (text/plain, inline)]

WDYT?

Thanks,
Ludo’.

Message #32 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Gavin Smith <gavinsmith0123 <at> gmail.com>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: Texinfo <bug-texinfo <at> gnu.org>, 22651 <at> debbugs.gnu.org
Subject: Re: "Up (dir)" HTML link is 404
Date: Thu, 5 May 2016 15:44:00 +0100

On 5 May 2016 at 13:47, Ludovic Courtès <ludo <at> 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.

Message #35 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: bug-gnulib <at> gnu.org
Cc: Ludovic Courtès <ludo <at> gnu.org>, 22651 <at> debbugs.gnu.org
Subject: [PATCH] gendocs.sh: Fix "dir" link in HTML output
Date: Sat,  7 May 2016 19:25:09 +0200

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

Message #38 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: bug-gnulib <at> gnu.org
Cc: Ludovic Courtès <ludo <at> gnu.org>, 22651 <at> debbugs.gnu.org
Subject: [PATCH] gendocs.sh: Set default TOP_NODE_UP_URL in HTML output.
Date: Sat,  7 May 2016 19:25:10 +0200

Suggested by Gavin Smith <gavinsmith0123 <at> gmail.com>.
Reported by myglc2 <myglc2 <at> gmail.com> in <http://bugs.gnu.org/22651>.

* build-aux/gendocs.sh (MANUAL_TITLE, PACKAGE, EMAIL)
(commonarg, dirargs, dirs, infoarg, generate_ascii)
(generate_html, generate_info, generate_tex, outdir)
(source_extra, split, srcfile, texarg): Move above 'version'.
(htmlarg): Likewise, and add "-c TOP_NODE_UP_URL=/manual".
---
 build-aux/gendocs.sh | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/build-aux/gendocs.sh b/build-aux/gendocs.sh
index 1d1e1e7..ef55fbe 100755
--- a/build-aux/gendocs.sh
+++ b/build-aux/gendocs.sh
@@ -2,7 +2,7 @@
 # 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=2016-01-01.00
+scriptversion=2016-05-07.19
 
 # Copyright 2003-2016 Free Software Foundation, Inc.
 #
@@ -52,6 +52,24 @@ templateurl="http://git.savannah.gnu.org/cgit/gnulib.git/plain/doc/gendocs_templ
 unset CDPATH
 unset use_texi2html
 
+MANUAL_TITLE=
+PACKAGE=
+EMAIL=webmasters <at> 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 -c TOP_NODE_UP_URL=/manual"
+infoarg=--no-split
+generate_ascii=true
+generate_html=true
+generate_info=true
+generate_tex=true
+outdir=manual
+source_extra=
+split=node
+srcfile=
+texarg="-t @finalout"
+
 version="gendocs.sh $scriptversion
 
 Copyright 2016 Free Software Foundation, Inc.
@@ -74,7 +92,7 @@ Options:
   -I DIR       append DIR to the Texinfo search path.
   --common ARG pass ARG in all invocations.
   --html ARG   pass ARG to makeinfo or texi2html for HTML targets,
-                 instead of --css-ref=/software/gnulib/manual.css.
+                 instead of '$htmlarg'.
   --info ARG   pass ARG to makeinfo for Info, instead of --no-split.
   --no-ascii   skip generating the plain text output.
   --no-html    skip generating the html output.
@@ -137,24 +155,6 @@ SETLANG setting in the source.
 Email bug reports or enhancement requests to bug-gnulib <at> gnu.org.
 "
 
-MANUAL_TITLE=
-PACKAGE=
-EMAIL=webmasters <at> 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
-infoarg=--no-split
-generate_ascii=true
-generate_html=true
-generate_info=true
-generate_tex=true
-outdir=manual
-source_extra=
-split=node
-srcfile=
-texarg="-t @finalout"
-
 while test $# -gt 0; do
   case $1 in
     -s)          shift; srcfile=$1;;
-- 
2.7.4

Message #41 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: ludo <at> gnu.org (Ludovic Courtès)
To: bug-gnulib <at> gnu.org
Cc: 22651 <at> debbugs.gnu.org
Subject: Re: [PATCH] gendocs.sh: Set default TOP_NODE_UP_URL in HTML output.
Date: Fri, 20 May 2016 09:49:17 +0200

Ludovic Courtès <ludo <at> gnu.org> skribis:

> Suggested by Gavin Smith <gavinsmith0123 <at> gmail.com>.
> Reported by myglc2 <myglc2 <at> gmail.com> in <http://bugs.gnu.org/22651>.
>
> * build-aux/gendocs.sh (MANUAL_TITLE, PACKAGE, EMAIL)
> (commonarg, dirargs, dirs, infoarg, generate_ascii)
> (generate_html, generate_info, generate_tex, outdir)
> (source_extra, split, srcfile, texarg): Move above 'version'.
> (htmlarg): Likewise, and add "-c TOP_NODE_UP_URL=/manual".

Pushed as 8d807a9.

Ludo’.

Message #44 received at 22651 <at> debbugs.gnu.org (full text, mbox):

From: ng0 <ngillmann <at> runbox.com>
To: 22651 <at> debbugs.gnu.org
Subject: fixed, please close.
Date: Tue, 27 Sep 2016 16:53:49 +0000

see subject.

thanks
-- 
              ng0

Message #49 received at 22651-done <at> debbugs.gnu.org (full text, mbox):

From: ng0 <ngillmann <at> runbox.com>
To: 22651-done <at> debbugs.gnu.org
Date: Tue, 27 Sep 2016 18:51:18 +0000

Message #52 received at 22651-done <at> debbugs.gnu.org (full text, mbox):

From: ludo <at> gnu.org (Ludovic Courtès)
To: ng0 <ngillmann <at> runbox.com>
Cc: 22651-done <at> debbugs.gnu.org
Subject: Re: bug#22651: fixed, please close.
Date: Fri, 30 Sep 2016 18:12:16 +0200

ng0 <ngillmann <at> 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’.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.