Gentoo Archives: gentoo-doc-cvs

From: vapier <vapier@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: bugzilla-howto.xml
Date: Tue, 30 Aug 2005 02:51:25
Message-Id: 200508300249.j7U2nFdn012732@robin.gentoo.org
1 vapier 05/08/30 02:51:12
2
3 Modified: xml/htdocs/doc/en bugzilla-howto.xml
4 Log:
5 tell users to utilize -ggdb -g instead of -ggdb3 since -ggdb3 can cause problems itself and -ggdb/-g is sufficient most of the time
6
7 Revision Changes Path
8 1.6 +9 -9 xml/htdocs/doc/en/bugzilla-howto.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.6&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.6&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/bugzilla-howto.xml.diff?r1=1.5&r2=1.6&cvsroot=gentoo
13
14 Index: bugzilla-howto.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v
17 retrieving revision 1.5
18 retrieving revision 1.6
19 diff -u -r1.5 -r1.6
20 --- bugzilla-howto.xml 22 Jul 2005 23:46:11 -0000 1.5
21 +++ bugzilla-howto.xml 30 Aug 2005 02:51:12 -0000 1.6
22 @@ -1,6 +1,6 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.5 2005/07/22 23:46:11 neysx Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.6 2005/08/30 02:51:12 vapier Exp $ -->
27
28 <guide link="/doc/en/bugzilla-howto.xml">
29 <title>Gentoo Bug Reporting Guide</title>
30 @@ -20,8 +20,8 @@
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 -<version>1.4</version>
35 -<date>2005-07-22</date>
36 +<version>1.5</version>
37 +<date>2005-08-29</date>
38
39 <chapter>
40 <title>Introduction</title>
41 @@ -132,7 +132,7 @@
42 </p>
43
44 <pre caption="make.conf settings">
45 -CFLAGS="-O2 -pipe -ggdb3"
46 +CFLAGS="-O1 -pipe -g -ggdb"
47 CXXFLAGS="${CFLAGS}"
48 </pre>
49
50 @@ -281,7 +281,7 @@
51 This backtrace contains a large number of ?? marks. This is because without
52 debug symbols, <c>gdb</c> doesn't know how the program was run. Hence, it is
53 crucial that debug symbols are <e>not</e> stripped. Now remember a while ago we
54 -mentioned the -ggdb3 flag. Let's see what the output looks like with the flag
55 +mentioned the -ggdb flag. Let's see what the output looks like with the flag
56 enabled:
57 </p>
58
59 @@ -296,21 +296,21 @@
60 Here we see that a lot more information is available for developers. Not only is
61 function information displayed, but even the exact line numbers of the source
62 files. This method is the most preferred if you can spare the extra space.
63 -Here's how much the file size varies between debug, strip, and -ggdb3 enabled
64 +Here's how much the file size varies between debug, strip, and -ggdb enabled
65 programs.
66 </p>
67
68 -<pre caption="Filesize differences With -ggdb3 flag">
69 +<pre caption="Filesize differences With -ggdb flag">
70 <comment>(debug symbols stripped)</comment>
71 -rwxr-xr-x 1 chris users 3140 6/28 13:11 bad_code
72 <comment>(debug symbols enabled)</comment>
73 -rwxr-xr-x 1 chris users 6374 6/28 13:10 bad_code
74 -<comment>(-ggdb3 flag enabled)</comment>
75 +<comment>(-ggdb flag enabled)</comment>
76 -rwxr-xr-x 1 chris users 19552 6/28 13:11 bad_code
77 </pre>
78
79 <p>
80 -As you can see, -ggdb3 adds about <e>13178</e> more bytes to the file size over the one
81 +As you can see, -ggdb adds about <e>13178</e> more bytes to the file size over the one
82 with debugging symbols. However, as shown above, this increase in file size can
83 be worth it if presenting debug information to developers. The backtrace can be
84 saved to a file by copying and pasting from the terminal (if it's a non-x based
85
86
87
88 --
89 gentoo-doc-cvs@g.o mailing list