From owner-freebsd-doc@FreeBSD.ORG  Tue Feb 26 08:02:33 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id AF299284;
 Tue, 26 Feb 2013 08:02:33 +0000 (UTC)
 (envelope-from gabor@FreeBSD.org)
Received: from server.mypc.hu (server.mypc.hu [87.229.73.95])
 by mx1.freebsd.org (Postfix) with ESMTP id 4B2CC328;
 Tue, 26 Feb 2013 08:02:33 +0000 (UTC)
Received: from server.mypc.hu (localhost [127.0.0.1])
 by server.mypc.hu (Postfix) with ESMTP id 03C0A14D2508;
 Tue, 26 Feb 2013 09:02:31 +0100 (CET)
X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com
Received: from server.mypc.hu ([127.0.0.1])
 by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024)
 with LMTP id kalZiHb_EuQC; Tue, 26 Feb 2013 09:02:28 +0100 (CET)
Received: from [152.66.168.174] (dhcp-174.q.wlan.net.bme.hu [152.66.168.174])
 (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits))
 (No client certificate requested)
 by server.mypc.hu (Postfix) with ESMTPSA id 36B2214D242D;
 Tue, 26 Feb 2013 09:02:28 +0100 (CET)
Message-ID: <512C6C15.7080705@FreeBSD.org>
Date: Tue, 26 Feb 2013 09:02:29 +0100
From: Gabor Kovesdan <gabor@FreeBSD.org>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:17.0) Gecko/20130107 Thunderbird/17.0.2
MIME-Version: 1.0
To: Craig Rodrigues <rodrigc@FreeBSD.org>
Subject: Re: How to build FreeBSD doc web pages?
References: <CAG=rPVcM1=mL8qUOTAD3n4mkx9qsgM91GmF11_LYRVPu+evPPg@mail.gmail.com>
In-Reply-To: <CAG=rPVcM1=mL8qUOTAD3n4mkx9qsgM91GmF11_LYRVPu+evPPg@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: freebsd-doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/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: Tue, 26 Feb 2013 08:02:33 -0000

Em 24-02-2013 22:35, Craig Rodrigues escreveu:
> I am trying to fix some text in the FreeBSD docs,
> and am trying to build the FreeBSD docs and web pages
> so I can view the output HTML as I am fixing things.
There are three main use cases:

1, To build the whole documentation set (web and docs)
cd doc/en_US.ISO8859-1/htdocs
make all install DESTDIR=/home/gabor/public_html/webtest

2, To build documentation only (without web):
cd doc
make all install DOCDIR=/home/gabor/public_html/doc

3, Only build one specific article/book:
cd doc/en_US.ISO8859-1/article/foobar
make all install DOCDIR=/home/gabor/public_html/doc

Note the difference in using either DESTDIR or DOCDIR. (Yes, this is 
confusing and should be rethought. The doc build needs some improvements.)

Gabor