* Online documentation problem
@ 2014-05-22 20:57 Simon Marchi
2014-05-22 21:07 ` Frank Ch. Eigler
0 siblings, 1 reply; 5+ messages in thread
From: Simon Marchi @ 2014-05-22 20:57 UTC (permalink / raw)
To: overseers
Hi,
I would like to report a problem I have seen with the online GDB doc.
1. Go to this page: https://sourceware.org/gdb/onlinedocs/gdb/General-Query-Packets.html
2. Click on a link named "vCont packet" (search in the page)
Expected behavior: the browser brings you to the vCont packet section of the target page.
Observed behavior: the browser goes to the right page, but stays at the top.
While the page is loading, we can see the URL being rewritten and the anchor changing from "#vCont-packet" to "#vCont packet". This hints to a server configuration problem. If you manually add the - in the anchor, it will get you to the right place in the page.
Thanks,
Simon
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Online documentation problem
2014-05-22 20:57 Online documentation problem Simon Marchi
@ 2014-05-22 21:07 ` Frank Ch. Eigler
2014-05-22 22:16 ` Pedro Alves
0 siblings, 1 reply; 5+ messages in thread
From: Frank Ch. Eigler @ 2014-05-22 21:07 UTC (permalink / raw)
To: Simon Marchi; +Cc: overseers
Hi -
> I would like to report a problem I have seen with the online GDB doc.
>
> 1. Go to this page: https://sourceware.org/gdb/onlinedocs/gdb/General-Query-Packets.htm> 2. Click on a link named "vCont packet" (search in the page)
> [...]
Please raise it with the gdb developer mailing lists.
- FChE
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Online documentation problem
2014-05-22 21:07 ` Frank Ch. Eigler
@ 2014-05-22 22:16 ` Pedro Alves
2014-05-24 1:19 ` Joel Brobecker
0 siblings, 1 reply; 5+ messages in thread
From: Pedro Alves @ 2014-05-22 22:16 UTC (permalink / raw)
To: Frank Ch. Eigler, Simon Marchi; +Cc: overseers
On 05/22/2014 10:07 PM, Frank Ch. Eigler wrote:
> Hi -
>
>> I would like to report a problem I have seen with the online GDB doc.
>>
>> 1. Go to this page: https://sourceware.org/gdb/onlinedocs/gdb/General-Query-Packets.htm> 2. Click on a link named "vCont packet" (search in the page)
>> [...]
>
> Please raise it with the gdb developer mailing lists.
Indeed it seems like it's the html itself in the server that's wrong:
$ wget https://sourceware.org/gdb/onlinedocs/gdb/vCont-packet.html
$ cat vCont-packet.html
<meta http-equiv="refresh" content="0; url=Packets.html#vCont%20packet">
$
The same file inside <https://sourceware.org/gdb/onlinedocs/gdb.html.tar.gz>
looks exactly the same.
The local version of the html documentation I just now generated doesn't
have that issue, and here the generated vCont-packet.html is much bigger:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "Free Software" and "Free Software Needs
Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
and with the Back-Cover Texts as in (a) below.
(a) The FSF's Back-Cover Text is: "You are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<!-- This file redirects to the location of a node or anchor -->
<head>
<title>Debugging with GDB: vCont packet</title>
<meta name="description" content="Debugging with GDB: vCont packet">
<meta name="keywords" content="Debugging with GDB: vCont packet">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
<meta http-equiv="Refresh" content="0; url=Packets.html#vCont-packet">
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<p>The node you are looking for is at <a href="Packets.html#vCont-packet">vCont packet</a>.</p>
</body>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
So I'd suspect that the makeinfo version used to generate the copy of
the server is an old buggy version.
--
Pedro Alves
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Online documentation problem
2014-05-22 22:16 ` Pedro Alves
@ 2014-05-24 1:19 ` Joel Brobecker
2014-05-24 1:33 ` Frank Ch. Eigler
0 siblings, 1 reply; 5+ messages in thread
From: Joel Brobecker @ 2014-05-24 1:19 UTC (permalink / raw)
To: Pedro Alves; +Cc: Frank Ch. Eigler, Simon Marchi, overseers
> Indeed it seems like it's the html itself in the server that's wrong:
>
> $ wget https://sourceware.org/gdb/onlinedocs/gdb/vCont-packet.html
> $ cat vCont-packet.html
> <meta http-equiv="refresh" content="0; url=Packets.html#vCont%20packet">
> $
>
> The same file inside <https://sourceware.org/gdb/onlinedocs/gdb.html.tar.gz>
> looks exactly the same.
>
> The local version of the html documentation I just now generated doesn't
> have that issue, and here the generated vCont-packet.html is much bigger:
It looks like the version of makeinfo on sourceware.org is a little
too old (4.13 version the latest being 5.2). I quickly made a local
install of texinfo-5.2 in user admin's home directory, to check
my theory, and things seem to be better with that version. I've
regenerated the release documentation as well as the HEAD documentation,
and things seem to be working there, now.
I had meant to regenerate the documentation for the page shown
above, to validate my testing, but each time generated the documentation
for the wrong target (the link above if for the tip of the currently
active release branch). Since it's a PITN to figure out the parameters
for calling the script that does the update, and since it's going to
be rebuilt about 30mins from now, I decided to let it go.
Next Actions are:
- For Simon: To confirm say on Sunday or Monday that the link
is now fixed;
- For overseers: Decide what we want to do next, whether we want
to install a newer version of makeinfo, or just live the small
install in user admin's home dir. Or some other solution I haven't
thought of yet.
--
Joel
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Online documentation problem
2014-05-24 1:19 ` Joel Brobecker
@ 2014-05-24 1:33 ` Frank Ch. Eigler
0 siblings, 0 replies; 5+ messages in thread
From: Frank Ch. Eigler @ 2014-05-24 1:33 UTC (permalink / raw)
To: Joel Brobecker; +Cc: Pedro Alves, Simon Marchi, overseers
Hi -
On Fri, May 23, 2014 at 06:19:33PM -0700, Joel Brobecker wrote:
> [...]
> - For overseers: Decide what we want to do next, whether we want
> to install a newer version of makeinfo, or just live the small
> install in user admin's home dir. Or some other solution I haven't
> thought of yet.
We'd generally like to stick with base RHEL versions of system
packages if possible, and have no objection to a personal installation
of something newer.
- FChE
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2014-05-24 1:33 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-05-22 20:57 Online documentation problem Simon Marchi
2014-05-22 21:07 ` Frank Ch. Eigler
2014-05-22 22:16 ` Pedro Alves
2014-05-24 1:19 ` Joel Brobecker
2014-05-24 1:33 ` Frank Ch. Eigler
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).