Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 7 Aug 2003 14:05:42 +0200
From:      "Simon L. Nielsen" <simon@FreeBSD.org>
To:        Hiroki Sato <hrs@eos.ocn.ne.jp>
Cc:        cvs-all@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/articles/5-roadmap article.sgml doc/en_US.ISO8859-1/articles/checkpoint article.sgml doc/en_US.ISO8859-1/articles/committers-guide article.sgml doc/en_US.ISO8859-1/articles/contributing article.sgml doc/en_US.ISO8859-1/articles/contributors article.sgml doc/en_US.ISO8859-1/share/sgml catalog trademarks.ent
Message-ID:  <20030807120540.GB388@FreeBSD.org>
In-Reply-To: <20030807113201.GA388@FreeBSD.org>
References:  <200308062148.h76LmeDf004506@repoman.freebsd.org> <20030807.082059.95055414.hrs@eos.ocn.ne.jp> <20030806233226.GE21194@FreeBSD.org> <20030807.091621.59658151.hrs@eos.ocn.ne.jp> <20030807113201.GA388@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--kfjH4zxOES6UT95V
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On 2003.08.07 13:32:02 +0200, Simon L. Nielsen wrote:
> On 2003.08.07 09:16:21 +0900, Hiroki Sato wrote:

> >  We can put trademark.ent doc/share/sgml and the translators can transl=
ate
> >  &tm-attrib.*; with overriding entities.  It is a hard job for the tran=
slation
> >  teams to maintain duplicate copies of the file since, for example, whe=
n a new
> >  trademark is added, they have to merge it (this is the reason why I sp=
lit
> >  en_US.ISO8859-1/articles/contributors/article.sgml recently).  To over=
ride
> >  entities which need to be translated, we can avoid such situation.
> >=20
> >  I think entities should be shared with the localized docs as much as p=
ossible,
> >  and if it can be shared, it should not be in en_US.ISO8859-1/share/sgm=
l.
>=20
> If it makes life simpler for the translators, I agree it should be
> moved, so I will move the file.

I just looked more closely at how some of the other "shared" entity
files are defined, and got a bit confused on what exactly I should move.

In share/sgml/catalog there is :

PUBLIC  "-//FreeBSD//ENTITIES DocBook Author Entities//EN"
        "../../en_US.ISO8859-1/share/sgml/authors.ent"

In en_US.ISO8859-1/share/sgml/catalog there is :

PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN"
	"mailing-lists.ent"

Both have localized versions in ja_JP.eucJP/share/sgml/, so I'm a bit
confused on how sharing entities is supposed to work.

If I move trademark.ent to doc/share/sgml with the coresponding catalog
entry, which was what you suggested (as I understood it), it looks like
we have a third way to share localized entities?  That seems a bit odd
to me, but perhaps there is a reason I don't know about?

As I said, it's fine with me to move the file, I just want to make sure
we do it "the right way".

--=20
Simon L. Nielsen
FreeBSD Documentation Team

--kfjH4zxOES6UT95V
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (FreeBSD)

iD8DBQE/MkCUh9pcDSc1mlERAke+AKCR3XmIvSCdOqgBOT6JLT7jkPBqXQCgmnYs
RdS+WWG48wP10Kbpt0jw4lg=
=IVkP
-----END PGP SIGNATURE-----

--kfjH4zxOES6UT95V--



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