Gentoo Bug Reporting Guide

From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.43) id 1Dw7Di-0004gO-2B for garchives@archives.gentoo.org; Fri, 22 Jul 2005 23:46:22 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.4/8.13.4) with SMTP id j6MNjgpZ000046; Fri, 22 Jul 2005 23:45:42 GMT Received: from smtp.gentoo.org (smtp.gentoo.org [134.68.220.30]) by robin.gentoo.org (8.13.4/8.13.4) with ESMTP id j6MNjfYW004102 for ; Fri, 22 Jul 2005 23:45:41 GMT Message-Id: <200507222345.j6MNjfYW004102@robin.gentoo.org> Received: from lark.gentoo.osuosl.org ([140.211.166.177] helo=lark.gentoo.org) by smtp.gentoo.org with smtp (Exim 4.43) id 1Dw7Da-0006Cw-11 for gentoo-doc-cvs@lists.gentoo.org; Fri, 22 Jul 2005 23:46:14 +0000 Received: by lark.gentoo.org (sSMTP sendmail emulation); Fri, 22 Jul 2005 23:46:11 +0000 From: "Xavier Neys" Date: Fri, 22 Jul 2005 23:46:11 +0000 To: gentoo-doc-cvs@lists.gentoo.org Subject: [gentoo-doc-cvs] cvs commit: bugzilla-howto.xml Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-doc-cvs@gentoo.org Reply-to: docs-team@lists.gentoo.org X-Archives-Salt: 8df734f4-914f-4054-b5cb-048d58ce3b37 X-Archives-Hash: 52525b85f9d84e150b4774b1506031c3 neysx 05/07/22 23:46:11 Modified: xml/htdocs/doc/en bugzilla-howto.xml Log: Done some coding style/link fixing Revision Changes Path 1.5 +131 -146 xml/htdocs/doc/en/bugzilla-howto.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/bugzilla-howto.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo Index: bugzilla-howto.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- bugzilla-howto.xml 10 Jul 2005 14:13:08 -0000 1.4 +++ bugzilla-howto.xml 22 Jul 2005 23:46:11 -0000 1.5 @@ -1,6 +1,6 @@ - + Gentoo Bug Reporting Guide @@ -20,8 +20,8 @@ -1.3 -2005-07-10 +1.4 +2005-07-22 Introduction @@ -86,11 +86,11 @@

-These errors can be quite troublesome. However, once you find them, what do -you do? The following sections will look at two important tools for handling -run time errors. After that, we'll take a look at compile errors, and how to -handle them. Let's start out with the first tool for debugging run time -errors -- gdb. +These errors can be quite troublesome. However, once you find them, what do you +do? The following sections will look at two important tools for handling run +time errors. After that, we'll take a look at compile errors, and how to handle +them. Let's start out with the first tool for debugging run time errors -- +gdb.

@@ -111,7 +111,7 @@ program is to emerge the program with FEATURES="nostrip". This prevents the stripping of debug symbols. Why are programs stripped by default? The reason is the same as that for having gzipped man pages -- saving space. -Here's how the size of a program varies with and without debug symbol stripping. +Here's how the size of a program varies with and without debug symbol stripping.

@@ -128,7 +128,7 @@
 the size! Two more things can be done for debugging. The first is adding ggdb3
 to your CFLAGS and CXXFLAGS. This flag adds more debugging information than is
 generally included. We'll see what that means later on. This is how
-/etc/make.conf might look with the newly added flags.  
+/etc/make.conf might look with the newly added flags.
 
 
 @@ -137,9 +137,9 @@
 
 
 
-Lastly, you can also add debug to the package's USE flags. This can be done with the
-package.use file.
- 
+Lastly, you can also add debug to the package's USE flags. This can be done
+with the package.use file.
+
 
  # echo "category/package debug" >> /etc/portage/package.use
@@ -395,7 +395,7 @@
 reading in "bar" as it should. In this case, we can recommend the ebuild
 maintainer to put a warning about it. For now though, we can copy over the
 config file from .foobar and modify it to produce the correct
-results. 
+results.
 
 
 
@@ -510,9 +510,9 @@
 
 
 
-PORT_LOGDIR is a portage variable that sets up a log directory for separate 
-emerge logs. Let's take a look and see what that entails. First, run your emerge
-with PORT_LOGDIR set to your favorite log location. Let's say we have a
+PORT_LOGDIR is a portage variable that sets up a log directory for separate
+emerge logs. Let's take a look and see what that entails. First, run your
+emerge with PORT_LOGDIR set to your favorite log location. Let's say we have a
 location /var/log/portage. We'll use that for our log directory:
 
 
@@ -639,7 +639,7 @@
 
 This is how the Advanced Search Page looks like. While it may seem overwhelming
 at first, we're going to look at a few simple areas to narrow down the rather
-vague searches bugzilla returns. 
+vague searches bugzilla returns.
 
 
 
@@ -759,15 +759,13 @@
 
 
 Another common misconception occurs with our Documentation bugs. For example, a
-user finds a bug with the Catalyst
+user finds a bug with the Catalyst
 Docs. The general tendency is to file a bug under Docs-user, which gets
 assigned to the GDP, when it should
-actually go to a member of the Release Engineering team. As
-a rule of thumb, only documentation under http://www.gentoo.org/doc/* is under
-the GDP. Anything under http://www.gentoo.org/proj/* is under the respective
-teams.
+actually go to a member of the Release
+Engineering team. As a rule of thumb, only documentation under
+http://www.gentoo.org/doc/* is under the GDP. Anything under
+http://www.gentoo.org/proj/* is under the respective teams.
 
 
 
@@ -779,8 +777,9 @@
 
 
 
-Our bug goes in Gentoo Linux as it's an ebuild bug. We head over there and are presented
-with the multi-step bug reporting process. Let us now proceed with Step 1...
+Our bug goes in Gentoo Linux as it's an ebuild bug. We head over there and are
+presented with the multi-step bug reporting process. Let us now proceed with
+Step 1...
 
 
 
@@ -808,22 +807,23 @@
 
 
   
-  First, there's the Product. The product will narrow down the bug to a
-  specific area of Gentoo like Bugzilla (for bugs relating to bugs.gentoo.org),
-  Docs-user(for User Documentation) or Gentoo Linux (for ebuilds and the like).
+    First, there's the Product. The product will narrow down the bug to a
+    specific area of Gentoo like Bugzilla (for bugs relating to
+    bugs.gentoo.org), Docs-user(for User Documentation) or Gentoo Linux (for
+    ebuilds and the like).
   
   
-  Component is where exactly the problem occurs, more specifically which part
-  of selected product the bug comes under. This makes classification easier.
+    Component is where exactly the problem occurs, more specifically which part
+    of selected product the bug comes under. This makes classification easier.
   
   
-  Hardware platform is what architecture you're running. If you were running
-  SPARC, you would set it to SPARC.
+    Hardware platform is what architecture you're running. If you were running
+    SPARC, you would set it to SPARC.
   
   
-  Operating System is what Operating System you're using. Because Gentoo is
-  considered a "Meta-distribution", it can run on other operating systems
-  beside Linux.
+    Operating System is what Operating System you're using. Because Gentoo is
+    considered a "Meta-distribution", it can run on other operating systems
+    beside Linux.
   
 
 
@@ -832,34 +832,27 @@
 
 
 
-  
-  Product - Gentoo Linux (Since it is an ebuild issue)
-  
-  
-  Component - Application (It is an application at fault, foobar2)
-  
-  
-  Hardware Platform - All (This error could occur across architectures)
-  
-  
-  Operation System - All (It could occur on all types of systems)
-  
+  Product - Gentoo Linux (Since it is an ebuild issue)
+  Component - Application (It is an application at fault, foobar2)
+  Hardware Platform - All (This error could occur across architectures)
+  Operation System - All (It could occur on all types of systems)
 
 
 
 
 
   



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