/[gentoo]/xml/htdocs/doc/en/bugzilla-howto.xml
Gentoo

Diff of /xml/htdocs/doc/en/bugzilla-howto.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.11 Revision 1.12
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.11 2008/01/31 14:31:41 jkt Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/bugzilla-howto.xml,v 1.12 2008/02/01 19:30:40 jkt Exp $ -->
4 4
5<guide link="/doc/en/bugzilla-howto.xml"> 5<guide link="/doc/en/bugzilla-howto.xml">
6<title>Gentoo Bug Reporting Guide</title> 6<title>Gentoo Bug Reporting Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="chriswhite@gentoo.org">Chris White</mail> 9 <mail link="chriswhite@gentoo.org">Chris White</mail>
10</author> 10</author>
11<author title="Editor"> 11<author title="Editor">
12 <mail link="fox2mike@gentoo.org">Shyam Mani</mail> 12 <mail link="fox2mike@gentoo.org">Shyam Mani</mail>
13</author> 13</author>
14 14
15<abstract> 15<abstract>
16This document shows the proper method of reporting bugs using Bugzilla. 16This document shows the proper method of reporting bugs using Bugzilla.
17</abstract> 17</abstract>
18 18
19<!-- The content of this document is licensed under the CC-BY-SA license --> 19<!-- The content of this document is licensed under the CC-BY-SA license -->
20<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 20<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
21<license/> 21<license/>
22 22
23<version>1.10</version> 23<version>1.11</version>
24<date>2008-01-31</date> 24<date>2008-01-31</date>
25 25
26<chapter> 26<chapter>
27<title>Introduction</title> 27<title>Introduction</title>
28<section> 28<section>
29<title>Preface</title> 29<title>Preface</title>
30<body> 30<body>
31 31
32<p> 32<p>
33One of the factors that delay a bug being fixed is the way it is reported. By 33One of the factors that delay a bug being fixed is the way it is reported. By
34creating this guide, we hope to help improve the communication between 34creating this guide, we hope to help improve the communication between
35developers and users in bug resolution. Getting bugs fixed is an important, if 35developers and users in bug resolution. Getting bugs fixed is an important, if
36not crucial part of the quality assurance for any project and hopefully this 36not crucial part of the quality assurance for any project and hopefully this
37guide will help make that a success. 37guide will help make that a success.
38</p> 38</p>
1330overlay is. An overlay is a special directory like <path>/usr/portage</path>, 1330overlay is. An overlay is a special directory like <path>/usr/portage</path>,
1331the difference being that when you <c>emerge sync</c>, files contained within it 1331the difference being that when you <c>emerge sync</c>, files contained within it
1332will not be deleted. Luckily, a special <path>/usr/local/portage</path> 1332will not be deleted. Luckily, a special <path>/usr/local/portage</path>
1333directory is created for that purpose. Let's go ahead and set our portage 1333directory is created for that purpose. Let's go ahead and set our portage
1334overlay in<path>/etc/make.conf</path>. Open make.conf up in your favorite editor 1334overlay in<path>/etc/make.conf</path>. Open make.conf up in your favorite editor
1335and add this towards the end. 1335and add this towards the end.
1336</p> 1336</p>
1337 1337
1338<pre caption="Setting Up PORTDIR_OVERLAY"> 1338<pre caption="Setting Up PORTDIR_OVERLAY">
1339PORTDIR_OVERLAY="/usr/local/portage" 1339PORTDIR_OVERLAY="/usr/local/portage"
1340</pre> 1340</pre>
1341 1341
1342<p> 1342<p>
1343Now we'll want to create the appropriate directories to put our test ebuild 1343Now we'll want to create the appropriate directories to put our test ebuild
1344files in. In this case, we're supposed to put them in sys-apps/foobar2. You'll 1344files in. In this case, we're supposed to put them in sys-apps/foobar2. You'll
1345notice that the second comment asks for a files directory for the patch. The 1345notice that the second comment asks for a <path>files</path> directory for the
1346files directory holds the Manifest files (md5sums of files for a particular version of 1346patch. This directory holds other required files that aren't included with
1347a package) and any other required files that aren't included with the standard
1348source archive (patches, init.d scripts, etc). This is a subdir in the package 1347the standard source archive (patches, init.d scripts, etc). This is a subdir in
1349directory called files. Go ahead and create these directories: 1348the package directory called <path>files</path>. Go ahead and create these
1349directories:
1350</p> 1350</p>
1351 1351
1352<pre caption="Setting Up The Category And Package Directories"> 1352<pre caption="Setting Up The Category And Package Directories">
1353# <i>mkdir -p /usr/local/portage/sys-apps/foobar2/files</i> 1353# <i>mkdir -p /usr/local/portage/sys-apps/foobar2/files</i>
1354</pre> 1354</pre>
1355 1355
1356<note> 1356<note>
1357The -p in mkdir creates not only the directory you want but also any missing 1357The -p in mkdir creates not only the directory you want but also any missing
1358parent directories as well (sys-apps and foobar2 in this case). 1358parent directories as well (sys-apps and foobar2 in this case).
1359</note> 1359</note>
1360 1360
1361<p> 1361<p>
1362Ok now, we can go ahead and download the files. First, download the ebuild 1362Ok now, we can go ahead and download the files. First, download the ebuild
1363into <path>/usr/local/portage/sys-apps/foobar2</path>, and then add the patch 1363into <path>/usr/local/portage/sys-apps/foobar2</path>, and then add the patch
1364to <path>/usr/local/portage/sys-apps/foobar2/files</path>. Now that we have the 1364to <path>/usr/local/portage/sys-apps/foobar2/files</path>. Now that we have the

Legend:
Removed from v.1.11  
changed lines
  Added in v.1.12

  ViewVC Help
Powered by ViewVC 1.1.20