Changeset 32166 for trunk/doc-new


Ignore:
Timestamp:
Dec 18, 2007, 9:55:06 PM (12 years ago)
Author:
jmpp@…
Message:
  1. Makefile:
    • abstract all command calls into path'd variables so that the Makefile can work called off launchd without any PATH reliance;
    • in doing that, note that the xsltproc command is provided by the libxslt port and require it too (path'd under ${prefix} too, for consistency);
  2. README:
    • correct project naming case;
    • note that the libxslt port is also required to build the documentation.
Location:
trunk/doc-new
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/Makefile

    r31885 r32166  
    11# $Id$
    22# Makefile to generate the macports html guide and the man pages.
    3 # The ports 'docbook-xsl' and 'docbook-xml' have to be installed.
     3# The ports 'docbook-xsl', 'docbook-xml' and 'libxslt' have to be
     4# installed.
    45
    56# If your macports isn't installed in /opt/local you have to change PREFIX
     
    910# prefix of the macports installation:
    1011PREFIX ?= /opt/local
     12
     13# command abstraction variables:
     14MKDIR = /bin/mkdir
     15CP = /bin/cp
     16RM = /bin/rm
     17SED = /usr/bin/sed
     18XSLTPROC = $(PREFIX)/bin/xsltproc
    1119
    1220# data directories:
     
    4351
    4452guide:
    45         mkdir -p $(GUIDE-RESULT)
    46         cp $(GUIDE)/resources/$(STYLESHEET) $(GUIDE-RESULT)/$(STYLESHEET)
    47         cp $(GUIDE)/resources/images/* $(GUIDE-RESULT)/
    48         xsltproc --xinclude $(STRINGPARAMS) --output $(GUIDE-RESULT)/index.html \
     53        $(MKDIR) -p $(GUIDE-RESULT)
     54        $(CP) $(GUIDE)/resources/$(STYLESHEET) $(GUIDE-RESULT)/$(STYLESHEET)
     55        $(CP) $(GUIDE)/resources/images/* $(GUIDE-RESULT)/
     56        $(XSLTPROC) --xinclude $(STRINGPARAMS) --output $(GUIDE-RESULT)/index.html \
    4957            $(GUIDE-XSL) $(GUIDE-SRC)/guide.xml
    5058
    5159man:
    52         mkdir -p $(MAN-RESULT)
    53         mkdir -p $(MAN-TMP)
    54         cp $(GUIDE-SRC)/portfile-*.xml $(MAN-TMP)
    55         sed -i "" 's|<section|<refsection|g' $(MAN-TMP)/*
    56         sed -i "" 's|</section>|</refsection>|g' $(MAN-TMP)/*
    57         xsltproc --xinclude --output $(MAN-RESULT) $(MAN-XSL) \
     60        $(MKDIR) -p $(MAN-RESULT)
     61        $(MKDIR) -p $(MAN-TMP)
     62        $(CP) $(GUIDE-SRC)/portfile-*.xml $(MAN-TMP)
     63        $(SED) -i "" 's|<section|<refsection|g' $(MAN-TMP)/*
     64        $(SED) -i "" 's|</section>|</refsection>|g' $(MAN-TMP)/*
     65        $(XSLTPROC) --xinclude --output $(MAN-RESULT) $(MAN-XSL) \
    5866            $(MAN-SRC)/port.1.xml \
    5967            $(MAN-SRC)/portfile.7.xml \
    6068            $(MAN-SRC)/portgroup.7.xml \
    6169            $(MAN-SRC)/porthier.7.xml
    62         rm -r $(MAN-TMP)
     70        $(RM) -r $(MAN-TMP)
    6371
    6472clean:
    65         rm -rf $(GUIDE-RESULT)
    66         rm -rf $(MAN-RESULT)
    67         rm -rf $(MAN-TMP)
     73        $(RM) -rf $(GUIDE-RESULT)
     74        $(RM) -rf $(MAN-RESULT)
     75        $(RM) -rf $(MAN-TMP)
  • trunk/doc-new/README

    r29265 r32166  
    1 This is the macports documentation directory.
     1This is the MacPorts documentation directory.
    22
    33To generate it you have to checkout the whole "trunk/doc-new" directory and
    4 you need the "docbook-xsl" and "docbook-xml" ports. If your port installation
    5 isn't in /opt/local look at "Makefile" how you have to change this setup.
     4you need the "docbook-xsl", "docbook-xml" and "libxslt" ports. If your port
     5installation isn't in /opt/local look at "Makefile" how you have to change
     6this setup.
    67
    78To generate the guide and the man pages just use "make" in this directory.
Note: See TracChangeset for help on using the changeset viewer.