bagder: curl-www/docs _bugs.html,1.6,1.7 _menu.html,1.21,1.22

[email protected] Wed, 04 Feb 2009 14:14:52 +0000
Newsgroups gmane.comp.web.curl.www.cvs
Message-ID <[email protected]>
Update of /cvsroot/curl/curl-www/docs
In directory labb:/tmp/cvs-serv21573/docs

Modified Files:
	_bugs.html _menu.html 
Log Message:
unified to one (improved) single bug report page


Index: _menu.html
===================================================================
RCS file: /cvsroot/curl/curl-www/docs/_menu.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- _menu.html	26 Apr 2008 21:21:30 -0000	1.21
+++ _menu.html	4 Feb 2009 14:14:50 -0000	1.22
@@ -41,9 +41,9 @@
 #endif
 
 #ifdef DOCS_BUGS
-HERE(x, Bugs)
+HERE(x, Bug Report)
 #else
-DOCREF(/docs/bugs.html, Bugs)
+DOCREF(/docs/bugs.html, Bug Report)
 #endif
 
 #ifdef DOCS_CAEXTRACT

Index: _bugs.html
===================================================================
RCS file: /cvsroot/curl/curl-www/docs/_bugs.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- _bugs.html	27 Nov 2003 15:56:18 -0000	1.6
+++ _bugs.html	4 Feb 2009 14:14:50 -0000	1.7
@@ -1,6 +1,6 @@
 #include "_doctype.html"
 <HTML>
-<HEAD> <TITLE>cURL - BUGS</TITLE>
+<HEAD> <TITLE>cURL - Report Bugs</TITLE>
 #include "css.t"
 </HEAD>
 
@@ -11,20 +11,83 @@
 #include "_menu.html"
 #include "setup.t"
 
-WHERE2(Docs, "/docs/", Bugs)
+WHERE2(Docs, "/docs/", Bug Report)
 
-TITLE(BUGS -- how to report bugs)
-<div class="relatedbox">
-<b>Related:</b>
-<br><a href="knownbugs.html">Known Bugs</a>
-<br><a href="todo.html">TODO</a>
-<br><a href="http://sourceforge.net/bugs/?group_id=976">Bug Tracker</a>
-</div>
+TITLEPRE How, Why, And Where to Report Bugs
+TITLEPOST
+<p>
+ Of course there are bugs in curl and libcurl. Some are known, but most of
+ them remain unknown to us until you let us know. We depend on bug reports
+ from the users to find the problems. We are not likely to be able to fix bugs
+ if we don't get to know about their existance first. Bugs tend to get fixed
+ within a short while after we've been notified (at least when we agree about
+ it being a bug and not a feature)!
 
-#include "bugs.t"
+SUBTITLE(Known Bugs)
+<p>
+ Some bugs are known to already exist. We try to keep track of them on a
+ separate <a href="/docs/knownbugs.html">KNOWN_BUGS</a> document.
 
-#include "_footer.html"
+SUBTITLE(How To Report)
+
+<p> If you can't fix a bug yourself, file an <i>as detailed a report as
+ possible</i> in the <a href="http://sourceforge.net/bugs/?group_id=976">bug
+ tracking system</a> <b>or</b> mail it to a suitable <a href="/mail/">mailing
+ list</a>. Bugs in or improvements to libcurl are best posted to the <a
+ href="http://curl.haxx.se/mail/list.cgi?list=curl-library">curl-library
+ list</a>, while bugs in or with the curl tool can be posted to the <a
+ href="http://curl.haxx.se/mail/list.cgi?list=curl-users">curl-users list</a>.
+
+<p>
+ If you opt to use one of the mailing lists, notice that you need to be
+ subscribed first to get the mail through to the list!
 
+SUBTITLE(What To Report)
+<P>
+ When reporting a bug, try to include information that will help us understand
+ what's wrong, what's expected to happen and how to repeat it. You should
+ supply:
+
+<ul>
+ <li> your operating system's name and version number
+ <li> what version of curl you're using (curl -V is fine)
+ <li> what URL you were working with
+ <li> everything else you think might matter
+</ul>
+
+TITLE(Bugs in libcurl bindings)
+<p>
+ There will of course pop up bugs in libcurl bindings. Try to report those
+ bugs in the correct forum. Here's a collection of links and advice for you!
+
+SUBTITLE(PHP/CURL)
+<p>
+ If you experience problems with the curl module in PHP, and they don't seem
+ to happen with libcurl or curl in other situations, please file the report in
+ the <a href="http://bugs.php.net/">PHP bug tracker</a>. Make sure it's marked
+ as 'cURL related'.
+
+SUBTITLE(Python -- PycURL)
+<p>
+ <a href="http://sourceforge.net/tracker/?group_id=28236&atid=392777">PycURL
+ bug tracker</a>
+
+SUBTITLE(Rexx -- Rexxcurl)
+<p>
+ <a href="http://sourceforge.net/tracker/?group_id=30502&atid=399216">Rexxcurl
+ bug tracker</a>
+
+SUBTITLE(Tcl -- Tclcurl)
+<p>
+ Send a very detailed description to <a
+ href="mailto:fandom_at_retemail.es">Andres Garcia</a>.
+
+SUBTITLE(Cocoa -- Curlhandle)
+<p>
+ <a
+ href="http://sourceforge.net/tracker/?group_id=32407&atid=405234">Curlhandle
+ bug tracker</a>
+
+#include "_footer.html"
 </BODY>
 </HTML>
-