docs/85232: [PATCH] instructions on building web site don't work

[Lowell Gilbert]

>Number:         85232
>Category:       docs
>Synopsis:       [PATCH] instructions on building web site don't work
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 22 20:30:25 GMT 2005
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted: