From owner-cvs-all  Thu Aug 26 12:37:23 1999
Delivered-To: cvs-all@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP
	id 211D715454; Thu, 26 Aug 1999 12:37:15 -0700 (PDT)
	(envelope-from nik@FreeBSD.org)
Received: (from nik@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id MAA83481;
	Thu, 26 Aug 1999 12:37:14 -0700 (PDT)
	(envelope-from nik@FreeBSD.org)
Message-Id: <199908261937.MAA83481@freefall.freebsd.org>
From: Nik Clayton <nik@FreeBSD.org>
Date: Thu, 26 Aug 1999 12:37:14 -0700 (PDT)
To: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject: cvs commit: doc/share/mk docproj.docbook.mk
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk

nik         1999/08/26 12:37:14 PDT

  Modified files:
    share/mk             docproj.docbook.mk 
  Log:
  1. Fix a subtle bug in the use of ${DOC}.  If you ran make(1) and defined
     ${FORMATS} on the command line then it would assume that you wanted to
     build a document in the current directory, based on the setting of ${DOC}.
     If ${DOC} wasn't set, it defaulted to the name of the current directory.
  
     Any Makefile that includes this, and expects to have documentation built
     in the current directory must now explicitly define DOC.  All the current
     ones do anyway.  This should be a non-problem when docproj.docbook.mk is
     split out in to smaller, more modular files.
  
     Move the comments for DOC from the non-mandatory to the mandatory
     section.
  
  2. Clarify the meaning of DESTDIR, it's changed a little bit since it was
     first documented.
  
  3. Initial, tentative support for building pkg_* packages from the
     formatted documentation.  Needs work, but I've had the patch out for
     review for a couple of days, and no comments either way -- so if
     people hate it, this should at least spur them on to say so.
  
         # cd /path/to/doc/to/turn/into/a/package
         # touch COMMENT DESCR
         # make 'FORMATS=this that and the other' package
  
     to build 'n' packages, one per format.  "make install" is run as part
     of the package dependency, so this will overwrite documentation you
     have already got installed.
  
  4. Remove DOC_INSTALL_PREFIX.  Should have been DOCDIR from the start.
  
  Revision  Changes    Path
  1.10      +60 -26    doc/share/mk/docproj.docbook.mk



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message