File: README2

package info (click to toggle)
libxalan2-java 2.7.1-5
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 19,468 kB
  • ctags: 26,006
  • sloc: java: 175,784; xml: 28,073; sh: 164; jsp: 43; makefile: 43; sql: 6
file content (100 lines) | stat: -rw-r--r-- 3,151 bytes parent folder | download | duplicates (5)
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
README.APACHE
=====================================================================
 * Copyright 2004 The Apache Software Foundation.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
=====================================================================
Entire source tree and support packages are located in the single jar
file 'apache.jar'. 


Installation
-------------

(1) create directory [Root], unpack 'apache.jar' there.
	ex) % cd /tmp; mkdir xsltc_apache 
	    % cd xsltc_apache
        copy apache.jar to xsltc_apache directory
	    % jar xvf apache.jar 
	cleanup
	    % rm -rf META-INF apache.jar

    Unpacking the jar file will result in the following tree:

	[Root]
	  External/
	    BCEL/                ... contains BCEL.jar
	    JLex/                ... contains JLex.jar
	    java_cup/            ... contains java_cup.jar, runtime/runtime.jar
	    xml-tr2/             ... contains xml.jar
	  bin/
	    xslt
	    xsltc
	  doc/
	    api/                 ... contains javadoc for api
	  src/
	    GNUmakefile
	    GNUmakefile.allinc
	    docs/
	      LICENSE.txt
	      Message.txt
	      README
	      README.api
	      README.xslt
	      README.xsltc
	      XSLTCprn_lg.txt*
	      xsltcA3.txt
	    org/
	      apache/
		xalan/
		  xsltc/
		     (src tree)  ... all the source code files


    The 'src tree' is a hierarchy of the following packages:
	org.apache.xalan.xsltc
	org.apache.xalan.xsltc.compiler
	org.apache.xalan.xsltc.compiler.util
	org.apache.xalan.xsltc.dom
	org.apache.xalan.xsltc.runtime
	org.apache.xalan.xsltc.util
	org.apache.xalan.xsltc.util.getopt


(2) make bin programs executable
	    % chmod +x bin/*

(3) set env variable to point to top of directory [Root]
	ex) % setenv XSLT /tmp/xsltc_apache

(4) compile sources (uses gnu make and the provides 'GNUmakefile'). This
    will create java classes in [Root]/classes, e.g. /tmp/xsltc_apache/classes.
    (No need to set your CLASSPATH variable.)
    
	ex) % cd src; gmake again

    Note: the 'again' target forces everything to be built from scratch,
    including the java_cup source files. Subsequent builds can be done
    using the 'classes' target. 

(5) make the javadoc
	ex) % gmake jdoc

(6) add bin directory to your executable path, 
	ex) % set path=($XSLT/bin $path)

(7) test distribution, given a stylesheet (test.xsl) and an input xml doc
    (test.xml), and be sure current working directory (.) is in your
    CLASSPATH.
 	% xsltc test.xsl		... creates translet, test.class
	% xslt test.xml test		... runs translet on xml input