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

[Simon L. Nielsen]

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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-doc/attachments/20030807/0fa85564/attachment.bin