Last-Modified: Tue, 29 Oct 2024 10:09:43 GMT
Expires: Fri, 27 Oct 2034 10:09:43 GMT

<!DOCTYPE html>
<html lang='en'>
<head>
<title>bugs.tex « docs - openwrt/em-br6478acv2/master-187ad058 - openwrt master 187ad058</title>
<meta name='generator' content='cgit v1.2.3'/>
<meta name='robots' content='index, nofollow'/>
<link rel='stylesheet' type='text/css' href='/cgit.css'/>
<link rel='shortcut icon' href='/favicon.ico'/>
<link rel='alternate' title='Atom feed' href='http://openwrt.panaceas.org/cgit/openwrt/em-br6478acv2/master-187ad058/atom/docs/bugs.tex?h=master' type='application/atom+xml'/>
<link rel='vcs-git' href='git://git.panaceas.org/openwrt/em-br6478acv2/master-187ad058' title='openwrt/em-br6478acv2/master-187ad058 Git repository'/>
<link rel='vcs-git' href='ssh://git@git.panaceas.org/git/openwrt/em-br6478acv2/master-187ad058' title='openwrt/em-br6478acv2/master-187ad058 Git repository'/>
</head>
<body>
<div id='cgit'><table id='header'>
<tr>
<td class='logo' rowspan='2'><a href='/cgit/'><img src='/cgit.png' alt='cgit logo'/></a></td>
<td class='main'><a href='/cgit/'>index</a> : <a title='openwrt/em-br6478acv2/master-187ad058' href='/cgit/openwrt/em-br6478acv2/master-187ad058/'>openwrt/em-br6478acv2/master-187ad058</a></td><td class='form'><form method='get'>
<input type='hidden' name='id' value='fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'/><select name='h' onchange='this.form.submit();'>
<option value='master' selected='selected'>master</option>
</select> <input type='submit' value='switch'/></form></td></tr>
<tr><td class='sub'>openwrt master 187ad058</td><td class='sub right'>James</td></tr></table>
<table class='tabs'><tr><td>
<a href='/cgit/openwrt/em-br6478acv2/master-187ad058/about/'>about</a><a href='/cgit/openwrt/em-br6478acv2/master-187ad058/'>summary</a><a href='/cgit/openwrt/em-br6478acv2/master-187ad058/refs/?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>refs</a><a href='/cgit/openwrt/em-br6478acv2/master-187ad058/log/docs/bugs.tex'>log</a><a class='active' href='/cgit/openwrt/em-br6478acv2/master-187ad058/tree/docs/bugs.tex?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>tree</a><a href='/cgit/openwrt/em-br6478acv2/master-187ad058/commit/docs/bugs.tex?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>commit</a><a href='/cgit/openwrt/em-br6478acv2/master-187ad058/diff/docs/bugs.tex?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>diff</a><a href='/cgit/openwrt/em-br6478acv2/master-187ad058/stats/docs/bugs.tex'>stats</a></td><td class='form'><form class='right' method='get' action='/cgit/openwrt/em-br6478acv2/master-187ad058/log/docs/bugs.tex'>
<input type='hidden' name='id' value='fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/cgit/openwrt/em-br6478acv2/master-187ad058/tree/?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>root</a>/<a href='/cgit/openwrt/em-br6478acv2/master-187ad058/tree/docs?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>docs</a>/<a href='/cgit/openwrt/em-br6478acv2/master-187ad058/tree/docs/bugs.tex?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>bugs.tex</a></div><div class='content'>blob: 9c46b5a7e611f293ea4fc3e4a56051521fd181bb (<a href='/cgit/openwrt/em-br6478acv2/master-187ad058/plain/docs/bugs.tex?id=fadaa3f96f50d5abb363c69304d78fa3f3bbbb93'>plain</a>)
<table summary='blob content' class='blob'>
<tr><td class='linenumbers'><pre><a id='n1' href='#n1'>1</a>
<a id='n2' href='#n2'>2</a>
<a id='n3' href='#n3'>3</a>
<a id='n4' href='#n4'>4</a>
<a id='n5' href='#n5'>5</a>
<a id='n6' href='#n6'>6</a>
<a id='n7' href='#n7'>7</a>
<a id='n8' href='#n8'>8</a>
<a id='n9' href='#n9'>9</a>
<a id='n10' href='#n10'>10</a>
<a id='n11' href='#n11'>11</a>
<a id='n12' href='#n12'>12</a>
<a id='n13' href='#n13'>13</a>
<a id='n14' href='#n14'>14</a>
<a id='n15' href='#n15'>15</a>
<a id='n16' href='#n16'>16</a>
<a id='n17' href='#n17'>17</a>
<a id='n18' href='#n18'>18</a>
<a id='n19' href='#n19'>19</a>
<a id='n20' href='#n20'>20</a>
<a id='n21' href='#n21'>21</a>
<a id='n22' href='#n22'>22</a>
<a id='n23' href='#n23'>23</a>
<a id='n24' href='#n24'>24</a>
<a id='n25' href='#n25'>25</a>
<a id='n26' href='#n26'>26</a>
<a id='n27' href='#n27'>27</a>
<a id='n28' href='#n28'>28</a>
<a id='n29' href='#n29'>29</a>
<a id='n30' href='#n30'>30</a>
<a id='n31' href='#n31'>31</a>
<a id='n32' href='#n32'>32</a>
<a id='n33' href='#n33'>33</a>
<a id='n34' href='#n34'>34</a>
<a id='n35' href='#n35'>35</a>
<a id='n36' href='#n36'>36</a>
<a id='n37' href='#n37'>37</a>
<a id='n38' href='#n38'>38</a>
<a id='n39' href='#n39'>39</a>
<a id='n40' href='#n40'>40</a>
<a id='n41' href='#n41'>41</a>
<a id='n42' href='#n42'>42</a>
<a id='n43' href='#n43'>43</a>
<a id='n44' href='#n44'>44</a>
<a id='n45' href='#n45'>45</a>
<a id='n46' href='#n46'>46</a>
<a id='n47' href='#n47'>47</a>
<a id='n48' href='#n48'>48</a>
<a id='n49' href='#n49'>49</a>
<a id='n50' href='#n50'>50</a>
<a id='n51' href='#n51'>51</a>
<a id='n52' href='#n52'>52</a>
</pre></td>
<td class='lines'><pre><code><style>pre { line-height: 125%; margin: 0; }
td.linenos pre { color: #000000; background-color: #f0f0f0; padding: 0 5px 0 5px; }
span.linenos { color: #000000; background-color: #f0f0f0; padding: 0 5px 0 5px; }
td.linenos pre.special { color: #000000; background-color: #ffffc0; padding: 0 5px 0 5px; }
span.linenos.special { color: #000000; background-color: #ffffc0; padding: 0 5px 0 5px; }
.highlight .hll { background-color: #ffffcc }
.highlight { background: #ffffff; }
.highlight .c { color: #888888 } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { color: #008800; font-weight: bold } /* Keyword */
.highlight .ch { color: #888888 } /* Comment.Hashbang */
.highlight .cm { color: #888888 } /* Comment.Multiline */
.highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */
.highlight .cpf { color: #888888 } /* Comment.PreprocFile */
.highlight .c1 { color: #888888 } /* Comment.Single */
.highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #333333 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #666666 } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */
.highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */
.highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */
.highlight .kp { color: #008800 } /* Keyword.Pseudo */
.highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */
.highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */
.highlight .na { color: #336699 } /* Name.Attribute */
.highlight .nb { color: #003388 } /* Name.Builtin */
.highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */
.highlight .no { color: #003366; font-weight: bold } /* Name.Constant */
.highlight .nd { color: #555555 } /* Name.Decorator */
.highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */
.highlight .nl { color: #336699; font-style: italic } /* Name.Label */
.highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */
.highlight .py { color: #336699; font-weight: bold } /* Name.Property */
.highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */
.highlight .nv { color: #336699 } /* Name.Variable */
.highlight .ow { color: #008800 } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */
.highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */
.highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */
.highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */
.highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */
.highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */
.highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */
.highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */
.highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */
.highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */
.highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */
.highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */
.highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */
.highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */
.highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */
.highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */
.highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */
.highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */
.highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */
.highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */
.highlight .vc { color: #336699 } /* Name.Variable.Class */
.highlight .vg { color: #dd7700 } /* Name.Variable.Global */
.highlight .vi { color: #3333bb } /* Name.Variable.Instance */
.highlight .vm { color: #336699 } /* Name.Variable.Magic */
.highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */</style><div class="highlight"><pre><span></span>OpenWrt as an open source software opens its development to the community by
having a publicly browseable subversion repository. The Trac software which
comes along with a Subversion frontend,  a Wiki and a ticket reporting system 
is used as an interface between developers, users and contributors in order to 
make the whole development process much easier and efficient.

We make distinction between two kinds of people within the Trac system:

<span class="k">\begin</span><span class="nb">{</span>itemize<span class="nb">}</span>
<span class="k">\item</span> developers, able to report, close and fix tickets
<span class="k">\item</span> reporters, able to add a comment, patch, or request ticket status
<span class="k">\end</span><span class="nb">{</span>itemize<span class="nb">}</span>

<span class="k">\subsubsection</span><span class="nb">{</span>Opening a ticket<span class="nb">}</span>

A reporter might want to open a ticket for the following reasons:

<span class="k">\begin</span><span class="nb">{</span>itemize<span class="nb">}</span>
<span class="k">\item</span> a bug affects a specific hardware and/or software and needs to be fixed
<span class="k">\item</span> a specific software package would be seen as part of the official OpenWrt repository
<span class="k">\item</span> a feature should be added or removed from OpenWrt
<span class="k">\end</span><span class="nb">{</span>itemize<span class="nb">}</span>

Regarding the kind of ticket that is open, a patch is welcome in those cases:

<span class="k">\begin</span><span class="nb">{</span>itemize<span class="nb">}</span>
<span class="k">\item</span> new package to be included in OpenWrt
<span class="k">\item</span> fix for a bug that works for the reporter and has no known side effect
<span class="k">\item</span> new features that can be added by modifying existing OpenWrt files
<span class="k">\end</span><span class="nb">{</span>itemize<span class="nb">}</span>

Once the ticket is open, a developer will take care of it, if so, the ticket is marked
as &quot;accepted&quot; with the developer name. You can add comments at any time to the ticket,
even when it is closed.

<span class="k">\subsubsection</span><span class="nb">{</span>Closing a ticket<span class="nb">}</span>

A ticket might be closed by a developer because:

<span class="k">\begin</span><span class="nb">{</span>itemize<span class="nb">}</span>
<span class="k">\item</span> the problem is already fixed (wontfix)
<span class="k">\item</span> the problem described is not judged as valid, and comes along with an explanation why (invalid)
<span class="k">\item</span> the developers know that this bug will be fixed upstream (wontfix)
<span class="k">\item</span> the problem is very similar to something that has already been reported (duplicate)
<span class="k">\item</span> the problem cannot be reproduced by the developers (worksforme)
<span class="k">\end</span><span class="nb">{</span>itemize<span class="nb">}</span>

At the same time, the reporter may want to get the ticket closed since he is not 
longer able to trigger the bug, or found it invalid by himself.

When a ticket is closed by a developer and marked as &quot;fixed&quot;, the comment contains 
the subversion changeset which corrects the bug.
</pre></div>
</code></pre></td></tr></table>
</div> <!-- class=content -->
<div class='footer'>generated by <a href='https://git.zx2c4.com/cgit/about/'>cgit v1.2.3</a> (<a href='https://git-scm.com/'>git 2.25.1</a>) at 2024-10-29 10:09:43 +0000</div>
</div> <!-- id=cgit -->
</body>
</html>
