public inbox for gcc-patches@gcc.gnu.org
 help / color / mirror / Atom feed
* [RFA,doc] libstdc++ FAQ and bug reporting
@ 2011-01-30 16:12 Gerald Pfeifer
  2011-01-31  0:40 ` Jonathan Wakely
  0 siblings, 1 reply; 5+ messages in thread
From: Gerald Pfeifer @ 2011-01-30 16:12 UTC (permalink / raw)
  To: libstdc++; +Cc: gcc-patches

This first part of this patch is obvious.  While looking into a similar 
issue in the second hunk I realized that probably the entire paragraph 
could/should go.  It does not look current / like a FAQ any more these
days.

Okay?

Gerald

2011-01-30  Gerald Pfeifer  <gerald@pfeifer.com>
 
	* doc/xml/faq.xml: Adjust link to bug database.
	Remove old item on broken header files.

Index: doc/xml/faq.xml
===================================================================
--- doc/xml/faq.xml	(revision 169407)
+++ doc/xml/faq.xml	(working copy)
@@ -745,7 +745,7 @@
     </para> 
     <para> 
     Before reporting a bug, please examine the
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs.html">bugs database</link> with the
+    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs/">bugs database</link> with the
     category set to <quote>g++</quote>. 
     </para> 
   </answer>
@@ -848,14 +848,6 @@
   </question>
   <answer xml:id="a-v2_headers">
       <para>
-	If you have found an extremely broken header file which is
-	causing problems for you, look carefully before submitting a
-	"high" priority bug report (which you probably
-	shouldn't do anyhow; see the last paragraph of the page
-	describing <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs.html">the GCC
-	bug database</link>).
-      </para>
-      <para>
 	If the headers are in <filename>${prefix}/include/g++-3</filename>, or
 	if the installed library's name looks like
 	<filename>libstdc++-2.10.a</filename> or

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [RFA,doc] libstdc++ FAQ and bug reporting
  2011-01-30 16:12 [RFA,doc] libstdc++ FAQ and bug reporting Gerald Pfeifer
@ 2011-01-31  0:40 ` Jonathan Wakely
  2011-02-06 23:35   ` Gerald Pfeifer
  0 siblings, 1 reply; 5+ messages in thread
From: Jonathan Wakely @ 2011-01-31  0:40 UTC (permalink / raw)
  To: Gerald Pfeifer; +Cc: libstdc++, gcc-patches

On 30 January 2011 14:46, Gerald Pfeifer wrote:
> This first part of this patch is obvious.  While looking into a similar
> issue in the second hunk I realized that probably the entire paragraph
> could/should go.  It does not look current / like a FAQ any more these
> days.
>
> Okay?

Although I agree that problems with v2 headers are not reported now
and that paragraph could go, the next one starting "If the headers"
makes less sense ... which headers?

How about "If you are using headers in ${prefix}/include/g++-3 ..." ?

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [RFA,doc] libstdc++ FAQ and bug reporting
  2011-01-31  0:40 ` Jonathan Wakely
@ 2011-02-06 23:35   ` Gerald Pfeifer
  2011-02-07  0:05     ` Jonathan Wakely
  0 siblings, 1 reply; 5+ messages in thread
From: Gerald Pfeifer @ 2011-02-06 23:35 UTC (permalink / raw)
  To: Jonathan Wakely; +Cc: libstdc++, gcc-patches

On Sun, 30 Jan 2011, Jonathan Wakely wrote:
> Although I agree that problems with v2 headers are not reported now
> and that paragraph could go, the next one starting "If the headers"
> makes less sense ... which headers?
> 
> How about "If you are using headers in ${prefix}/include/g++-3 ..." ?

Sounds good to me.  Do you approve the following, update patch for
mainline and the GCC 4.5 branch?

Gerald


2011-02-07  Gerald Pfeifer  <gerald@pfeifer.com>

	* doc/xml/faq.xml: Adjust link to bug database.
	Remove old item on broken header files.

Index: doc/xml/faq.xml
===================================================================
--- doc/xml/faq.xml	(revision 169868)
+++ doc/xml/faq.xml	(working copy)
@@ -745,7 +745,7 @@
     </para> 
     <para> 
     Before reporting a bug, please examine the
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs.html">bugs database</link> with the
+    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs/">bugs database</link> with the
     category set to <quote>g++</quote>. 
     </para> 
   </answer>
@@ -848,17 +848,9 @@
   </question>
   <answer xml:id="a-v2_headers">
       <para>
-	If you have found an extremely broken header file which is
-	causing problems for you, look carefully before submitting a
-	"high" priority bug report (which you probably
-	shouldn't do anyhow; see the last paragraph of the page
-	describing <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/bugs.html">the GCC
-	bug database</link>).
-      </para>
-      <para>
-	If the headers are in <filename>${prefix}/include/g++-3</filename>, or
-	if the installed library's name looks like
-	<filename>libstdc++-2.10.a</filename> or
+	If you are using headers in
+	<filename>${prefix}/include/g++-3</filename>, or if the installed
+	library's name looks like <filename>libstdc++-2.10.a</filename> or
 	<filename>libstdc++-libc6-2.10.so</filename>, then you are using the
 	old libstdc++-v2 library, which is nonstandard and
 	unmaintained.  Do not report problems with -v2 to the -v3

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [RFA,doc] libstdc++ FAQ and bug reporting
  2011-02-06 23:35   ` Gerald Pfeifer
@ 2011-02-07  0:05     ` Jonathan Wakely
  2011-02-13 23:23       ` Gerald Pfeifer
  0 siblings, 1 reply; 5+ messages in thread
From: Jonathan Wakely @ 2011-02-07  0:05 UTC (permalink / raw)
  To: Gerald Pfeifer; +Cc: libstdc++, gcc-patches

On 6 February 2011 23:35, Gerald Pfeifer wrote:
> On Sun, 30 Jan 2011, Jonathan Wakely wrote:
>> Although I agree that problems with v2 headers are not reported now
>> and that paragraph could go, the next one starting "If the headers"
>> makes less sense ... which headers?
>>
>> How about "If you are using headers in ${prefix}/include/g++-3 ..." ?
>
> Sounds good to me.  Do you approve the following, update patch for
> mainline and the GCC 4.5 branch?

Yes.  Thanks for making these improvements.

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: [RFA,doc] libstdc++ FAQ and bug reporting
  2011-02-07  0:05     ` Jonathan Wakely
@ 2011-02-13 23:23       ` Gerald Pfeifer
  0 siblings, 0 replies; 5+ messages in thread
From: Gerald Pfeifer @ 2011-02-13 23:23 UTC (permalink / raw)
  To: Jonathan Wakely; +Cc: libstdc++, gcc-patches

On Mon, 7 Feb 2011, Jonathan Wakely wrote:
> Yes.  Thanks for making these improvements.

Thanks for looking into this.

For the record, this is the version I applied to the GCC 4.5 branch;
exactly the same contents, just the markup had changed so I needed to
accomodate for that.

Gerald


2011-02-13  Gerald Pfeifer  <gerald@pfeifer.com>

	* doc/xml/faq.xml: Adjust link to bug database.
	Remove old item on broken header files.

Index: doc/xml/faq.xml
===================================================================
--- doc/xml/faq.xml	(revision 170111)
+++ doc/xml/faq.xml	(working copy)
@@ -745,7 +745,7 @@
     </para> 
     <para> 
     Before reporting a bug, please examine the
-    <ulink url="http://gcc.gnu.org/bugs.html">bugs database</ulink> with the
+    <ulink url="http://gcc.gnu.org/bugs/">bugs database</ulink> with the
     category set to <quote>g++</quote>. 
     </para> 
   </answer>
@@ -848,17 +848,9 @@
   </question>
   <answer id="a-v2_headers">
       <para>
-	If you have found an extremely broken header file which is
-	causing problems for you, look carefully before submitting a
-	&quot;high&quot; priority bug report (which you probably
-	shouldn't do anyhow; see the last paragraph of the page
-	describing <ulink url="http://gcc.gnu.org/bugs.html">the GCC
-	bug database</ulink>).
-      </para>
-      <para>
-	If the headers are in <filename>${prefix}/include/g++-3</filename>, or
-	if the installed library's name looks like
-	<filename>libstdc++-2.10.a</filename> or
+	If you are using headers in
+	<filename>${prefix}/include/g++-3</filename>, or if the installed
+	library's name looks like <filename>libstdc++-2.10.a</filename> or
 	<filename>libstdc++-libc6-2.10.so</filename>, then you are using the
 	old libstdc++-v2 library, which is nonstandard and
 	unmaintained.  Do not report problems with -v2 to the -v3

^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2011-02-13 23:21 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2011-01-30 16:12 [RFA,doc] libstdc++ FAQ and bug reporting Gerald Pfeifer
2011-01-31  0:40 ` Jonathan Wakely
2011-02-06 23:35   ` Gerald Pfeifer
2011-02-07  0:05     ` Jonathan Wakely
2011-02-13 23:23       ` Gerald Pfeifer

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).