From mboxrd@z Thu Jan  1 00:00:00 1970
From: Gavin Smith <gavinsmith0123@gmail.com>
Subject: bug#22651: "Up (dir)" HTML link is 404
Date: Wed, 4 May 2016 19:07:20 +0100
Message-ID: <CAKPWYQ3muG3nLo8yQJVhe9ueLQPohSUn9it3vq6s8JvWLfgSKw__29948.4702795327$1462385321$gmane$org@mail.gmail.com>
References: <87si0wmte9.fsf@gmail.com> <87fuwt3g9y.fsf@gmail.com>
	<877ffaj20x.fsf_-_@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:38117)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ay1De-0003hS-1w
	for bug-guix@gnu.org; Wed, 04 May 2016 14:08:24 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ay1DS-0005pd-9d
	for bug-guix@gnu.org; Wed, 04 May 2016 14:08:12 -0400
Received: from debbugs.gnu.org ([208.118.235.43]:54045)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ay1DR-0005oL-4G
	for bug-guix@gnu.org; Wed, 04 May 2016 14:08:06 -0400
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ay1DN-0005B6-Pc
	for bug-guix@gnu.org; Wed, 04 May 2016 14:08:01 -0400
Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-Message-ID: <handler.22651.B22651.146238524719860@debbugs.gnu.org>
In-Reply-To: <877ffaj20x.fsf_-_@gnu.org>
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix/>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: "bug-Guix" <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
To: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@gnu.org>
Cc: Texinfo <bug-texinfo@gnu.org>, 22651@debbugs.gnu.org

On 3 May 2016 at 21:54, Ludovic Court=C3=A8s <ludo@gnu.org> wrote:
> Hello,
>
> Following the =E2=80=9CUp (dir)=E2=80=9D 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 =E2=80=9Cdir=E2=80=9D 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=3D/manual/ ...

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/First-Node.ht=
ml#First-Node


>
> If so, what about hosting a =E2=80=9Cdir=E2=80=9D somewhere on gnu.org an=
d have the
> default htmlxref.cnf that comes with Texinfo point to that?
>
> Thanks,
> Ludo=E2=80=99.
>