[98867] trunk/doc-new

[jmr at macports.org]

Revision: 98867
          http://trac.macports.org//changeset/98867
Author:   jmr at macports.org
Date:     2012-10-19 00:37:59 -0700 (Fri, 19 Oct 2012)
Log Message:
-----------
doc-new: remove PDF in "make clean", and add some documentation regarding dblatex (#35999)

Modified Paths:
--------------
    trunk/doc-new/Makefile
    trunk/doc-new/README

Modified: trunk/doc-new/Makefile
===================================================================
--- trunk/doc-new/Makefile	2012-10-19 01:23:23 UTC (rev 98866)
+++ trunk/doc-new/Makefile	2012-10-19 07:37:59 UTC (rev 98867)
@@ -2,6 +2,7 @@
 
 # Makefile to generate the MacPorts HTML guide and the man pages.
 # The ports 'docbook-xsl', 'docbook-xml' and 'libxslt' have to be installed.
+# For the guide-dblatex target, the 'dblatex' port is also required.
 
 # If your MacPorts isn't installed in /opt/local you have to change PREFIX
 # here.
@@ -56,7 +57,7 @@
 
 .PHONY: all guide guide-chunked guide-dblatex man clean validate
 
-all: guide guide-chunked guide-dblatex man
+all: guide guide-chunked man
 
 # Generate the HTML guide using DocBook from the XML sources in $(GUIDE_SRC).
 guide:
@@ -111,6 +112,7 @@
 	# If someone knows a better way to do this please change it.
 	$(TCLSH) toc-for-chunked.tcl $(GUIDE_RESULT_CHUNK)
 
+# Generate the guide as a PDF.
 guide-dblatex: SUFFIX = pdf
 guide-dblatex:
 	$(MKDIR) -p $(GUIDE_RESULT_DBLATEX)
@@ -157,6 +159,7 @@
 clean:
 	$(RM) -rf $(GUIDE)/resources/xsl
 	$(RM) -rf $(GUIDE_RESULT)
+	$(RM) -rf $(GUIDE_RESULT_DBLATEX)
 	$(RM) -rf $(MAN_RESULT)
 	$(RM) -rf $(MAN_TMP)
 	$(RM) -rf $(MAN_XSL)

Modified: trunk/doc-new/README
===================================================================
--- trunk/doc-new/README	2012-10-19 01:23:23 UTC (rev 98866)
+++ trunk/doc-new/README	2012-10-19 07:37:59 UTC (rev 98867)
@@ -2,8 +2,11 @@
 
 To generate it you have to checkout the whole "trunk/doc-new" directory and
 you need the "docbook-xsl", "docbook-xml" and "libxslt" ports. If your port
-installation isn't in /opt/local look at "Makefile" how you have to change
-this setup.
+installation isn't in /opt/local, edit or override the PREFIX Makefile
+variable.
 
 To generate the guide and the man pages just use "make" in this directory.
 Then they are generated in guide/html and man/man.
+
+To generate a PDF version of the guide, use "make guide-dblatex". This
+requires the "dblatex" port.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20121019/293f62bc/attachment-0001.html>