all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#22651: Up: GNU Guix doc produces 404 page not found
@ 2016-02-13 17:06 myglc2
  2016-02-15 19:49 ` Alex Kost
                   ` (3 more replies)
  0 siblings, 4 replies; 14+ messages in thread
From: myglc2 @ 2016-02-13 17:06 UTC (permalink / raw)
  To: 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: Up: GNU Guix doc produces 404 page not found
  2016-02-13 17:06 bug#22651: Up: GNU Guix doc produces 404 page not found myglc2
@ 2016-02-15 19:49 ` Alex Kost
  2016-02-15 20:06   ` carl hansen
                     ` (2 more replies)
  2016-05-07 17:25 ` bug#22651: [PATCH] gendocs.sh: Fix "dir" link in HTML output Ludovic Courtès
                   ` (2 subsequent siblings)
  3 siblings, 3 replies; 14+ messages in thread
From: Alex Kost @ 2016-02-15 19:49 UTC (permalink / raw)
  To: myglc2; +Cc: 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: Up: GNU Guix doc produces 404 page not found
  2016-02-15 19:49 ` Alex Kost
@ 2016-02-15 20:06   ` carl hansen
  2016-02-15 23:10     ` Thompson, David
  2016-05-03 20:54   ` bug#22651: "Up (dir)" HTML link is 404 Ludovic Courtès
       [not found]   ` <877ffaj20x.fsf_-_@gnu.org>
  2 siblings, 1 reply; 14+ messages in thread
From: carl hansen @ 2016-02-15 20:06 UTC (permalink / raw)
  To: Alex Kost; +Cc: myglc2, 22651

[-- 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 --]

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: Up: GNU Guix doc produces 404 page not found
  2016-02-15 20:06   ` carl hansen
@ 2016-02-15 23:10     ` Thompson, David
  2016-02-16  0:59       ` carl hansen
  0 siblings, 1 reply; 14+ messages in thread
From: Thompson, David @ 2016-02-15 23:10 UTC (permalink / raw)
  To: carl hansen; +Cc: Alex Kost, myglc2, 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: Up: GNU Guix doc produces 404 page not found
  2016-02-15 23:10     ` Thompson, David
@ 2016-02-16  0:59       ` carl hansen
  2016-02-16  1:22         ` Leo Famulari
  0 siblings, 1 reply; 14+ messages in thread
From: carl hansen @ 2016-02-16  0:59 UTC (permalink / raw)
  To: Thompson, David; +Cc: Alex Kost, myglc2, 22651

[-- 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 --]

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: Up: GNU Guix doc produces 404 page not found
  2016-02-16  0:59       ` carl hansen
@ 2016-02-16  1:22         ` Leo Famulari
  0 siblings, 0 replies; 14+ messages in thread
From: Leo Famulari @ 2016-02-16  1:22 UTC (permalink / raw)
  To: carl hansen; +Cc: Alex Kost, myglc2, 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: "Up (dir)" HTML link is 404
  2016-02-15 19:49 ` Alex Kost
  2016-02-15 20:06   ` carl hansen
@ 2016-05-03 20:54   ` Ludovic Courtès
       [not found]   ` <877ffaj20x.fsf_-_@gnu.org>
  2 siblings, 0 replies; 14+ messages in thread
From: Ludovic Courtès @ 2016-05-03 20:54 UTC (permalink / raw)
  To: bug-texinfo; +Cc: 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: "Up (dir)" HTML link is 404
       [not found]   ` <877ffaj20x.fsf_-_@gnu.org>
@ 2016-05-04 18:07     ` Gavin Smith
       [not found]     ` <CAKPWYQ3muG3nLo8yQJVhe9ueLQPohSUn9it3vq6s8JvWLfgSKw@mail.gmail.com>
  1 sibling, 0 replies; 14+ messages in thread
From: Gavin Smith @ 2016-05-04 18:07 UTC (permalink / raw)
  To: Ludovic Courtès; +Cc: Texinfo, 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: "Up (dir)" HTML link is 404
       [not found]     ` <CAKPWYQ3muG3nLo8yQJVhe9ueLQPohSUn9it3vq6s8JvWLfgSKw@mail.gmail.com>
@ 2016-05-05 12:47       ` Ludovic Courtès
       [not found]       ` <87h9ecekn5.fsf@gnu.org>
  1 sibling, 0 replies; 14+ messages in thread
From: Ludovic Courtès @ 2016-05-05 12:47 UTC (permalink / raw)
  To: Gavin Smith; +Cc: Texinfo, 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: "Up (dir)" HTML link is 404
       [not found]       ` <87h9ecekn5.fsf@gnu.org>
@ 2016-05-05 14:44         ` Gavin Smith
  0 siblings, 0 replies; 14+ messages in thread
From: Gavin Smith @ 2016-05-05 14:44 UTC (permalink / raw)
  To: Ludovic Courtès; +Cc: Texinfo, 22651

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.

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: [PATCH] gendocs.sh: Fix "dir" link in HTML output
  2016-02-13 17:06 bug#22651: Up: GNU Guix doc produces 404 page not found myglc2
  2016-02-15 19:49 ` Alex Kost
@ 2016-05-07 17:25 ` Ludovic Courtès
  2016-09-27 16:53 ` bug#22651: fixed, please close ng0
  2016-09-27 18:51 ` bug#22651: ng0
  3 siblings, 0 replies; 14+ messages in thread
From: Ludovic Courtès @ 2016-05-07 17:25 UTC (permalink / raw)
  To: bug-gnulib; +Cc: 22651

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: fixed, please close.
  2016-02-13 17:06 bug#22651: Up: GNU Guix doc produces 404 page not found myglc2
  2016-02-15 19:49 ` Alex Kost
  2016-05-07 17:25 ` bug#22651: [PATCH] gendocs.sh: Fix "dir" link in HTML output Ludovic Courtès
@ 2016-09-27 16:53 ` ng0
  2016-09-30 16:12   ` Ludovic Courtès
  2016-09-27 18:51 ` bug#22651: ng0
  3 siblings, 1 reply; 14+ messages in thread
From: ng0 @ 2016-09-27 16:53 UTC (permalink / raw)
  To: 22651

see subject.

thanks
-- 
              ng0

^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651:
  2016-02-13 17:06 bug#22651: Up: GNU Guix doc produces 404 page not found myglc2
                   ` (2 preceding siblings ...)
  2016-09-27 16:53 ` bug#22651: fixed, please close ng0
@ 2016-09-27 18:51 ` ng0
  3 siblings, 0 replies; 14+ messages in thread
From: ng0 @ 2016-09-27 18:51 UTC (permalink / raw)
  To: 22651-done



^ permalink raw reply	[flat|nested] 14+ messages in thread

* bug#22651: fixed, please close.
  2016-09-27 16:53 ` bug#22651: fixed, please close ng0
@ 2016-09-30 16:12   ` Ludovic Courtès
  0 siblings, 0 replies; 14+ messages in thread
From: Ludovic Courtès @ 2016-09-30 16:12 UTC (permalink / raw)
  To: ng0; +Cc: 22651-done

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

^ permalink raw reply	[flat|nested] 14+ messages in thread

end of thread, other threads:[~2016-09-30 16:13 UTC | newest]

Thread overview: 14+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-02-13 17:06 bug#22651: Up: GNU Guix doc produces 404 page not found myglc2
2016-02-15 19:49 ` Alex Kost
2016-02-15 20:06   ` carl hansen
2016-02-15 23:10     ` Thompson, David
2016-02-16  0:59       ` carl hansen
2016-02-16  1:22         ` Leo Famulari
2016-05-03 20:54   ` bug#22651: "Up (dir)" HTML link is 404 Ludovic Courtès
     [not found]   ` <877ffaj20x.fsf_-_@gnu.org>
2016-05-04 18:07     ` Gavin Smith
     [not found]     ` <CAKPWYQ3muG3nLo8yQJVhe9ueLQPohSUn9it3vq6s8JvWLfgSKw@mail.gmail.com>
2016-05-05 12:47       ` Ludovic Courtès
     [not found]       ` <87h9ecekn5.fsf@gnu.org>
2016-05-05 14:44         ` Gavin Smith
2016-05-07 17:25 ` bug#22651: [PATCH] gendocs.sh: Fix "dir" link in HTML output Ludovic Courtès
2016-09-27 16:53 ` bug#22651: fixed, please close ng0
2016-09-30 16:12   ` Ludovic Courtès
2016-09-27 18:51 ` bug#22651: ng0

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.