GNU bug report logs - #24289
bug in online documentation presentation

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: Eric Weaver <eric@HIDDEN>; Keywords: notabug; dated Mon, 22 Aug 2016 22:27:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 24289 <at> debbugs.gnu.org:


Received: (at 24289) by debbugs.gnu.org; 23 Aug 2016 14:03:08 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Aug 23 10:03:08 2016
Received: from localhost ([127.0.0.1]:38021 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1bcCIB-0008MW-LV
	for submit <at> debbugs.gnu.org; Tue, 23 Aug 2016 10:03:07 -0400
Received: from eggs.gnu.org ([208.118.235.92]:44020)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1bcCI6-0008Ln-47
 for 24289 <at> debbugs.gnu.org; Tue, 23 Aug 2016 10:03:01 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <eliz@HIDDEN>) id 1bcCHv-0005qF-CK
 for 24289 <at> debbugs.gnu.org; Tue, 23 Aug 2016 10:02:53 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=0.6 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD
 autolearn=disabled version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56408)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <eliz@HIDDEN>)
 id 1bcCHf-0005ig-Tg; Tue, 23 Aug 2016 10:02:31 -0400
Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4211
 helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128)
 (Exim 4.82) (envelope-from <eliz@HIDDEN>)
 id 1bcCHe-0004MN-6v; Tue, 23 Aug 2016 10:02:30 -0400
Date: Tue, 23 Aug 2016 17:02:45 +0300
Message-Id: <83oa4jfure.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Eric Weaver <eric@HIDDEN>
In-reply-to: <CACeZL8Mn3cG7+t6vhXPWzagCnCUkNDs+AAry9sROYdt++tZT6Q@HIDDEN>
 (message from Eric Weaver on Mon, 22 Aug 2016 18:24:42 -0400)
Subject: Re: bug#24289: bug in online documentation presentation
References: <CACeZL8Mn3cG7+t6vhXPWzagCnCUkNDs+AAry9sROYdt++tZT6Q@HIDDEN>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -5.3 (-----)
X-Debbugs-Envelope-To: 24289
Cc: 24289 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Reply-To: Eli Zaretskii <eliz@HIDDEN>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -5.3 (-----)

tags 24289 + notabug
thanks

> From: Eric Weaver <eric@HIDDEN>
> Date: Mon, 22 Aug 2016 18:24:42 -0400
> Cc: Eric Matthew Weaver <eric@HIDDEN>
> 
> bug in online documentation presentation ... not the content, but the presentation... I'm reading the
> documentation page-by-page and am noticing an inconsistency with the presence (or lack) of the bottom row
> of links. For example...
> 
> page 1, "https://www.gnu.org/software/emacs/manual/html_node/elisp/Introduction.html#Introduction" has the
> top & bottom rows of Next, Previous, Up, Contents, Index
> but page 1.1, "https://www.gnu.org/software/emacs/manual/html_node/elisp/Caveats.html#Caveats" has only
> the top row
> page 1.2, "https://www.gnu.org/software/emacs/manual/html_node/elisp/Lisp-History.html#Lisp-History" has
> both the top & bottom rows
> but page 1.3, "https://www.gnu.org/software/emacs/manual/html_node/elisp/Conventions.html#Conventions"
> has only the top row
> and page 1.3.1,
> "https://www.gnu.org/software/emacs/manual/html_node/elisp/Some-Terms.html#Some-Terms" has only the
> top row
> page 1.3.2, "https://www.gnu.org/software/emacs/manual/html_node/elisp/nil-and-t.html#nil-and-t" has both
> the top & bottom rows
> but page 1.3.3,
> "https://www.gnu.org/software/emacs/manual/html_node/elisp/Evaluation-Notation.html#Evaluation-Notation"
> has only the top row
> 
> the pattern so far is that if the outline hierarchical address ends with an odd number, then the page does not
> get a bottom row of links.

No, the pattern is: if the node is large enough, it gets the links at
the bottom, in addition to the ones at the top.  The theory behind
this being that in a short enough node you will still see the links at
the top even when you are reading the stuff at the bottom.

In the Texinfo manual we have this piece of documentation:

  'WORDS_IN_PAGE'
       For HTML, with output split at nodes.  Specifies the approximate
       minimum page length at which a navigation panel is placed at the
       bottom of a page.  To avoid ever having the navigation buttons at
       the bottom of a page, set this to a sufficiently large number.  The
       default is 300.

If you think the default value is too large, please report this to the
Texinfo maintainers.  This project just uses Texinfo defaults while
producing the HTML docs.

> Would be great if you can fix it, but it's not the end of the world.

Personally, I don't think this is something that should be fixed,
certainly not in Emacs.

Thanks.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#24289; Package emacs. Full text available.
Added tag(s) notabug. Request was from Eli Zaretskii <eliz@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 22 Aug 2016 22:26:52 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Aug 22 18:26:52 2016
Received: from localhost ([127.0.0.1]:37251 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1bbxgC-0004af-FM
	for submit <at> debbugs.gnu.org; Mon, 22 Aug 2016 18:26:52 -0400
Received: from eggs.gnu.org ([208.118.235.92]:60187)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ew6@HIDDEN>) id 1bbxf7-0004Yk-QO
 for submit <at> debbugs.gnu.org; Mon, 22 Aug 2016 18:25:46 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <ew6@HIDDEN>) id 1bbxf1-0002SO-60
 for submit <at> debbugs.gnu.org; Mon, 22 Aug 2016 18:25:40 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,HTML_MESSAGE
 autolearn=disabled version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:42898)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <ew6@HIDDEN>) id 1bbxf0-0002SD-Sa
 for submit <at> debbugs.gnu.org; Mon, 22 Aug 2016 18:25:38 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51144)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <ew6@HIDDEN>) id 1bbxey-0002b2-9N
 for bug-gnu-emacs@HIDDEN; Mon, 22 Aug 2016 18:25:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <ew6@HIDDEN>) id 1bbxeu-0002QC-MQ
 for bug-gnu-emacs@HIDDEN; Mon, 22 Aug 2016 18:25:36 -0400
Received: from millet.cc.columbia.edu ([128.59.72.250]:60135)
 by eggs.gnu.org with esmtp (Exim 4.71)
 (envelope-from <ew6@HIDDEN>) id 1bbxeu-0002OE-Hx
 for bug-gnu-emacs@HIDDEN; Mon, 22 Aug 2016 18:25:32 -0400
Received: from hazelnut (hazelnut.cc.columbia.edu [128.59.213.250])
 by millet.cc.columbia.edu (8.13.8/8.13.8) with ESMTP id u7MMNCcW028860
 for <bug-gnu-emacs@HIDDEN>; Mon, 22 Aug 2016 18:25:26 -0400
Received: from hazelnut (localhost.localdomain [127.0.0.1])
 by hazelnut (Postfix) with ESMTP id CC4026D
 for <bug-gnu-emacs@HIDDEN>; Mon, 22 Aug 2016 18:25:26 -0400 (EDT)
Received: from sendprodmail01.cc.columbia.edu (sendprodmail01.cc.columbia.edu
 [128.59.72.13]) by hazelnut (Postfix) with ESMTP id B6C896D
 for <bug-gnu-emacs@HIDDEN>; Mon, 22 Aug 2016 18:25:26 -0400 (EDT)
Received: from mail-lf0-f72.google.com (mail-lf0-f72.google.com
 [209.85.215.72])
 by sendprodmail01.cc.columbia.edu (8.14.4/8.14.4) with ESMTP id u7MMPPnk042082
 (version=TLSv1/SSLv3 cipher=AES128-GCM-SHA256 bits=128 verify=NOT)
 for <bug-gnu-emacs@HIDDEN>; Mon, 22 Aug 2016 18:25:26 -0400
Received: by mail-lf0-f72.google.com with SMTP id p85so83737542lfg.3
 for <bug-gnu-emacs@HIDDEN>; Mon, 22 Aug 2016 15:25:26 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20130820;
 h=x-gm-message-state:mime-version:from:date:message-id:subject:to:cc;
 bh=b4gSInqtKNeqPjZP2EcvoA7MGczmoG5t4csUI+vYlpo=;
 b=ms4/Mj2YVDxoMEQwaL17Y+sH9b4fIr7iYSZUNy/rzfc6igDuHufpsC+DmdfjUhpnJd
 jRl6fkdvrapYs1SXzpQnzNcEXTvQ+tX6jjFe1+q/2sJt6Tipj0Nni9L3dC/L36CCJGTO
 O0Kehe+2QmNOmufe3QAAslVjyRJA1ctRSEQ/nsjso8ysCUgX12qt3BUFukyAMd5bRQKD
 51MlkHm93lk5BgupU571q4YJMJEZioh1jruv+VctPqBbjTkVCuYzIJDYWmMy+b9i6bPK
 bJjUdtkxbNHVdYQdCdgzToHQ8t4qehW+Z0760KZtvYkZYpDYsYZv/iNGxmpPNhecjX58
 LL9w==
X-Gm-Message-State: AEkoous62i5qer6pftdWkG7MfrGl0/v0sDKl25PbEJwox7rf55ngBpBmVrWpCVfbxHf+C2VnOGRidnp2LXXfWUTdA6LLMMh0877LB1BSbD/BA8uXdF4CLFdvdl1jzusQSLdlLYBsdfAYaMFwlC3vNvLh77+YWpJ6YQ==
X-Received: by 10.25.87.2 with SMTP id l2mr6911107lfb.170.1471904724892;
 Mon, 22 Aug 2016 15:25:24 -0700 (PDT)
X-Received: by 10.25.87.2 with SMTP id l2mr6911093lfb.170.1471904724332; Mon,
 22 Aug 2016 15:25:24 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.25.21.221 with HTTP; Mon, 22 Aug 2016 15:24:42 -0700 (PDT)
From: Eric Weaver <eric@HIDDEN>
Date: Mon, 22 Aug 2016 18:24:42 -0400
Message-ID: <CACeZL8Mn3cG7+t6vhXPWzagCnCUkNDs+AAry9sROYdt++tZT6Q@HIDDEN>
Subject: bug in online documentation presentation
To: bug-gnu-emacs@HIDDEN
Content-Type: multipart/alternative; boundary=001a114127bc3cc568053ab0862a
X-No-Spam-Score: Local
X-Scanned-By: MIMEDefang 2.78 on 128.59.72.13
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -4.0 (----)
X-Debbugs-Envelope-To: submit
X-Mailman-Approved-At: Mon, 22 Aug 2016 18:26:51 -0400
Cc: Eric Matthew Weaver <eric@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -4.0 (----)

--001a114127bc3cc568053ab0862a
Content-Type: text/plain; charset=UTF-8

bug in online documentation presentation ... not the content, but the
presentation... I'm reading the documentation page-by-page and am noticing
an inconsistency with the presence (or lack) of the bottom row of links.
For example...

page 1, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/Introduction.html#Introduction"
has
the top & bottom rows of Next, Previous, Up, Contents, Index
but page 1.1, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/Caveats.html#Caveats"
has only the top row
page 1.2, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/Lisp-History.html#Lisp-History"
has both the top & bottom rows
but page 1.3, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/Conventions.html#Conventions"
has only the top row
and page 1.3.1, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/Some-Terms.html#Some-Terms"
has only the top row
page 1.3.2, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/nil-and-t.html#nil-and-t"
has both the top & bottom rows
but page 1.3.3, "
https://www.gnu.org/software/emacs/manual/html_node/elisp/Evaluation-Notation.html#Evaluation-Notation"
has only the top row

the pattern so far is that if the outline hierarchical address ends with an
odd number, then the page does not get a bottom row of links.

Would be great if you can fix it, but it's not the end of the world.

Tnx.  /Eric

--001a114127bc3cc568053ab0862a
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">bug in online documentation presentation ... not the conte=
nt, but the presentation... I&#39;m reading the documentation page-by-page =
and am noticing an inconsistency with the presence (or lack) of the bottom =
row of links.=C2=A0 For example...<br><div><br></div><div>page 1, &quot;<a =
href=3D"https://www.gnu.org/software/emacs/manual/html_node/elisp/Introduct=
ion.html#Introduction">https://www.gnu.org/software/emacs/manual/html_node/=
elisp/Introduction.html#Introduction</a>&quot;=C2=A0has the top &amp; botto=
m rows of Next, Previous, Up, Contents, Index</div><div>but page 1.1, &quot=
;<a href=3D"https://www.gnu.org/software/emacs/manual/html_node/elisp/Cavea=
ts.html#Caveats">https://www.gnu.org/software/emacs/manual/html_node/elisp/=
Caveats.html#Caveats</a>&quot; has only the top row</div><div>page 1.2, &qu=
ot;<a href=3D"https://www.gnu.org/software/emacs/manual/html_node/elisp/Lis=
p-History.html#Lisp-History">https://www.gnu.org/software/emacs/manual/html=
_node/elisp/Lisp-History.html#Lisp-History</a>&quot; has both the top &amp;=
 bottom rows</div><div>but page 1.3, &quot;<a href=3D"https://www.gnu.org/s=
oftware/emacs/manual/html_node/elisp/Conventions.html#Conventions">https://=
www.gnu.org/software/emacs/manual/html_node/elisp/Conventions.html#Conventi=
ons</a>&quot; has only the top row</div><div>and page 1.3.1, &quot;<a href=
=3D"https://www.gnu.org/software/emacs/manual/html_node/elisp/Some-Terms.ht=
ml#Some-Terms">https://www.gnu.org/software/emacs/manual/html_node/elisp/So=
me-Terms.html#Some-Terms</a>&quot; has only the top row</div><div>page 1.3.=
2, &quot;<a href=3D"https://www.gnu.org/software/emacs/manual/html_node/eli=
sp/nil-and-t.html#nil-and-t">https://www.gnu.org/software/emacs/manual/html=
_node/elisp/nil-and-t.html#nil-and-t</a>&quot; has both the top &amp; botto=
m rows</div><div>but page 1.3.3, &quot;<a href=3D"https://www.gnu.org/softw=
are/emacs/manual/html_node/elisp/Evaluation-Notation.html#Evaluation-Notati=
on">https://www.gnu.org/software/emacs/manual/html_node/elisp/Evaluation-No=
tation.html#Evaluation-Notation</a>&quot; has only the top row</div><div><b=
r></div><div>the pattern so far is that if the outline hierarchical address=
 ends with an odd number, then the page does not get a bottom row of links.=
</div><div><br></div><div>Would be great if you can fix it, but it&#39;s no=
t the end of the world.</div><div><br></div><div>Tnx. =C2=A0/Eric</div><div=
><br></div></div>

--001a114127bc3cc568053ab0862a--





Acknowledgement sent to Eric Weaver <eric@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#24289; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Tue, 23 Aug 2016 14:15:02 UTC

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