From owner-cvs-all@FreeBSD.ORG Thu Aug 7 05:05:44 2003 Return-Path: Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 846B737B401; Thu, 7 Aug 2003 05:05:44 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5C4DC43F85; Thu, 7 Aug 2003 05:05:43 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 2BB4210BF82; Thu, 7 Aug 2003 14:05:42 +0200 (CEST) Date: Thu, 7 Aug 2003 14:05:42 +0200 From: "Simon L. Nielsen" To: Hiroki Sato Message-ID: <20030807120540.GB388@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> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="kfjH4zxOES6UT95V" Content-Disposition: inline In-Reply-To: <20030807113201.GA388@FreeBSD.org> User-Agent: Mutt/1.5.4i cc: doc-committers@FreeBSD.org cc: cvs-doc@FreeBSD.org 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 X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Aug 2003 12:05:45 -0000 --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--