* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: bugzilla-howto.xml
@ 2009-01-26 7:34 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 5+ messages in thread
From: Joshua Saddler (nightmorph) @ 2009-01-26 7:34 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 09/01/26 07:34:41
Modified: bugzilla-howto.xml
Log:
new bugzie format, patches from pva on bug 254488
Revision Changes Path
1.14 xml/htdocs/doc/en/bugzilla-howto.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.14&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.14&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.13&r2=1.14
Index: bugzilla-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- bugzilla-howto.xml 23 May 2008 20:42:42 -0000 1.13
+++ bugzilla-howto.xml 26 Jan 2009 07:34:41 -0000 1.14
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.13 2008/05/23 20:42:42 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.14 2009/01/26 07:34:41 nightmorph Exp $ -->
<guide link="/doc/en/bugzilla-howto.xml">
<title>Gentoo Bug Reporting Guide</title>
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.11</version>
-<date>2008-01-31</date>
+<version>1.12</version>
+<date>2009-01-25</date>
<chapter>
<title>Introduction</title>
@@ -439,11 +439,15 @@
Let's take a look at this very simple <c>emerge</c> error:
</p>
-<pre caption="emerge Error">
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2-7.o foobar2-7.c
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2-8.o foobar2-8.c
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2-9.o foobar2-9.c
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2.o foobar2.c
+<pre caption="emerge Error (long lines are manually wrapped to fit the window)">
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2-7.o foobar2-7.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2-8.o foobar2-8.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2-9.o foobar2-9.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2.o foobar2.c
foobar2.c:1:17: ogg.h: No such file or directory
make: *** [foobar2.o] Error 1
@@ -459,12 +463,16 @@
compile messages, the build error, and the emerge error message as shown below.
</p>
-<pre caption="Parts of the error">
+<pre caption="Parts of the error (long lines are manually wrapped to fit the window)">
<comment>(Compilation Messages)</comment>
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2-7.o foobar2-7.c
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2-8.o foobar2-8.c
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2-9.o foobar2-9.c
-gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod -c -o foobar2.o foobar2.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2-7.o foobar2-7.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2-8.o foobar2-8.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2-9.o foobar2-9.c
+gcc -D__TEST__ -D__GNU__ -D__LINUX__ -L/usr/lib -I/usr/include -L/usr/lib/nspr/ -I/usr/include/fmod \
+ -c -o foobar2.o foobar2.c
<comment>(Build Error)</comment>
foobar2.c:1:17: ogg.h: No such file or directory
@@ -524,7 +532,7 @@
</note>
<pre caption="emerge-ing With PORT_LOGDIR">
-# <i>PORT_LOGDIR=/var/log/portage emerge foobar2</i>
+# <i>PORT_LOGDIR=/var/log/portage emerge cate-gory/foobar2</i>
</pre>
<p>
@@ -537,18 +545,16 @@
total 16
drwxrws--- 2 root root 4096 Jun 30 10:08 .
drwxr-xr-x 15 root root 4096 Jun 30 10:08 ..
--rw-r--r-- 1 root root 7390 Jun 30 10:09 2115-foobar2-1.0.log
+-rw-r--r-- 1 root root 7390 Jun 30 10:09 cate-gory:foobar2-1.0:20090110-213217.log
</pre>
<p>
-The log files have the format [counter]-[package name]-[version].log. Counter
-is a special variable that is meant to state this package as the n-th package
-you've emerged. This prevents duplicate logs from appearing. A quick look at
-the log file will show the entire emerge process. This can be attached later
-on as we'll see in the bug reporting section. Now that we've safely obtained
-our information needed to report the bug we can continue to do so. However,
-before we get started on that, we need to make sure no one else has reported
-the issue. Let's take a look at searching for bugs.
+The log files have the format [category]:[package name]-[version]:[date].log. A
+quick look at the log file will show the entire emerge process. This can be
+attached later on as we'll see in the bug reporting section. Now that we've
+safely obtained our information needed to report the bug we can continue to do
+so. However, before we get started on that, we need to make sure no one else
+has reported the issue. Let's take a look at searching for bugs.
</p>
</body>
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: bugzilla-howto.xml
@ 2009-03-05 12:02 Jan Kundrat (jkt)
0 siblings, 0 replies; 5+ messages in thread
From: Jan Kundrat (jkt) @ 2009-03-05 12:02 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 09/03/05 12:02:04
Modified: bugzilla-howto.xml
Log:
- we use -ggdb, not -ggdb3
- specifying -g -ggdb is redundant
Revision Changes Path
1.15 xml/htdocs/doc/en/bugzilla-howto.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.14&r2=1.15
Index: bugzilla-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- bugzilla-howto.xml 26 Jan 2009 07:34:41 -0000 1.14
+++ bugzilla-howto.xml 5 Mar 2009 12:02:04 -0000 1.15
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.14 2009/01/26 07:34:41 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.15 2009/03/05 12:02:04 jkt Exp $ -->
<guide link="/doc/en/bugzilla-howto.xml">
<title>Gentoo Bug Reporting Guide</title>
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.12</version>
-<date>2009-01-25</date>
+<version>1.13</version>
+<date>2009-03-05</date>
<chapter>
<title>Introduction</title>
@@ -125,14 +125,14 @@
Just for reference, <e>bad_code</e> is the program we'll be debugging with
<c>gdb</c> later on. As you can see, the program without debugging symbols is
3140 bytes, while the program with them is 6374 bytes. That's close to double
-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
-<path>/etc/make.conf</path> <e>might</e> look with the newly added flags.
+the size! Two more things can be done for debugging. The first is adding
+<c>ggdb</c> 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 <path>/etc/make.conf</path> <e>might</e> look with the newly added flags.
</p>
<pre caption="make.conf settings">
-CFLAGS="-O1 -pipe -g -ggdb"
+CFLAGS="-O1 -pipe -ggdb"
CXXFLAGS="${CFLAGS}"
</pre>
@@ -285,7 +285,7 @@
enabled:
</p>
-<pre caption="Program backtrace with -ggdb3">
+<pre caption="Program backtrace with -ggdb">
(gdb) <i>bt</i>
#0 0xb7e4bdc0 in strcpy () from /lib/libc.so.6
#1 0x0804838c in run_it (input=0x0) at bad_code.c:7
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: bugzilla-howto.xml
@ 2009-03-05 12:13 Jan Kundrat (jkt)
0 siblings, 0 replies; 5+ messages in thread
From: Jan Kundrat (jkt) @ 2009-03-05 12:13 UTC (permalink / raw
To: gentoo-doc-cvs
jkt 09/03/05 12:13:20
Modified: bugzilla-howto.xml
Log:
#260477, encourage LC_ALL=C when reporting bugs
Revision Changes Path
1.16 xml/htdocs/doc/en/bugzilla-howto.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.16&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.16&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.15&r2=1.16
Index: bugzilla-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- bugzilla-howto.xml 5 Mar 2009 12:02:04 -0000 1.15
+++ bugzilla-howto.xml 5 Mar 2009 12:13:20 -0000 1.16
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.15 2009/03/05 12:02:04 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.16 2009/03/05 12:13:20 jkt Exp $ -->
<guide link="/doc/en/bugzilla-howto.xml">
<title>Gentoo Bug Reporting Guide</title>
@@ -20,7 +20,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.13</version>
+<version>1.14</version>
<date>2009-03-05</date>
<chapter>
@@ -492,6 +492,23 @@
</p>
<p>
+Please make sure you always include error messages in English, even when your
+system language is set to something else. You can temporarily switch to English
+locale by prepending <c>LC_ALL=C</c> to the emerge command like this:
+</p>
+
+<pre caption="Temporarily switching locale to English">
+# <i>LC_ALL=C emerge sys-apps/foobar2</i>
+</pre>
+
+<note>
+This is also about the only time you should use the <c>LC_ALL</c> environmental
+variable for specifying locale settings. If you are looking for a way to switch
+your system's language, then please consult our <uri
+link="guide-localization.xml">Localization Guide</uri> instead.
+</note>
+
+<p>
Make errors are the actual error and the information the developer needs. When
you see "make: ***", this is often where the error has occurred. Normally, you
can copy and paste 10 lines above it and the developer will be able to address
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: bugzilla-howto.xml
@ 2010-02-28 6:14 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 5+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-02-28 6:14 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 10/02/28 06:14:01
Modified: bugzilla-howto.xml
Log:
update with new perl commands, bug 307147
Revision Changes Path
1.17 xml/htdocs/doc/en/bugzilla-howto.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.17&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.17&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.16&r2=1.17
Index: bugzilla-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- bugzilla-howto.xml 5 Mar 2009 12:13:20 -0000 1.16
+++ bugzilla-howto.xml 28 Feb 2010 06:14:00 -0000 1.17
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.16 2009/03/05 12:13:20 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.17 2010/02/28 06:14:00 nightmorph Exp $ -->
-<guide link="/doc/en/bugzilla-howto.xml">
+<guide>
<title>Gentoo Bug Reporting Guide</title>
<author title="Author">
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.14</version>
-<date>2009-03-05</date>
+<version>1.15</version>
+<date>2010-02-27</date>
<chapter>
<title>Introduction</title>
@@ -51,7 +51,7 @@
</p>
<pre caption="A run time error">
-$ <i>./bad_code `perl -e 'print Ax100'`</i>
+$ <i>./bad_code `perl -e 'print "A"x100'`</i>
Segmentation fault
</pre>
@@ -177,7 +177,7 @@
</p>
<pre caption="Breaking The Program">
-$ <i>./bad_code `perl -e 'print Ax100'`</i>
+$ <i>./bad_code `perl -e 'print "A"x100'`</i>
Segmentation fault
</pre>
@@ -189,7 +189,7 @@
</p>
<pre caption="Running Our Program Through GDB">
-$ <i>gdb --args ./bad_code `perl -e 'print Ax100'`</i>
+$ <i>gdb --args ./bad_code `perl -e 'print "A"x100'`</i>
GNU gdb 6.3
Copyright 2004 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: bugzilla-howto.xml
@ 2013-07-22 12:01 Sven Vermeulen (swift)
0 siblings, 0 replies; 5+ messages in thread
From: Sven Vermeulen (swift) @ 2013-07-22 12:01 UTC (permalink / raw
To: gentoo-doc-cvs
swift 13/07/22 12:01:15
Modified: bugzilla-howto.xml
Log:
Moved to wiki - https://wiki.gentoo.org/wiki/Bugzilla_HOWTO
Revision Changes Path
1.19 xml/htdocs/doc/en/bugzilla-howto.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.19&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.19&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.18&r2=1.19
Index: bugzilla-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- bugzilla-howto.xml 24 Jul 2012 12:12:51 -0000 1.18
+++ bugzilla-howto.xml 22 Jul 2013 12:01:15 -0000 1.19
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.18 2012/07/24 12:12:51 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.19 2013/07/22 12:01:15 swift Exp $ -->
-<guide>
+<guide disclaimer="obsolete" redirect="https://wiki.gentoo.org/wiki/Bugzilla_HOWTO">
<title>Gentoo Bug Reporting Guide</title>
<author title="Author">
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2</version>
-<date>2012-07-24</date>
+<version>3</version>
+<date>2013-07-22</date>
<chapter>
<title>Introduction</title>
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2013-07-22 12:01 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-03-05 12:13 [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: bugzilla-howto.xml Jan Kundrat (jkt)
-- strict thread matches above, loose matches on Subject: below --
2013-07-22 12:01 Sven Vermeulen (swift)
2010-02-28 6:14 Joshua Saddler (nightmorph)
2009-03-05 12:02 Jan Kundrat (jkt)
2009-01-26 7:34 Joshua Saddler (nightmorph)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox