GNU bug report logs -
#24289
bug in online documentation presentation
Previous Next
Reported by: Eric Weaver <eric <at> columbia.edu>
Date: Mon, 22 Aug 2016 22:27:01 UTC
Severity: minor
Tags: notabug
Done: Stefan Kangas <stefan <at> marxist.se>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 24289 in the body.
You can then email your comments to 24289 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#24289
; Package
emacs
.
(Mon, 22 Aug 2016 22:27:02 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
Eric Weaver <eric <at> columbia.edu>
:
New bug report received and forwarded. Copy sent to
bug-gnu-emacs <at> gnu.org
.
(Mon, 22 Aug 2016 22:27:02 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
[Message part 1 (text/plain, inline)]
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
[Message part 2 (text/html, inline)]
Added tag(s) notabug.
Request was from
Eli Zaretskii <eliz <at> gnu.org>
to
control <at> debbugs.gnu.org
.
(Tue, 23 Aug 2016 14:03:02 GMT)
Full text and
rfc822 format available.
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#24289
; Package
emacs
.
(Tue, 23 Aug 2016 14:04:01 GMT)
Full text and
rfc822 format available.
Message #10 received at 24289 <at> debbugs.gnu.org (full text, mbox):
tags 24289 + notabug
thanks
> From: Eric Weaver <eric <at> columbia.edu>
> Date: Mon, 22 Aug 2016 18:24:42 -0400
> Cc: Eric Matthew Weaver <eric <at> columbia.edu>
>
> 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.
Reply sent
to
Stefan Kangas <stefan <at> marxist.se>
:
You have taken responsibility.
(Wed, 14 Aug 2019 09:41:02 GMT)
Full text and
rfc822 format available.
Notification sent
to
Eric Weaver <eric <at> columbia.edu>
:
bug acknowledged by developer.
(Wed, 14 Aug 2019 09:41:02 GMT)
Full text and
rfc822 format available.
Message #15 received at 24289-done <at> debbugs.gnu.org (full text, mbox):
Eli Zaretskii <eliz <at> gnu.org> writes:
> tags 24289 + notabug
> thanks
>
[...]
> 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.
This was tagged notabug in 2016 but never closed. Closing now.
Thanks,
Stefan Kangas
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Wed, 11 Sep 2019 11:24:04 GMT)
Full text and
rfc822 format available.
This bug report was last modified 4 years and 227 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.