1 |
rane 06/09/02 05:26:46 |
2 |
|
3 |
Modified: bugzilla-howto.xml |
4 |
Log: |
5 |
#119053, added instructions about making diffs |
6 |
|
7 |
Revision Changes Path |
8 |
1.7 xml/htdocs/doc/en/bugzilla-howto.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.7&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?rev=1.7&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml?r1=1.6&r2=1.7 |
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.6 |
18 |
retrieving revision 1.7 |
19 |
diff -u -r1.6 -r1.7 |
20 |
--- bugzilla-howto.xml 30 Aug 2005 02:51:12 -0000 1.6 |
21 |
+++ bugzilla-howto.xml 2 Sep 2006 05:26:46 -0000 1.7 |
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.6 2005/08/30 02:51:12 vapier Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.7 2006/09/02 05:26:46 rane 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.5</version> |
35 |
-<date>2005-08-29</date> |
36 |
+<version>1.6</version> |
37 |
+<date>2006-09-01</date> |
38 |
|
39 |
<chapter> |
40 |
<title>Introduction</title> |
41 |
@@ -1101,10 +1101,45 @@ |
42 |
</p> |
43 |
|
44 |
<p> |
45 |
-While we're doing all this, suppose another person finds your bug by searching |
46 |
-through bugzilla and is curious to keep track of the bug, they may do so by |
47 |
-putting their email in the Add CC field of the bug as shown below. You could |
48 |
-also keep track of other bugs by following the same method. |
49 |
+Sometimes a developer might ask you to attach a diff or patch for a file. |
50 |
+Standard diff files can be obtained through: |
51 |
+</p> |
52 |
+ |
53 |
+<pre caption="Standard Diff Creation"> |
54 |
+$ <i>cp file file.old</i> |
55 |
+$ <i>nano file</i> |
56 |
+$ <i>diff -u file.old file</i> |
57 |
+</pre> |
58 |
+ |
59 |
+<p> |
60 |
+For C/C++ source files, the <b>-p</b> flag is added to show what function calls |
61 |
+the diff applies to: |
62 |
+</p> |
63 |
+ |
64 |
+<pre caption="Diff-ing C/C++ source"> |
65 |
+$ <i>cp file.c file.c.old</i> |
66 |
+$ <i>nano file.c</i> |
67 |
+$ <i>diff -up file.c.old file.c</i> |
68 |
+</pre> |
69 |
+ |
70 |
+<p> |
71 |
+The documentation team will require the flag combination <b>-Nt</b> as well as |
72 |
+<b>-u</b>. This mainly has to do with tab expansion. You can create such a diff |
73 |
+with: |
74 |
+</p> |
75 |
+ |
76 |
+<pre caption="Documentation diffs"> |
77 |
+$<i> cp file.xml file.xml.old</i> |
78 |
+$<i> nano file.xml</i> |
79 |
+$<i> diff -Nut file.xml.old file.xml</i> |
80 |
+</pre> |
81 |
+ |
82 |
+<p> |
83 |
+And your diff is created. While we're doing all this, suppose another person |
84 |
+finds your bug by searching through bugzilla and is curious to keep track of |
85 |
+the bug, they may do so by putting their email in the Add CC field of the bug |
86 |
+as shown below. You could also keep track of other bugs by following the same |
87 |
+method. |
88 |
</p> |
89 |
|
90 |
<figure link="/images/docs/bugzie-add-email.png" caption="Adding Email To CC:"/> |
91 |
|
92 |
|
93 |
|
94 |
-- |
95 |
gentoo-doc-cvs@g.o mailing list |