From owner-freebsd-doc@FreeBSD.ORG  Mon May 30 16:50:49 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BB4C816A41C;
	Mon, 30 May 2005 16:50:49 +0000 (GMT)
	(envelope-from yar@comp.chem.msu.su)
Received: from comp.chem.msu.su (comp.chem.msu.su [158.250.32.97])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 22D8C43D1D;
	Mon, 30 May 2005 16:50:48 +0000 (GMT)
	(envelope-from yar@comp.chem.msu.su)
Received: from comp.chem.msu.su (localhost [127.0.0.1])
	by comp.chem.msu.su (8.13.3/8.13.3) with ESMTP id j4UGolP2063919;
	Mon, 30 May 2005 20:50:47 +0400 (MSD)
	(envelope-from yar@comp.chem.msu.su)
Received: (from yar@localhost)
	by comp.chem.msu.su (8.13.3/8.13.3/Submit) id j4UGolaT063918;
	Mon, 30 May 2005 20:50:47 +0400 (MSD) (envelope-from yar)
Date: Mon, 30 May 2005 20:50:46 +0400
From: Yar Tikhiy <yar@comp.chem.msu.su>
To: Hiroki Sato <hrs@FreeBSD.org>
Message-ID: <20050530165046.GA63216@comp.chem.msu.su>
References: <20050530141615.GA55963@comp.chem.msu.su>
	<20050531.002515.125576180.hrs@allbsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20050531.002515.125576180.hrs@allbsd.org>
User-Agent: Mutt/1.5.9i
Cc: freebsd-doc@FreeBSD.org
Subject: Re: Building documents outside doc/ tree impossible?
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 30 May 2005 16:50:49 -0000

On Tue, May 31, 2005 at 12:25:15AM +0900, Hiroki Sato wrote:
> Yar Tikhiy <yar@comp.chem.msu.su> wrote
>   in <20050530141615.GA55963@comp.chem.msu.su>:
> 
> ya> My memory fails to tell me reliably if this was ever possible, but
> ya> I've just found that building a document outside the doc/ tree fails
> ya> due to errors regarding mailing list entities.  Of course, I'm
> ya> setting DOC_PREFIX to the actual location of the doc/ tree.  Is
> ya> this by design, due to a bug, or my fault?  I've failed to find any
> ya> suspicious Makefile.inc files in the tree or whatever.
> 
>  You have to set both of $DOC_PREFIX and
>  $LANGCODE (LANGCODE=en_US.ISO8859-1, for example).

This indeed cures my problem.  Thanks a lot!

Should we document this point somewhere?
Google doesn't think it is documented already ;-(
And which knobs should be documented along with these to keep
the things logical and comprehensive?
Sorry, I like to write and commit documentation periodically,
but I have little knowledge about our FDP machinery.

-- 
Yar