From dschultz@uclink.Berkeley.EDU  Tue Jul 16 04:57:57 2002
Return-Path: <dschultz@uclink.Berkeley.EDU>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B7E8E37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 16 Jul 2002 04:57:57 -0700 (PDT)
Received: from HAL9000.homeunix.com (12-233-156-170.client.attbi.com [12.233.156.170])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 2E88E43E42
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 16 Jul 2002 04:57:57 -0700 (PDT)
	(envelope-from dschultz@uclink.Berkeley.EDU)
Received: from HAL9000.homeunix.com (localhost [127.0.0.1])
	by HAL9000.homeunix.com (8.12.3/8.12.3) with ESMTP id g6G7P53d000550
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 16 Jul 2002 00:25:06 -0700 (PDT)
	(envelope-from das@HAL9000.homeunix.com)
Received: (from das@localhost)
	by HAL9000.wox.org (8.12.3/8.12.3/Submit) id g6G7OxBj000546;
	Tue, 16 Jul 2002 00:24:59 -0700 (PDT)
	(envelope-from das)
Message-Id: <200207160724.g6G7OxBj000546@HAL9000.wox.org>
Date: Tue, 16 Jul 2002 00:24:59 -0700 (PDT)
From: David Schultz <dschultz@uclink.Berkeley.EDU>
To: FreeBSD-gnats-submit@freebsd.org
Subject: Confusing instructions for subscribing to mailing lists
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40648
>Category:       docs
>Synopsis:       Confusing instructions for subscribing to mailing lists
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jul 16 05:00:13 PDT 2002
>Closed-Date:    Tue Jul 16 05:16:05 PDT 2002
>Last-Modified:  Tue Jul 16 05:16:05 PDT 2002
>Originator:     David Schultz
>Release:        N/A
>Organization:
>Environment:
>Description:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/eresources.html

The first thing it says under the ``How to Subscribe'' heading is how
to send mail to the lists.  Many unalert readers seem to look at the
heading, then at the example address <listname@FreeBSD.ORG> and send
off a subscribe request to the wrong place.  This is annoying for
people who are already subscribed, and a big turn-off for potential
subscribers, whose requests are silently ignored.

A partial solution to this problem is to make the first thing under
``How to Subscribe'' say---you guessed it---how to subscribe.
>How-To-Repeat:
>Fix:
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v
retrieving revision 1.87
diff -u -r1.87 chapter.sgml
--- chapter.sgml	2002/07/04 14:24:45	1.87
+++ chapter.sgml	2002/07/16 07:15:46
@@ -548,12 +548,6 @@
     <sect2 id="eresources-subscribe">
       <title>How to Subscribe</title>
       
-      <para>All mailing lists live on <hostid
-	  role="fqdn">FreeBSD.org</hostid>, so to post to a given list you
-	simply mail to
-	&lt;<replaceable>listname</replaceable>@FreeBSD.org&gt;.  It will then
-	be redistributed to mailing list members world-wide.</para>
-	  
       <para>To subscribe to a list, send mail to &a.majordomo; and include
 
 	<programlisting>subscribe &lt;listname&gt; [&lt;optional address&gt;]</programlisting>
@@ -564,6 +558,13 @@
       <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.org</userinput>
 subscribe freebsd-announce
 ^D</screen>
+
+      <para>To actually post to a given list you
+	simply send mail to
+	&lt;<replaceable>listname</replaceable>@FreeBSD.org&gt;.  It will then
+	be redistributed to mailing list members world-wide.
+	<emphasis>Please note,</emphasis> subscription requests go to
+	&a.majordomo;, not the lists themselves.</para>
 	    
       <para>If you want to subscribe yourself under a different name, or
 	submit a subscription request for a local mailing list (this is more
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Tue Jul 16 05:15:18 PDT 2002 
State-Changed-Why:  
Excellent point!  Thanks for taking the time to do the SGML part of 
this and submitting it :) 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Tue Jul 16 05:15:18 PDT 2002 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=40648 
>Unformatted:
