Up: GNU Guix doc produces 404 page not found

  • Done
  • quality assurance status badge
Details
8 participants
  • Alex Kost
  • carl hansen
  • Thompson, David
  • Gavin Smith
  • Leo Famulari
  • Ludovic Courtès
  • myglc2
  • ng0
Owner
unassigned
Submitted by
myglc2
Severity
normal
M
A
A
Alex Kost wrote on 15 Feb 2016 20:49
(name . myglc2)(address . myglc2@gmail.com)(address . 22651@debbugs.gnu.org)
87fuwt3g9y.fsf@gmail.com
myglc2 (2016-02-13 20:06 +0300) wrote:

Toggle quote (5 lines)
> 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:


or here:


You'll get the same 404. These pages are automatically generated from
texinfo manuals. See also a similar issue at

--
Alex
C
C
carl hansen wrote on 15 Feb 2016 21:06
(name . Alex Kost)(address . alezost@gmail.com)
CAHEkXCSz1dC4khgiKrx3KCHBk1ezt_YSvYT+OSy=idG5HbNbOw@mail.gmail.com
On Mon, Feb 15, 2016 at 11:49 AM, Alex Kost <alezost@gmail.com> wrote:

Toggle quote (24 lines)
> 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
>

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: file
T
T
Thompson, David wrote on 16 Feb 2016 00:10
(name . carl hansen)(address . carlhansen1234@gmail.com)
CAJ=RwfbfA-q8iB3wa7NMF=Bo2uF1oUU+tLHY+xkSiJJkGLv5rg@mail.gmail.com
On Mon, Feb 15, 2016 at 3:06 PM, carl hansen <carlhansen1234@gmail.com> wrote:
Toggle quote (7 lines)
>
> 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
C
C
carl hansen wrote on 16 Feb 2016 01:59
(name . Thompson, David)(address . dthompson2@worcester.edu)
CAHEkXCQaBzTg9NQtST6q62fsEr+-NwD72EwtVvm0CC4M_yXaLw@mail.gmail.com
On Mon, Feb 15, 2016 at 3:10 PM, Thompson, David <dthompson2@worcester.edu>
wrote:

Toggle quote (15 lines)
> 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: file
L
L
Leo Famulari wrote on 16 Feb 2016 02:22
(name . carl hansen)(address . carlhansen1234@gmail.com)
20160216012217.GB3984@jasmine
On Mon, Feb 15, 2016 at 04:59:00PM -0800, carl hansen wrote:
Toggle quote (26 lines)
> 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.

L
L
Ludovic Courtès wrote on 3 May 2016 22:54
"Up (dir)" HTML link is 404
(address . bug-texinfo@gnu.org)(address . 22651@debbugs.gnu.org)
877ffaj20x.fsf_-_@gnu.org
Hello,

Following the “Up (dir)” from:


leads to:


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’.
G
G
Gavin Smith wrote on 4 May 2016 20:07
(name . Ludovic Courtès)(address . ludo@gnu.org)
CAKPWYQ3muG3nLo8yQJVhe9ueLQPohSUn9it3vq6s8JvWLfgSKw@mail.gmail.com
On 3 May 2016 at 21:54, Ludovic Courtès <ludo@gnu.org> wrote:
Toggle quote (14 lines)
> 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/ ...



Toggle quote (7 lines)
>
> 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’.
>
L
L
Ludovic Courtès wrote on 5 May 2016 14:47
(name . Gavin Smith)(address . gavinsmith0123@gmail.com)
87h9ecekn5.fsf@gnu.org
Hi,

Gavin Smith <gavinsmith0123@gmail.com> skribis:

Toggle quote (7 lines)
> 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:
--- 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
WDYT?

Thanks,
Ludo’.
G
G
Gavin Smith wrote on 5 May 2016 16:44
(name . Ludovic Courtès)(address . ludo@gnu.org)
CAKPWYQ1J0BZXhL6ScXd3cQ7VOwzMgAMCguymy1qG+T43KB=6tg@mail.gmail.com
On 5 May 2016 at 13:47, Ludovic Courtès <ludo@gnu.org> wrote:
Toggle quote (8 lines)
> 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.
L
L
Ludovic Courtès wrote on 7 May 2016 19:25
[PATCH] gendocs.sh: Fix "dir" link in HTML output
(address . bug-gnulib@gnu.org)
1462641910-31441-1-git-send-email-ludo@gnu.org
Hello!

This patch aims to fix “dir” links in HTML output, as discussed at

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
L
L
Ludovic Courtès wrote on 7 May 2016 19:25
[PATCH] gendocs.sh: Set default TOP_NODE_UP_URL in HTML output.
(address . bug-gnulib@gnu.org)
1462641910-31441-2-git-send-email-ludo@gnu.org
Suggested by Gavin Smith <gavinsmith0123@gmail.com>.
Reported by myglc2 <myglc2@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(-)

Toggle diff (74 lines)
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@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@gnu.org.
"
-MANUAL_TITLE=
-PACKAGE=
-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
-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
L
L
Ludovic Courtès wrote on 20 May 2016 09:49
(address . bug-gnulib@gnu.org)(address . 22651@debbugs.gnu.org)
874m9tjhj6.fsf@gnu.org
Ludovic Courtès <ludo@gnu.org> skribis:

Toggle quote (9 lines)
> Suggested by Gavin Smith <gavinsmith0123@gmail.com>.
> Reported by myglc2 <myglc2@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’.
N
fixed, please close.
(address . 22651@debbugs.gnu.org)
87oa39jnc2.fsf@we.make.ritual.n0.is
see subject.

thanks
--
ng0
N
(address . 22651-done@debbugs.gnu.org)
8737kljhw9.fsf@we.make.ritual.n0.is

Closed
L
L
Ludovic Courtès wrote on 30 Sep 2016 18:12
(name . ng0)(address . ngillmann@runbox.com)(address . 22651-done@debbugs.gnu.org)
8760pdmknz.fsf@gnu.org
ng0 <ngillmann@runbox.com> skribis:

Toggle quote (2 lines)
> 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’.
Closed
?