/usr/bin/diffoscope --timeout 7200 --html /srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/htp_1.19-8.diffoscope.html --text /srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/htp_1.19-8.diffoscope.txt --json /srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/htp_1.19-8.diffoscope.json --profile=- /srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/b1/htp_1.19-8_armhf.changes /srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/b2/htp_1.19-8

⊟

192 KB

/srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/b1/htp_1.19-8_armhf.changes vs.

/srv/reproducible-results/rbuild-debian/r-b-build.wIhAG2r8/b2/htp_1.19-8_armhf.changes ¶

⊟

264 B

Files ¶

⊟

192 KB

htp_1.19-8_armhf.deb ¶

⊟

452 B

file list ¶

⊟

563 B

control.tar.xz ¶

⊟

535 B

control.tar ¶

⊟

465 B

./control ¶

⊟

48.0 B

./md5sums ¶

⊟

30.0 B

./md5sums ¶

Files differ

⊟

191 KB

data.tar.xz ¶

⊟

191 KB

data.tar ¶

⊟

15.4 KB

file list ¶

⊟

8.48 KB

⊟

3.84 KB

⊟

5.02 KB

⊟

3.02 KB

⊟

4.17 KB

⊟

2.83 KB

⊟

10.8 KB

⊟

4.14 KB

⊟

13.4 KB

⊟

4.72 KB

⊟

14.7 KB

⊟

8.47 KB

⊟

21.7 KB

⊟

15.8 KB

⊟

4.38 KB

⊟

2.78 KB

⊟

6.94 KB

⊟

4.62 KB

⊟

4.38 KB

⊟

3.42 KB

⊟

8.53 KB

⊟

4.9 KB

⊟

17.7 KB

⊟

10.6 KB

⊟

4.2 KB

⊟

1.72 KB

⊟

3.1 KB

⊟

2.14 KB

⊟

5.1 KB

⊟

2.25 KB

⊟

8.51 KB

⊟

4.05 KB

⊟

4.75 KB

⊟

2.22 KB

⊟

7.62 KB

⊟

2.45 KB

⊟

14.3 KB

⊟

8.56 KB

⊟

7.43 KB

⊟

3.63 KB


Offset 1, 3 lines modified		Offset 1, 3 lines modified

1	·ed67a0e94085fc733397c7354a726286·69240·debug·optional·htp-dbgsym_1.19-8_armhf.deb	1	·ed67a0e94085fc733397c7354a726286·69240·debug·optional·htp-dbgsym_1.19-8_armhf.deb
2	·4f~~48562eea33ed7f8~~b4a0380836a27a8·11~~2856~~·web·optional·htp_1.19-8_armhf.deb	2	·05d5ffcf7f7cfe75a579b8403c88a4a6·111408·web·optional·htp_1.19-8_armhf.deb


Offset 1, 3 lines modified		Offset 1, 3 lines modified
1	-rw-r--r--···0········0········0········4·2020-06-14·23:21:19.000000·debian-binary	1	-rw-r--r--···0········0········0········4·2020-06-14·23:21:19.000000·debian-binary
2	-rw-r--r--···0········0········0·····3616·2020-06-14·23:21:19.000000·control.tar.xz	2	-rw-r--r--···0········0········0·····3620·2020-06-14·23:21:19.000000·control.tar.xz
3	-rw-r--r--···0········0········0···10~~9048~~·2020-06-14·23:21:19.000000·data.tar.xz	3	-rw-r--r--···0········0········0···107596·2020-06-14·23:21:19.000000·data.tar.xz


Offset 1, 12 lines modified		Offset 1, 12 lines modified
1	Package:·htp	1	Package:·htp
2	Version:·1.19-8	2	Version:·1.19-8
3	Architecture:·armhf	3	Architecture:·armhf
4	Maintainer:·Marcelo·Soares·Mota·<motasmarcelo@gmail.com>	4	Maintainer:·Marcelo·Soares·Mota·<motasmarcelo@gmail.com>
5	Installed-Size:·~~628~~	5	Installed-Size:·599
6	Depends:·libc6·(>=·2.34)	6	Depends:·libc6·(>=·2.34)
7	Section:·web	7	Section:·web
8	Priority:·optional	8	Priority:·optional
9	Homepage:·http://htp.sourceforge.net	9	Homepage:·http://htp.sourceforge.net
10	Description:·nice·HTML·pre-processor	10	Description:·nice·HTML·pre-processor
11	·htp·is·an·HTML·pre-processor.·It·is·designed·to·be·a·flexible·authoring·tool	11	·htp·is·an·HTML·pre-processor.·It·is·designed·to·be·a·flexible·authoring·tool
12	·that·can·easily·be·integrated·into·the·HTML·design·process.	12	·that·can·easily·be·integrated·into·the·HTML·design·process.


Offset 114, 41 lines modified		Offset 114, 35 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"tagname"</span>·<span·class="ebnf">[</span><span·class="htp-attrib">option</span>=<span·class="htp-string">"option1·<span·class="ebnf">[</span>option2·...<span·class="ebnf">]</span>"</span>·<span·class="ebnf">]</span>·<span·class="ebnf">[</span><span·class="htp-attrib">global</span><span·class="ebnf">]</span>·<span·class="ebnf">[</span><span·class="htp-attrib">expand</span><span·class="ebnf">]</span>></span><br>
122	~~ ·...·~~<span·class="htp-tag"><<a·href="~~use~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">~~use~~</a>·<span·class="htp-attrib">block</span>~~>~~</span> ...<br>	121	<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">BLOCK</a>·<span·class="htp-attrib">NAME</span>=<span·class="htp-string">"blockname"</span>·<span·class="ebnf">[</span><span·class="htp-att[·...·truncated·by·diffoscope;·len:·149,·SHA:·49dfd84ac7aca5220a5f1bed63f440279d146be0ec423b34a57498d1917cf24e·...·]<br>
		122	text·block<br>
123	<span·class="htp-tag"><<a·href="block~~def~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/~~blockdef~~</a>></span><br>	123	<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/BLOCK</a>></span><br>
124	<br>	124	<br>
125	</code></p>	125	</code></p>
126	<h2>synopsis</h2>	126	<h2>synopsis</h2>
127	<strong>ALTTEXT</strong>·declares·an·ALT·attribute·for·any·<A	127	<strong>ALTTEXT</strong>·declares·an·ALT·attribute·for·any·<A
128	HREF="img.html">IMG</A>·tag·with·a·SRC·matching·the·ALTTEXT·NAME.	128	HREF="img.html">IMG</A>·tag·with·a·SRC·matching·the·ALTTEXT·NAME.
129	Since·relative·paths·can·be·used·to·point·to·the·same·image,·only·the	129	Since·relative·paths·can·be·used·to·point·to·the·same·image,·only·the
130	filename·is·considered·in·all·comparisons.	130	filename·is·considered·in·all·comparisons.
131	<p>	131	<p>
132	When·an·IMG·tag·with·a·matching·source·is·encountered,·htp·will·add·an·ALT	132	When·an·IMG·tag·with·a·matching·source·is·encountered,·htp·will·add·an·ALT
133	attribute·only·if·one·is·not·already·present.··This·allows·for·ALT·text·to	133	attribute·only·if·one·is·not·already·present.··This·allows·for·ALT·text·to
134	be·overridden·on·specific·images·and·default·text·on·all·others.	134	be·overridden·on·specific·images·and·default·text·on·all·others.
135	<p>	135	<p>
136	For·example:	136	For·example:
137	··<p><code>	137	··<p><code>
		138	<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"tagname"</span>·<span·class="htp-attrib">[option</span>=<span·class="htp-string">"option1·[option2·...]"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">[global]</span>·<span·class="htp-attrib">[expand]</span>></span><br>
138	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"section"</span>·<span·class="htp-attrib">option</span>=<span·class="htp-string">"title"</span>></span><br>
139	· <span·class="htp-tag"><h1></span><span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">title</span>></span><span·class="htp-tag"></h1></span><br>
140	· <span·class="htp-tag"><p·<span·class="htp-attrib">class</span>=<span·class="htp-string">"section"</span>></span><br>
141	·~~ ~~·~~ ~~<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">block</span>></span><br>	139	·...·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">block</span>></span> ...<br>
142	· <span·class="htp-tag"></p></span><br>
143	~~ ·~~<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>	140	<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>
144	<br>	141	<br>
145	·<span·class="htp-tag"><section·<span·class="htp-attrib">title</span>=<span·class="htp-string">"My·Section"</span>></span><br>
146	· ·This·is·a·fancy·section.<br>
147	·<span·class="htp-tag"></section></span><br>
148	</code></p>	142	</code></p>
149	<p>	143	<p>
150	An·ALTTEXT·tag·with·a·name·but·no·text·attribute·removes·any·ALT	144	An·ALTTEXT·tag·with·a·name·but·no·text·attribute·removes·any·ALT
151	mapping·for·this·image.··Successing·IMG·tags·with·a·matching·SRC·name·are·not	145	mapping·for·this·image.··Successing·IMG·tags·with·a·matching·SRC·name·are·not
152	changed.	146	changed.
153	<p>	147	<p>
154	Since·this·is·useful·for·an·image·used·throughout·a·set·of·documents,	148	Since·this·is·useful·for·an·image·used·throughout·a·set·of·documents,


Offset 1, 27 lines modified		Offset 1, 27 lines modified
1	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./	1	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./
2	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/	2	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/
3	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/bin/	3	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/bin/
4	-rwxr-xr-x···0·root·········(0)·root·········(0)····42560·2020-06-14·23:21:19.000000·./usr/bin/htp	4	-rwxr-xr-x···0·root·········(0)·root·········(0)····42560·2020-06-14·23:21:19.000000·./usr/bin/htp
5	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/	5	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/
6	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/doc/	6	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/doc/
7	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/doc/htp/	7	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/doc/htp/
8	-rw-r--r--···0·root·········(0)·root·········(0)····10522·2020-06-14·23:21:19.000000·./usr/share/doc/htp/alttext.html	8	-rw-r--r--···0·root·········(0)·root·········(0)·····9546·2020-06-14·23:21:19.000000·./usr/share/doc/htp/alttext.html
9	-rw-r--r--···0·root·········(0)·root·········(0)·····1418·2020-06-14·23:21:19.000000·./usr/share/doc/htp/alttext.htp	9	-rw-r--r--···0·root·········(0)·root·········(0)·····1418·2020-06-14·23:21:19.000000·./usr/share/doc/htp/alttext.htp
10	-rw-r--r--···0·root·········(0)·root·········(0)·····~~946~~2·2020-06-14·23:21:19.000000·./usr/share/doc/htp/block.html	10	-rw-r--r--···0·root·········(0)·root·········(0)·····7882·2020-06-14·23:21:19.000000·./usr/share/doc/htp/block.html
11	-rw-r--r--···0·root·········(0)·root·········(0)······781·2020-06-14·23:21:19.000000·./usr/share/doc/htp/block.htp	11	-rw-r--r--···0·root·········(0)·root·········(0)······781·2020-06-14·23:21:19.000000·./usr/share/doc/htp/block.htp
12	-rw-r--r--···0·root·········(0)·root·········(0)·····~~9322~~·2020-06-14·23:21:19.000000·./usr/share/doc/htp/blockdef.html	12	-rw-r--r--···0·root·········(0)·root·········(0)·····8571·2020-06-14·23:21:19.000000·./usr/share/doc/htp/blockdef.html
13	-rw-r--r--···0·root·········(0)·root·········(0)·····1075·2020-06-14·23:21:19.000000·./usr/share/doc/htp/blockdef.htp	13	-rw-r--r--···0·root·········(0)·root·········(0)·····1075·2020-06-14·23:21:19.000000·./usr/share/doc/htp/blockdef.htp
14	-rw-r--r--···0·root·········(0)·root·········(0)·····4763·2020-06-14·23:21:19.000000·./usr/share/doc/htp/bugs.html	14	-rw-r--r--···0·root·········(0)·root·········(0)·····4763·2020-06-14·23:21:19.000000·./usr/share/doc/htp/bugs.html
15	-rw-r--r--···0·root·········(0)·root·········(0)······737·2020-06-14·23:21:19.000000·./usr/share/doc/htp/bugs.htp	15	-rw-r--r--···0·root·········(0)·root·········(0)······737·2020-06-14·23:21:19.000000·./usr/share/doc/htp/bugs.htp
16	-rw-r--r--···0·root·········(0)·root·········(0)······878·2020-06-14·23:21:19.000000·./usr/share/doc/htp/changelog.Debian.gz	16	-rw-r--r--···0·root·········(0)·root·········(0)······878·2020-06-14·23:21:19.000000·./usr/share/doc/htp/changelog.Debian.gz
17	-rw-r--r--···0·root·········(0)·root·········(0)····~~11816~~·2020-06-14·23:21:19.000000·./usr/share/doc/htp/comment.html	17	-rw-r--r--···0·root·········(0)·root·········(0)·····9560·2020-06-14·23:21:19.000000·./usr/share/doc/htp/comment.html
18	-rw-r--r--···0·root·········(0)·root·········(0)······676·2020-06-14·23:21:19.000000·./usr/share/doc/htp/comment.htp	18	-rw-r--r--···0·root·········(0)·root·········(0)······676·2020-06-14·23:21:19.000000·./usr/share/doc/htp/comment.htp
19	-rw-r--r--···0·root·········(0)·root·········(0)····13083·2020-06-14·23:16:46.000000·./usr/share/doc/htp/copyright	19	-rw-r--r--···0·root·········(0)·root·········(0)····13083·2020-06-14·23:16:46.000000·./usr/share/doc/htp/copyright
20	-rw-r--r--···0·root·········(0)·root·········(0)····1~~5161~~·2020-06-14·23:21:19.000000·./usr/share/doc/htp/def.html	20	-rw-r--r--···0·root·········(0)·root·········(0)····11794·2020-06-14·23:21:19.000000·./usr/share/doc/htp/def.html
21	-rw-r--r--···0·root·········(0)·root·········(0)·····3601·2020-06-14·23:21:19.000000·./usr/share/doc/htp/def.htp	21	-rw-r--r--···0·root·········(0)·root·········(0)·····3601·2020-06-14·23:21:19.000000·./usr/share/doc/htp/def.htp
22	-rw-r--r--···0·root·········(0)·root·········(0)·····8030·2020-06-14·23:21:19.000000·./usr/share/doc/htp/default.html	22	-rw-r--r--···0·root·········(0)·root·········(0)·····8030·2020-06-14·23:21:19.000000·./usr/share/doc/htp/default.html
23	-rw-r--r--···0·root·········(0)·root·········(0)·····3149·2020-06-14·23:21:19.000000·./usr/share/doc/htp/default.htp	23	-rw-r--r--···0·root·········(0)·root·········(0)·····3149·2020-06-14·23:21:19.000000·./usr/share/doc/htp/default.htp
24	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/doc/htp/examples/	24	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-06-14·23:21:19.000000·./usr/share/doc/htp/examples/
25	-rw-r--r--···0·root·········(0)·root·········(0)······536·2015-05-16·17:04:11.000000·./usr/share/doc/htp/examples/Makefile.sub	25	-rw-r--r--···0·root·········(0)·root·········(0)······536·2015-05-16·17:04:11.000000·./usr/share/doc/htp/examples/Makefile.sub
26	-rw-r--r--···0·root·········(0)·root·········(0)·····2404·2015-05-16·17:04:11.000000·./usr/share/doc/htp/examples/album.hti	26	-rw-r--r--···0·root·········(0)·root·········(0)·····2404·2015-05-16·17:04:11.000000·./usr/share/doc/htp/examples/album.hti
27	-rw-r--r--···0·root·········(0)·root·········(0)·····1087·2015-05-16·17:04:11.000000·./usr/share/doc/htp/examples/album.htt	27	-rw-r--r--···0·root·········(0)·root·········(0)·····1087·2015-05-16·17:04:11.000000·./usr/share/doc/htp/examples/album.htt


Offset 1, 43 lines modified		Offset 1, 37 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·ALTTEXT·****	2	****·htp·on-line·reference·:·ALTTEXT·****
3	Table_of_Contents············***·syntax·***	3	Table_of_Contents············***·syntax·***
		4	Introduction···············<[[ref]]BLOCK·NAME="blockname"·[GLOBAL]·[EXPAND]>
		5	License····················text·block
		6	Tutorial···················<[[ref]]/BLOCK>
		7	Usage
4	Introduction···············<[[ref]]blockdef·name="tagname"·[option="option1
5	License····················[option2·...]"·]·[global]·[expand]>
6	Tutorial··················· ·...·<[[ref]]use·block> ...
7	Usage······················<[[ref]]/blockdef>
8	HTP·Tags
9	~~[>]~~·~~ALTTEXT~~················***·synopsis·***	8	HTP·Tags···················***·synopsis·***
10	··BL~~OCK··~~················ALTTEXT·declares·an·ALT·attribute·for·any·IMG·tag	9	[>]·ALTTEXT················ALTTEXT·declares·an·ALT·attribute·for·any·IMG·tag
11	··BLOCK~~DEF~~···············with·a·SRC·matching·the·ALTTEXT·NAME.·Since	10	··BLOCK··················with·a·SRC·matching·the·ALTTEXT·NAME.·Since
12	··~~DEF·····~~···············relative·paths·can·be·used·to·point·to·the·same	11	··BLOCKDEF···············relative·paths·can·be·used·to·point·to·the·same
13	··~~FILE~~···················image,·only·the·filename·is·considered·in·all	12	··DEF····················image,·only·the·filename·is·considered·in·all
14	··~~IF··~~···················comparisons.	13	··FILE···················comparisons.
15	··INC····················When·an·IMG·tag·with·a·matching·source·is	14	··IF·····················When·an·IMG·tag·with·a·matching·source·is
16	··IMG····················encountered,·htp·will·add·an·ALT·attribute·only·if	15	··INC····················encountered,·htp·will·add·an·ALT·attribute·only·if
17	··IM~~AGEURL~~···············one·is·not·already·present.·This·allows·for·ALT	16	··IMG····················one·is·not·already·present.·This·allows·for·ALT
18	··~~OPT·····~~···············text·to·be·overridden·on·specific·images·and	17	··IMAGEURL···············text·to·be·overridden·on·specific·images·and
19	··OUT~~PUT~~·················default·text·on·all·others.	18	··OPT····················default·text·on·all·others.
20	··QU~~OTE·~~·················For·example:	19	··OUTPUT·················For·example:
21	··S~~ET···~~················· ·<[[ref]]blockdef·name="~~section~~"·option="tit~~le">~~	20	··QUOTE··················<[[ref]]blockdef·name="tagname"·[option="option1
		21	··SET····················[option2·...]"·]·[global]·[expand]>
22	··UNDEF·················· · <h1><[[ref]]use·title></h1>
23	··UNSET·················· · <p·class="section">
24	··U~~SE,_$~~················· · · <[[ref]]use·block>	22	··UNDEF·················· ·...·<[[ref]]use·block> ...
25	··WHILE·················· · </p>
26	··<~~!---·~~················· ·<[[ref]]/blockdef>	23	··UNSET··················<[[ref]]/blockdef>
		24	··USE,_$
27	History
28	Wish_list·················· ·<section·title="My·Section">
29	Bugs······················· · ·This·is·a·fancy·section.
30	····························· ·</section>
31	······~~·····~~··················An·ALTTEXT·tag·with·a·name·but·no·text·attribute	25	··WHILE··················An·ALTTEXT·tag·with·a·name·but·no·text·attribute
32	······~~·····~~··················removes·any·ALT·mapping·for·this·image.·Successing	26	··<!---··················removes·any·ALT·mapping·for·this·image.·Successing
33	·~~········~~····················IMG·tags·with·a·matching·SRC·name·are·not·changed.	27	History····················IMG·tags·with·a·matching·SRC·name·are·not·changed.
34	·~~··········~~··················Since·this·is·useful·for·an·image·used·throughout	28	Wish_list··················Since·this·is·useful·for·an·image·used·throughout
35	·~~·····~~·······················a·set·of·documents,·ALTTEXT·is·most·appropriate·in	29	Bugs·······················a·set·of·documents,·ALTTEXT·is·most·appropriate·in
36	·····························an·include_file·or·a·default_file.	30	·····························an·include_file·or·a·default_file.
37	·····························In·addition·to·ALTTEXT,·htp·can·also·automatically	31	·····························In·addition·to·ALTTEXT,·htp·can·also·automatically
38	·····························add·WIDTH·and·HEIGHT·attributes·to·IMG·tags.	32	·····························add·WIDTH·and·HEIGHT·attributes·to·IMG·tags.


Offset 114, 24 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	·<span·class="htp-tag"><<a·href="alttext.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">alttext</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">text</span>=<span·class="htp-string">"Company·logo"</span>></span><br>
122	<br>
123	·this·line:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"logo.gif"</span>></span><br>
124	·becomes·this·after·processing:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">alt</span>=<span·class="htp-string">"Company·logo"</span>></span><br>
125	<br>
126	·this·line:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"../image/logo.gif"</span>></span><br>
127	·will·also·have·an·ALT·attribute·appended·to·it<br>
128	<br>
129	·this·line:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">alt</span>=<span·class="htp-string">"Click·here·for·more·information!"</span>></span><br>
130	·remains·unchanged.<br>
131	</code></p>	121	</code></p>
132	<h2>synopsis</h2>	122	<h2>synopsis</h2>
133	<P>	123	<P>
134	<STRONG>BLOCK·and·/BLOCK</STRONG>·are·used·to·create·block·macros,·which	124	<STRONG>BLOCK·and·/BLOCK</STRONG>·are·used·to·create·block·macros,·which
135	are·similar·in·use·to·<A·HREF="set.html">SET</A>·macros,·but·can·be	125	are·similar·in·use·to·<A·HREF="set.html">SET</A>·macros,·but·can·be
136	multi-line·definitions.	126	multi-line·definitions.
137	</P>	127	</P>


Offset 1, 62 lines modified		Offset 1, 52 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·BLOCK,·/BLOCK·****	2	****·htp·on-line·reference·:·BLOCK,·/BLOCK·****
3	Table_of·······***·syntax·***	3	Table_of_Contents············***·syntax·***
		4	Introduction···············***·synopsis·***
		5	License····················BLOCK·and·/BLOCK·are·used·to·create·block·macros,
		6	Tutorial···················which·are·similar·in·use·to·SET·macros,·but·can·be
		7	Usage······················multi-line·definitions.
		8	HTP·Tags···················Any·text·and·formatting·may·be·set·inside·the
		9	··ALTTEXT················block.·You·can·use·any·htp·or·user·defined·metatag
		10	[>]·BLOCK··················including·FILE_INCLUDE.·The·metatags·won't·be
4	Contents······· ·<[[ref]]alttext·name="logo.gif"·text="Company·logo">
5	Introduction
6	License······ ·this·line:·<[[ref]]img·src="logo.gif">
7	Tutorial····· ·becomes·this·after·processing:·<[[ref]]img·src="logo.gif"·alt="Company
8	Usage········logo">
9	HTP·Tags
10	··ALTTEXT·· ·this·line:·<[[ref]]img·src="../image/logo.gif">
11	[>]·BLOCK···· ·will·also·have·an·ALT·attribute·appended·to·it
12	··BLOCKDEF
13	··DEF······ ·this·line:·<[[ref]]img·src="logo.gif"·alt="Click·here·for·more
14	··FILE·····information!">
15	··IF······· ·remains·unchanged.
16	··INC······***·synopsis·***
17	··IMG······BLOCK·and·/BLOCK·are·used·to·create·block·macros,·which·are·similar·in
18	··IMAGEURL·use·to·SET·macros,·but·can·be·multi-line·definitions.
19	··OPT······Any·text·and·formatting·may·be·set·inside·the·block.·You·can·use·any·htp
20	··OUTPUT···or·user·defined·metatag·including·FILE_INCLUDE.·The·metatags·won't·be
21	··QUOTE····expanded·before·the·block·is·USEd·except·if·you~~·give·the·EXPAND~~	11	··BLOCKDEF···············expanded·before·the·block·is·USEd·except·if·you
22	··SET······parameter.
23	··UNDEF····The·block·macro·is·dereferenced·(expanded)·with·the·USE_tag_or_the_'$'
24	··UNSET····operator.·See·the·notes·on·the·USE·tag·on·how·to·pass·parameters·to·a
25	··~~USE,_$~~···~~block~~·m~~acro~~.	12	··DEF····················give·the·EXPAND·parameter.
		13	··FILE···················The·block·macro·is·dereferenced·(expanded)·with
		14	··IF·····················the·USE_tag_or_the_'$'_operator.·See·the·notes·on
		15	··INC····················the·USE·tag·on·how·to·pass·parameters·to·a·block
		16	··IMG····················macro.
		17	··IMAGEURL
		18	··OPT
		19	··OUTPUT
		20	··QUOTE
		21	··SET
		22	··UNDEF
		23	··UNSET
		24	··USE,_$
26	··WHILE	25	··WHILE
27	··<!---	26	··<!---
28	History	27	History
29	Wish_list	28	Wish_list
30	Bugs	29	Bugs















31	page_source	30	page_source
32	htp_project	31	htp_project
33	htp_homepage	32	htp_homepage
34	hosted·by	33	hosted·by
35	Sourceforge	34	Sourceforge
		35	HTML·coding·[Powered_by
36	HTML·coding
37	[Powered_by
38	htp]	36	htp]
39	·····htp·on-line·reference·/·http://htp.sourceforge.net/ref/	37	·····htp·on-line·reference·/·http://htp.sourceforge.net/ref/
40	·····Authors:·Jim·Nelson,·Jochen_Hoenicke,·Michael_Möller.	38	·····Authors:·Jim·Nelson,·Jochen_Hoenicke,·Michael_Möller.
41	·····Maintainers:·Jochen_Hoenicke.	39	·····Maintainers:·Jochen_Hoenicke.
42	Copyright·©·1995–96·Jim·Nelson.	40	Copyright·©·1995–96·Jim·Nelson.
43	Copyright·©·2001–2014·Jochen_Hoenicke.	41	Copyright·©·2001–2014·Jochen_Hoenicke.
44	Permission·to·reproduce·and·distribute·this·hypertext·document·granted~~·according·to~~	42	Permission·to·reproduce·and·distribute·this·hypertext·document·granted
45	terms·described·in·the·License_section.	43	according·to·terms·described·in·the·License_section.
46	last·updated·Sat·May·16,·2015	44	last·updated·Sat·May·16,·2015


Offset 114, 17 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"tagname"</span>·<span·class="ebnf">[</span><span·class="htp-attrib">option</span>=<span·class="htp-string">"option1·<span·class="ebnf">[</span>option2·...<span·class="ebnf">]</span>"</span>·<span·class="ebnf">]</span>·<span·class="ebnf">[</span><span·class="htp-attrib">global</span><span·class="ebnf">]</span>·<span·class="ebnf">[</span><span·class="htp-attrib">expand</span><span·class="ebnf">]</span>></span><br>
122	<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
123	<br>
124	</code></p>	121	</code></p>
125	<h2>synopsis</h2>	122	<h2>synopsis</h2>
126	<strong>BLOCKDEF</strong>·creates·block·<A	123	<strong>BLOCKDEF</strong>·creates·block·<A
127	HREF="metatag.html">metatags</A>,·which·is·a·fancy·way·of·saying·it	124	HREF="metatag.html">metatags</A>,·which·is·a·fancy·way·of·saying·it
128	creates·new·block·tags.··A·block·tag·is·a·tag·that·takes·a·whole·block	125	creates·new·block·tags.··A·block·tag·is·a·tag·that·takes·a·whole·block
129	as·additional·parameter.··This·block·is·surrounded·by·<tagname>·and	126	as·additional·parameter.··This·block·is·surrounded·by·<tagname>·and
130	</tagname>.··The·contents·of·this·block·are·automatically·stored	127	</tagname>.··The·contents·of·this·block·are·automatically·stored


Offset 1, 48 lines modified		Offset 1, 44 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·BLOCKDEF,·/BLOCKDEF·****	2	****·htp·on-line·reference·:·BLOCKDEF,·/BLOCKDEF·****
3	Table_of_Contents············***·syntax·***	3	Table_of_Contents············***·syntax·***
4	Introduction···············<[[ref]]def·name="tagname"·[option="option1
5	License····················[option2·...]"·]·[global]·[expand]>
6	Tutorial···················<[[ref]]/def>
7	Usage
8	~~HTP·Tags····~~···············***·synopsis·***	4	Introduction···············***·synopsis·***
9	~~··ALTTEXT~~················BLOCKDEF·creates·block·metatags,·which·is·a·fancy	5	License····················BLOCKDEF·creates·block·metatags,·which·is·a·fancy
10	~~··BLOCK~~··················way·of·saying·it·creates·new·block·tags.·A·block	6	Tutorial···················way·of·saying·it·creates·new·block·tags.·A·block
11	~~[>]·BLOCKDEF~~···············tag·is·a·tag·that·takes·a·whole·block·as	7	Usage······················tag·is·a·tag·that·takes·a·whole·block·as
12	··~~DEF·~~···················additional·parameter.·This·block·is·surrounded·by	8	HTP·Tags···················additional·parameter.·This·block·is·surrounded·by
13	··~~FILE···~~················<tagname>·and·</tagname>.·The·contents·of·this	9	··ALTTEXT················<tagname>·and·</tagname>.·The·contents·of·this
14	··~~IF···~~··················block·are·automatically·stored·in·the·block·macro	10	··BLOCK··················block·are·automatically·stored·in·the·block·macro
15	··~~INC·····~~···············named·BLOCK.	11	[>]·BLOCKDEF···············named·BLOCK.
16	··~~IMG~~····················For·example:	12	··DEF····················For·example:
17	··~~IMAGEURL~~··············· · ·<[[ref]]def·name="centered">	13	··FILE··················· · ·<[[ref]]def·name="centered">
18	··~~OPT~~···················· · ·<p·align=center>	14	··IF····················· · ·<p·align=center>
19	··~~OUTPUT~~················· · ·<[[ref]]/def>	15	··INC···················· · ·<[[ref]]/def>
20	··QU~~OTE~~	16	··IMG
21	··~~SET·····~~··············· · ·<centered>	17	··IMAGEURL··············· · ·<centered>
22	··~~UNDEF~~·················· · ·This·text·is·centered.	18	··OPT···················· · ·This·text·is·centered.
23	··U~~NSE~~T··················All·block·metatags·have·the·implicit·option	19	··OUTPUT·················All·block·metatags·have·the·implicit·option
24	··~~USE,_$~~·················EXPAND,·which·tells·htp·to·expand·the·contents·of	20	··QUOTE··················EXPAND,·which·tells·htp·to·expand·the·contents·of
25	··~~WHILE~~··················the·block·before·the·definition·is·expanded.	21	··SET····················the·block·before·the·definition·is·expanded.
26	··~~<!---~~··················A·more·thorough·discussion·and·more·elaborate	22	··UNDEF··················A·more·thorough·discussion·and·more·elaborate
27	H~~istory··~~··················examples·are·discussed·in·the·metatag·section.	23	··UNSET··················examples·are·discussed·in·the·metatag·section.
		24	··USE,_$
		25	··WHILE
		26	··<!---
		27	History
28	Wish_list	28	Wish_list
29	Bugs	29	Bugs


Offset 114, 47 lines modified		Offset 114, 45 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"tagname"</span>·<span·class="ebnf">[</span><span·class="htp-attrib">option</span>=<span·class="htp-string">"option1·<span·class="ebnf">[</span>option2·...<span·class="ebnf">]</span>"</span>·<span·class="ebnf">]</span>·<span·class="ebnf">[</span><span·class="htp-attrib">global</span><span·class="ebnf">]</span>·<span·class="ebnf">[</span><span·class="htp-attrib">expand</span><span·class="ebnf">]</span>></span><br>
122	<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
123	<br>
124	</code></p>	121	</code></p>
125	<h2>synopsis</h2>	122	<h2>synopsis</h2>
126	<p>	123	<p>
127	This·is·a·simple·comment·that·is·not·included·in·the·output.··This·is·useful	124	This·is·a·simple·comment·that·is·not·included·in·the·output.··This·is·useful
128	when·commenting·metatags,·since·the·metatags·do·not·appear·the·output·either.	125	when·commenting·metatags,·since·the·metatags·do·not·appear·the·output·either.
129	Example:	126	Example:
130	</p>	127	</p>
131	··<p><code>	128	··<p><code>
132	· ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"centered"</span>></span><br>
133	· ·<span·class="htp-tag"><p·<span·class="htp-attrib">align</span>=<span·class="htp-value">center</span>></span><br>
134	· ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
135	<br>
136	· ·<span·class="htp-tag"><centered></span><br>
137	· ·This·tex~~t·is~~·~~cen~~tered.<br>	129	· ·a·is·expanded·at·time·1.<br>
		130	· ·b·is·expanded·at·time·0.<br>
		131	·contents·of·a:· ·a·is·expanded·at·time·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">time</span>></span>.<br>
		132	·contents·of·b:· ·b·is·expanded·at·time·0.<br>
		133	· ·c·is·expanded·at·time·1;· ·a·is·expanded·at·time·1.<br>
		134	· ·d·is·expanded·at·time·1;· ·a·is·expanded·at·time·2.<br>
		135	· ·e·is·expanded·at·time·2;· ·a·is·defined·for·the·2nd·time·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">time</span>></span>.<br>
138	</code></p>	136	</code></p>
139	<p>	137	<p>
140	Note·that·these·comments·should·not·include·<·or·>,·that·is·you	138	Note·that·these·comments·should·not·include·<·or·>,·that·is·you
141	should·not·use·it·to·comment·out·htp·code.··For·that·purpose·use·something	139	should·not·use·it·to·comment·out·htp·code.··For·that·purpose·use·something
142	like·this:	140	like·this:
143	</p>	141	</p>
144	··<p><code>	142	··<p><code>
145	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">execute</span>=<span·class="htp-string">"command-line"</span>·<span·class="htp-attrib">(output</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">\|</span>·<span·class="htp-attrib">redirect)</span>·<span·class="htp-attrib">[noerror]</span>></span><br>
146	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">include</span>=<span·class="htp-string">"includefilename"</span>·<span·class="htp-attrib">[parameters</span>·<span·class="htp-attrib">...]</span>></span><br>
147	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">name</span>></span><br>
148	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">size[</span>·=<span·class="htp-value"></span>·<span·class="htp-attrib">(byte\|kbyte\|mbyte\|gbyte)</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">[precision</span>=<span·class="htp-value">n]</span>></span><br>
149	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">time[</span>·=<span·class="htp-string">"format"</span>·<span·class="htp-attrib">]</span>></span><br>
150	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">date[</span>·=<span·class="htp-string">"format"</span>·<span·class="htp-attrib">]</span>></span><br>
151	<span·class="htp-tag"><<a·href="f~~ile~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">f~~ile~~</a>·<span·class="htp-attrib">search</span>=<span·class="htp-string">"se~~archpa~~th"</span>></span><br>	143	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"bigfont"</span>></span><br>
		144	· ·<span·class="htp-tag"><font·<span·class="htp-attrib">size</span>=<span·class="htp-string">"+4"</span>></span><br>
		145	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
		146	<br>
152	<span·class="htp-tag"><<a·href="f~~ile~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">f~~ile~~</a>·<span·class="htp-attrib">~~temp~~late</span>=<span·class="htp-string">"~~template~~filename"</span>></span><br>	147	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"/bigfont"</span>></span><br>
		148	· ·<span·class="htp-tag"></font></span><br>
		149	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
153	<br>	150	<br>
		151	·<span·class="htp-tag"><bigfont></span>Some·large·text<span·class="htp-tag"></bigfont></span><br>
154	</code></p>	152	</code></p>
155	<p>Make·sure·that·the·variable·is·never·defined·and·xyz·should·be·the	153	<p>Make·sure·that·the·variable·is·never·defined·and·xyz·should·be·the
156	reason·why·you·don't·want·to·include·this·block</p>	154	reason·why·you·don't·want·to·include·this·block</p>
157	<p>	155	<p>
158	</td>	156	</td>
159	</tr>	157	</tr>
160	<tr>	158	<tr>

+[HTP]
+******·htp·on-line·reference·:·<!---·******
+Table_of·······*****·syntax·*****
+Contents·······*****·synopsis·*****
+ Introduction·This·is·a·simple·comment·that·is·not·included·in·the·output.·This·is·useful
+ License······when·commenting·metatags,·since·the·metatags·do·not·appear·the·output
+ Tutorial·····either.·Example:
+ Usage········ · ·a·is·expanded·at·time·1.
+ HTP·Tags····· · ·b·is·expanded·at·time·0.
+  ··ALTTEXT·· ·contents·of·a:· ·a·is·expanded·at·time·<[[ref]]use·time>.
+  ··BLOCK···· ·contents·of·b:· ·b·is·expanded·at·time·0.
+  ··BLOCKDEF· · ·c·is·expanded·at·time·1;· ·a·is·expanded·at·time·1.
+  ··DEF······ · ·d·is·expanded·at·time·1;· ·a·is·expanded·at·time·2.
+  ··FILE····· · ·e·is·expanded·at·time·2;· ·a·is·defined·for·the·2nd·time·<[[ref]]use
+  ··IF·······time>.
+  ··INC······Note·that·these·comments·should·not·include·<·or·>,·that·is·you·should·not
+ Introduction···············<[[ref]]def·name="tagname"·[option="option1
+ License····················[option2·...]"·]·[global]·[expand]>
+ Tutorial···················<[[ref]]/def>
+ Usage
+ HTP·Tags···················*****·synopsis·*****
+  ··ALTTEXT················This·is·a·simple·comment·that·is·not·included·in
+  ··BLOCK··················the·output.·This·is·useful·when·commenting
+  ··BLOCKDEF···············metatags,·since·the·metatags·do·not·appear·the
+  ··DEF····················output·either.·Example:
+  ··FILE··················· · ·<[[ref]]def·name="centered">
+  ··IF····················· · ·<p·align=center>
+  ··INC···················· · ·<[[ref]]/def>
+  ··IMG
+  ··IMAGEURL··············· · ·<centered>
+  ··OPT···················· · ·This·text·is·centered.
+  ··OUTPUT·················Note·that·these·comments·should·not·include·<·or
+  ··QUOTE··················>,·that·is·you·should·not·use·it·to·comment·out
+  ··IMG······use·it·to·comment·out·htp·code.·For·that·purpose·use·something·like·this:
+  ··IMAGEURL· ·<[[ref]]def·name="bigfont">
+  ··OPT······ · ·<font·size="+4">
+  ··OUTPUT··· ·<[[ref]]/def>
+  ··QUOTE
+  ··SET······ ·<[[ref]]def·name="/bigfont">
+  ··UNDEF···· · ·</font>
+  ··UNSET···· ·<[[ref]]/def>
+  ··USE,_$
+  ··WHILE···· ·<bigfont>Some·large·text</bigfont>
+ [>]·<!---····Make·sure·that·the·variable·is·never·defined·and·xyz·should·be·the·reason
+ History······why·you·don't·want·to·include·this·block
+ Wish_list
+ Bugs
+  ··UNDEF··················this:
+  ··UNSET··················<[[ref]]file·execute="command-line"
+  ··USE,_$·················(output="filename"·|·redirect)·[noerror]>
+  ··WHILE··················<[[ref]]file·include="includefilename"·[parameters
+ [>]·<!---··················...]>
+ History····················<[[ref]]file·name>
+ Wish_list··················<[[ref]]file·[·name="filename"·]·size[·=
+ Bugs·······················(byte|kbyte|mbyte|gbyte)·]·[precision=n]>
+·····························<[[ref]]file·[·name="filename"·]·time[·="format"
+·····························]>
+·····························<[[ref]]file·[·name="filename"·]·date[·="format"
+·····························]>
+·····························<[[ref]]file·search="searchpath">
+·····························<[[ref]]file·template="templatefilename">
+·····························Make·sure·that·the·variable·is·never·defined·and
+·····························xyz·should·be·the·reason·why·you·don't·want·to
+·····························include·this·block


Offset 114, 72 lines modified		Offset 114, 59 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"section"</span>·<span·class="htp-attrib">option</span>=<span·class="htp-string">"title"</span>></span><br>
122	· <span·class="htp-tag"><h1></span><span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">title</span>></span><span·class="htp-tag"></h1></span><br>
123	· <span·class="htp-tag"><p·<span·class="htp-attrib">class</span>=<span·class="htp-string">"section"</span>></span><br>
124	· · <span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">block</span>></span><br>
125	· <span·class="htp-tag"></p></span><br>
126	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>
127	<br>
128	·<span·class="htp-tag"><section·<span·class="htp-attrib">title</span>=<span·class="htp-string">"My·Section"</span>></span><br>
129	· ·This·is·a·fancy·section.<br>
130	·<span·class="htp-tag"></section></span><br>
131	</code></p>	121	</code></p>
132	<h2>synopsis</h2>	122	<h2>synopsis</h2>
133	<p>	123	<p>
134	<strong>DEF</strong>·creates·<a·href="metatag.html">metatags</a>,·which·is·a	124	<strong>DEF</strong>·creates·<a·href="metatag.html">metatags</a>,·which·is·a
135	fancy·way·of·saying·it·creates·new·tags.··The·mechanism·is·very·similar·to	125	fancy·way·of·saying·it·creates·new·tags.··The·mechanism·is·very·similar·to
136	<a·href="block.html">BLOCK</a>·macros,·except·that·the·<a·href="use.html">USE</a>	126	<a·href="block.html">BLOCK</a>·macros,·except·that·the·<a·href="use.html">USE</a>
137	tag·is·not·used·to·expand·them.··Instead,·they·are·expanded·by·their·own·name.	127	tag·is·not·used·to·expand·them.··Instead,·they·are·expanded·by·their·own·name.
138	For·example:	128	For·example:
139	</p>	129	</p>
140	··<p><code>	130	··<p><code>
141	<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">if</a>·<span·class="htp-attrib">disabled_because_xyz</span>></span><br>
142	·...<br>
143	~~<sp~~an~~·cla~~ss~~="ht~~p~~-tag">&lt~~;<a·~~href="if.html"~~·><i~~mg·~~sr~~c="~~p~~ic/manu~~a~~l.p~~n~~g"·bor~~der=0·alt~~="[ref]"~~·~~wid~~t~~h="10"·he~~igh~~t="~~1~~0">/if</a>></span~~><br>	131	· ·a·is·expanded·at·time·1.<br>
		132	· ·b·is·expanded·at·time·0.<br>
		133	·contents·of·a:· ·a·is·expanded·at·time·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">time</span>></span>.<br>
		134	·contents·of·b:· ·b·is·expanded·at·time·0.<br>
		135	· ·c·is·expanded·at·time·1;· ·a·is·expanded·at·time·1.<br>
		136	· ·d·is·expanded·at·time·1;· ·a·is·expanded·at·time·2.<br>
		137	· ·e·is·expanded·at·time·2;· ·a·is·defined·for·the·2nd·time·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">time</span>></span>.<br>
144	</code></p>	138	</code></p>
145	<P>	139	<P>
146	Some·metatags·will·require·an·opening·and·closing·tag·(comparable·to	140	Some·metatags·will·require·an·opening·and·closing·tag·(comparable·to
147	<TITLE>·and·</TITLE>).··In·this·case,·you·should·use·the·<A	141	<TITLE>·and·</TITLE>).··In·this·case,·you·should·use·the·<A
148	HREF="blockdef.html">BLOCKDEF</A>·macro.··Another·slightly·faster	142	HREF="blockdef.html">BLOCKDEF</A>·macro.··Another·slightly·faster
149	alternative·is·to·use·two·metatags,·the·opening·tag·and·the·closing	143	alternative·is·to·use·two·metatags,·the·opening·tag·and·the·closing
150	tag·with·a·preceding·slash.·For·example:	144	tag·with·a·preceding·slash.·For·example:
151	</P>	145	</P>
152	··<p><code>	146	··<p><code>
153	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">execute</span>=<span·class="htp-string">"command-line"</span>·<span·class="htp-attrib">(output</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">\|</span>·<span·class="htp-attrib">redirect)</span>·<span·class="htp-attrib">[noerror]</span>></span><br>
154	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">include</span>=<span·class="htp-string">"includefilename"</span>·<span·class="htp-attrib">[parameters</span>·<span·class="htp-attrib">...]</span>></span><br>
155	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">name</span>></span><br>
156	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">size[</span>·=<span·class="htp-value"></span>·<span·class="htp-attrib">(byte\|kbyte\|mbyte\|gbyte)</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">[precision</span>=<span·class="htp-value">n]</span>></span><br>
157	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">time[</span>·=<span·class="htp-string">"format"</span>·<span·class="htp-attrib">]</span>></span><br>
158	<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">file</a>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">date[</span>·=<span·class="htp-string">"format"</span>·<span·class="htp-attrib">]</span>></span><br>
159	<span·class="htp-tag"><<a·href="f~~ile~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">f~~ile~~</a>·<span·class="htp-attrib">search</span>=<span·class="htp-string">"se~~archpa~~th"</span>></span><br>	147	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"bigfont"</span>></span><br>
160	~~<sp~~an~~·cla~~ss~~="ht~~p~~-tag">&lt~~;<a·~~href="file.html"~~·><~~img·~~s~~rc="~~p~~ic/manu~~a~~l.p~~n~~g"·border=0~~·al~~t="[ref]"·width~~=~~"10~~"·he~~igh~~t="10">~~file</a>~~·<span·class="htp-attrib">~~templat~~e</span>=<span·class="htp-string">"~~templatefilena~~me"</span>></span><br>	148	· ·<span·class="htp-tag"><font·<span·class="htp-attrib">size</span>=<span·class="htp-string">"+4"</span>></span><br>
		149	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
161	<br>	150	<br>
		151	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"/bigfont"</span>></span><br>
		152	· ·<span·class="htp-tag"></font></span><br>
		153	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
		154	<br>
		155	·<span·class="htp-tag"><bigfont></span>Some·large·text<span·class="htp-tag"></bigfont></span><br>
162	</code></p>	156	</code></p>
163	<p>·You·should·really·use·<a·href="blockdef.html">BLOCKDEF</a>,·though,	157	<p>·You·should·really·use·<a·href="blockdef.html">BLOCKDEF</a>,·though,
164	as·it·will·check·for·matching·end·tag.·It·is·not·that·slower.··</p>	158	as·it·will·check·for·matching·end·tag.·It·is·not·that·slower.··</p>
165	<P>	159	<P>
166	Options·can·be·passed·to·a·metatag,·which·can·then·expand·as·if·it·were	160	Options·can·be·passed·to·a·metatag,·which·can·then·expand·as·if·it·were
167	a·<A·HREF="set.html">SET</A>·macro.··Option·names·are·parameterized·with	161	a·<A·HREF="set.html">SET</A>·macro.··Option·names·are·parameterized·with
168	the·OPTION·attribute.··Multiple·options·can·be·listed·by·separating·their	162	the·OPTION·attribute.··Multiple·options·can·be·listed·by·separating·their
169	name·with·a·space·(which·therefore·requires·they·be·surrounded·by·quotes.)	163	name·with·a·space·(which·therefore·requires·they·be·surrounded·by·quotes.)
170	</P>	164	</P>
171	··<p><code>	165	··<p><code>
172	· ·a·is·expanded·at·time·1.<br>
173	· ·b·is·expanded·at·time·0.<br>
174	·contents·of·a:· ·a·is·expanded·at·time·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">time</span>></span>.<br>
175	·contents·of·b:· ·b·is·expanded·at·time·0.<br>
176	· ·c·is·expanded·at·time·1;· ·a·is·expanded·at·time·1.<br>
177	· ·d·is·expanded·at·time·1;· ·a·is·expanded·at·time·2.<br>
178	· ·e·is·expanded·at·time·2;· ·a·is·defined·for·the·2nd·time·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">time</span>></span>.<br>
179	</code></p>	166	</code></p>
180	<P>	167	<P>
181	htp·will·do·very·specific·checking·of·parameters·when·a·metatag·is	168	htp·will·do·very·specific·checking·of·parameters·when·a·metatag·is
182	invoked.··htp·assumes·that·all·parameter·options·to·the·metatag·are	169	invoked.··htp·assumes·that·all·parameter·options·to·the·metatag·are
183	optional.··This·is·why·the·HEADERIMG·definition·uses·IF·to·verify·the	170	optional.··This·is·why·the·HEADERIMG·definition·uses·IF·to·verify·the
184	SIZE·option·is·defined·before·expanding·it·in·the·block.··If·a	171	SIZE·option·is·defined·before·expanding·it·in·the·block.··If·a
185	parameter·is·required,·simply·expand·it·without·first·checking.··When	172	parameter·is·required,·simply·expand·it·without·first·checking.··When


Offset 1, 59 lines modified		Offset 1, 44 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·DEF,·/DEF·****	2	****·htp·on-line·reference·:·DEF,·/DEF·****
3	Table_of·······***·syntax·***	3	Table_of·······***·syntax·***
4	Contents······· ·<[[ref]]blockdef·name="section"·option="title">
5	Introduction· · <h1><[[ref]]use·title></h1>
6	License······ · <p·class="section">
7	Tutorial····· · · <[[ref]]use·block>
8	Usage········ · </p>
9	HTP·Tags····· ·<[[ref]]/blockdef>
10	··ALTTEXT
11	··BLOCK···· ·<section·title="My·Section">
12	··BLOCKDEF· · ·This·is·a·fancy·section.
13	[>]·DEF······ ·</section>
14	~~··FILE~~·····***·synopsis·***	4	Contents·······***·synopsis·***
15	~~··IF······~~·DEF·creates·metatags,·which·is·a·fancy·way·of·saying·it·creates·new·tags.	5	Introduction·DEF·creates·metatags,·which·is·a·fancy·way·of·saying·it·creates·new·tags.
16	~~··INC~~······The·mechanism·is·very·similar·to·BLOCK·macros,·except·that·the·USE·tag·is	6	License······The·mechanism·is·very·similar·to·BLOCK·macros,·except·that·the·USE·tag·is
17	~~··IMG·~~·····not·used·to·expand·them.·Instead,·they·are·expanded·by·their·own·name.·For	7	Tutorial·····not·used·to·expand·them.·Instead,·they·are·expanded·by·their·own·name.·For
18	··IMAGEURL·example:
19	··OPT······<[[ref]]if·disabled_because_xyz>
20	··OUTPUT··· ·...
21	··~~QUOTE~~····~~<[[r~~e~~f]]/if>~~	8	Usage········example:
		9	HTP·Tags····· · ·a·is·expanded·at·time·1.
		10	··ALTTEXT·· · ·b·is·expanded·at·time·0.
		11	··BLOCK···· ·contents·of·a:· ·a·is·expanded·at·time·<[[ref]]use·time>.
		12	··BLOCKDEF· ·contents·of·b:· ·b·is·expanded·at·time·0.
		13	[>]·DEF······ · ·c·is·expanded·at·time·1;· ·a·is·expanded·at·time·1.
		14	··FILE····· · ·d·is·expanded·at·time·1;· ·a·is·expanded·at·time·2.
		15	··IF······· · ·e·is·expanded·at·time·2;· ·a·is·defined·for·the·2nd·time·<[[ref]]use
		16	··INC······time>.
22	··~~SET~~······Some·metatags·will·require·an·opening·and·closing·tag·(comparable·to	17	··IMG······Some·metatags·will·require·an·opening·and·closing·tag·(comparable·to
23	··~~UNDEF···~~·and	18	··IMAGEURL·and
24	··~~UNSET~~····).·In·this·case,·you·should·use·the·BLOCKDEF·macro.·Another·slightly·faster	19	··OPT······).·In·this·case,·you·should·use·the·BLOCKDEF·macro.·Another·slightly·faster
25	··~~USE,_$~~···alternative·is·to·use·two·metatags,·the·opening·tag·and·the·closing·tag	20	··OUTPUT···alternative·is·to·use·two·metatags,·the·opening·tag·and·the·closing·tag
26	··~~WHIL~~E····with·a·preceding·slash.·For·example:	21	··QUOTE····with·a·preceding·slash.·For·example:
		22	··SET······ ·<[[ref]]def·name="bigfont">
		23	··UNDEF···· · ·<font·size="+4">
		24	··UNSET···· ·<[[ref]]/def>
		25	··USE,_$
		26	··WHILE···· ·<[[ref]]def·name="/bigfont">
		27	··<!---···· · ·</font>
		28	History······ ·<[[ref]]/def>
		29	Wish_list
		30	Bugs········· ·<bigfont>Some·large·text</bigfont>
27	··<!---····<[[ref]]file·execute="command-line"·(output="filename"·\|·redirect)
28	History······[noerror]>
29	Wish_list····<[[ref]]file·include="includefilename"·[parameters·...]>
30	Bugs·········<[[ref]]file·name>
31	···············<[[ref]]file·[·name="filename"·]·size[·=·(byte\|kbyte\|mbyte\|gbyte)·]
32	···············[precision=n]>
33	···············<[[ref]]file·[·name="filename"·]·time[·="format"·]>
34	···············<[[ref]]file·[·name="filename"·]·date[·="format"·]>
35	···············<[[ref]]file·search="searchpath">
36	···············<[[ref]]file·template="templatefilename">

37	···············You·should·really·use·BLOCKDEF,·though,·as·it·will·check·for·matching·end	31	···············You·should·really·use·BLOCKDEF,·though,·as·it·will·check·for·matching·end
38	···············tag.·It·is·not·that·slower.	32	···············tag.·It·is·not·that·slower.
39	···············Options·can·be·passed·to·a·metatag,·which·can·then·expand·as·if·it·were·a	33	···············Options·can·be·passed·to·a·metatag,·which·can·then·expand·as·if·it·were·a
40	···············SET·macro.·Option·names·are·parameterized·with·the·OPTION·attribute.	34	···············SET·macro.·Option·names·are·parameterized·with·the·OPTION·attribute.
41	···············Multiple·options·can·be·listed·by·separating·their·name·with·a·space·(which	35	···············Multiple·options·can·be·listed·by·separating·their·name·with·a·space·(which
42	···············therefore·requires·they·be·surrounded·by·quotes.)	36	···············therefore·requires·they·be·surrounded·by·quotes.)
43	··············· · ·a·is·expanded·at·time·1.
44	··············· · ·b·is·expanded·at·time·0.
45	··············· ·contents·of·a:· ·a·is·expanded·at·time·<[[ref]]use·time>.
46	··············· ·contents·of·b:· ·b·is·expanded·at·time·0.
47	··············· · ·c·is·expanded·at·time·1;· ·a·is·expanded·at·time·1.
48	··············· · ·d·is·expanded·at·time·1;· ·a·is·expanded·at·time·2.
49	··············· · ·e·is·expanded·at·time·2;· ·a·is·defined·for·the·2nd·time·<[[ref]]use
50	···············time>.
51	···············htp·will·do·very·specific·checking·of·parameters·when·a·metatag·is·invoked.	37	···············htp·will·do·very·specific·checking·of·parameters·when·a·metatag·is·invoked.
52	···············htp·assumes·that·all·parameter·options·to·the·metatag·are·optional.·This·is	38	···············htp·assumes·that·all·parameter·options·to·the·metatag·are·optional.·This·is
53	···············why·the·HEADERIMG·definition·uses·IF·to·verify·the·SIZE·option·is·defined	39	···············why·the·HEADERIMG·definition·uses·IF·to·verify·the·SIZE·option·is·defined
54	···············before·expanding·it·in·the·block.·If·a·parameter·is·required,·simply·expand	40	···············before·expanding·it·in·the·block.·If·a·parameter·is·required,·simply·expand
55	···············it·without·first·checking.·When·htp·expands·the·metatag·and·the·macro·is	41	···············it·without·first·checking.·When·htp·expands·the·metatag·and·the·macro·is
56	···············not·defined,·it·will·halt·processing·and·complain·with·an·error·message·and	42	···············not·defined,·it·will·halt·processing·and·complain·with·an·error·message·and
57	···············the·required·macro·name.·Normally·htp·will·not·allow·parameters·not·listed	43	···············the·required·macro·name.·Normally·htp·will·not·allow·parameters·not·listed


Offset 98, 43 lines modified		Offset 98, 23 lines modified
98	<p>However,·if·the·block·tag·is·marked·with·the·<code>expand</code>	98	<p>However,·if·the·block·tag·is·marked·with·the·<code>expand</code>
99	modifier·it·is·expanded·immediately.··This·is·useful·if·you·want·to	99	modifier·it·is·expanded·immediately.··This·is·useful·if·you·want·to
100	store·something·in·a·block·macro,·that·depends·on·the·current·value·of	100	store·something·in·a·block·macro,·that·depends·on·the·current·value·of
101	another·macro.··This·other·macro·may·no·longer·have·the·correct·value	101	another·macro.··This·other·macro·may·no·longer·have·the·correct·value
102	when·the·macro·is·expanded.··Here·is·some·code·that·demonstrate·when	102	when·the·macro·is·expanded.··Here·is·some·code·that·demonstrate·when
103	the·htp·tags·are·expanded:·</P>	103	the·htp·tags·are·expanded:·</P>
104	··<p><code>	104	··<p><code>
		105	<font·size="-2"> 1.·</font> · ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"centered"</span>></span><br>
105	<font·size="-2"> 1.·</font> ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">DEF</a>·<span·class="htp-attrib">NAME</span>=<span·class="htp-string">"HEADERIMG"</span>·<span·class="htp-attrib">OPTION</span>=<span·class="htp-string">"SRC·TITLE·SIZE"</span>></span><br>
106	<font·size="-2"> 2.·</font> · ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IF</a>·<span·class="htp-attrib">size</span>></span><br>
107	<font·size="-2"> 3.·</font>~~ · ·~~ · ·<span·class="htp-tag"><~~FON~~T·<span·class="htp-attrib">~~SIZE~~</span>=<span·class="htp-value">~~<span·~~c~~lass=~~"ht~~p-macro">${siz~~e~~}</span~~></span>></span><br>	106	<font·size="-2"> 2.·</font> · ·<span·class="htp-tag"><p·<span·class="htp-attrib">align</span>=<span·class="htp-value">center</span>></span><br>
108	<font·size="-2"> 4.·</font> · ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/IF</a>></span><br>	107	<font·size="-2"> 3.·</font> · ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
109	<font·size="-2"> 5.·</font> · ·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IMG</a>·<span·class="htp-attrib">SRC</span>=<span·class="htp-value">pics/<span·class="htp-macro">${src}</span></span>></span><br>
110	<font·size="-2"> 6.·</font> · ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">USE</a>·<span·class="htp-attrib">title</span>></span><br>
111	<font·size="-2"> 7.·</font> · ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IF</a>·<span·class="htp-attrib">size</span>></span><br>
112	<font·size="-2"> 8.·</font> · · · ·<span·class="htp-tag"></FONT></span><br>
113	<font·size="-2"> 9.·</font> · ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/IF</a>></span><br>
114	<font·size="-2">10.·</font> ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/DEF</a>></span><br>
115	<font·size="-2">11.·</font><br>	108	<font·size="-2"> 4.·</font><br>
		109	<font·size="-2"> 5.·</font> · ·<span·class="htp-tag"><centered></span><br>
		110	<font·size="-2"> 6.·</font> · ·This·text·is·centered.<br>
116	<font·size="-2">12.·</font> ·<span·class="htp-tag"><HEADERIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">SIZE</span>=<span·class="htp-string">"+2"</span>·<span·class="htp-attrib">TITLE</span>=<span·class="htp-string">"A·title"</span>></span><br>
117	<font·size="-2">13.·</font><br>
118	<font·size="-2">14.·</font> ·<span·class="htp-tag"><HEADERIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">TITLE</span>=<span·class="htp-string">"Normal·sized·title"</span>></span><br>
119	<font·size="-2">15.·</font><br>
120	<font·size="-2">16.·</font> ·This·will·fail:<br>
121	<font·size="-2">17.·</font> ·<span·class="htp-tag"><HEADERIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">ALT</span>=<span·class="htp-string">"Our·logo"</span>·<span·class="htp-attrib">TITLE</span>=<span·class="htp-string">"Another·title"</span>></span><br>
122	<font·size="-2">18.·</font><br>
123	<font·size="-2">19.·</font> ·Instead,·use·*·like·this:<br>
124	<font·size="-2">20.·</font> ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">DEF</a>·<span·class="htp-attrib">NAME</span>=<span·class="htp-string">"MYIMG"</span>·<span·class="htp-attrib">OPTION</span>=<span·class="htp-string">"SRC·*"</span>></span><br>
125	<font·size="-2">21.·</font> · ·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IMG</a>·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"pics/<span·class="htp-macro">${src}</span>"</span>·<span·class="htp-attrib"><span·class="htp-macro">$*</span></span>></span><br>
126	<font·size="-2">22.·</font> ·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/DEF</a>></span><br>
127	<font·size="-2">23.·</font> · ·<br>
128	<font·size="-2">24.·</font> ·<span·class="htp-tag"><MYIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">ALT</span>=<span·class="htp-string">"Our·logo"</span>></span><br>
129	</code></p>	111	</code></p>
130	This·produces·the·following:	112	This·produces·the·following:
131	··<p><code>	113	··<p><code>
132	<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">...</span>></span><br>


Offset 1, 90 lines modified		Offset 1, 80 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·global·and·expand·****	2	****·htp·on-line·reference·:·global·and·expand·****
3	Table_of·········***·The·global·attribute·***	3	Table_of_Contents············***·The·global·attribute·***
4	Contents·········Normally·when·you·define·a·macro·it·is·only·defined·in·the·current
5	Introduction···scope.·A·scope·is·for·example·the·definition·of·a·metatag.·Once·the
6	License········definition·is·expanded·and·the·metatag·has·finished·the·macro·is
7	Tutorial·······automatically·removed.·In·some·cases·you·want·to·define·a·macro
8	Usage··········inside·a·metatag·and·use·it·later.·You·can·do·this·with·the·global
9	··Command-···attribute·that·you·can·add·to·[[ref]]set,·[[ref]]inc,·[[ref]]block,·[
10	······line·······[ref]]def,·and·[[ref]]blockdef·tags.
11	··Options····***·The·expand·attribute·***
12	··Predefined·The·expand·attribute·is·not·a·tag·of·its·own·but·is·an·attribute·of
13	······macros·····all·block·tags·even·metatags·defined·with·the·blockdef·macro.
14	[>]·global_and·Normally·htp·uses·a·lazy·evaluation·strategy,·i.e.·it·expands·htp
15	······expand·····tags,·metatags·and·macros·when·the·HTML·document·is·written·not·when
16	HTP_Tags·······they're·stored·into·block·macros.·When·you·use·a·macro·defined·with
17	History········the·blockdef·tag·the·html·code·between·the·tags·is·just·copied
18	Wish_list······literally·into·the·macro·named·block,·without·any·expansion·going·on.
19	Bu~~gs···~~········~~However,~~·if·~~the~~·~~block~~·tag·~~is·~~mar~~ked~~·w~~ith~~·~~the~~·~~expa~~nd·m~~odifier~~·it·is	4	Introduction···············Normally·when·you·define·a·macro·it·is·only
		5	License····················defined·in·the·current·scope.·A·scope·is·for
		6	Tutorial···················example·the·definition·of·a·metatag.·Once·the
		7	Usage······················definition·is·expanded·and·the·metatag·has
		8	··Command-line···········finished·the·macro·is·automatically·removed.·In
		9	··Options················some·cases·you·want·to·define·a·macro·inside·a
		10	··Predefined_macros······metatag·and·use·it·later.·You·can·do·this·with·the
		11	[>]·global_and_expand······global·attribute·that·you·can·add·to·[[ref]]set,·[
		12	HTP_Tags···················[ref]]inc,·[[ref]]block,·[[ref]]def,·and·[
		13	History····················[ref]]blockdef·tags.
		14	Wish_list··················***·The·expand·attribute·***
		15	Bugs·······················The·expand·attribute·is·not·a·tag·of·its·own·but
		16	·····························is·an·attribute·of·all·block·tags·even·metatags
		17	·····························defined·with·the·blockdef·macro.·Normally·htp·uses
		18	·····························a·lazy·evaluation·strategy,·i.e.·it·expands·htp
		19	·····························tags,·metatags·and·macros·when·the·HTML·document
		20	·····························is·written·not·when·they're·stored·into·block
		21	·····························macros.·When·you·use·a·macro·defined·with·the
		22	·····························blockdef·tag·the·html·code·between·the·tags·is


Offset 1, 127 lines modified		Offset 1, 124 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·FILE·****	2	****·htp·on-line·reference·:·FILE·****
3	Table_of·······***·syntax·***	3	Table_of_Contents············***·syntax·***
4	Contents······· ·<[[ref]]DEF·NAME="HEADERIMG"·OPTION="SRC·TITLE·SIZE">
5	Introduction· · ·<[[ref]]IF·size>
6	License······ · · · ·<FONT·SIZE=${size}>
7	Tutorial····· · ·<[[ref]]/IF>
8	Usage········ · ·<[[ref]]IMG·SRC=pics/${src}>
9	HTP·Tags····· · ·<[[ref]]USE·title>
10	··ALTTEXT·· · ·<[[ref]]IF·size>
11	··BLOCK···· · · · ·</FONT>
12	··BLOCKDEF· · ·<[[ref]]/IF>
13	··DEF······ ·<[[ref]]/DEF>
14	[>]·FILE
15	··IF······· ·<HEADERIMG·SRC="logo.gif"·SIZE="+2"·TITLE="A·title">
16	··INC
17	··IMG······ ·<HEADERIMG·SRC="logo.gif"·TITLE="Normal·sized·title">
18	··IMAGEURL
19	··OPT······ ·This·will·fail:
20	··OUTPUT··· ·<HEADERIMG·SRC="logo.gif"·ALT="Our·logo"·TITLE="Another·title">
21	··QUOTE
22	··SET······ ·Instead,·use·*·like·this:
23	··UNDEF···· ·<[[ref]]DEF·NAME="MYIMG"·OPTION="SRC·*">
24	··UNSET···· · ·<[[ref]]IMG·SRC="pics/${src}"·$*>
25	··USE,_$··· ·<[[ref]]/DEF>
26	··WHILE···· ·
27	··<!---···· ·<MYIMG·SRC="logo.gif"·ALT="Our·logo">
28	History······***·synopsis·***
29	Wish_list····FILE·has·several·optional·parameters·of·differing·purpose.·The
30	Bugs·········output·file's·name,·the·current·date·and·time,·and·the·contents·of
31	···············another·file·may·be·included.·Another·file's·time,·date,·or·size
32	···············may·be·added·to·the·output·file·as·well.
33	···············As·with·all·HTML,·these·tags·do·not·have·to·be·on·their·own·line,
34	···············so·the·following·is·perfectly·acceptable:
35	···············<[[ref]]img·src="filename"·...>	4	Introduction···············<[[ref]]img·src="filename"·...>
		5	License
		6	Tutorial···················***·synopsis·***


Offset 1, 49 lines modified		Offset 1, 44 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·IF,·ELSEIF,·ELSE,·/IF·****	2	****·htp·on-line·reference·:·IF,·ELSEIF,·ELSE,·/IF·****
3	Table_of_Contents············***·syntax·***	3	Table_of_Contents············***·syntax·***
4	Introduction···············<[[ref]]img·src="filename"·...>
5	License
6	Tut~~orial····~~···············***·synopsis·***	4	Introduction···············***·synopsis·***
7	~~Usage··~~····················IF,·NOT,·ELSEIF,·ELSE,·and·/IF·are·the·building	5	License····················IF,·NOT,·ELSEIF,·ELSE,·and·/IF·are·the·building
8	~~HTP·Tags~~···················blocks·for·conditional·processing.·The·basic·form	6	Tutorial···················blocks·for·conditional·processing.·The·basic·form
9	~~··ALTTEXT~~················is·shown·above.	7	Usage······················is·shown·above.
10	··~~BLOCK~~··················"Conditional"·is·either·a·"compare"·or·"is	8	HTP·Tags···················"Conditional"·is·either·a·"compare"·or·"is
11	··BL~~OCKDEF~~···············defined"·operation.·A·compare·operator·is·a·test	9	··ALTTEXT················defined"·operation.·A·compare·operator·is·a·test
12	··~~DEF··~~··················of·the·value·of·a·macro·against·a·literal·string:	10	··BLOCK··················of·the·value·of·a·macro·against·a·literal·string:
13	··FILE···················<[[ref]]imageurl·url="imageurl"·[·path="path/in/
14	[>]·IF·····················local/filesystem"·]>
15	··INC
16	··~~IMG·····~~···············and·a·defined·operator·is·a·test·of·a·macro's	11	··BLOCKDEF···············and·a·defined·operator·is·a·test·of·a·macro's
17	··~~IMAGEURL~~···············existance:	12	··DEF····················existance:
18	··~~OPT·~~··················· · ·<[[ref]]INC·i="1"·j="-1">	13	··FILE··················· · ·<[[ref]]INC·i="1"·j="-1">
19	··~~OUTPUT~~·················If·the·NOT·tag·is·present·in·the·IF·markup,·the	14	[>]·IF·····················If·the·NOT·tag·is·present·in·the·IF·markup,·the
20	··~~QUOTE~~··················evaluation·of·the·conditional·is·reversed.·The	15	··INC····················evaluation·of·the·conditional·is·reversed.·The
21	··~~SET~~····················first·IF·or·ELSEIF·condition·that·evaluates·to	16	··IMG····················first·IF·or·ELSEIF·condition·that·evaluates·to
22	··~~UNDEF···~~···············true·is·chosen.·If·none·of·the·conditions·is·true	17	··IMAGEURL···············true·is·chosen.·If·none·of·the·conditions·is·true
23	··~~UNSET~~··················the·ELSE·block·is·taken·if·it·is·present.·A	18	··OPT····················the·ELSE·block·is·taken·if·it·is·present.·A
24	··~~USE,_$~~·················conditional·block·must·be·closed·with·the·/IF·tag.	19	··OUTPUT·················conditional·block·must·be·closed·with·the·/IF·tag.
25	··~~WHIL~~E··················IF·tags·can·be·nested.	20	··QUOTE··················IF·tags·can·be·nested.
		21	··SET
		22	··UNDEF
		23	··UNSET
		24	··USE,_$
		25	··WHILE
26	··<!---	26	··<!---
27	History	27	History
28	Wish_list	28	Wish_list
29	Bugs	29	Bugs


Offset 114, 60 lines modified		Offset 114, 34 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
		121	<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">...</span>></span><br>
121	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">DEF</a>·<span·class="htp-attrib">NAME</span>=<span·class="htp-string">"HEADERIMG"</span>·<span·class="htp-attrib">OPTION</span>=<span·class="htp-string">"SRC·TITLE·SIZE"</span>></span><br>
122	· ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IF</a>·<span·class="htp-attrib">size</span>></span><br>
123	· · · ·<span·class="htp-tag"><FONT·<span·class="htp-attrib">SIZE</span>=<span·class="htp-value"><span·class="htp-macro">${size}</span></span>></span><br>
124	· ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/IF</a>></span><br>
125	· ·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IMG</a>·<span·class="htp-attrib">SRC</span>=<span·class="htp-value">pics/<span·class="htp-macro">${src}</span></span>></span><br>
126	· ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">USE</a>·<span·class="htp-attrib">title</span>></span><br>
127	· ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IF</a>·<span·class="htp-attrib">size</span>></span><br>
128	· · · ·<span·class="htp-tag"></FONT></span><br>
129	· ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/IF</a>></span><br>
130	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/DEF</a>></span><br>
131	<br>
132	·<span·class="htp-tag"><HEADERIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">SIZE</span>=<span·class="htp-string">"+2"</span>·<span·class="htp-attrib">TITLE</span>=<span·class="htp-string">"A·title"</span>></span><br>
133	<br>
134	·<span·class="htp-tag"><HEADERIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">TITLE</span>=<span·class="htp-string">"Normal·sized·title"</span>></span><br>
135	<br>
136	·This·will·fail:<br>
137	·<span·class="htp-tag"><HEADERIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">ALT</span>=<span·class="htp-string">"Our·logo"</span>·<span·class="htp-attrib">TITLE</span>=<span·class="htp-string">"Another·title"</span>></span><br>
138	<br>	122	<br>
139	·Instead,·use·*·like·this:<br>
140	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">DEF</a>·<span·class="htp-attrib">NAME</span>=<span·class="htp-string">"MYIMG"</span>·<span·class="htp-attrib">OPTION</span>=<span·class="htp-string">"SRC·*"</span>></span><br>
141	· ·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IMG</a>·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"pics/<span·class="htp-macro">${src}</span>"</span>·<span·class="htp-attrib"><span·class="htp-macro">$*</span></span>></span><br>
142	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/DEF</a>></span><br>
143	· ·<br>
144	·<span·class="htp-tag"><MYIMG·<span·class="htp-attrib">SRC</span>=<span·class="htp-string">"logo.gif"</span>·<span·class="htp-attrib">ALT</span>=<span·class="htp-string">"Our·logo"</span>></span><br>
145	</code></p>	123	</code></p>
146	<h2>synopsis</h2>	124	<h2>synopsis</h2>
147	<STRONG>FILE</STRONG>·has·several·optional·parameters·of·differing·purpose.	125	<STRONG>FILE</STRONG>·has·several·optional·parameters·of·differing·purpose.
148	The·output·file's·name,·the·current·date·and·time,·and·the·contents·of	126	The·output·file's·name,·the·current·date·and·time,·and·the·contents·of
149	another·file·may·be·included.··Another·file's·time,·date,·or·size·may·be	127	another·file·may·be·included.··Another·file's·time,·date,·or·size·may·be
150	added·to·the·output·file·as·well.	128	added·to·the·output·file·as·well.
151	<P>	129	<P>
152	As·with·all·HTML,·these·tags·do·not·have·to·be·on·their·own·line,·so·the	130	As·with·all·HTML,·these·tags·do·not·have·to·be·on·their·own·line,·so·the
153	following·is·perfectly·acceptable:	131	following·is·perfectly·acceptable:
154	··<p><code>	132	··<p><code>
155	<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">...</span>></span><br>
156	<br>
157	</code></p>	133	</code></p>
158	<P>	134	<P>
159	<h3><a·name="name">NAME</a>,·TIME,·SIZE</h3>	135	<h3><a·name="name">NAME</a>,·TIME,·SIZE</h3>
160	<P>	136	<P>
161	To·include·information·about·another·file,·such·as·an·archive·file·or	137	To·include·information·about·another·file,·such·as·an·archive·file·or
162	graphic·image,·specify·its·name·with·the·NAME·attribute·followed·by·the	138	graphic·image,·specify·its·name·with·the·NAME·attribute·followed·by·the
163	type·of·information·to·be·displayed:	139	type·of·information·to·be·displayed:
164	··<p><code>	140	··<p><code>
165	<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">INC</a>·<span·class="htp-attrib">macroname1</span>=<span·class="htp-string">"increment1"</span>·<span·class="htp-attrib">[macroname2</span>=<span·class="htp-string">"increment2"</span>·<span·class="htp-attrib">...</span>·<span·class="htp-attrib">]</span>·<span·class="htp-attrib">[GLOBAL]</span>></span><br>
166	<br>
167	</code></p>	141	</code></p>
168	<P>	142	<P>
169	For·file·size·information,·the·value·BYTE,·KBYTE,·etc.·dictates·how·the	143	For·file·size·information,·the·value·BYTE,·KBYTE,·etc.·dictates·how·the
170	information·is·displayed.··In·anything·other·than·byte·format,·the·information	144	information·is·displayed.··In·anything·other·than·byte·format,·the·information
171	is·displayed·in·floating-point·notation.··The·amount·of·precision·(the·number	145	is·displayed·in·floating-point·notation.··The·amount·of·precision·(the·number
172	of·digits·to·the·right·of·the·decimal·point)·can·be·set·with·the·optional	146	of·digits·to·the·right·of·the·decimal·point)·can·be·set·with·the·optional
173	PRECISION·attribute.··The·default·precision·is·zero·(0),·which·means·no	147	PRECISION·attribute.··The·default·precision·is·zero·(0),·which·means·no


Offset 114, 26 lines modified		Offset 114, 22 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"filename"</span>·<span·class="htp-attrib">...</span>></span><br>
122	<br>
123	</code></p>	121	</code></p>
124	<h2>synopsis</h2>	122	<h2>synopsis</h2>
125	<STRONG>IF,·NOT,·ELSEIF,·ELSE,·and·/IF</STRONG>·are·the·building	123	<STRONG>IF,·NOT,·ELSEIF,·ELSE,·and·/IF</STRONG>·are·the·building
126	blocks·for·conditional·processing.··The·basic·form·is·shown·above.	124	blocks·for·conditional·processing.··The·basic·form·is·shown·above.
127	<P>·"Conditional"·is·either·a·"compare"·or·"is·defined"·operation.··A	125	<P>·"Conditional"·is·either·a·"compare"·or·"is·defined"·operation.··A
128	compare·operator·is·a·test·of·the·value·of·a·macro·against·a·literal	126	compare·operator·is·a·test·of·the·value·of·a·macro·against·a·literal
129	string:	127	string:
130	··<p><code>	128	··<p><code>
131	<span·class="htp-tag"><<a·href="imageurl.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">imageurl</a>·<span·class="htp-attrib">url</span>=<span·class="htp-string">"imageurl"</span>·<span·class="htp-attrib">[</span>·<span·class="htp-attrib">path</span>=<span·class="htp-string">"path/in/local/filesystem"</span>·<span·class="htp-attrib">]</span>></span><br>
132	<br>
133	</code></p>	129	</code></p>
134	<P>	130	<P>
135	and·a·defined·operator·is·a·test·of·a·macro's·existance:	131	and·a·defined·operator·is·a·test·of·a·macro's·existance:
136	<P>	132	<P>
137	··<p><code>	133	··<p><code>
138	· ·<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">INC</a>·<span·class="htp-attrib">i</span>=<span·class="htp-string">"1"</span>·<span·class="htp-attrib">j</span>=<span·class="htp-string">"-1"</span>></span><br>	134	· ·<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">INC</a>·<span·class="htp-attrib">i</span>=<span·class="htp-string">"1"</span>·<span·class="htp-attrib">j</span>=<span·class="htp-string">"-1"</span>></span><br>
139	</code></p>	135	</code></p>


Offset 114, 16 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	· ·<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">FILE</a>·<span·class="htp-attrib">INCLUDE</span>=<span·class="htp-string">"include.hti"</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"Jim·Nelson"</span>·<span·class="htp-attrib">email</span>=<span·class="htp-string">"jnelson@crl.com"</span>></span><br>
122	· ·This·tag·will·fail:·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">USE</a>·<span·class="htp-attrib">name</span>></span><br>
123	</code></p>	121	</code></p>
124	<h2>synopsis</h2>	122	<h2>synopsis</h2>
125	<P>	123	<P>
126	<STRONG>IMAGEURL</STRONG>·tells·htp,·where·to·find·images·on·the·local	124	<STRONG>IMAGEURL</STRONG>·tells·htp,·where·to·find·images·on·the·local
127	file·system.··declares·an·URL·replacement·that·is·used·for	125	file·system.··declares·an·URL·replacement·that·is·used·for
128	size·lookups·in·any·<A·HREF="img.html">IMG</A>·tag.·This·definitions	126	size·lookups·in·any·<A·HREF="img.html">IMG</A>·tag.·This·definitions
129	takes·effect·only·if·the·<A·HREF="opt.html">IMGXY</A>·option·is	127	takes·effect·only·if·the·<A·HREF="opt.html">IMGXY</A>·option·is


Offset 1, 39 lines modified		Offset 1, 41 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·IMAGEURL·****	2	****·htp·on-line·reference·:·IMAGEURL·****
3	Table_of_Contents····***·syntax·***	3	Table_of_Contents············***·syntax·***
4	Introduction······· · ·<[[ref]]FILE·INCLUDE="include.hti"·name="Jim·Nelson"
5	License············email="jnelson@crl.com">
6	Tutorial··········· · ·This·tag·will·fail:·<[[ref]]USE·name>
7	~~Usage~~··············***·synopsis·***	4	Introduction···············***·synopsis·***
8	~~HTP~~·~~Tags~~···········IMAGEURL·tells·htp,·where·to·find·images·on·th~~e·local·fil~~e	5	License····················IMAGEURL·tells·htp,·where·to·find·images·on·the
9	··ALTTEXT········system.·declares·an·URL·replacement·that·is·used·for·size
10	··BLOCK··········lookups·in·any·IMG·tag.·This·definitions·takes·effect·only
11	~~··BLOCKDEF~~·······if·~~the~~·~~IMGXY·opt~~ion·is·e~~nabl~~e~~d.·B~~eacause·~~htp~~·c~~an't·lookup~~	6	Tutorial···················local·file·system.·declares·an·URL·replacement
		7	Usage······················that·is·used·for·size·lookups·in·any·IMG·tag.·This
		8	HTP·Tags···················definitions·takes·effect·only·if·the·IMGXY·option
		9	··ALTTEXT················is·enabled.·Beacause·htp·can't·lookup·files·in·the
12	··~~DEF··~~··········~~files~~·in·~~the~~·world·wide·web·you·have·to·map·absolute·image	10	··BLOCK··················world·wide·web·you·have·to·map·absolute·image·URLs
13	··~~FIL~~E···········~~URLs~~·to·a·directory·in·the·local·file·system.	11	··BLOCKDEF···············to·a·directory·in·the·local·file·system.
14	··IF·············When·an·IMG·tag·is·encountered·where·htp·has·to~~·insert~~	12	··DEF····················When·an·IMG·tag·is·encountered·where·htp·has·to
15	··INC············width·and·height·the·defined·URL·replacements·will·be
16	··IMG············taken·into·account·(later·definitions·take·precedence·to
17	[>]·IMAGEURL·······earlier):·For·each·defined·imageurl·it·checks·(case-
18	··~~OPT·~~···········~~insensit~~iv~~e)·if~~·~~it·is~~·a~~·pref~~ix~~·of~~·the·~~image's~~·SRC	13	··FILE···················insert·width·and·height·the·defined·URL
		14	··IF·····················replacements·will·be·taken·into·account·(later
		15	··INC····················definitions·take·precedence·to·earlier):·For·each
		16	··IMG····················defined·imageurl·it·checks·(case-insensitive)·if
		17	[>]·IMAGEURL···············it·is·a·prefix·of·the·image's·SRC·attribute.·If·it
19	··OUTPUT·········~~attribute.~~·If·it·matches·this·prefix·is·replaced·by·the	18	··OPT····················matches·this·prefix·is·replaced·by·the·given·PATH.
20	··QUOT~~E··~~········~~giv~~en·~~PATH.~~·If·no·IMAGEURL·matches·the·SRC·is·considered	19	··OUTPUT·················If·no·IMAGEURL·matches·the·SRC·is·considered·as
21	··SET············as·relative·link·and·looked·up·in·the·curren~~t·direc~~t~~ory.~~	20	··QUOTE··················relative·link·and·looked·up·in·the·current
		21	··SET····················directory.
22	··UNDEF··········For·example:	22	··UNDEF··················For·example:
23	··UNSET·········· · ·<[[ref]]I~~NC·i="1"·j="-1"~~>	23	··UNSET·················· · ·<[[ref]]IF·name>...<[[ref]]/IF>
24	··USE,_$·········If·IMAGEURL·is·specified·with·a·URL·but·no·PATH~~·attribute,~~	24	··USE,_$·················If·IMAGEURL·is·specified·with·a·URL·but·no·PATH
25	··WHILE··········it·is·treated·as·an·undefine,·and·is~~·removed.~~	25	··WHILE··················attribute,·it·is·treated·as·an·undefine,·and·is
		26	··<!---··················removed.
26	··~~<!---~~··········Since·you·usually·need·the·url·mapping·for·a~~·number·of~~	27	History····················Since·you·usually·need·the·url·mapping·for·a
27	History············images·used·throughout·a·set·of·documents,·IMAGEURL·is
28	Wish_list··········most·appropriately·put·into·an·include_file·or·the·htp.def
29	~~Bug~~s···············file.	28	Wish_list··················number·of·images·used·throughout·a·set·of
		29	Bugs·······················documents,·IMAGEURL·is·most·appropriately·put·into
		30	·····························an·include_file·or·the·htp.def·file.
30	·····················In·addition·to·WIDTH·and·HEIGHT,·htp·can·also~~·(semi-~~	31	·····························In·addition·to·WIDTH·and·HEIGHT,·htp·can·also
31	·····················)automatically·add·an·ALT_text·attribute·to~~·IMG·tags.~~	32	·····························(semi-)automatically·add·an·ALT_text·attribute·to
		33	·····························IMG·tags.


Offset 114, 15 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	· ·<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">IF</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"Jim"</span>></span>...<span·class="htp-tag"><<a·href="if.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/IF</a>></span><br>
122	</code></p>	121	</code></p>
123	<h2>synopsis</h2>	122	<h2>synopsis</h2>
124	<P>·<STRONG>img</STRONG>·is·a·standard·HTML·tag.··htp·can·add·the·specified	123	<P>·<STRONG>img</STRONG>·is·a·standard·HTML·tag.··htp·can·add·the·specified
125	image's·width·and·height·to·the·tag·automatically.··This·has·the·advantage	124	image's·width·and·height·to·the·tag·automatically.··This·has·the·advantage
126	of·not·having·to·determine·each·image's·size·manually,·which·is·especially	125	of·not·having·to·determine·each·image's·size·manually,·which·is·especially
127	useful·if·the·image·may·change·frequently.·</P>	126	useful·if·the·image·may·change·frequently.·</P>
128	<P>·htp·adds·this·information·with·the·WIDTH·and·HEIGHT·markup	127	<P>·htp·adds·this·information·with·the·WIDTH·and·HEIGHT·markup


Offset 1, 45 lines modified		Offset 1, 44 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·IMG·****	2	****·htp·on-line·reference·:·IMG·****
3	Table_of_Contents············***·syntax·***	3	Table_of_Contents············***·syntax·***
4	Introduction··············· · ·<[[ref]]IF·name="Jim">...<[[ref]]/IF>
5	~~License·····~~···············***·synopsis·***	4	Introduction···············***·synopsis·***
6	~~Tutorial~~···················img·is·a·standard·HTML·tag.·htp·can·add·the	5	License····················img·is·a·standard·HTML·tag.·htp·can·add·the
7	~~Usage···~~···················specified·image's·width·and·height·to·the·tag	6	Tutorial···················specified·image's·width·and·height·to·the·tag
8	~~HTP·Tags~~···················automatically.·This·has·the·advantage·of·not	7	Usage······················automatically.·This·has·the·advantage·of·not
9	··~~ALTTEXT~~················having·to·determine·each·image's·size·manually,	8	HTP·Tags···················having·to·determine·each·image's·size·manually,
10	··BL~~OCK··~~················which·is·especially·useful·if·the·image·may·change	9	··ALTTEXT················which·is·especially·useful·if·the·image·may·change
11	··BLOCK~~DEF~~···············frequently.	10	··BLOCK··················frequently.
12	··~~DEF·····~~···············htp·adds·this·information·with·the·WIDTH·and	11	··BLOCKDEF···············htp·adds·this·information·with·the·WIDTH·and
13	··~~FILE~~···················HEIGHT·markup·attributes.·If·htp·detects·these	12	··DEF····················HEIGHT·markup·attributes.·If·htp·detects·these
14	··~~IF··~~···················attributes·are·already·present·in·the·tag,·it·will	13	··FILE···················attributes·are·already·present·in·the·tag,·it·will
15	··INC····················not·modify·the·values.·If·htp·cannot·find·the	14	··IF·····················not·modify·the·values.·If·htp·cannot·find·the
16	[>]·IMG····················image·file,·it·will·issue·a·warning·but·not·halt	15	··INC····················image·file,·it·will·issue·a·warning·but·not·halt
17	··IM~~AGEURL~~···············processing.	16	[>]·IMG····················processing.
18	··~~OPT·····~~···············At·this·time,·GIF·(Graphic·Interchange·Format),	17	··IMAGEURL···············At·this·time,·GIF·(Graphic·Interchange·Format),
19	··OUT~~PUT~~·················PNG·(Portable·Network·Graphics),·and·JFIF·(JPEG	18	··OPT····················PNG·(Portable·Network·Graphics),·and·JFIF·(JPEG
20	··QU~~OTE·~~·················File·Interchange·Format)·are·supported.	19	··OUTPUT·················File·Interchange·Format)·are·supported.
21	··~~SET··~~··················The·IMGXY_and_NOIMGXY·options·control·whether·or	20	··QUOTE··················The·IMGXY_and_NOIMGXY·options·control·whether·or
22	··~~UNDEF~~··················not·htp·actually·adds·this·information·as·it	21	··SET····················not·htp·actually·adds·this·information·as·it
23	··UNSET··················executes.	22	··UNDEF··················executes.
24	··USE,_$·················Since·htp·is·able·to·lookup·files·only·in·the	23	··UNSET··················Since·htp·is·able·to·lookup·files·only·in·the
25	··~~WHILE·~~·················local·filesystem,·the·IMAGEURL·tag·may·be·used·to	24	··USE,_$·················local·filesystem,·the·IMAGEURL·tag·may·be·used·to
26	··~~<!---~~··················map·URLs·to·local·files.	25	··WHILE··················map·URLs·to·local·files.
27	H~~istory··~~··················htp·can·also·add·default·ALT·text·to·IMG·tags	26	··<!---··················htp·can·also·add·default·ALT·text·to·IMG·tags
28	Wis~~h_list~~··················using·ALTTEXT.	27	History····················using·ALTTEXT.
		28	Wish_list
29	Bugs	29	Bugs


Offset 114, 37 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	· ·<span·class="htp-tag"><<a·href="file.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">FILE</a>·<span·class="htp-attrib">INCLUDE</span>=<span·class="htp-string">"include.hti"</span>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"Jim·Nelson"</span>·<span·class="htp-attrib">email</span>=<span·class="htp-string">"jnelson@crl.com"</span>></span><br>
122	· ·This·tag·will·fail:·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">USE</a>·<span·class="htp-attrib">name</span>></span><br>
123	/var/www/other.domain/"><br>
124	<br>
125	·For·this·line:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"logo.gif"</span>></span><br>
126	·the·local·filename·"logo.gif"·will·be·used·to·determine·image·dimensions<br>
127	·(no·URL·replacement).<br>
128	<br>
129	·For·this·line:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"http://my.domain.org/logo.gif"</span>></span><br>
130	·the·local·filename·"/var/www/my.domain/logo.gif"·will·be·used.<br>
131	<br>
132	·But·for·this·line:·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"http://other.domain.org/logo.gif"</span>></span><br>
133	·the·local·file·cannot·be·found·(no·prefix·match),·so·the·image·dimensions<br>
134	·will·not·be·added.<br>
135	<br>
136	·Order·is·important;·last·IMAGEURL·tag·takes·precedence:<br>
137	·<span·class="htp-tag"><<a·href="imageurl.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">imageurl</a>·<span·class="htp-attrib">url</span>=<span·class="htp-string">"/"</span>·<span·class="htp-attrib">path</span>=<span·class="htp-string">"/var/www/htdocs/"</span>></span><br>
138	·<span·class="htp-tag"><<a·href="imageurl.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">imageurl</a>·<span·class="htp-attrib">url</span>=<span·class="htp-string">"/test/"</span>·<span·class="htp-attrib">path</span>=<span·class="htp-string">"/var/www/test/"</span>></span><br>
139	<br>
140	·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"/image.gif"</span>></span> and·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"/test/image.gif"</span>></span> are·mapped·to<br>
141	·/var/www/htdocs/image.gif·and·/var/www/test/image.gif,·resp.<br>
142	·If·the·order·of·the·imageurl·lines·would·be·swapped,·the·second·<br>
143	·image·would·be·mapped·to·/var/www/htdocs/test/image.gif.<br>
144	</code></p>	121	</code></p>
145	<h2>synopsis</h2>	122	<h2>synopsis</h2>
146	The·<STRONG>INC</STRONG>·can·be·used·for·incrementing/decrementing·a	123	The·<STRONG>INC</STRONG>·can·be·used·for·incrementing/decrementing·a
147	variable·or·for·variable·addition.··The·basic·form·is·shown·above.	124	variable·or·for·variable·addition.··The·basic·form·is·shown·above.
148	<P>	125	<P>
149	The·"increment"·is·anything·that·evaluates·to·a·integer.··It·can·be·a	126	The·"increment"·is·anything·that·evaluates·to·a·integer.··It·can·be·a
150	literal·string·or·a·macro·preceeded·by·the·'$'-operator.··The	127	literal·string·or·a·macro·preceeded·by·the·'$'-operator.··The


Offset 1, 54 lines modified		Offset 1, 37 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·INC·****	2	****·htp·on-line·reference·:·INC·****
3	Table_of·······***·syntax·***	3	Table_of_Contents············***·syntax·***
		4	Introduction···············***·synopsis·***
		5	License····················The·INC·can·be·used·for·incrementing/decrementing
		6	Tutorial···················a·variable·or·for·variable·addition.·The·basic
		7	Usage······················form·is·shown·above.
		8	HTP·Tags···················The·"increment"·is·anything·that·evaluates·to·a
		9	··ALTTEXT················integer.·It·can·be·a·literal·string·or·a·macro
4	Contents······· · ·<[[ref]]FILE·INCLUDE="include.hti"·name="Jim·Nelson"
5	Introduction·email="jnelson@crl.com">
6	License······ · ·This·tag·will·fail:·<[[ref]]USE·name>
7	Tutorial·····/var/www/other.domain/">
8	Usage
9	HTP·Tags····· ·For·this·line:·<[[ref]]img·src="logo.gif">
10	··ALTTEXT·· ·the·local·filename·"logo.gif"·will·be·used·to·determine·image·dimensions
11	··BLOCK···· ·(no·URL·replacement).
12	··BLOCKDEF
13	··DEF······ ·For·this·line:·<[[ref]]img·src="http://my.domain.org/logo.gif">
14	··FILE····· ·the·local·filename·"/var/www/my.domain/logo.gif"·will·be·used.
15	··IF
16	[>]·INC······ ·But·for·this·line:·<[[ref]]img·src="http://other.domain.org/logo.gif">
17	··IMG······ ·the·local·file·cannot·be·found·(no·prefix·match),·so·the·image·dimensions
18	··IMAGEURL· ·will·not·be·added.
19	··OPT
20	··OUTPUT··· ·Order·is·important;·last·IMAGEURL·tag·takes·precedence:
21	··QUOTE···· ·<[[ref]]imageurl·url="/"·path="/var/www/htdocs/">
22	··SET······ ·<[[ref]]imageurl·url="/test/"·path="/var/www/test/">
23	··UNDEF
24	··UNSET···· ·<[[ref]]img·src="/image.gif"> and·<[[ref]]img·src="/test/image.gif"> are
25	··USE,_$···mapped·to
26	··WHILE···· ·/var/www/htdocs/image.gif·and·/var/www/test/image.gif,·resp.
27	··<!---···· ·If·the·order·of·the·imageurl·lines·would·be·swapped,·the·second
28	History······ ·image·would·be·mapped·to·/var/www/htdocs/test/image.gif.
29	Wish_list····***·synopsis·***
30	Bugs·········The·INC·can·be·used·for·incrementing/decrementing·a·variable·or·for·variable
31	···············addition.·The·basic·form·is·shown·above.
32	···············The·"increment"·is·anything·that·evaluates·to·a·integer.·It·can·be·a·literal
33	····~~·····~~······~~string~~·or·a·~~macro~~·preceeded·by·the·'$'-operator.·The·macroname·mus~~t·be·~~the	10	··BLOCK··················preceeded·by·the·'$'-operator.·The·macroname·must
34	···············name·of·a·defined·macro·that·contains·a~~n·integer.·If·the·increme~~n~~t·is~~	11	··BLOCKDEF···············be·the·name·of·a·defined·macro·that·contains·an
		12	··DEF····················integer.·If·the·increment·is·ommitted·it·defaults
35	····~~····~~·······~~ommitted~~·it·~~defaults~~·to·1.·The·effect·of·this·operation·is·that·the~~·macro·is~~	13	··FILE···················to·1.·The·effect·of·this·operation·is·that·the
36	···············redefined·to·contain·the·sum·of~~·its·previous·value·and~~·its~~·increment.~~	14	··IF·····················macro·is·redefined·to·contain·the·sum·of·its
		15	[>]·INC····················previous·value·and·its·increment.
37	···············To·increment·or·decrement·a·variable·you·can·use~~·this·form:~~	16	··IMG····················To·increment·or·decrement·a·variable·you·can·use
		17	··IMAGEURL···············this·form:
38	··············· · ·<[[ref]]INC·i="1"·j="-1">	18	··OPT···················· · ·<[[ref]]INC·i="1"·j="-1">
39	···············Note·that·INC·doesn't·check·if·the·strings·reall~~y·denote·integers.·It·ma~~y	19	··OUTPUT·················Note·that·INC·doesn't·check·if·the·strings·really
		20	··QUOTE··················denote·integers.·It·may·give·weired·results·when
40	····~~···~~········~~give~~·~~weired~~·~~results~~·~~when~~·used·on·arbitrary·strings.·The·integer·values·are	21	··SET····················used·on·arbitrary·strings.·The·integer·values·are
41	···············limited·to·the·range·-2^31..2^31.	22	··UNDEF··················limited·to·the·range·-2^31..2^31.
42	···············Note·further·that·htp·wasn't·designed·to·d~~o·extensive·calculati~~o~~ns.·The·INC~~	23	··UNSET··················Note·further·that·htp·wasn't·designed·to·do
		24	··USE,_$·················extensive·calculations.·The·INC·tag·is·useful·in
43	····~~·····~~······~~tag~~·is·~~useful~~·in·conjunction·with·WHILE·to·iterate·over·the·defined~~·blocks.~~	25	··WHILE··················conjunction·with·WHILE·to·iterate·over·the·defined


		26	··<!---··················blocks.
		27	History
		28	Wish_list
		29	Bugs


Offset 88, 16 lines modified		Offset 88, 14 lines modified
88	<P>·Metatags·are·defined·with·the·<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>def</code></a>·and·<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>blockdef</code></a>·tags·and	88	<P>·Metatags·are·defined·with·the·<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>def</code></a>·and·<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>blockdef</code></a>·tags·and
89	undefined·with·the·<a·href="undef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>undef</code></a>·tag.··</P>	89	undefined·with·the·<a·href="undef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>undef</code></a>·tag.··</P>
90	<P>	90	<P>
91	As·an·example·we·show·how·to·define·a·tag·that·builds·a	91	As·an·example·we·show·how·to·define·a·tag·that·builds·a
92	fancy·horizontal·rule·out·of·several·images.	92	fancy·horizontal·rule·out·of·several·images.
93	</P>	93	</P>
94	··<p><code>	94	··<p><code>
95	<font·size="-2"> 1.·</font><span·class="htp-tag"><<a·href="set.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">SET</a>·<span·class="htp-attrib">macroname1</span>=<span·class="htp-string">"macrovalue1"</span>·<span·class="htp-attrib">[macroname2</span>=<span·class="htp-string">"macrovalue2"</span>·<span·class="htp-attrib">...]</span>·<span·class="htp-attrib">[GLOBAL]</span>></span><br>
96	<font·size="-2"> 2.·</font><br>
97	</code></p>	95	</code></p>
98	<P>·In·line·1·of·the·above·example·a·new·tag·named·imghr·is·defined.	96	<P>·In·line·1·of·the·above·example·a·new·tag·named·imghr·is·defined.
99	The·html·code·which·implements·this·rule·is·following·in·lines·2-8.	97	The·html·code·which·implements·this·rule·is·following·in·lines·2-8.
100	between·the·<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>def</code>·and	98	between·the·<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10"><code>def</code>·and
101	<code>/def</code></a>·tags.··You·don't·have·to·understand·this	99	<code>/def</code></a>·tags.··You·don't·have·to·understand·this
102	html·code,·but·you·should·understand·that·this·is·just·pure·html·to	100	html·code,·but·you·should·understand·that·this·is·just·pure·html·to
103	draw·the·fancy·rule.·Every·time·you·write·<code><imghr></code>	101	draw·the·fancy·rule.·Every·time·you·write·<code><imghr></code>


Offset 1, 98 lines modified		Offset 1, 87 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·Metatags·****	2	****·htp·on-line·reference·:·Metatags·****
3	Table_of········***·Programming·your·own·tags·***	3	Table_of········***·Programming·your·own·tags·***
4	Contents········Metatags·allow·for·defining·your·own·HTML-like·tags.·When·you·define·a	4	Contents········Metatags·allow·for·defining·your·own·HTML-like·tags.·When·you·define
5	Introduction··metatag·you·have·to·provide·the·HTML·code·which·it·abbreviates.·In~~·fact~~	5	Introduction··a·metatag·you·have·to·provide·the·HTML·code·which·it·abbreviates.·In
6	License·······metatags·are·just·like·block·macros,·but·they·have·a·nicer~~·syntax.·With~~	6	License·······fact·metatags·are·just·like·block·macros,·but·they·have·a·nicer
7	Tutorial······metatags·you·can·expand·htp's·functionality.	7	Tutorial······syntax.·With·metatags·you·can·expand·htp's·functionality.
8	··Macros····Metatags·are·defined·with·the·[[ref]]def·and·[[ref]]blockdef·tags·and	8	··Macros····Metatags·are·defined·with·the·[[ref]]def·and·[[ref]]blockdef·tags·and
9	··Including·undefined·with·the·[[ref]]undef·tag.	9	··Including·undefined·with·the·[[ref]]undef·tag.
10	··Templates·As·an·example·we·show·how·to·define·a·tag·that·builds·a·fancy~~·horizontal~~	10	··Templates·As·an·example·we·show·how·to·define·a·tag·that·builds·a·fancy
11	··Files·····rule·out·of·several·images.	11	··Files·····horizontal·rule·out·of·several·images.
12	[>]·Metatags·· 1.<[[ref]]SET·macroname1="macrovalue1"·[macroname2="macrovalue2"·...]
13	Usage·········[GLOBAL]>
14	HTP_Tags······ 2.
15	~~History·····~~··In·line·1·of·the·above·example·a·new·tag·named·imghr·is·defined.·The	12	[>]·Metatags··In·line·1·of·the·above·example·a·new·tag·named·imghr·is·defined.·The
16	~~Wish_list~~·····html·code·which·implements·this·rule·is·following·in·lines·2-8.~~·between~~	13	Usage·········html·code·which·implements·this·rule·is·following·in·lines·2-8.
17	Bugs······~~···~~·the·[[ref]]def_and_/def·tags.·You·don't·have·to·understand~~·this·html~~	14	HTP_Tags······between·the·[[ref]]def_and_/def·tags.·You·don't·have·to·understand
18	·······~~···~~·~~····~~·code,·but·you·should·understand·that·this·is·just·pure·html~~·to·draw·the~~	15	History·······this·html·code,·but·you·should·understand·that·this·is·just·pure·html
19	················fancy·rule.·Every·time·you·write·<imghr>·as·in·line·12·htp·will·replace
20	················this·tag·with·the·corresponding·html·code.·To·make·metatags·available·to
21	················all·htp·documents·in·your·project,·place·them·in·a·common·[[ref]]include
22	················file.	16	Wish_list·····to·draw·the·fancy·rule.·Every·time·you·write·<imghr>·as·in·line·12
		17	Bugs··········htp·will·replace·this·tag·with·the·corresponding·html·code.·To·make
		18	················metatags·available·to·all·htp·documents·in·your·project,·place·them
		19	················in·a·common·[[ref]]include_file.
23	················Often·you·want·to·define·tags·that·have·an·opening·and·a·closing	20	················Often·you·want·to·define·tags·that·have·an·opening·and·a·closing
24	················variant.·For·this·purpose·you·should·use·the·[[ref]]blockdef·tag.~~·When~~	21	················variant.·For·this·purpose·you·should·use·the·[[ref]]blockdef·tag.
25	················htp·encounters·a·blockdef·tag·it·will·automatically·search·for~~·the~~	22	················When·htp·encounters·a·blockdef·tag·it·will·automatically·search·for
26	················matching·closing·tag·and·put·everything·between·these·tags·in·a~~·block~~	23	················the·matching·closing·tag·and·put·everything·between·these·tags·in·a
27	················macro·named·block.·Here·is·an·example·for·this.	24	················block·macro·named·block.·Here·is·an·example·for·this.
28	················ 1. · ·<[[ref]]SET·emailaddr="jnelson@crl.com">
29	················***·Using·parameters·***	25	················***·Using·parameters·***
30	················More·sophisticated·tags·accept·parameters.·The·option·parameter·lets	26	················More·sophisticated·tags·accept·parameters.·The·option·parameter·lets
31	················multiple·metatag·parameters·be·named·and·expanded·inside·the·def·or	27	················multiple·metatag·parameters·be·named·and·expanded·inside·the·def·or
32	················blockdef·block:	28	················blockdef·block:
33	················ 1. ·<[[ref]]def·name="sharedimg"·option="name·alt">	29	················ 1. ·<[[ref]]def·name="sharedimg"·option="name·alt">
34	················ 2. · ·<[[ref]]img·src="/home/sharedimages/${name}"·alt="${alt}">;	30	················ 2. · ·<[[ref]]img·src="/home/sharedimages/${name}"·alt="${alt}">;
35	················ 3. ·<[[ref]]/def>	31	················ 3. ·<[[ref]]/def>
36	················ 4.	32	················ 4.
37	················ 5. ·<sharedimg·name="bubble.gif"·alt="Bubble·image">	33	················ 5. ·<sharedimg·name="bubble.gif"·alt="Bubble·image">
38	················***·Saving·blocks·for·later·***	34	················***·Saving·blocks·for·later·***
39	················When·you·are·using·templates,·the·html·should·only·be·written·by·the	35	················When·you·are·using·templates,·the·html·should·only·be·written·by·the
40	················template·file.·The·normal·htp·files·should·just·define·macros·that~~·are~~	36	················template·file.·The·normal·htp·files·should·just·define·macros·that
41	················used·later·in·the·template.·So·you·may·want·to·write·block·tags~~·that~~	37	················are·used·later·in·the·template.·So·you·may·want·to·write·block·tags
42	················just·save·the·block·in·a·macro·for·later·use.·Although·this·i~~s·pos~~s~~ible~~	38	················that·just·save·the·block·in·a·macro·for·later·use.·Although·this·is
43	················with·htp·it·is·quite·tricky,·so·here·we·present·the·way·t~~o·d~~o~~·this:~~	39	················possible·with·htp·it·is·quite·tricky,·so·here·we·present·the·way·to
		40	················do·this:
44	················ 1. ·<[[ref]]set·sect-ctr="0">
45	················ 2. ·<[[ref]]blockdef·name="section">
46	················ 3. · ·<[[ref]]inc·sect-ctr>
47	················ 4. · ·<[[ref]]block·name="sect-${sect-ctr}"·expand·global>
48	················ 5. · · ·<[[ref]]use·block·noexpand>
49	················ 6. · ·<[[ref]]/block>
50	················ 7. ·<[[ref]]/blockdef>
51	················This·defines·a·block·macro·named·section.·This·macro·uses·a·counter	41	················This·defines·a·block·macro·named·section.·This·macro·uses·a·counter
52	················sect-ctr·that·enumerates·the·sections.·It·is·increased·for·every~~·section~~	42	················sect-ctr·that·enumerates·the·sections.·It·is·increased·for·every
53	················(line·3)·and·then·the·block·macro·name·is·build·from·this~~·counter.·So~~	43	················section·(line·3)·and·then·the·block·macro·name·is·build·from·this
54	················the·first·section·is·stored·in·block·sect-1,·the·seco~~nd·in·sect-2·a~~nd~~·so~~	44	················counter.·So·the·first·section·is·stored·in·block·sect-1,·the·second
55	················on.·The·[[ref]]global·flag·in·line·4·tells·htp·that·t~~hese·macros·should~~	45	················in·sect-2·and·so·on.·The·[[ref]]global·flag·in·line·4·tells·htp·that
56	················be·defined·globally·for·the·remaining·run.~~·Otherwise·they·would·be~~	46	················these·macros·should·be·defined·globally·for·the·remaining·run.
57	················forgotten·at·the·end·of·the·section·macro.	47	················Otherwise·they·would·be·forgotten·at·the·end·of·the·section·macro.
58	················The·tricky·part·is·the·[[ref]]expand·and·noexpand·flags·in·line·4·and~~·5.~~	48	················The·tricky·part·is·the·[[ref]]expand·and·noexpand·flags·in·line·4·and
59	················Normally·when·you·define·a·block·macro·the·code·between·the·start~~·and~~	49	················5.·Normally·when·you·define·a·block·macro·the·code·between·the·start
60	················end·tag·is·literally·copied·into·the·macro·value.·The·expansion~~·takes~~	50	················and·end·tag·is·literally·copied·into·the·macro·value.·The·expansion
61	················place·when·the·macro·is·used.·In·this·case·that·doesn't·mak~~e·sens~~e~~;·all~~	51	················takes·place·when·the·macro·is·used.·In·this·case·that·doesn't·make
62	················macros·sect-1,·sect-2·and·so·on·would·just·contain·th~~e·same·valu~~e,	52	················sense;·all·macros·sect-1,·sect-2·and·so·on·would·just·contain·the
63	················namely·<use·block>·and·block·wouldn't·be·defined·anymor~~e·when·th~~e~~·macros~~	53	················same·value,·namely·<use·block>·and·block·wouldn't·be·defined·anymore
64	················are·finally·expanded.·Therefore·we·use·expand·to~~·expand·the·use·tag~~	54	················when·the·macros·are·finally·expanded.·Therefore·we·use·expand·to
65	················already·when·sect-1·is·defined.	55	················expand·the·use·tag·already·when·sect-1·is·defined.
66	················The·noexpand·attribute·of·the·[[ref]]use·tag·is·just·the·opposite·and	56	················The·noexpand·attribute·of·the·[[ref]]use·tag·is·just·the·opposite·and
67	················prevents·the·contents·of·block·to·be·expanded·twice.·If·you·omit·it,~~·it~~	57	················prevents·the·contents·of·block·to·be·expanded·twice.·If·you·omit·it,
68	················would·be·expanded·when·defining·the·sect-1·macro·and·when·using·i~~t·la~~ter	58	················it·would·be·expanded·when·defining·the·sect-1·macro·and·when·using·it
69	················in·the·template.·Generally·it·is·a·good·idea·to·use·noexpand~~·whenever~~	59	················later·in·the·template.·Generally·it·is·a·good·idea·to·use·noexpand
70	················you·use·expand·in·a·block·around·it.	60	················whenever·you·use·expand·in·a·block·around·it.
71	················To·close·this·example·we·show·how·to·expand·the·sect-${sect-ctr}~~·blocks~~	61	················To·close·this·example·we·show·how·to·expand·the·sect-${sect-ctr}
72	················in·the·template:	62	················blocks·in·the·template:
		63	················ 1.<[[ref]]UNDEF·tagname>
		64	················ 2.<[[ref]]UNDEF·tagname1·tagname2·...·>
73	················ 1.<[[ref]]WHILE·[NOT]·conditional>
74	················ 2. · ·block
75	················ 3.<[[ref]]/WHILE>
76	················ 4.	65	················ 3.
77	················The·[[ref]]while·tag·in·line·3·checks·whether·the·macro·sect-${sect-~~ctr}~~	66	················The·[[ref]]while·tag·in·line·3·checks·whether·the·macro·sect-${sect-
78	················is·defined.·If·it·is·defined·the·body·is·evaluated,·whic~~h·expands·t~~he	67	················ctr}·is·defined.·If·it·is·defined·the·body·is·evaluated,·which
79	················macro·and·increases·sect-ctr.·Afterwards·the·whil~~e·condition·is·check~~ed	68	················expands·the·macro·and·increases·sect-ctr.·Afterwards·the·while
80	················again·to·check·for·sect-2·macro.·This·repeats·until·sect-${sect-ctr}·is
81	················not·defined.	69	················condition·is·checked·again·to·check·for·sect-2·macro.·This·repeats
		70	················until·sect-${sect-ctr}·is·not·defined.
82	················***·Conclusions·***	71	················***·Conclusions·***
83	················This·closes·our·short·htp·tutorial.·I·hope·you·did·enjoy·it·and·see~~·the~~	72	················This·closes·our·short·htp·tutorial.·I·hope·you·did·enjoy·it·and·see
84	················advantages·of·using·htp·for·your·own·projects.·Please·give·us·s~~ome~~	73	················the·advantages·of·using·htp·for·your·own·projects.·Please·give·us
85	················feedback·about·this·tutorial.·What·can·be·improved?	74	················some·feedback·about·this·tutorial.·What·can·be·improved?
86	················There·is·more·documentation·in·this·manual,·see·the·[[ref]]Usage~~·chapter~~	75	················There·is·more·documentation·in·this·manual,·see·the·[[ref]]Usage
87	················or·browse·the·documentations·for·the·htp·tags.·If·you're~~·looking·for~~	76	················chapter·or·browse·the·documentations·for·the·htp·tags.·If·you're
88	················examples,·in·case·you·haven't·already·noticed·yourself,~~·there·is·a·link~~	77	················looking·for·examples,·in·case·you·haven't·already·noticed·yourself,
89	················to·the·source·code·on·the·left,·where·you·can·get·th~~e·source·cod~~e~~·for~~	78	················there·is·a·link·to·the·source·code·on·the·left,·where·you·can·get·the
90	················every·page·on·this·site.	79	················source·code·for·every·page·on·this·site.


Offset 114, 27 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"imghr"</span>></span><br>
122	· <span·class="htp-tag"><table·<span·class="htp-attrib">border</span>=<span·class="htp-string">"0"</span>·<span·class="htp-attrib">cellspacing</span>=<span·class="htp-string">"0"</span>·<span·class="htp-attrib">cellpadding</span>=<span·class="htp-string">"0"</span>></span><br>
123	· <span·class="htp-tag"><tr></span><br>
124	· ·<span·class="htp-tag"><td·<span·class="htp-attrib">width</span>=<span·class="htp-value">10</span>></span><span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"leftsep.png"</span>></span><span·class="htp-tag"></td></span><br>
125	· ·<span·class="htp-tag"><td·<span·class="htp-attrib">width</span>=<span·class="htp-string">"95%"</span>·<span·class="htp-attrib">background</span>=<span·class="htp-string">"midsep.png"</span>></span>&nbsp;<span·class="htp-tag"></td></span><br>
126	· ·<span·class="htp-tag"><td·<span·class="htp-attrib">width</span>=<span·class="htp-value">10</span>></span><span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"rightsep.png"</span>></span><span·class="htp-tag"></td></span><br>
127	· <span·class="htp-tag"></tr></span><br>
128	· <span·class="htp-tag"></table></span><br>
129	<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/def</a>></span><br>
130	<br>
131	paragraph<br>
132	<span·class="htp-tag"><imghr></span><br>
133	paragraph<br>
134	</code></p>	121	</code></p>
135	<h2>synopsis</h2>	122	<h2>synopsis</h2>
136	<STRONG>OPT</STRONG>·is·an·htp·tag·that·can·be·used·to·specify·processing	123	<STRONG>OPT</STRONG>·is·an·htp·tag·that·can·be·used·to·specify·processing
137	options·inside·the·actual·document·being·processed.··The·options·are	124	options·inside·the·actual·document·being·processed.··The·options·are
138	used·exactly·as·they·would·be·on·the·command-line,·although·they·are·not	125	used·exactly·as·they·would·be·on·the·command-line,·although·they·are·not
139	preceded·by·a·‘-’·character.	126	preceded·by·a·‘-’·character.
140	<P>	127	<P>


Offset 1, 49 lines modified		Offset 1, 38 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·OPT·****	2	****·htp·on-line·reference·:·OPT·****
3	Table_of·······***·syntax·***	3	Table_of·······***·syntax·***
4	Contents······· <[[ref]]def·name="imghr">
5	Introduction· · <table·border="0"·cellspacing="0"·cellpadding="0">
6	License······ · <tr>
7	Tutorial····· · ·<td·width=10><[[ref]]img·src="leftsep.png"></td>
8	Usage········ · ·<td·width="95%"·background="midsep.png"> </td>
9	HTP·Tags····· · ·<td·width=10><[[ref]]img·src="rightsep.png"></td>
10	··ALTTEXT·· · </tr>
11	··BLOCK···· · </table>
12	··~~BLOCKDEF~~· ~~<[[ref]]/def>~~	4	Contents·······***·synopsis·***
		5	Introduction·OPT·is·an·htp·tag·that·can·be·used·to·specify·processing·options·inside·the
		6	License······actual·document·being·processed.·The·options·are·used·exactly·as·they·would·be
		7	Tutorial·····on·the·command-line,·although·they·are·not·preceded·by·a·‘-’·character.
		8	Usage········Click·here·for·more_information_on_using_customization_options_with_htp.
		9	HTP·Tags
		10	··ALTTEXT
		11	··BLOCK
		12	··BLOCKDEF
13	··DEF	13	··DEF
14	··FILE····· paragraph
15	··IF······· <imghr>
16	··INC······ paragraph
17	··IMG······***·synopsis·***
18	··IMAGEURL·OPT·is·an·htp·tag·that·can·be·used·to·specify·processing·options·inside·the
19	[>]·OPT······actual·document·being·processed.·The·options·are·used·exactly·as·they·would·be
20	··OUTPUT···on·the·command-line,·although·they·are·not·preceded·by·a·‘-’·character.
21	··Q~~UOT~~E~~····Click·here·for·more_information_on_using_customization_options_with_htp.~~	14	··FILE
		15	··IF
		16	··INC
		17	··IMG
		18	··IMAGEURL
		19	[>]·OPT
		20	··OUTPUT
		21	··QUOTE
22	··SET	22	··SET
23	··UNDEF	23	··UNDEF
24	··UNSET	24	··UNSET
25	··USE,_$	25	··USE,_$
26	··WHILE	26	··WHILE
27	··<!---	27	··<!---
28	History	28	History
29	Wish_list	29	Wish_list
30	Bugs	30	Bugs











31	page_source	31	page_source
32	htp_project	32	htp_project
33	htp_homepage	33	htp_homepage
34	hosted·by	34	hosted·by
35	Sourceforge	35	Sourceforge
36	HTML·coding	36	HTML·coding
37	[Powered_by	37	[Powered_by


Offset 1, 25 lines modified		Offset 1, 25 lines modified

1	[HTP]	1	[HTP]
2	****·htp·on-line·reference·:·OUTPUT·****	2	****·htp·on-line·reference·:·OUTPUT·****
3	Table_of_Contents············***·syntax·***	3	Table_of_Contents············***·syntax·***
4	Introduction···············<[[ref]]QUOTE·TAG·[ATTRIBUTE=VALUE·...]>
5	License
6	Tut~~orial····~~···············***·synopsis·***	4	Introduction···············***·synopsis·***
7	~~Usage··~~····················The·OUTPUT·tag·can·be·used·to·create·auxillary	5	License····················The·OUTPUT·tag·can·be·used·to·create·auxillary
8	~~HTP·Tags~~···················files·besides·the·main·HTML·file.·The·text·between	6	Tutorial···················files·besides·the·main·HTML·file.·The·text·between
9	~~··ALTTEXT~~················this·tag·and·the·corresponding·</OUTPUT>·tag·is	7	Usage······················this·tag·and·the·corresponding·</OUTPUT>·tag·is
10	··~~BLOCK~~··················written·to·output·file.	8	HTP·Tags···················written·to·output·file.
11	··BL~~OCKDEF~~···············Normally·the·outputfile·is·cleared·before·writing	9	··ALTTEXT················Normally·the·outputfile·is·cleared·before·writing
12	··~~DEF··~~··················to·it,·but·you·can·use·the·APPEND·attribute·to	10	··BLOCK··················to·it,·but·you·can·use·the·APPEND·attribute·to
13	··~~FILE····~~···············extend·an·existing·file.·The·text·written·to·the	11	··BLOCKDEF···············extend·an·existing·file.·The·text·written·to·the
14	··~~IF·~~····················file·is·normally·not·expanded,·i.e.·all·tags	12	··DEF····················file·is·normally·not·expanded,·i.e.·all·tags
15	··~~INC·~~···················inside·this·block·are·not·executed·but·written	13	··FILE···················inside·this·block·are·not·executed·but·written
16	··IMG····················unmodified·to·the·file.·However,·you·can·use·the	14	··IF·····················unmodified·to·the·file.·However,·you·can·use·the
17	··I~~MAGEURL~~···············EXPAND·attribute·to·override·this·behaviour.	15	··INC····················EXPAND·attribute·to·override·this·behaviour.
		16	··IMG
		17	··IMAGEURL
18	··OPT	18	··OPT
19	[>]·OUTPUT	19	[>]·OUTPUT
20	··QUOTE	20	··QUOTE
21	··SET	21	··SET
22	··UNDEF	22	··UNDEF
23	··UNSET	23	··UNSET
24	··USE,_$	24	··USE,_$


Offset 114, 21 lines modified		Offset 114, 21 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
		121	·<span·class="htp-tag"><<a·href="set.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">set</a>·<span·class="htp-attrib">sect-ctr</span>=<span·class="htp-string">"0"</span>></span><br>
121	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"bo~~ldi~~ta~~lic~~"</span>></span><br>	122	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"section"</span>></span><br>
122	· ·<span·class="htp-tag"><b></span><span·class="htp-tag"><i></span><br>
123	· ·<span·class="htp-tag"><<a·href="~~use~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">~~use~~</a>·<span·class="htp-attrib">~~blo~~ck</span>></span><br>	123	· ·<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">inc</a>·<span·class="htp-attrib">sect-ctr</span>></span><br>
124	· ·<span·class="htp-tag"></i></span><span·class="htp-tag"></b></span><br>	124	· ·<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">block</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"sect-<span·class="htp-macro">${sect-ctr}</span>"</span>·<span·class="htp-attrib">expand</sp[·...·truncated·by·diffoscope;·len:·42,·SHA:·37eb4a8d46f3410fb1f4c4bb9945bd70d3a80e30d58d0607eb4d16840f9bb68e·...·]></span><br>
		125	· · ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">block</span>·<span·class="htp-attrib">noexpand</span>></span><br>
		126	· ·<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/block</a>></span><br>
125	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>	127	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>
126	<br>
127	·This·is·<span·class="htp-tag"><bolditalic></span>bold·and·italic<span·class="htp-tag"></bolditalic></span><br>
128	</code></p>	128	</code></p>
129	<h2>synopsis</h2>	129	<h2>synopsis</h2>
130	<STRONG>QUOTE</STRONG>·is·used·to·quote·a·macro·that·would·otherwise	130	<STRONG>QUOTE</STRONG>·is·used·to·quote·a·macro·that·would·otherwise
131	be·interpreted·by·HTP.··It·may·be·useful·in·conjunction·with·a	131	be·interpreted·by·HTP.··It·may·be·useful·in·conjunction·with·a
132	surrounding·<a·href="expand.html">EXPAND</a>ed·block·to·prevent·early	132	surrounding·<a·href="expand.html">EXPAND</a>ed·block·to·prevent·early
133	expansion·of·some·contained·blocks.··Note·that·'$'·evaluation·is·still	133	expansion·of·some·contained·blocks.··Note·that·'$'·evaluation·is·still
134	done·inside·a·quote·block.	134	done·inside·a·quote·block.


Offset 114, 31 lines modified		Offset 114, 29 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
		121	·<span·class="htp-tag"><<a·href="set.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">set</a>·<span·class="htp-attrib">sect-ctr</span>=<span·class="htp-string">"0"</span>></span><br>
121	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"bo~~ldi~~ta~~lic~~"</span>></span><br>	122	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"section"</span>></span><br>
122	· ·<span·class="htp-tag"><b></span><span·class="htp-tag"><i></span><br>
123	· ·<span·class="htp-tag"><<a·href="~~use~~.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">~~use~~</a>·<span·class="htp-attrib">~~blo~~ck</span>></span><br>	123	· ·<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">inc</a>·<span·class="htp-attrib">sect-ctr</span>></span><br>
124	· ·<span·class="htp-tag"></i></span><span·class="htp-tag"></b></span><br>	124	· ·<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">block</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"sect-<span·class="htp-macro">${sect-ctr}</span>"</span>·<span·class="htp-attrib">expand</sp[·...·truncated·by·diffoscope;·len:·42,·SHA:·37eb4a8d46f3410fb1f4c4bb9945bd70d3a80e30d58d0607eb4d16840f9bb68e·...·]></span><br>
		125	· · ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">block</span>·<span·class="htp-attrib">noexpand</span>></span><br>
		126	· ·<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/block</a>></span><br>
125	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>	127	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>
126	<br>
127	·This·is·<span·class="htp-tag"><bolditalic></span>bold·and·italic<span·class="htp-tag"></bolditalic></span><br>
128	</code></p>	128	</code></p>
129	<h2>synopsis</h2>	129	<h2>synopsis</h2>
130	<STRONG>SET</STRONG>·creates·a·macro·definition·that·can·later·be·expanded	130	<STRONG>SET</STRONG>·creates·a·macro·definition·that·can·later·be·expanded
131	anywhere·in·the·HTML·document.··To·create·a·macro:	131	anywhere·in·the·HTML·document.··To·create·a·macro:
132	··<p><code>	132	··<p><code>
133	·<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">def</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"sharedimg"</span>·<span·class="htp-attrib">option</span>=<span·class="htp-string">"name·alt"</span>></span><br>
134	· ·<span·class="htp-tag"><<a·href="img.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">img</a>·<span·class="htp-attrib">src</span>=<span·class="htp-string">"/home/sharedimages/<span·class="htp-macro">${name}</span>"</span>·<span·class="htp-attrib">alt</span>=<span·class="htp-string">"<span·class="htp-macro">${alt}</span>"</span>></span>;<br>
135	~~ ·~~<span·class="htp-tag"><<a·href="def.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/~~def~~</a>></span><br>	133	<span·class="htp-tag"><<a·href="undef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">UNDEF</a>·<span·class="htp-attrib">tagname</span>></span><br>
		134	<span·class="htp-tag"><<a·href="undef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">UNDEF</a>·<span·class="htp-attrib">tagname1</span>·<span·class="htp-attrib">tagname2</span>·<span·class="htp-attrib">...</span>·></span><br>
136	<br>	135	<br>
137	·<span·class="htp-tag"><sharedimg·<span·class="htp-attrib">name</span>=<span·class="htp-string">"bubble.gif"</span>·<span·class="htp-attrib">alt</span>=<span·class="htp-string">"Bubble·image"</span>></span><br>
138	</code></p>	136	</code></p>
139	<P>	137	<P>
140	The·macro·"emailaddr"·can·then·be·expanded·later.··The·<A·HREF="use.html">	138	The·macro·"emailaddr"·can·then·be·expanded·later.··The·<A·HREF="use.html">
141	USE</A>·tag·is·used·to·expand·the·macro·outside·a·tag·(i.e.,·into·the·regular	139	USE</A>·tag·is·used·to·expand·the·macro·outside·a·tag·(i.e.,·into·the·regular
142	text).··If·the·macro·needs·to·be·expanded·inside·a·markup·tag,·use·the	140	text).··If·the·macro·needs·to·be·expanded·inside·a·markup·tag,·use·the
143	<A·HREF="use.html">'$'</A>·operator.	141	<A·HREF="use.html">'$'</A>·operator.
144	<P>	142	<P>


Offset 114, 43 lines modified		Offset 114, 37 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	·<span·class="htp-tag"><<a·href="set.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">set</a>·<span·class="htp-attrib">sect-ctr</span>=<span·class="htp-string">"0"</span>></span><br>
122	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">blockdef</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"section"</span>></span><br>
123	· ·<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">inc</a>·<span·class="htp-attrib">sect-ctr</span>></span><br>
124	· ·<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">block</a>·<span·class="htp-attrib">name</span>=<span·class="htp-string">"sect-<span·class="htp-macro">${sect-ctr}</span>"</span>·<span·class="htp-attrib">expand</span>·<span·class="htp-attrib">global</span>></span><br>
125	· · ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">block</span>·<span·class="htp-attrib">noexpand</span>></span><br>
126	· ·<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/block</a>></span><br>
127	·<span·class="htp-tag"><<a·href="blockdef.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/blockdef</a>></span><br>
128	</code></p>	121	</code></p>
129	<h2>synopsis</h2>	122	<h2>synopsis</h2>
130	<STRONG>UNSET</STRONG>·removes·(or·deletes)·a·macro·and·it's·definition.	123	<STRONG>UNSET</STRONG>·removes·(or·deletes)·a·macro·and·it's·definition.
131	The·macro·is·subsequently·not·available·for·use·in·the·pre-processed·files.	124	The·macro·is·subsequently·not·available·for·use·in·the·pre-processed·files.
132	(Note·that·simply·redefining·the·macro·with·another·<A·HREF="set.html">SET</A>·or	125	(Note·that·simply·redefining·the·macro·with·another·<A·HREF="set.html">SET</A>·or
133	<A·HREF="block.html">BLOCK</A>·definition·with·the·same·name·is·acceptable.··The	126	<A·HREF="block.html">BLOCK</A>·definition·with·the·same·name·is·acceptable.··The
134	old·macro·definition·will·be·removed·automatically.)	127	old·macro·definition·will·be·removed·automatically.)
135	<P>	128	<P>
136	For·example:	129	For·example:
137	··<p><code>	130	··<p><code>
138	<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">macroname</span>·<span·class="htp-attrib">[parameters</span>·<span·class="htp-attrib">...]</span>·<span·class="htp-attrib">[noexpand]</span>></span><br>
139	<span·class="htp-tag"><...·<span·class="htp-attrib"><span·class="htp-macro">$macroname</span></span>·<span·class="htp-attrib">...</span>></span><br>
140	<span·class="htp-tag"><~~...·<span·~~c~~lass=~~"~~htp-att~~rib"~~><sp~~an·cl~~ass=~~"~~htp-m~~acro"~~>${macronam~~e~~}</span~~>~~</span~~>·<span·class="htp-attrib">~~...~~</span>></span><br>	131	<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">block</a>·<span·class="htp-attrib">stuff</span>></span><br>
		132	·<span·class="htp-tag"><a·<span·class="htp-attrib">href</span>=<span·class="htp-value"><span·class="htp-macro">$email</span></span>></span>send·email<span·class="htp-tag"></a></span><br>
		133	<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/block</a>></span><br>
141	<br>	134	<br>
		135	<span·class="htp-tag"><<a·href="set.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">set</a>·<span·class="htp-attrib">morestuff</span>=<span·class="htp-value"><span·class="htp-macro">$email</span></span>></span><br>
		136	<br>
		137	This·works:· · ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">stuff</span>·<span·class="htp-attrib">email</span>=<span·class="htp-string">"jnelson@crl.com"</span>></span><br>
		138	But·this·fails:·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">email</span>></span><br>
		139	And·this·fails:·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">morestuff</span>·<span·class="htp-attrib">email</span>=<span·class="htp-string">"jnelson@crl.com"</span>></span><br>
142	</code></p>	140	</code></p>
143	<P>	141	<P>
144	More·than·one·macro·may·be·removed·in·the·same·tag:	142	More·than·one·macro·may·be·removed·in·the·same·tag:
145	··<p><code>	143	··<p><code>
146	·<span·class="htp-tag"><<a·href="while.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">WHILE</a>·<span·class="htp-attrib">NOT</span>·<span·class="htp-attrib">i</span>=<span·class="htp-string">"10"</span>></span><br>
147	· ·...<br>
148	· ·<span·class="htp-tag"><<a·href="inc.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">INC</a>·<span·class="htp-attrib">i</span>></span><br>
149	·<span·class="htp-tag"><<a·href="while.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/WHILE</a>></span><br>
150	</code></p>	144	</code></p>
151	<p>	145	<p>
152	</td>	146	</td>
153	</tr>	147	</tr>
154	<tr>	148	<tr>
155	<td·width="20%"·bgcolor="white"·valign="bottom">	149	<td·width="20%"·bgcolor="white"·valign="bottom">
156	·<table·border="0"·cellspacing="0"·cellpadding="0"·width="100%">	150	·<table·border="0"·cellspacing="0"·cellpadding="0"·width="100%">


Offset 114, 18 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="while.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">WHILE</a>·<span·class="ebnf">[</span><span·class="htp-attrib">NOT</span><span·class="ebnf">]</span>·<span·class="htp-attrib">conditional</span>></span><br>
122	· ·block<br>
123	<span·class="htp-tag"><<a·href="while.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/WHILE</a>></span><br>
124	<br>
125	</code></p>	121	</code></p>
126	<h2>synopsis</h2>	122	<h2>synopsis</h2>
127	<strong>USE</strong>·will·expand·macros·that·have·been·previously	123	<strong>USE</strong>·will·expand·macros·that·have·been·previously
128	declared·with·either·<A·HREF="set.html">SET</A>·or·<A	124	declared·with·either·<A·HREF="set.html">SET</A>·or·<A
129	HREF="block.html">BLOCK</A>.··USE·can·only·be·used·outside·of·other	125	HREF="block.html">BLOCK</A>.··USE·can·only·be·used·outside·of·other
130	markup·tags.	126	markup·tags.
131	<p>·If·you·USE·a·block·macro·the·value·of·expanded·block·macros·will	127	<p>·If·you·USE·a·block·macro·the·value·of·expanded·block·macros·will

+[HTP]
+******·htp·on-line·reference·:·USE,·$·******
+Table_of·······*****·syntax·*****
+Contents·······*****·synopsis·*****
+ Introduction·USE·will·expand·macros·that·have·been·previously·declared·with
+ License······either·SET·or·BLOCK.·USE·can·only·be·used·outside·of·other
+ Tutorial·····markup·tags.
+ Usage········If·you·USE·a·block·macro·the·value·of·expanded·block·macros·will
+ HTP·Tags·····be·further·parsed·by·htp.·This·is·maybe·not·what·you·want,·for
+  ··ALTTEXT··example,·if·the·use·is·inside·a·block·which·expands·itself.·You
+ Introduction···············<[[ref]]WHILE·[NOT]·conditional>
+ License···················· · ·block
+ Tutorial···················<[[ref]]/WHILE>
+ Usage
+ HTP·Tags···················*****·synopsis·*****
+  ··ALTTEXT················USE·will·expand·macros·that·have·been·previously
+  ··BLOCK··················declared·with·either·SET·or·BLOCK.·USE·can·only·be
+  ··BLOCKDEF···············used·outside·of·other·markup·tags.
+  ··DEF····················If·you·USE·a·block·macro·the·value·of·expanded
+  ··FILE···················block·macros·will·be·further·parsed·by·htp.·This
+  ··IF·····················is·maybe·not·what·you·want,·for·example,·if·the
+  ··INC····················use·is·inside·a·block·which·expands·itself.·You
+  ··BLOCK····can·use·the·noexpand·attribute·to·prevent·further·expansion.
+  ··BLOCKDEF·USE·will·accept·additional·parameters,·which·are·"local"·macros
+  ··DEF······for·the·expanded·macro.·This·is·only·valid·for·BLOCK·macros.
+  ··FILE·····Macros·created·using·SET·cannot·have·parameters·passed.·For
+  ··IF·······example:
+  ··IMAGEURL···············expansion.
+  ··OPT····················USE·will·accept·additional·parameters,·which·are
+  ··OUTPUT·················"local"·macros·for·the·expanded·macro.·This·is
+  ··QUOTE··················only·valid·for·BLOCK·macros.·Macros·created·using
+  ··SET····················SET·cannot·have·parameters·passed.·For·example:
+  ··UNDEF·················· 1. ·<[[ref]]WHILE·NOT·i="10">
+  ··UNSET·················· 2. · ·...
+ [>]·USE,_$················· 3. · ·<[[ref]]INC·i>
+  ··WHILE·················· 4. ·<[[ref]]/WHILE>
+  ··INC······(See·below·for·a·description·of·the·'$'·operator.)·The·example
+  ··IMG······on·line·7·works·because·"stuff"·has·been·declared·as·a·block
+  ··IMAGEURL·macro,·and·the·tag·is·passing·the·"email"·macro·to·the·"stuff"
+  ··OPT······macro.·Line·8·fails·because·the·"email"·macro·is·unavailable
+  ··OUTPUT···once·the·block·macro·is·completely·expanded,·and·cannot·be
+  ··QUOTE····passed·to·a·SET·macro.
+ History····················The·example·on·line·7·works·because·"stuff"·has
+ Wish_list··················been·declared·as·a·block·macro,·and·the·tag·is
+ Bugs·······················passing·the·"email"·macro·to·the·"stuff"·macro.
+·····························Line·8·fails·because·the·"email"·macro·is
+·····························unavailable·once·the·block·macro·is·completely
+·····························expanded,·and·cannot·be·passed·to·a·SET·macro.
+  ··SET······Note·that·the·"email"·macro·is·available·to·other·macros·or
+  ··UNDEF····included·files·called·within·the·"stuff"·block.
+  ··UNSET····Inside·a·markup·tag,·like·IMG,·A·(anchor),·or·any·other·standard
+ [>]·USE,_$···HTML·or·htp·tag,·the·'$'·operator·must·be·used.·The·'$'·should
+  ··WHILE····be·immediately·followed·by·the·macro·name,·which·may·or·may·not
+  ··<!---····be·surrounded·by·curly·braces.·When·htp·encounters·this·it
+ History······replaces·the·macro·name·by·the·contents·of·the·macro·without
+ Wish_list····further·processing·the·contents.
+ Bugs········· 1.<a·href="mailto:$email">mailto·hyperlink</a>
+··············· 2.<a·href="http://$domain/~${username}/">another·hyperlink</a>
+·····························macros·or·included·files·called·within·the·"stuff"
+·····························block.
+·····························Inside·a·markup·tag,·like·IMG,·A·(anchor),·or·any
+·····························other·standard·HTML·or·htp·tag,·the·'$'·operator
+·····························must·be·used.·The·'$'·should·be·immediately
+·····························followed·by·the·macro·name,·which·may·or·may·not
+·····························be·surrounded·by·curly·braces.·When·htp·encounters
+·····························this·it·replaces·the·macro·name·by·the·contents·of
+·····························the·macro·without·further·processing·the·contents.
+····························· 1. ·<[[ref]]WHILE·sect-$i>
+····························· 2. · ·...
+····························· 3. · ·<[[ref]]INC·i>
+····························· 4. ·<[[ref]]/WHILE>
+···············The·use·of·curly·braces·is·encouraged,·since·it·is·more·robust
+···············and·should·never·cause·confusion·with·surrounding·text.·If·no
+···············curly·braces·are·used·the·macro·name·consists·either·of·a·single
+·····························more·robust·and·should·never·cause·confusion·with
+·····························surrounding·text.·If·no·curly·braces·are·used·the
+·····························macro·name·consists·either·of·a·single·punctuation
+···············punctuation·character·or·the·maximum·sequence·of·letters,
+···············digits,·"-"·and·"_"·that·follows·it.
+···············If·a·'$'·character·needs·to·be·kept·in·the·final·output,·and·not
+···············interpreted·as·a·macro·name,·it·must·be·escaped·by·another·'$'
+·····························output,·and·not·interpreted·as·a·macro·name,·it
+·····························must·be·escaped·by·another·'$'·character.·This·is
+···············character.·This·is·especially·true·for·PHP·code.
+···············If·the·'$'·macro·is·the·only·text·in·the·attribute's·value,·htp
+···············will·automatically·surround·it·with·quotation·marks·to·prevent
+·····························If·the·'$'·macro·is·the·only·text·in·the
+·····························attribute's·value,·htp·will·automatically·surround
+·····························it·with·quotation·marks·to·prevent·spaces·from
+···············spaces·from·delimiting·the·text·as·if·it·were·additional·markup
+·····························markup·attributes.·If·the·'$'·macro·is·surrounded
+·····························by·other·text·(as·in·the·two·examples·above),
+···············attributes.·If·the·'$'·macro·is·surrounded·by·other·text·(as·in
+···············the·two·examples·above),·quotation·marks·are·not·automatically
+···············supplied.
+···············Note·that·a·'$'·macro·can·be·placed·anywhere·in·a·markup·tag·and
+···············can·be·nested.·This·is·valid:
+··············· ·<[[ref]]WHILE·sect-$i>
+··············· · ·...
+··············· · ·<[[ref]]INC·i>
+··············· ·<[[ref]]/WHILE>
+···············The·tagName·macro·can·contain·any·tag·name,·even·a·self-defined
+·····························self-defined·metatag.·Note·that·$ctr·is·expanded
+·····························before·the·valueX·macro·is·expanded,·so·assuming
+···············metatag.·Note·that·$ctr·is·expanded·before·the·valueX·macro·is
+···············expanded,·so·assuming·that·ctr·was·set·to·1·it·will·expand
+···············value1.


Offset 114, 23 lines modified		Offset 114, 14 lines modified
114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>	114	······<a·class="noline"·href="bugs.html">Bugs</a></td></tr>
115	··</table>	115	··</table>
116	··</div>	116	··</div>
117	</td>	117	</td>
118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">	118	<td·bgcolor="#f0f0d0"·rowspan="2"·valign="top">
119	<h2>syntax</h2>	119	<h2>syntax</h2>
120	··<p><code>	120	··<p><code>
121	<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">block</a>·<span·class="htp-attrib">stuff</span>></span><br>
122	·<span·class="htp-tag"><a·<span·class="htp-attrib">href</span>=<span·class="htp-value"><span·class="htp-macro">$email</span></span>></span>send·email<span·class="htp-tag"></a></span><br>
123	<span·class="htp-tag"><<a·href="block.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">/block</a>></span><br>
124	<br>
125	<span·class="htp-tag"><<a·href="set.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">set</a>·<span·class="htp-attrib">morestuff</span>=<span·class="htp-value"><span·class="htp-macro">$email</span></span>></span><br>
126	<br>
127	This·works:· · ·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">stuff</span>·<span·class="htp-attrib">email</span>=<span·class="htp-string">"jnelson@crl.com"</span>></span><br>
128	But·this·fails:·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">email</span>></span><br>
129	And·this·fails:·<span·class="htp-tag"><<a·href="use.html"·><img·src="pic/manual.png"·border=0·alt="[ref]"·width="10"·height="10">use</a>·<span·class="htp-attrib">morestuff</span>·<span·class="htp-attrib">email</span>=<span·class="htp-string">"jnelson@crl.com"</span>></span><br>
130	</code></p>	121	</code></p>
131	<h2>synopsis</h2>	122	<h2>synopsis</h2>
132	<STRONG>WHILE</STRONG>·is·the·building·block·for·repeated·processing.	123	<STRONG>WHILE</STRONG>·is·the·building·block·for·repeated·processing.
133	The·basic·form·is·shown·above.	124	The·basic·form·is·shown·above.
134	<P>	125	<P>
135	"Conditional"·is·either·a·"compare"·or·"is·defined"·operation.	126	"Conditional"·is·either·a·"compare"·or·"is·defined"·operation.
136	A·compare·operator·is·a·test·of·the·value·of·a·macro·against·a·literal·string.	127	A·compare·operator·is·a·test·of·the·value·of·a·macro·against·a·literal·string.