Clean up the "Administrative Details" section of committer's Guide:

- Force column width to improve rendering.
- Remove a number of pieces of information which is either obsolete or
  just not important. This includes removing reference to using telnet
  which was already obsolete when I got a commit bit in 2003...
- Point people at freefall.
- Remove the hardcoded lists of members of cvsadm and GNATS admins -
  this just duplicated administration.html and new committers should
  not need to bug the two teams so often that they need to be pointed
  out more than the many other active administrative teams. [1]
- Point at dcvs and pcvs for CVS repo's, as those are still in use by
  developers.
- Don't use entities for internal mailing lists which expands to the
  names as the result is just confusing and not useful. This part
  should probably be changed to be a section with more text instead of
  trying to include most info inside a table.
- Add information about portmgr monthly reports.
- Add a few links to some useful internal pages with more information.
- Misc minor text cleanup.

Discussed with:	linimon, gavin [1]

en_US.ISO8859-1/articles/committers-guide/article.sgml

@@ -60,52 +60,44 @@
 
     <informaltable frame="none" orient="port" pgwide="1">
       <tgroup cols="2">
+	<colspec colwidth="20*">
+	<colspec colwidth="80*">
 	<tbody>
-	  <row>
-	    <entry><emphasis>Main CVS Repository Host</emphasis></entry>
-	    <entry><hostid role="fqdn">ncvs.FreeBSD.org</hostid></entry>
-	  </row>
-
-	  <row>
-	    <entry><emphasis>Main Subversion Repository Host</emphasis></entry>
-	    <entry><hostid role="fqdn">svn.FreeBSD.org</hostid></entry>
-	  </row>
-
 	  <row>
 	    <entry><emphasis>Login Methods</emphasis></entry>
 	    <entry>&man.ssh.1;, protocol 2 only</entry>
 	  </row>
 
 	  <row>
-	    <entry><emphasis>Main CVSROOT</emphasis></entry>
-	    <entry>
-	      <hostid role="fqdn">ncvs.FreeBSD.org</hostid><literal>:</literal><filename>/home/ncvs</filename> (although also see <xref linkend="vcs.operations">).
-	    </entry>
+	    <entry><emphasis>Main Shell Host</emphasis></entry>
+	    <entry><hostid role="fqdn">freefall.FreeBSD.org</hostid></entry>
 	  </row>
 
 	  <row>
 	    <entry><emphasis>Main Subversion Root</emphasis></entry>
 	    <entry>
-	      <literal>svn+ssh://</literal><hostid role="fqdn">svn.FreeBSD.org</hostid><filename>/base</filename> (although also see <xref linkend="vcs.operations">).
+	      <literal>svn+ssh://</literal><hostid role="fqdn">svn.FreeBSD.org</hostid><filename>/base</filename> (see also <xref linkend="vcs.operations">).
 	    </entry>
 	  </row>
 
 	  <row>
-	    <entry><emphasis>Main &a.cvsadm;</emphasis></entry>
-	    <entry>&a.peter; and &a.simon;, as well as &a.joe; and &a.marcus; for
-	      <filename>ports/</filename></entry>
+	    <entry><emphasis>Main CVSROOT's</emphasis></entry>
+	    <entry>
+
+	      <hostid role="fqdn">dcvs.FreeBSD.org</hostid><literal>:</literal><filename>/home/dcvs</filename>,
+	      <hostid role="fqdn">pcvs.FreeBSD.org</hostid><literal>:</literal><filename>/home/pcvs</filename>
+	      (see also <xref linkend="vcs.operations">).
+
+	    </entry>
 	  </row>
 
 	  <row>
-	    <entry><emphasis>&a.bugmeister;</emphasis></entry>
-	    <entry>&a.gavin; &a.linimon;, &a.remko;, and &a.vwe .</entry>
-	  </row>
+	    <entry><emphasis>Internal Mailing Lists</emphasis></entry>
 
-	  <row>
-	    <entry><emphasis>Mailing Lists</emphasis></entry>
-	    <entry>&a.doc-developers;, &a.doc-committers;;
-	    &a.ports-developers;, &a.ports-committers;;
-	    &a.src-developers;, &a.src-committers;.  (Each project
+	    <entry>developers (technically called all-developers),
+	      doc-developers, doc-committers, ports-developers,
+	      ports-committers, src-developers, src-committers.
+	      (Each project
 	    repository has its own -developers and -committers mailing
 	    lists.  Archives for these lists may be found in files
 	    <filename>/home/mail/<replaceable>repository-name</replaceable>-developers-archive</filename>
@@ -125,11 +117,10 @@
 	  </row>
 
 	  <row>
-	    <entry><emphasis>Noteworthy CVSup Tags</emphasis></entry>
-	    <entry>
-	      <literal>RELENG_7</literal> (7.X-STABLE), 
-	      <literal>RELENG_8</literal> (8.X-STABLE), 
-	      <literal>HEAD</literal> (-CURRENT)
+	    <entry><emphasis>Ports Management Team monthly
+		reports</emphasis></entry>
+	    <entry><filename>/home/portmgr/public/monthly-reports</filename>
+	      on the <hostid role="domainname">FreeBSD.org</hostid> cluster.
 	    </entry>
 	  </row>
 
@@ -146,16 +137,24 @@
       </tgroup>
     </informaltable>
 
-    <para>It is required that you use &man.ssh.1; or &man.telnet.1;
-      with Kerberos 5 to connect to the project hosts.  For
-      &man.ssh.1; only protocol 2 is allowed.
-      These are generally more secure than plain &man.telnet.1; or
-      &man.rlogin.1; since credential negotiation will always be
-      encrypted.  All traffic is encrypted by default with &man.ssh.1;.
-      With utilities like &man.ssh-agent.1; and &man.scp.1; also
-      available, &man.ssh.1; is also far more convenient.  If you do
+    <para>It is required that you use &man.ssh.1;
+      to connect to the project hosts.
+      If you do
       not know anything about &man.ssh.1;, please see
       <xref linkend="ssh.guide">.</para>
+
+    <para>Useful links:</para>
+
+    <itemizedlist>
+      <listitem><para><ulink url="&url.base;/internal/">FreeBSD
+	    Project Internal Pages</ulink></para></listitem>
+
+      <listitem><para><ulink url="&url.base;/internal/machines.html">FreeBSD
+	    Project Hosts</ulink></para></listitem>
+
+      <listitem><para><ulink url="&url.base;/administration.html">FreeBSD
+	    Project Administrative Groups</ulink></para></listitem>
+    </itemizedlist>
   </sect1>
 
   <sect1 id="committer.types">