svn commit: r50158 - head/en_US.ISO8859-1/articles/freebsd-releng

[Glen Barber]

Author: gjb
Date: Thu Apr 13 17:15:53 2017
New Revision: 50158
URL: https://svnweb.freebsd.org/changeset/doc/50158

Log:
  - Add notes about snapshot announcement emails and their helper
    scripts.
  - Reference the template used for ALPHA, BETA, and RC emails.
  
  Sponsored by:	The FreeBSD Foundation

Modified:
  head/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml

Modified: head/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml	Thu Apr 13 16:18:59 2017	(r50157)
+++ head/en_US.ISO8859-1/articles/freebsd-releng/releng-building.xml	Thu Apr 13 17:15:53 2017	(r50158)
@@ -197,6 +197,29 @@ KERNEL="GENERIC64"</programlisting>
 &prompt.root; <userinput>./setrev.sh -b &branch.stablex;</userinput>
 &prompt.root; <userinput>./zfs-setup.sh -c ./builds-<replaceable>11</replaceable>.conf</userinput>
 &prompt.root; <userinput>./thermite.sh -c ./builds-<replaceable>11</replaceable>.conf</userinput></screen>
+
+    <para>Once the builds have completed, additional helper scripts
+      are available to generate development snapshot emails which are
+      sent to the <literal>freebsd-snapshots at freebsd.org</literal>
+      mailing list:</para>
+
+    <screen>&prompt.root; <userinput>cd /releng/scripts-snapshot/scripts</userinput>
+&prompt.root; <userinput>./get-checksums.sh -c ./builds-<replaceable>11</replaceable>.conf | ./generate-email.pl > snapshot-<replaceable>11</replaceable>-mail</userinput></screen>
+
+    <note>
+      <para>The generated output should be double-checked for
+	correctness, and the email itself should be PGP signed,
+	in-line.</para>
+    </note>
+
+    <note>
+      <para>These helper scripts only apply to development snapshot
+	builds.  Announcements during the release cycle (excluding the
+	final release announcement) are created from an email
+	template.  A sample of the email template currently used can
+	be found <link
+	  xlink:href="https://svn.freebsd.org/base/user/gjb/thermite/non-release-template-mail.txt">here</link>.</para>
+    </note>
   </sect2>
 
   <sect2 xml:id="releng-build-release">