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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Stefan Kangas <stefan <at> marxist.se>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#24289: closed (bug in online documentation presentation)
Date: Wed, 14 Aug 2019 09:41:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Wed, 14 Aug 2019 11:39:45 +0200
with message-id <CADwFkmmgyVG8Pj24a9GYNiYCkbz1LD70+dH00KJd+aWuREr-0w <at> mail.gmail.com>
and subject line Re: bug#24289: bug in online documentation presentation
has caused the debbugs.gnu.org bug report #24289,
regarding bug in online documentation presentation
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
24289: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=24289
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Eric Weaver <eric <at> columbia.edu>
To: bug-gnu-emacs <at> gnu.org
Cc: Eric Matthew Weaver <eric <at> columbia.edu>
Subject: bug in online documentation presentation
Date: Mon, 22 Aug 2016 18:24:42 -0400

[Message part 3 (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 4 (text/html, inline)]

[Message part 5 (message/rfc822, inline)]

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Eric Weaver <eric <at> columbia.edu>, 24289-done <at> debbugs.gnu.org
Subject: Re: bug#24289: bug in online documentation presentation
Date: Wed, 14 Aug 2019 11:39:45 +0200

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

Previous Next

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