svn commit: r42235 - head/en_US.ISO8859-1/books/fdp-primer/docbook-markup

[Warren Block]

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 at MIT.EDU>:
>>>>> On Wed, 10 Jul 2013, Warren Block wrote:
>>>>>> +
>>>>>> +	<programlisting><sgmltag class="starttag">para</sgmltag>Questions 
>>>>>> about &os; may be sent to
>>>>>> +  <sgmltag 
>>>>>> class="starttag">email</sgmltag>questions@&os;.org<sgmltag 
>>>>>> class="endtag">email</sgmltag>.<sgmltag 
>>>>>> class="endtag">para</sgmltag></programlisting>
>>>>> 
>>>>> Somehow I thought "freebsd-questions at 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 at 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 at FreeBSD.org, not 
freebsd-questions at 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 at example.com, unless someone can suggest something better.