From owner-freebsd-doc@FreeBSD.ORG  Tue Jul  9 22:21:59 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@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 52319B74
 for <doc@freebsd.org>; Tue,  9 Jul 2013 22:21:59 +0000 (UTC)
 (envelope-from r.c.ladan@gmail.com)
Received: from mail-wg0-x22e.google.com (mail-wg0-x22e.google.com
 [IPv6:2a00:1450:400c:c00::22e])
 by mx1.freebsd.org (Postfix) with ESMTP id E197410A8
 for <doc@freebsd.org>; Tue,  9 Jul 2013 22:21:58 +0000 (UTC)
Received: by mail-wg0-f46.google.com with SMTP id c11so5199737wgh.13
 for <doc@freebsd.org>; Tue, 09 Jul 2013 15:21:58 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=sender:message-id:date:from:user-agent:mime-version:to:subject
 :x-enigmail-version:content-type:content-transfer-encoding;
 bh=E9wzlDjhtnMrBEmkfPMbF+se0IKEBr/x4RBmCEj/PhA=;
 b=drKoX5GX2iHxaXLMcr45c6AntPqyVBMmWIQonZa/c4UW1sqTd0KglIozl5jldtTF6m
 EhTEeTo8MF1oNK8zEF+Gv7w8xwvc/ASHtcXcteSxvN4YIxZuQC3H8d4YYR1FdrIgWmzz
 KGbowWAJ9wrcDe2pwjeXWYPNYSZgV6pTs1R0ilX/9udsXte17clIqNb90weH2/IYFJRi
 ys0PcoWZMv2PSr0nehn/H9ziTVLwgnJdwcchNeMFAlK4XeylePrV0L1lwtswpftJy6jO
 vkItSfckaAldCrYh7XrQsKsPay3PdcVqg/vYHmIEjrcN1/DatS8UIVdgE4XxK5kluTzt
 PmHw==
X-Received: by 10.180.20.228 with SMTP id q4mr33302865wie.60.1373408518100;
 Tue, 09 Jul 2013 15:21:58 -0700 (PDT)
Received: from ?IPv6:2001:980:d7ed:1:8e:1a90:6584:b13f?
 ([2001:980:d7ed:1:8e:1a90:6584:b13f])
 by mx.google.com with ESMTPSA id cz9sm19114550wib.3.2013.07.09.15.21.56
 for <doc@freebsd.org>
 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128);
 Tue, 09 Jul 2013 15:21:57 -0700 (PDT)
Sender: =?UTF-8?Q?Ren=C3=A9_Ladan?= <r.c.ladan@gmail.com>
Message-ID: <51DC8D03.2000107@freebsd.org>
Date: Wed, 10 Jul 2013 00:21:55 +0200
From: =?ISO-8859-1?Q?Ren=E9_Ladan?= <rene@freebsd.org>
User-Agent: Mozilla/5.0 (X11; FreeBSD amd64;
 rv:17.0) Gecko/20130701 Thunderbird/17.0.7
MIME-Version: 1.0
To: FBSD Doc project <doc@FreeBSD.org>
Subject: translators: projects/entities merged
X-Enigmail-Version: 1.5.1
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 09 Jul 2013 22:21:59 -0000

Dear translators,

now that the projects/entities is merged back into head/ as of r42226,
you will have to update the author entity references in your books and
articles to avoid loosing email addresses in the rendered output:

Before:
* share/xml/authors.ent :
  <!ENTITY a.et "ExtraTerrestial <email>et@FreeBSD.org</email>">

* articles/martian/article.xml:

  <para>The first green man to join &os; was &a.et;.</para>

which would render as

<para>The First green man to join FreeBSD was ExtraTerrestial <a href
....>et@FreeBSD.org</a>.</para>

After:
* share/xml/authors.ent :
  <!ENTITY a.et "ExtraTerrestial">
  <!ENTITY a.et.email "&a.et; <email xmlns=''>et@FreeBSD.org</email>">

(the empty namespace is required for the webpages to build)

This means the same sentence would now render without the email address,
unless you change it to:

<para>The first green man to join &os; was &a.et.email;.</para>

Regards,
René