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
[-- Attachment #1 --]
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 translate
> > &tm-attrib.*; with overriding entities. It is a hard job for the translation
> > teams to maintain duplicate copies of the file since, for example, when a new
> > trademark is added, they have to merge it (this is the reason why I split
> > en_US.ISO8859-1/articles/contributors/article.sgml recently). To override
> > entities which need to be translated, we can avoid such situation.
> >
> > I think entities should be shared with the localized docs as much as possible,
> > and if it can be shared, it should not be in en_US.ISO8859-1/share/sgml.
>
> 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".
--
Simon L. Nielsen
FreeBSD Documentation Team
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (FreeBSD)
iD8DBQE/MkCUh9pcDSc1mlERAke+AKCR3XmIvSCdOqgBOT6JLT7jkPBqXQCgmnYs
RdS+WWG48wP10Kbpt0jw4lg=
=IVkP
-----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030807120540.GB388>