From owner-freebsd-doc  Tue Sep  3 19:40:52 1996
Return-Path: owner-doc
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id TAA16590
          for doc-outgoing; Tue, 3 Sep 1996 19:40:52 -0700 (PDT)
Received: from fallout.campusview.indiana.edu (fallout.campusview.indiana.edu [149.159.1.1])
          by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id TAA16582;
          Tue, 3 Sep 1996 19:40:47 -0700 (PDT)
Received: from localhost (jfieber@localhost) by fallout.campusview.indiana.edu (8.7.5/8.7.3) with SMTP id VAA15856; Tue, 3 Sep 1996 21:40:36 -0500 (EST)
Date: Tue, 3 Sep 1996 21:40:36 -0500 (EST)
From: John Fieber <jfieber@indiana.edu>
To: "Jordan K. Hubbard" <jkh@time.cdrom.com>
cc: Satoshi Asami <asami@freebsd.org>, hanai@astec.co.jp, doc@freebsd.org
Subject: Re: Warning: SGML doc changes 
In-Reply-To: <305.841801390@time.cdrom.com>
Message-ID: <Pine.BSI.3.95.960903212527.7948B-100000@fallout.campusview.indiana.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-doc@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

On Tue, 3 Sep 1996, Jordan K. Hubbard wrote:

[WRT mm upgrade]
> > The last must be done regardless; the version currently in
> > current has some catastrophic bugs, never mind beind 9 versions
> > behind what is currently available. 
> 
> Can we bite this off as a separate task?  I'm worried that we might be
> gathering too many large scale TODOs and not enough short-term goals.

Certainly.

> > As for the handbook itself, you suggest putting the new stuff in
> > jp_JP.EUC.  It would follow that the english should then go in
> > en_??.ISO_8859-1.  The "foreign" directories have translated
>
> Sounds good to me!

Okay, who claims english?  AU, CA, GB, or US?  :->

Also, this scheme assumes translations are chopped up at the file
level.  This may be the most managable, but its also possible to
embed multiple translations in a single file.

  <![ % english [
  This is the english translation
  ]]>

  <![ % french [
  This is the french translation
  ]]>

  <![ % german [
  This is german...
  ]]>

  This will come out the same in both versions

The obvious advantage to this method is common text, most likely
examples, need not be duplicated.  It may potentially help keep
variant languages intact. 

The obvious problem is combining different encodings.  I gather
if we restrict the non-japanese text to USASCII we should not run
into conflicts with EUC-J.  Thats fine for english and japanese,
but would be a hassle for other european languages who would be
better with the ISO 8859-x or KOI8 encodings.

-john

== jfieber@indiana.edu ===========================================
== http://fallout.campusview.indiana.edu/~jfieber ================