From owner-freebsd-doc  Tue Mar 28  9:41:13 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from icc.cgu.chel.su (gw.cgu.chel.su [195.54.14.5])
	by hub.freebsd.org (Postfix) with ESMTP
	id 35EBA37B6DD; Tue, 28 Mar 2000 09:41:03 -0800 (PST)
	(envelope-from uucp@mail.cgu.chel.su)
Received: from mail.cgu.chel.su (mail.cgu.chel.su [195.54.14.68])
	by icc.cgu.chel.su (8.9.3/8.9.2/$Revision: 1.4 $) with ESMTP id XAA53897;
	Tue, 28 Mar 2000 23:40:45 +0600 (ESS)
	(envelope-from uucp@mail.cgu.chel.su)
Received: from mps.UUCP (uucp@localhost)
	by mail.cgu.chel.su (8.9.3/8.8.6) with UUCP id XAA60148;
	Tue, 28 Mar 2000 23:40:44 +0600 (ESS)
Received: by mps.cgu.chel.su (UUPC/@ v6.14g, 06Jun95)
          id AA30925; Tue, 28 Mar 2000 23:14:49 GMT (+05)
To: nik@freebsd.org
Cc: freebsd-doc@freebsd.org
References: <20000328015222.A6172@kilt.nothing-going-on.org>
Message-Id: <AAvAHuuCw6@mps.cgu.chel.su>
Organization: Andy at home
From: "Andrey Zakhvatov" <andy@mps.cgu.chel.su>
Date: Tue, 28 Mar  0 23:14:49 +0300
X-Mailer: BML [MS/DOS Beauty Mail v1.36h]
Subject: Re: doc/ tree tagging
Lines: 40
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Hello,

>   > What about:
>   >   1) Create subtree exclusively for man pages (partially already
>   >      there - share/man), a-la doc/ tree (i.e. with different languages
>   >      in mind).
>   >
>   >   2) Move all man pages from utilities sources to this directory and
>   >      track them here.
>   >
>   > I think it can help to simplify tracking man pages for translation teams.
>
>   Just to be sure I understand this correctly. . .
>
>   Do you mean moving things like src/bin/cat.1 to src/share/man/man1/cat.1,
>   or, more likely, src/share/en_US.ISO_8859-1/man/man1/cat.1 ?
    Yes, but I agree with you, it's practically impossible.

>   Or are you just talking about creating new directories under doc/<lang> ?
    I'll create some for Russian man pages when I'll start to translate them,
but what branch I must tracking? STABLE or CURRENT, or both (like official
English pages)?

>   If it's the former, I very strongly doubt you'll get a change of that
>   magnitude past everyone else.  I can see the benefits from a translators
>   point of view, but I don't think everyone else will think it is worth the
>   upheavel.  I could be wrong.
    Yes, maybe it's harder for coders to change *.{c|h} files in one
directory and man pages in another, but who knows?
    If we have strong agreement, that DocProj is little different from
SrcProj ;) and man pages belong to DocProj, then it's good way for creating
language-specific manpages-${LANG} parts of distribution.  But.. I guess
not this time, so little translators, so many docs.. ;)

>   If you mean the latter, we already do something like that with the Japanese
>   manual pages.
    Yeah, I'll take that like a pattern for future work.


Sincerely yours, Andy.


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message