1#! /bin/sh
2
3: "${SED=sed}"
4XMLSTARLET=$1
5STAR_NAME=`echo xml | ${SED} "$transform"`
6
7{
8echo ""
9echo ""
10echo "                                           XMLSTARLET USER'S GUIDE"
11echo ""
12echo "                                  see also http://xmlstar.sourceforge.net/"
13echo ""
14echo ""
15
16echo ""
17echo ""
18echo "1. BASIC COMMAND LINE OPTIONS"
19echo "===================================================="
20echo ""
21echo "$STAR_NAME --help"
22$SED '/^#/d' src/usage.txt
23
24echo ""
25echo ""
26echo ""
27echo "2. Select/Query XML documents"
28echo "===================================================="
29echo ""
30echo "$STAR_NAME sel --help"
31$SED '/^#/d' src/select-usage.txt
32
33echo ""
34echo ""
35echo ""
36echo "3. Editing XML documents"
37echo "===================================================="
38echo ""
39echo "$STAR_NAME ed --help"
40$SED '/^#/d' src/edit-usage.txt
41
42echo ""
43echo ""
44echo ""
45echo "4. Using XSLT to transform XML documents"
46echo "===================================================="
47echo ""
48echo "$STAR_NAME tr --help"
49$SED '/^#/d' src/trans-usage.txt
50
51echo ""
52echo ""
53echo ""
54echo "5. Formatting XML documents"
55echo "===================================================="
56echo ""
57echo "$STAR_NAME fo --help"
58$SED '/^#/d' src/format-usage.txt
59
60echo ""
61echo ""
62echo ""
63echo "6. Validating XML documents"
64echo "===================================================="
65echo ""
66echo "$STAR_NAME val --help"
67$SED '/^#/d' src/validate-usage.txt
68
69echo ""
70echo ""
71echo ""
72echo "7. Displaying structure of XML documents"
73echo "===================================================="
74echo ""
75echo "$STAR_NAME el --help"
76$SED '/^#/d' src/elem-usage.txt
77
78echo ""
79echo ""
80echo ""
81echo ""
82echo "8. Escape/Unescape special XML characters"
83echo "===================================================="
84echo ""
85echo "$STAR_NAME esc --help"
86$SED '/^#/d' src/escape-usage.txt
87
88echo ""
89echo ""
90echo ""
91echo ""
92echo "9. List directory as XML"
93echo "===================================================="
94echo ""
95echo "$STAR_NAME ls --help"
96$SED '/^#/d' src/ls-usage.txt
97
98echo ""
99echo ""
100echo ""
101echo ""
102echo "10. XML canonicalization"
103echo "===================================================="
104echo ""
105echo "$STAR_NAME c14n --help"
106$SED '/^#/d' src/c14n-usage.txt
107
108echo ""
109echo ""
110echo ""
111echo ""
112echo "11. Convert XML into PYX format (based on ESIS - ISO 8879)"
113echo "===================================================="
114echo ""
115echo "$STAR_NAME pyx --help"
116$SED '/^#/d' src/pyx-usage.txt
117
118echo ""
119echo ""
120echo ""
121echo ""
122echo "12. Examples:"
123echo "===================================================="
124echo ""
125echo "Input1"
126echo "examples/xml/table.xml"
127echo ""
128cat "$srcdir"/examples/xml/table.xml
129echo ""
130echo ""
131echo "Input2"
132echo "examples/xml/tab-obj.xml"
133echo ""
134cat "$srcdir"/examples/xml/tab-obj.xml
135echo ""
136echo ""
137echo "Input3"
138echo "examples/html/hello1.html"
139echo ""
140cat "$srcdir"/examples/html/hello1.html
141echo ""
142echo ""
143echo "Input4"
144echo "examples/sgml/docbook1.sgml"
145echo ""
146cat "$srcdir"/examples/sgml/docbook1.sgml
147echo ""
148echo ""
149echo "Stylesheet1"
150echo "examples/xsl/sum1.xsl"
151echo ""
152cat "$srcdir"/examples/xsl/sum1.xsl
153echo ""
154echo ""
155echo "Stylesheet2"
156echo "examples/xsl/hello1.xsl"
157echo ""
158cat "$srcdir"/examples/xsl/hello1.xsl
159echo ""
160echo ""
161echo "Stylesheet3"
162echo "examples/xsl/param1.xsl"
163echo ""
164cat "$srcdir"/examples/xsl/param1.xsl
165echo ""
166echo ""
167
168echo ""
169
170for eg in "$srcdir"/examples/*[0-9]
171do
172	if [ -x "$eg" ]
173	then
174		echo "Command:"
175		sed -e '/^#!/d' "$eg"
176		echo "Result Output:"
177		cat "$srcdir"/examples/results/`basename $eg`.out
178		echo ""
179		echo ""
180	fi
181done
182
183echo ""
184} | $SED -e "s:\./xmlstarlet:$STAR_NAME:g; s:PROG:$STAR_NAME:g"
185
186
187