File: README

package info (click to toggle)
samba 2%3A3.2.5-4lenny15
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 124,704 kB
  • ctags: 69,181
  • sloc: ansic: 564,153; xml: 219,271; sh: 11,039; perl: 4,458; makefile: 4,301; python: 1,975; cpp: 1,224; exp: 1,147; yacc: 881; awk: 557; csh: 58; sed: 45
file content (26 lines) | stat: -rw-r--r-- 1,267 bytes parent folder | download | duplicates (17)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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.