diff mbox

[RFA,doc] libstdc++ FAQ and bug reporting

Message ID alpine.LNX.2.00.1102070032260.8943@gerinyyl
State New
Headers show

Commit Message

Gerald Pfeifer Feb. 6, 2011, 11:35 p.m. UTC
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.

Comments

Jonathan Wakely Feb. 7, 2011, 12:05 a.m. UTC | #1
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.
diff mbox

Patch

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