From owner-freebsd-doc@FreeBSD.ORG Sun Nov 27 06:10:12 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6A3AF106566C for ; Sun, 27 Nov 2011 06:10:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4F3798FC0A for ; Sun, 27 Nov 2011 06:10:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id pAR6ACSu053270 for ; Sun, 27 Nov 2011 06:10:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id pAR6ACjj053269; Sun, 27 Nov 2011 06:10:12 GMT (envelope-from gnats) Date: Sun, 27 Nov 2011 06:10:12 GMT Message-Id: <201111270610.pAR6ACjj053269@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Manolis Kiagias Cc: Subject: Re: docs/162862: DESTDIR environment variable setting is not correct for apache22 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Manolis Kiagias List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 27 Nov 2011 06:10:12 -0000 The following reply was made to PR docs/162862; it has been noted by GNATS. From: Manolis Kiagias To: Mniyardfa Jotawski Cc: freebsd-doc@freebsd.org, bug-followup@FreeBSD.org Subject: Re: docs/162862: DESTDIR environment variable setting is not correct for apache22 Date: Sun, 27 Nov 2011 08:09:59 +0200 This is a multi-part message in MIME format. --------------060207050906090607080501 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit On 27/11/2011 5:33 πμ, Mniyardfa Jotawski wrote: > > > On Sat, Nov 26, 2011 at 6:09 PM, Manolis Kiagias > > wrote: > > On 26/11/2011 1:07 πμ, Mniyardfa Jotawski wrote: >> 2011/11/25 Manolis Kiagias > > >> >> Hi, >> >> >> Hi, >> >> The example is not specific to apache22 or in fact any >> specific web server. You don't have to use apache to serve >> FreeBSD web pages. The /usr/local/www is used as a common >> preference (or hint) as /usr is the largest partition on most >> FreeBSD systems following the default installation scheme. >> You are supposed to know how to install / configure a web >> server and adapt these instructions to your specific >> installation. >> IMHO, if we add apache specific information to this section >> we will also have to add more sections describing basic >> configuration for serving the pages (like setting >> DocumentRoot, encoding etc.). I believe these are out of >> scope for this document. >> >> >> I did agree with your opinion but since I specifically aimed to >> apache2, as I wrote in my Problem Description: , that requires >> that documents to serve should be in (or under) DocumentRoot >> which is /usr/local/www/apache22. But once I follow suggestion >> in FDP Primer chapter 8.3, that installs all documents to >> /usr/local/www/data. In this case, I have to create apache22 >> subdirectory under what DESTDIR environment variable points to >> and mv all data/ into that in order for my apache2 to start quietly. > > What you would really need to do is change the DESTDIR shown in > the example to: > > env DESTDIR=/usr/local/www/apache22 make install > > As I said, the example is not to be taken literally. DESTDIR > should be set to your own DocumentRoot (or whatever is called by > the web server used) and not copied directly from fdp-primer. > > >> >> Anyway, I also see that there will be an endless Notes to mention >> to the readers if we wrote to a specific web-server like apache >> as you said me. >> >> May be that we put a few words to mention further works after >> ``make all install'' for some specific server or all documents >> will have to be installed to ~/public_html/data otherwise. >> > > Not necessary if DESTDIR is set correctly beforehand > > >> Many thanks indeed for your time. >> >> Apologized me for disturbing and apologized me for my English too. >> >> >> > > You are not disturbing, you are trying to make FreeBSD better! Thanks! > > > Hi, > > All in all, I do agree with you but I found that the whole documents > will be placed under ~/public_html/data if DESTDIR were not passed to > make command line. Even one passed some value for DESTDIR to make > command line, the whole documents still be placed under > ${DESTDIR}/data regardless of any web servers used. > > > Should a few words mention this to the readers ? > > Really apologized me indeed. This is my limitation, my English. > > With Best Regards, > psr > > Ah, I see your point now. It's true, the actual install directory is $DESTDIR/data. I'll make sure this gets mentioned in the fdp-primer. Best, Manolis --------------060207050906090607080501 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 8bit On 27/11/2011 5:33 πμ, Mniyardfa Jotawski wrote:


On Sat, Nov 26, 2011 at 6:09 PM, Manolis Kiagias <sonic2000gr@gmail.com> wrote:
On 26/11/2011 1:07 πμ, Mniyardfa Jotawski wrote:
2011/11/25 Manolis Kiagias <sonic2000gr@gmail.com>
Hi,


Hi,

 
The example is not specific to apache22 or in fact any specific web server. You don't have to use apache to serve FreeBSD web pages. The /usr/local/www is used as a common preference (or hint) as /usr is the largest partition on most FreeBSD systems following the default installation scheme. You are supposed to know how to install / configure a web server and adapt these instructions to your specific installation.
IMHO, if we add apache specific information to this section we will also have to add more sections describing  basic configuration for serving the pages (like setting DocumentRoot, encoding etc.). I believe these are out of scope for this document.


I did agree with your opinion but since I specifically aimed to apache2, as I wrote in my Problem Description: , that requires that documents to serve should be in (or under) DocumentRoot which is /usr/local/www/apache22.  But once I follow suggestion in FDP Primer chapter 8.3, that installs all documents to /usr/local/www/data.  In this case, I have to create apache22 subdirectory under what DESTDIR environment variable points to and mv all data/ into that in order for my apache2 to start quietly.

What you would really need to do is change the DESTDIR shown in the example to:

env DESTDIR=/usr/local/www/apache22 make install

As I said, the example is not to be taken literally.  DESTDIR should be set to your own DocumentRoot (or whatever is called by the web server used) and not copied directly from fdp-primer.



Anyway, I also see that there will be an endless Notes to mention to the readers if we wrote to a  specific web-server like apache as you said me.

May be that we put a few words to mention further  works after ``make all install''  for some specific server or all documents will have to be installed to ~/public_html/data otherwise.


Not necessary if DESTDIR is set correctly beforehand


Many thanks indeed for your time.

Apologized me for disturbing and apologized me for my English too.




You are not disturbing, you are trying to make FreeBSD better! Thanks!

Hi,

All in all, I do agree with you but I found that the whole documents will be placed under ~/public_html/data if  DESTDIR were not passed to make command line.  Even one passed some value for DESTDIR to make command line, the whole documents still be placed under ${DESTDIR}/data regardless of any web servers used.


Should a few words mention this to the readers ?

Really apologized me indeed.  This is my limitation, my English.

With Best Regards,
psr



Ah, I see your point now.  It's true, the actual install directory is $DESTDIR/data. I'll make sure this gets mentioned in the fdp-primer.

Best,
Manolis
--------------060207050906090607080501--