svn commit: r38858 - head/en_US.ISO8859-1/articles/committers-guide
Glen Barber
gjb at FreeBSD.org
Sun May 20 20:55:21 UTC 2012
Author: gjb
Date: Sun May 20 20:55:21 2012
New Revision: 38858
URL: http://svn.freebsd.org/changeset/doc/38858
Log:
- Update the Conventions and Traditions to reflect the doc CVS->SVN
conversion.
- Add a note that the .ent, .sgml, and .xml files are in the doc
repository.
Modified:
head/en_US.ISO8859-1/articles/committers-guide/article.sgml
Modified: head/en_US.ISO8859-1/articles/committers-guide/article.sgml
==============================================================================
--- head/en_US.ISO8859-1/articles/committers-guide/article.sgml Sun May 20 20:32:48 2012 (r38857)
+++ head/en_US.ISO8859-1/articles/committers-guide/article.sgml Sun May 20 20:55:21 2012 (r38858)
@@ -2696,18 +2696,25 @@ $target - head/$source:$P,$Q,$R</screen>
<sect2 id="conventions-committers">
<title>Guidelines For Committers</title>
+ <note>
+ <para>The <literal>.ent</literal>, <literal>.sgml</literal>,
+ and <literal>.xml</literal> files listed below exist in the
+ &os; Documentation Project SVN repository at
+ <hostid role="fqdn">svn.FreeBSD.org/doc/</hostid>.</para>
+ </note>
+
<para>If you have been given commit rights to one or more of the
repositories:</para>
<itemizedlist>
<listitem>
<para>Add your author entity to
- <filename>doc/en_US.ISO8859-1/share/sgml/authors.ent</filename>;
+ <filename>head/en_US.ISO8859-1/share/sgml/authors.ent</filename>;
this should be done first since an omission of this commit will
cause the next commits to break the doc/ build.</para>
<para>This is a relatively easy task, but remains a good first test of
- your CVS skills.</para>
+ your version control skills.</para>
<note>
<para>Don't forget to get mentor approval for these patches!</para>
@@ -2717,36 +2724,36 @@ $target - head/$source:$P,$Q,$R</screen>
<listitem>
<para>Also add your author entity to
- <filename>www/en/developers.sgml</filename>.</para>
+ <filename>head/share/sgml/developers.ent</filename>.</para>
</listitem>
<listitem>
<para>Add yourself to the <quote>Developers</quote> section of
the <ulink url="&url.articles.contributors;/index.html">Contributors List</ulink>
- (<filename>doc/en_US.ISO8859-1/articles/contributors/contrib.committers.sgml</filename>) and remove yourself from the <quote>Additional
- Contributors</quote> section (<filename>doc/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml</filename>).
+ (<filename>head/en_US.ISO8859-1/articles/contributors/contrib.committers.sgml</filename>) and remove yourself from the <quote>Additional
+ Contributors</quote> section (<filename>head/en_US.ISO8859-1/articles/contributors/contrib.additional.sgml</filename>).
Please note that entries are sorted by last name.</para>
</listitem>
<listitem>
<para>Add an entry for yourself to
- <filename>www/share/sgml/news.xml</filename>. Look for the other
+ <filename>head/share/sgml/news.xml</filename>. Look for the other
entries that look like <quote>A new committer</quote> and follow the
format.</para>
</listitem>
<listitem>
<para>You should add your PGP or GnuPG key to
- <filename>doc/share/pgpkeys</filename> (and if you do not
+ <filename>head/share/pgpkeys</filename> (and if you do not
have a key, you should create one). Do not forget to commit
- the updated <filename>doc/share/pgpkeys/pgpkeys.ent</filename>
- and <filename>doc/share/pgpkeys/pgpkeys-developers.sgml</filename>.
+ the updated <filename>head/share/pgpkeys/pgpkeys.ent</filename>
+ and <filename>head/share/pgpkeys/pgpkeys-developers.sgml</filename>.
Please note that entries are sorted by last name.</para>
<para>&a.des; has
- written a shell script (<filename>doc/share/pgpkeys/addkey.sh</filename>) to make this extremely simple. See the
+ written a shell script (<filename>head/share/pgpkeys/addkey.sh</filename>) to make this extremely simple. See the
<ulink
- url="http://cvsweb.FreeBSD.org/doc/share/pgpkeys/README">README</ulink>
+ url="http://svnweb.FreeBSD.org/doc/head/share/pgpkeys/README">README</ulink>
file for more information.</para>
<note>
More information about the svn-doc-all
mailing list