hacking: fix typos

* docs/hacking.html.in (committers): Fix spelling and grammar.
This commit is contained in:
Eric Blake 2010-03-08 17:02:44 -07:00 committed by Jim Meyering
parent 618dc80c2f
commit 0be3783316
2 changed files with 17 additions and 13 deletions

View File

@ -369,8 +369,8 @@ of arguments.
The AUTHORS files indicates the list of people with commit acces right The AUTHORS files indicates the list of people with commit acces right
who can actually merge the patches. who can actually merge the patches.
The general rule for commiting patches is to make sure it has been reviewed The general rule for commiting a patch is to make sure it has been reviewed
properly in the mailing-list first, usually if a couple of persons gave an properly in the mailing-list first, usually if a couple of people gave an
ACK or +1 to a patch and nobody raised an objection on the list it should ACK or +1 to a patch and nobody raised an objection on the list it should
be good to go. If the patch touches a part of the code where you're not the be good to go. If the patch touches a part of the code where you're not the
main maintainer or not have a very clear idea of how things work, it's better main maintainer or not have a very clear idea of how things work, it's better

View File

@ -514,38 +514,42 @@
<h2><a name="committers">Libvirt commiters guidelines</a></h2> <h2><a name="committers">Libvirt committers guidelines</a></h2>
<p> <p>
The AUTHORS files indicates the list of people with commit acces right The AUTHORS files indicates the list of people with commit access right
who can actually merge the patches. who can actually merge the patches.
</p> </p>
<p> <p>
The general rule for commiting patches is to make sure it has been reviewed The general rule for committing patches is to make sure it has been reviewed
properly in the mailing-list first, usually if a couple of persons gave an properly in the mailing-list first, usually if a couple of persons gave an
ACK or +1 to a patch and nobody raised an objection on the list it should ACK or +1 to a patch and nobody raised an objection on the list it should
be good to go. If the patch touches a part of the code where you're not the be good to go. If the patch touches a part of the code where you're not the
main maintainer or not have a very clear idea of how things work, it's better main maintainer, or where you donot have a very clear idea of
to wait for a more authoritative feedback though. Before commiting please how things work, it's better
also rebuild locally and run 'make check syntax-check' and make sure they to wait for a more authoritative feedback though. Before committing, please
don't raise error. Try to look for warnings too for example configure with also rebuild locally, run 'make check syntax-check', and make sure you
don't raise errors. Try to look for warnings too; for example,
configure with
<pre>
--enable-compile-warnings=error --enable-compile-warnings=error
</pre>
which adds -Werror to compile flags, so no warnings get missed which adds -Werror to compile flags, so no warnings get missed
</p> </p>
<p> <p>
Exceptions to that 'review and approval on the list first' is fixing failures An exception to 'review and approval on the list first' is fixing failures
to build: to build:
</p> </p>
<ul> <ul>
<li>if a recently commited patch breaks compilation on a platform <li>if a recently committed patch breaks compilation on a platform
or for a given driver then it's fine to commit a minimal fix or for a given driver, then it's fine to commit a minimal fix
directly without getting the review feedback first</li> directly without getting the review feedback first</li>
<li>if make check or make syntax-check breaks, if there is <li>if make check or make syntax-check breaks, if there is
an obvious fix, it's fine to commit immediately. an obvious fix, it's fine to commit immediately.
The patch should still be sent to the list (or tell what the fix was if The patch should still be sent to the list (or tell what the fix was if
trivial) and 'make check syntax-check' should pass too before commiting trivial), and 'make check syntax-check' should pass too, before committing
anything</li> anything</li>
<li> <li>
fixes for documentation and code comments can be managed fixes for documentation and code comments can be managed