From owner-freebsd-doc  Tue Sep  3 18:43:19 1996
Return-Path: owner-doc
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id SAA14279
          for doc-outgoing; Tue, 3 Sep 1996 18:43:19 -0700 (PDT)
Received: from time.cdrom.com (time.cdrom.com [204.216.27.226])
          by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id SAA14274;
          Tue, 3 Sep 1996 18:43:16 -0700 (PDT)
Received: from time.cdrom.com (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with ESMTP id SAA00307; Tue, 3 Sep 1996 18:43:10 -0700 (PDT)
To: John Fieber <jfieber@indiana.edu>
cc: Satoshi Asami <asami@freebsd.org>, hanai@astec.co.jp, doc@freebsd.org,
        core@freebsd.org
Subject: Re: Warning: SGML doc changes 
In-reply-to: Your message of "Tue, 03 Sep 1996 20:30:18 CDT."
             <Pine.BSI.3.95.960903201138.7948A-100000@fallout.campusview.indiana.edu> 
Date: Tue, 03 Sep 1996 18:43:10 -0700
Message-ID: <305.841801390@time.cdrom.com>
From: "Jordan K. Hubbard" <jkh@time.cdrom.com>
Sender: owner-doc@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

> Okay, that makes three possible work orders for groff:
> 
>   1. Upgrade to 1.10
>   2. Make it grok Japanese
>   3. Upgrade the mm macros
> 
> 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.

> 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
> versions of various files.  When generating a handbook for a
> particular language, the english versions will serve as a
> fallback of no native translation is identified for a particular
> part. 

Sounds good to me!

> I'm curious about the make world scenario for this.  Do we
> generate all possible language versions always, or just one
> based on the value of LANG at build time?

I think just based on LANG.  That'd let me make multiple passes
over the docs with different values for LANG when generating foreign
language boot floppies.

						Jordan