Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 13 Mar 2002 10:40:23 +0200
From:      Giorgos Keramidas <keramida@freebsd.org>
To:        Peter Pentchev <roam@ringlet.net>
Cc:        doc@freebsd.org
Subject:   Re: [PATCH] Entities for FreeBSD.org addresses & lists
Message-ID:  <20020313084023.GA27931@hades.hell.gr>
In-Reply-To: <20020313092728.A344@straylight.oblivion.bg>
References:  <20020313092728.A344@straylight.oblivion.bg>

next in thread | previous in thread | raw e-mail | index | archive | help
On 2002-03-13 09:27, Peter Pentchev wrote:
> Hi,
> 
> Is there a reason that we are not using the entities we have
> for the committers' names and e-mail addresses and for our
> mailing lists throughout the documentation?

Yes, there is.  Reason is nobody has done it until now :P

> At http://people.FreeBSD.org/~roam/doc/fbsdmail/

<looks-fine>
  articles::committers-guide.patch
  articles::contributing.patch
  articles::formatting-media.patch
  articles::freebsd-questions.patch
  articles::hubs.patch
  articles::new-users.patch
  articles::releng-packages.patch
  articles::releng.patch
  books::developers-handbook.patch
  teams.ent.patch
</looks-fine>

In books::faq.patch change this:

	+            the &a.platforms;.
	+            </para>

to the following:

	+            the &a.platforms;.</para>

In books::fdp-primer.patch change this:

	+<!ENTITY % mailing-lists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN"> %mailing-lists;

to read:

	+<!ENTITY % mailing-lists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN">
	+%mailing-lists;

In books::fdp-primer.patch don't let the comma have any whitespace
before it:

	+         let you have any) then you can e-mail &a.nik;
	+          , and arrange to e-mail the files

should look like:

+         let you have any) then you can e-mail &a.nik;,
+         and arrange to e-mail the files

In the handbook diff, the following might look a little strange:

		  please contact the FreeBSD project administrators
	-         <email>hubs@FreeBSD.org</email> for more information.</para>
	+         &a.hubs; for more information.</para>

since &a.hubs; will make the output have the following text:

	the FreeBSD project administrators FreeBSD mirror sites mailing
	list <hubs@FreeBSD.org>

you might want to remove 'FreeBSD project administrators' too, to make the
output be:

	the FreeBSD mirror sites mailing list <hubs@FreeBSD.org>

Don't make changes to 'The Corporate Networkers Guide'.  It's copyrighted
work, and you (or the Doc team) would have to contact the author and
published first, get their approval, if that it at all possible.

<not-fine>
  books::corp-net-guide.patch
</not-fine>

Super cool work :)))

Giorgos Keramidas                       FreeBSD Documentation Project
keramida@{freebsd.org,ceid.upatras.gr}  http://www.FreeBSD.org/docproj/

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020313084023.GA27931>