From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([69.77.167.62] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1Jze6A-0003lD-FO for garchives@archives.gentoo.org; Fri, 23 May 2008 20:42:46 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 8087FE0593; Fri, 23 May 2008 20:42:44 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 3A7FBE0593 for ; Fri, 23 May 2008 20:42:44 +0000 (UTC) Received: from stork.gentoo.org (stork.gentoo.org [64.127.104.133]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id B4FA06745C for ; Fri, 23 May 2008 20:42:43 +0000 (UTC) Received: from swift by stork.gentoo.org with local (Exim 4.69) (envelope-from ) id 1Jze66-0006Q2-Hb for gentoo-doc-cvs@lists.gentoo.org; Fri, 23 May 2008 20:42:42 +0000 To: gentoo-doc-cvs@lists.gentoo.org Subject: [gentoo-doc-cvs] cvs commit: bugzilla-howto.xml Message-Id: From: Sven Vermeulen Date: Fri, 23 May 2008 20:42:42 +0000 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-doc-cvs@lists.gentoo.org Reply-to: docs-team@lists.gentoo.org X-Archives-Salt: ea55be6b-960d-4db1-b11d-29c2015b150b X-Archives-Hash: ca101548925b1481b55feed04bb260ec swift 08/05/23 20:42:42 Modified: bugzilla-howto.xml Log: Coding style Revision Changes Path 1.13 xml/htdocs/doc/en/bugzilla-howto.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.13&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.13&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.12&r2=1.13 Index: bugzilla-howto.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- bugzilla-howto.xml 1 Feb 2008 19:30:40 -0000 1.12 +++ bugzilla-howto.xml 23 May 2008 20:42:42 -0000 1.13 @@ -1,6 +1,6 @@ - + Gentoo Bug Reporting Guide @@ -201,7 +201,7 @@ One can also debug with core dumps. These core files contain the same -information that the program would produce when run with gdb. In order to debug +information that the program would produce when run with gdb. In order to debug with a core file with bad_code, you would run gdb ./bad_code core where core is the name of the core file. @@ -327,11 +327,11 @@

-This ends the walk-through of gdb. Using gdb, we hope that you will -be able to use it to create better bug reports. However, there are other types -of errors that can cause a program to fail during run time. One of the other -ways is through improper file access. We can find those using a nifty little -tool called strace. +This ends the walk-through of gdb. Using gdb, we hope that you +will be able to use it to create better bug reports. However, there are other +types of errors that can cause a program to fail during run time. One of the +other ways is through improper file access. We can find those using a nifty +little tool called strace.

@@ -350,9 +350,9 @@ tool called strace was created to help deal with this. strace traces system calls (hence the name) which include calls that use the memory and files. For our example, we're going to take a program foobar2. This is an -updated version of foobar. However, during the change over to foobar2, you notice -all your configurations are missing! In foobar version 1, you had it setup to -say "foo", but now it's using the default "bar". +updated version of foobar. However, during the change over to foobar2, you +notice all your configurations are missing! In foobar version 1, you had it +setup to say "foo", but now it's using the default "bar". 

@@ -454,9 +454,9 @@

-The program is compiling smoothly when it suddenly stops and presents an error message. This -particular error can be split into 3 different sections, The compile messages, the build -error, and the emerge error message as shown below. +The program is compiling smoothly when it suddenly stops and presents an error +message. This particular error can be split into 3 different sections, The +compile messages, the build error, and the emerge error message as shown below. 

@@ -658,8 +658,8 @@
 

 
 

-Comment is the important part. Use the comment field to list what appears to be a
-specific instance of the error. Basically, don't use anything like the
+Comment is the important part. Use the comment field to list what appears to be
+a specific instance of the error. Basically, don't use anything like the
 beginning of the build error, find a line that's before it stating a true
 error. Also, you'll want to filter out any punctuation to prevent bugzilla
 from interpreting the results the comment the wrong way. Example from the xclass
@@ -772,9 +772,9 @@
 
 We would rather see a bug whose product was not supposed to be Gentoo Linux but
 has been filed under the same rather than seeing a bug which belongs the Gentoo
-Linux product and filed elsewhere. While neither is preferred, the former is more
-acceptable and understandable (except website bugs.. we might have an issue with
-that...).
+Linux product and filed elsewhere. While neither is preferred, the former is
+more acceptable and understandable (except website bugs.. we might have an issue
+with that...).
 
 
 

@@ -934,7 +934,7 @@
     Minor - Your program crashes here and there with apparent workarounds.
   
   
  • 
-    Normal - The default.  If you're not sure leave it here unless it's a new
+    Normal - The default. If you're not sure leave it here unless it's a new
     build or cosmetic change, then read below for more information.
   
    • 
   
  • Trivial - Things such as a mispelled word or whitespace clean up. 
    • 
@@ -1182,7 +1182,7 @@
 
 
    
 The documentation team will require the flag combination -Nt as well as
--u. This mainly has to do with tab expansion.  You can create such a diff
+-u. This mainly has to do with tab expansion. You can create such a diff
 with:
 
    
 
@@ -1251,7 +1251,7 @@
 Now shortly afterward, we find the error in the strace log and fix the bug and
 mark it as RESOLVED FIXED and mention that there was a change in the location
 of configuration files, and that I will update the ebuild with a warning about
-it.  The bug now becomes resolved, and you are shown the following.
+it. The bug now becomes resolved, and you are shown the following.
 
    
 
 
    
@@ -1282,7 +1282,7 @@
   
   
  • 
     CANTFIX - Somehow the bug cannot be solved because of certain
-    circumstances.  These circumstances will be noted by the person taking the
+    circumstances. These circumstances will be noted by the person taking the
     bug.
   
    • 
   
  • 
@@ -1303,7 +1303,7 @@
 
 
    
 Sometimes, before the bug can be resolved, a developer may request that you
-test an updated ebulid.  In the next chapter we'll take a look at testing
+test an updated ebulid. In the next chapter we'll take a look at testing
 ebuilds.
 
    
 
@@ -1422,7 +1422,7 @@
 
    
 In the first section we see that the emerge started off as it should. The second
 section shows our patch being applied successfully by the "[ ok ]" status
-message to the right. The last section tells us the program compiled ok.  The
+message to the right. The last section tells us the program compiled ok. The
 patch works! Now we can go and let the developer know that their patch works
 fine, and that they can commit the fix to portage.
 
    



-- 
gentoo-doc-cvs@lists.gentoo.org mailing list