From lowell@be-well.ilk.org  Mon Aug 22 20:29:52 2005
Return-Path: <lowell@be-well.ilk.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3908016A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 22 Aug 2005 20:29:52 +0000 (GMT)
	(envelope-from lowell@be-well.ilk.org)
Received: from mail28.sea5.speakeasy.net (mail28.sea5.speakeasy.net [69.17.117.30])
	by mx1.FreeBSD.org (Postfix) with ESMTP id BE0F143D49
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 22 Aug 2005 20:29:51 +0000 (GMT)
	(envelope-from lowell@be-well.ilk.org)
Received: (qmail 8981 invoked from network); 22 Aug 2005 20:29:50 -0000
Received: from dsl092-078-145.bos1.dsl.speakeasy.net (HELO be-well.ilk.org) ([66.92.78.145])
          (envelope-sender <lowell@be-well.ilk.org>)
          by mail28.sea5.speakeasy.net (qmail-ldap-1.03) with SMTP
          for <FreeBSD-gnats-submit@freebsd.org>; 22 Aug 2005 20:29:50 -0000
Received: by be-well.ilk.org (Postfix, from userid 1147)
	id D3F7D3F3; Mon, 22 Aug 2005 16:29:49 -0400 (EDT)
Message-Id: <20050822202949.D3F7D3F3@be-well.ilk.org>
Date: Mon, 22 Aug 2005 16:29:49 -0400 (EDT)
From: Lowell Gilbert <freebsd-bugs-local@be-well.ilk.org>
Reply-To: Lowell Gilbert <freebsd-bugs-local@be-well.ilk.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] instructions on building web site don't work
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         85232
>Category:       docs
>Synopsis:       [patch] fdp-primer: instructions on building web site don't work
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    pav
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 22 20:30:25 GMT 2005
>Closed-Date:    Sun Feb 12 00:11:55 GMT 2006
>Last-Modified:  Sun Feb 12 00:11:55 GMT 2006
>Originator:     Lowell Gilbert
>Release:        FreeBSD 5.4-STABLE i386
>Organization:
<The Ilk
>Environment:
System: FreeBSD be-well.ilk.org 5.4-STABLE FreeBSD 5.4-STABLE #5: Sat Jul 9 11:00:44 EDT 2005 root@be-well.ilk.org:/usr/src/sys/i386/compile/BE-WELL i386


	
>Description:
	

I ran into some trouble building the website according to the FDP
instructions.  These changes solve the problem.  (Maybe the setting
for DESTDIR should be moved to the "environment variables" section,
but I wasn't sure.)

>How-To-Repeat:


builddir=/usr/scratch/lowell/webbuild

mkdir -p $builddir

cd $builddir || exit 1

if ! cvs -d /usr/scratch/scratch/ncvs -R co www doc ; then
    exit 1
fi

echo cvsup okay

cd {$builddir}/www/en || exit 1

ENGLISH_ONLY=yes
export ENGLISH_ONLY
OPENJADE="yes"
export OPENJADE

make all || exit

echo built okay

cd {$builddir}/www/en || exit 1

make DESTDIR=/usr/scratch/scratch/FreeBSD-Web-site install || exit 1

echo installed okay


	
>Fix:

	


--- doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml.ORIG  Mon Aug 22 15:55:36 2005
+++ doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml       Mon Aug 22 16:19:20 2005
@@ -87,11 +87,11 @@
       <step>
        <para>Change into the <filename role="directory">www/en</filename> directory, and run
          the &man.make.1; <maketarget>all</maketarget> target, to create
          the web pages.</para>
        
-       <screen>&prompt.root; <userinput>cd en</userinput>
+       <screen>&prompt.root; <userinput>cd www/en</userinput>
 &prompt.root; <userinput>make all</userinput></screen>
       </step>
     </procedure>
   </sect1>
   
@@ -107,13 +107,15 @@
       </step>
 
       <step>
        <para>Run the &man.make.1; <maketarget>install</maketarget> target,
          setting the <makevar>DESTDIR</makevar> variable to the name of the 
-         directory you want to install the files to.</para>
+         directory you want to install the files to.  You may need to
+         set this in the environment rather than on the command line.</para>
        
-       <screen>&prompt.root; <userinput>make DESTDIR=<replaceable>/usr/local/www</replaceable> install</userinput></screen>
+       <screen>&prompt.root; <userinput>DESTDIR=<replaceable>/usr/local/www</replaceable>; export DESTDIR</userinput>
+&prompt.root; <userinput>make DESTDIR=<replaceable>/usr/local/www</replaceable> install</userinput></screen>
       </step>
 
       <step>
        <para>If you have previously installed the web pages into the same
          directory the install process will not have deleted any old or
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: pav 
State-Changed-When: Tue Jan 10 18:14:13 UTC 2006 
State-Changed-Why:  
Are you sure about the DESTDIR change? The old way works fine for me. 


Responsible-Changed-From-To: freebsd-doc->pav 
Responsible-Changed-By: pav 
Responsible-Changed-When: Tue Jan 10 18:14:13 UTC 2006 
Responsible-Changed-Why:  
Poke 

http://www.freebsd.org/cgi/query-pr.cgi?pr=85232 
State-Changed-From-To: feedback->closed 
State-Changed-By: pav 
State-Changed-When: Sun Feb 12 00:11:46 UTC 2006 
State-Changed-Why:  
Feedback timeout 

http://www.freebsd.org/cgi/query-pr.cgi?pr=85232 
>Unformatted:
