svn commit: samba-docs r1265 - in trunk/build: .
ab at samba.org
ab at samba.org
Sun Apr 13 20:11:28 GMT 2008
Author: ab
Date: 2008-04-13 20:11:27 +0000 (Sun, 13 Apr 2008)
New Revision: 1265
WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=1265
Log:
Add first cut at networkless build instructions for samba-docs
Added:
trunk/build/README
trunk/build/catalog.xml.in
Removed:
trunk/build/catalog.xml
Modified:
trunk/build/
Changeset:
Property changes on: trunk/build
___________________________________________________________________
Name: svn:ignore
+ catalog.xml
Added: trunk/build/README
===================================================================
--- trunk/build/README 2008-04-13 19:54:15 UTC (rev 1264)
+++ trunk/build/README 2008-04-13 20:11:27 UTC (rev 1265)
@@ -0,0 +1,26 @@
+HOW TO BUILD SAMBA DOCUMENTATION WITHOUT NETWORK ACCESS
+-------------------------------------------------------
+
+Samba documentation depends on several DTD schema specification and XML files
+that are stored in samba-web Subversion repository and hosted publicly through
+Samba.org web-site. In order to do networkless builds a local XML catalog should
+provide a local replica of those files.
+
+The easiest way to provide them is to fetch samba-docs subversion repository.
+In this directory (build/) we reference samba-web repository as external source
+so that Subversion fetches current state of DTDs out of samba-web repository.
+You then need to point xsltproc utility to use locally-provided version of DTDs.
+
+It is done by setting XML_CATALOG_FILES variable:
+
+export XML_CATALOG_FILES="file:///etc/xml/catalog file://$(pwd)/build/catalog.xml"
+
+where $(pwd)/build/catalog.xml is generated from $(pwd)/build/catalog.xml.in by a
+following command:
+
+cat $(pwd)/build/catalog.xml.in | sed -e "s|@BUILDDIR@|$(pwd)|g" > $(pwd)/build/catalog.xml
+
+where $(pwd) assumes that you're in the top-level directory of samba-docs.
+
+After those steps a regular make process can be followed and xsltproc will automatically
+use locally-provided DTDs through catalog.xml we've created.
Deleted: trunk/build/catalog.xml
===================================================================
--- trunk/build/catalog.xml 2008-04-13 19:54:15 UTC (rev 1264)
+++ trunk/build/catalog.xml 2008-04-13 20:11:27 UTC (rev 1265)
@@ -1,14 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
-<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
-
-<!-- XML Catalog file for SAMBA. -->
-
- <rewriteURI
- uriStartString="http://www.samba.org/samba/DTD/"
- rewritePrefix="file://@DIR@/build/DTD/"/>
-
- <rewriteURI
- uriStartString="http://www.gnu.org/licenses/"
- rewritePrefix="file://@DIR@/Samba3-ByExample/"/>
-</catalog>
Copied: trunk/build/catalog.xml.in (from rev 1264, trunk/build/catalog.xml)
===================================================================
--- trunk/build/catalog.xml 2008-04-13 19:54:15 UTC (rev 1264)
+++ trunk/build/catalog.xml.in 2008-04-13 20:11:27 UTC (rev 1265)
@@ -0,0 +1,14 @@
+<?xml version="1.0"?>
+<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
+<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
+
+<!-- XML Catalog file for SAMBA. -->
+
+ <rewriteURI
+ uriStartString="http://www.samba.org/samba/DTD/"
+ rewritePrefix="file://@BUILDDIR@/build/DTD/"/>
+
+ <rewriteURI
+ uriStartString="http://www.gnu.org/licenses/"
+ rewritePrefix="file://@BUILDDIR@/Samba3-ByExample/"/>
+</catalog>
More information about the samba-cvs
mailing list