The primary purposes are to clean up duplicated author definitions in
both share/xml/authors.ent and share/xml/developers.ent, and as a added
bonus simplify writing up author names/email addresses in web pages.
Apart from merging developers.ent into authors.ent, removing the former,
and updating the Committers Guide there should be little user-visible changes:
- a.portmgr renamed to a.portmgr.members
- a.doceng renamed to a.doceng.members
- team.re renamed to a.re.members.email and moved from
share/xml/freebsd.ent to share/xml/authors.ent
- a.core updated and moved from share/xml/mailing-lists.ent to
share/xml/teams.ent
- share/pgpkeys/{addkey.sh|README} updated
Translations are untouched except for build fixes.
Approved by: doceng (gjb)
Approved by: gjb (mentor)
this was that 'SGMLFLAGS' had to be changed to 'XMLFLAGS' in
share/mk/doc.docbook.mk so that everything continued to build OK.
Approved by: gabor (mentor)
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:
<!ENTITY % articles.ent PUBLIC
"-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
%articles.ent;
This pulls all of the necessary entities via share/sgml/articles.ent.
The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml. See
ja_JP.eucJP/share/sgml for example.
is not defined.
- URL_RELPREFIX must always point the top page's URL
(http://www.FreeBSD.org) in relative form, defined in Makefile.
- &url.base; can be used in doc/<langcode>/*. It will be
replaced with the real URL which points the top page.
For translators: Please make sure to define URL_RELPREFIX to
point the top page. The localized docs have different directory
hierarchy in its URL from the English version.
Tested by: den
I intend this article to be the first thing that new FreeBSD users
encounter when looking for information about mailing lists (i.e. I intend
to replace most links in our existing web pages to the 'How to get the
best results from freebsd-questions' article to this one instead; and
to have that article referenced from this one). That will happen shortly
(not yet).
Much of the text is indeed recycled from that article (thanks to Grog
for permission to do so), but some, including the bikeshed meta-info,
is my own. I have also generalized his article to apply to any mailing
list (not just FreeBSD-specific, although there is new text that touches
on that as well).
I have no doubt that there are rough edges in this article (both
stylistically and formatting). Please let me know. NB: it has
been tested locally with a make in the articles/ directory.
PR: docs/64934
Discussed with: ceri, grog, a few others.
