From eb28fee24ea0cf297b2aa2e6fd7fa2b8dc97cade Mon Sep 17 00:00:00 2001
From: Guangyuan Yang <ygy@FreeBSD.org>
Date: Mon, 14 Dec 2020 05:54:22 +0000
Subject: [PATCH] handbook: document new commit message mailing lists

Reviewed by:	bcr
Differential Revision:	https://reviews.FreeBSD.org/D27591
---
 .../books/handbook/eresources/chapter.xml     | 78 ++++++++++++++++++-
 en_US.ISO8859-1/share/xml/mailing-lists.ent   | 28 +++++++
 2 files changed, 105 insertions(+), 1 deletion(-)

diff --git a/en_US.ISO8859-1/books/handbook/eresources/chapter.xml b/en_US.ISO8859-1/books/handbook/eresources/chapter.xml
index 492c77d2b1..48b4e25ce5 100644
--- a/en_US.ISO8859-1/books/handbook/eresources/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/eresources/chapter.xml
@@ -751,12 +751,88 @@
 	the digest options can be changed in the account options
 	section.</para>
 
+      <para><emphasis>Commit message lists:</emphasis> The following
+	lists are for people interested in seeing the log messages for
+	changes to various areas of the source tree.  They are
+	<emphasis>Read-Only</emphasis> lists and should not have mail
+	sent to them.</para>
+
+	  <note>
+	    <para>SVN log messages are sent to SVN lists.</para>
+      </note>
+
+	      <informaltable frame="none" pgwide="1">
+	<tgroup cols="3">
+	  <thead>
+	    <row>
+	      <entry>List</entry>
+	      <entry>Source area</entry>
+	      <entry>Area Description (source for)</entry>
+	    </row>
+	  </thead>
+
+	  <tbody>
+	    <row>
+	      <entry>&a.dev-commits-doc-all.name;</entry>
+	      <entry><filename>/usr/doc</filename></entry>
+	      <entry>All changes to the doc repository</entry>
+	    </row>
+
+	    <row>
+	      <entry>&a.dev-commits-ports-all.name;</entry>
+	      <entry><filename>/usr/ports</filename></entry>
+	      <entry>All changes to the ports repository</entry>
+	    </row>
+
+	    <row>
+	      <entry>&a.dev-commits-ports-main.name;</entry>
+	      <entry><filename>/usr/ports</filename></entry>
+	      <entry>All changes to the <quote>main</quote> branch
+		of the ports repository</entry>
+	    </row>
+
+	    <row>
+	      <entry>&a.dev-commits-ports-branches.name;</entry>
+	      <entry><filename>/usr/ports</filename></entry>
+	      <entry>All changes to the quarterly branches of the
+		ports repository</entry>
+	    </row>
+
+	    <row>
+	      <entry>&a.dev-commits-src-all.name;</entry>
+	      <entry><filename>/usr/src</filename></entry>
+	      <entry>All changes to the src repository</entry>
+	    </row>
+
+	    <row>
+	      <entry>&a.dev-commits-src-main.name;</entry>
+	      <entry><filename>/usr/src</filename></entry>
+	      <entry>All changes to the <quote>main</quote> branch
+		of the src repository (the &os;-CURRENT branch)</entry>
+	    </row>
+
+	    <row>
+	      <entry>&a.dev-commits-src-branches.name;</entry>
+	      <entry><filename>/usr/src</filename></entry>
+	      <entry>All changes to all stable branches of the src
+		repository</entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </informaltable>
+
       <para><emphasis>SVN lists:</emphasis> The following lists are
-	for people interested in seeing the log messages for changes
+	for people interested in seeing the SVN log messages for changes
 	to various areas of the source tree.  They are
 	<emphasis>Read-Only</emphasis> lists and should not have mail
 	sent to them.</para>
 
+	  <note>
+	    <para>Only SVN log messages are sent to SVN lists.  After the
+	      SVN to Git Migration, the following lists no longer receives
+	      new commit messages.</para>
+      </note>
+
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="3">
 	  <thead>
diff --git a/en_US.ISO8859-1/share/xml/mailing-lists.ent b/en_US.ISO8859-1/share/xml/mailing-lists.ent
index 998b2000d2..c2a619ba22 100644
--- a/en_US.ISO8859-1/share/xml/mailing-lists.ent
+++ b/en_US.ISO8859-1/share/xml/mailing-lists.ent
@@ -153,6 +153,34 @@
 <!ENTITY a.dev-ci "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-ci.url;'>Automated reports of build and test results from FreeBSD's continuous integration tools.</link>">
 <!ENTITY a.dev-ci.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-ci.url;'>dev-ci</link>">
 
+<!ENTITY a.dev-commits-doc-all.url "&a.mailman.listinfo;/dev-commits-doc-all">
+<!ENTITY a.dev-commits-doc-all "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-doc-all.url;'>Commit messages for all branches of the doc repository.</link>">
+<!ENTITY a.dev-commits-doc-all.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-doc-all.url;'>dev-commits-doc-all</link>">
+
+<!ENTITY a.dev-commits-ports-all.url "&a.mailman.listinfo;/dev-commits-ports-all">
+<!ENTITY a.dev-commits-ports-all "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-ports-all.url;'>Commit messages for all branches of the ports repository.</link>">
+<!ENTITY a.dev-commits-ports-all.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-ports-all.url;'>dev-commits-ports-all</link>">
+
+<!ENTITY a.dev-commits-ports-branches.url "&a.mailman.listinfo;/dev-commits-ports-branches">
+<!ENTITY a.dev-commits-ports-branches "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-ports-branches.url;'>Commit messages for the quarterly branches of the ports repository.</link>">
+<!ENTITY a.dev-commits-ports-branches.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-ports-branches.url;'>dev-commits-ports-branches</link>">
+
+<!ENTITY a.dev-commits-ports-main.url "&a.mailman.listinfo;/dev-commits-ports-main">
+<!ENTITY a.dev-commits-ports-main "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-ports-main.url;'>Commit messages for the main branch of the ports repository.</link>">
+<!ENTITY a.dev-commits-ports-main.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-ports-main.url;'>dev-commits-ports-main</link>">
+
+<!ENTITY a.dev-commits-src-all.url "&a.mailman.listinfo;/dev-commits-src-all">
+<!ENTITY a.dev-commits-src-all "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-src-all.url;'>Commit messages for all branches of the src repository.</link>">
+<!ENTITY a.dev-commits-src-all.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-src-all.url;'>dev-commits-src-all</link>">
+
+<!ENTITY a.dev-commits-src-branches.url "&a.mailman.listinfo;/dev-commits-src-branches">
+<!ENTITY a.dev-commits-src-branches "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-src-branches.url;'>Commit messages for the stable branches of the src repository.</link>">
+<!ENTITY a.dev-commits-src-branches.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-src-branches.url;'>dev-commits-src-branches</link>">
+
+<!ENTITY a.dev-commits-src-main.url "&a.mailman.listinfo;/dev-commits-src-main">
+<!ENTITY a.dev-commits-src-main "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-src-main.url;'>Commit messages for the main branch of the src repository.</link>">
+<!ENTITY a.dev-commits-src-main.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-commits-src-main.url;'>dev-commits-src-main</link>">
+
 <!ENTITY a.dev-reviews.url "&a.mailman.listinfo;/dev-reviews">
 <!ENTITY a.dev-reviews "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-reviews.url;'>Automated notifications of work in progress for review in FreeBSD's review tools, including patches..</link>">
 <!ENTITY a.dev-reviews.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dev-reviews.url;'>dev-reviews</link>">