Changeset 98867

Timestamp:

Oct 19, 2012, 7:37:59 AM (12 years ago)

Author:

jmr@…

Message:

doc-new: remove PDF in "make clean", and add some documentation regarding dblatex (#35999)

Location:

trunk/doc-new

Files:

• Makefile (modified) (4 diffs)
• README (modified) (1 diff)

trunk/doc-new/Makefile

@@ -3 +3 @@
 # 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
@@ -57 +58 @@
 .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).
@@ -112 +113 @@
         $(TCLSH) toc-for-chunked.tcl $(GUIDE_RESULT_CHUNK)
 
+# Generate the guide as a PDF.
 guide-dblatex: SUFFIX = pdf
 guide-dblatex:
@@ -158 +160 @@
         $(RM) -rf $(GUIDE)/resources/xsl
         $(RM) -rf $(GUIDE_RESULT)
+        $(RM) -rf $(GUIDE_RESULT_DBLATEX)
         $(RM) -rf $(MAN_RESULT)
         $(RM) -rf $(MAN_TMP)

trunk/doc-new/README

@@ -3 +3 @@
 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.