From owner-svn-doc-head@FreeBSD.ORG  Wed Jul 10 23:30:09 2013
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by hub.freebsd.org (Postfix) with ESMTP id 80384A12;
 Wed, 10 Jul 2013 23:30:09 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 191C2114E;
 Wed, 10 Jul 2013 23:30:08 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r6ANU83Z082773;
 Wed, 10 Jul 2013 17:30:08 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6ANU7K8082770;
 Wed, 10 Jul 2013 17:30:08 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Wed, 10 Jul 2013 17:30:07 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Benjamin Kaduk <kaduk@MIT.EDU>
Subject: Re: svn commit: r42235 -
 head/en_US.ISO8859-1/books/fdp-primer/docbook-markup
In-Reply-To: <alpine.BSF.2.00.1307101641560.81627@wonkity.com>
Message-ID: <alpine.BSF.2.00.1307101717030.81627@wonkity.com>
References: <201307101135.r6ABZl5q011350@svn.freebsd.org>
 <alpine.GSO.1.10.1307101045290.26275@multics.mit.edu>
 <47757ABD-D461-4089-9C25-E511CD4B0F83@vnode.se>
 <alpine.BSF.2.00.1307100954580.54758@wonkity.com>
 <alpine.GSO.1.10.1307101811260.26275@multics.mit.edu>
 <alpine.BSF.2.00.1307101641560.81627@wonkity.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Wed, 10 Jul 2013 17:30:08 -0600 (MDT)
Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org,
 doc-committers@freebsd.org, Warren Block <wblock@freebsd.org>,
 Joel Dahl <joel@vnode.se>
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: SVN commit messages for the doc tree for head
 <svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 10 Jul 2013 23:30:09 -0000

On Wed, 10 Jul 2013, Warren Block wrote:

> On Wed, 10 Jul 2013, Benjamin Kaduk wrote:
>
>> On Wed, 10 Jul 2013, Warren Block wrote:
>> 
>>> On Wed, 10 Jul 2013, Joel Dahl wrote:
>>> 
>>>> 10 jul 2013 kl. 16:46 skrev Benjamin Kaduk <kaduk@MIT.EDU>:
>>>>> On Wed, 10 Jul 2013, Warren Block wrote:
>>>>>> +
>>>>>> +	<programlisting><sgmltag class="starttag">para</sgmltag>Questions 
>>>>>> about &amp;os; may be sent to
>>>>>> +  <sgmltag 
>>>>>> class="starttag">email</sgmltag>questions@&amp;os;.org<sgmltag 
>>>>>> class="endtag">email</sgmltag>.<sgmltag 
>>>>>> class="endtag">para</sgmltag></programlisting>
>>>>> 
>>>>> Somehow I thought "freebsd-questions@FreeBSD.org" was the preferred 
>>>>> spelling.
>>>> 
>>>> It definitely is.
>>> 
>>> Well, yes, but there's an alias.  Looking at now, I think it's preferable 
>>> to use an example.com address to avoid the &os; complication.
>>> 
>>> Does a standard fake example email address exist, like 
>>> notreal@example.com?
>> 
>> I don't know of one.  Using @example.com would also render the "questions 
>> about FreeBSD" part unusable, and I would kind of like to keep that.
>
> questions@ was just my idea of the least-damaging FreeBSD.org email address. 
> I'll add another example to show an email address without entities in the 
> both the username and domain.
>
> Of course this also points out that the Primer does not have a table of 
> &os;-specific entities...

And at least two more issues:

There is an entity for questions@, &a.questions;.  But creating that 
address without using the entity is wrong, and gives a bad example.

Also, that entity shows the email address as questions@FreeBSD.org, not 
freebsd-questions@FreeBSD.org.  Check out the bottom of each HTML 
Handbook page.

Given all that, I'm going to remove the questions@ address and use 
notreal@example.com, unless someone can suggest something better.