--- /srv/reproducible-results/rbuild-debian/r-b-build.KghiCuFB/b1/htp_1.19-8_amd64.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.KghiCuFB/b2/htp_1.19-8_amd64.changes
├── Files
│ @@ -1,3 +1,3 @@
│  
│   f95205d6135077fe67f7ffb7439955a0 70056 debug optional htp-dbgsym_1.19-8_amd64.deb
│ - c1d2e313b5df18b0372dcf230e60a4b7 120696 web optional htp_1.19-8_amd64.deb
│ + 7a4a4061f042f0e4f96298a94fbbab9f 119764 web optional htp_1.19-8_amd64.deb
├── htp_1.19-8_amd64.deb
│ ├── file list
│ │ @@ -1,3 +1,3 @@
│ │  -rw-r--r--   0        0        0        4 2020-06-14 23:21:19.000000 debian-binary
│ │  -rw-r--r--   0        0        0     3612 2020-06-14 23:21:19.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0   116892 2020-06-14 23:21:19.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0   115960 2020-06-14 23:21:19.000000 data.tar.xz
│ ├── control.tar.xz
│ │ ├── control.tar
│ │ │ ├── ./control
│ │ │ │ @@ -1,12 +1,12 @@
│ │ │ │  Package: htp
│ │ │ │  Version: 1.19-8
│ │ │ │  Architecture: amd64
│ │ │ │  Maintainer: Marcelo Soares Mota <motasmarcelo@gmail.com>
│ │ │ │ -Installed-Size: 663
│ │ │ │ +Installed-Size: 654
│ │ │ │  Depends: libc6 (>= 2.14)
│ │ │ │  Section: web
│ │ │ │  Priority: optional
│ │ │ │  Homepage: http://htp.sourceforge.net
│ │ │ │  Description: nice HTML pre-processor
│ │ │ │   htp is an HTML pre-processor. It is designed to be a flexible authoring tool
│ │ │ │   that can easily be integrated into the HTML design process.
│ │ │ ├── ./md5sums
│ │ │ │ ├── ./md5sums
│ │ │ │ │┄ Files differ
│ ├── data.tar.xz
│ │ ├── data.tar
│ │ │ ├── file list
│ │ │ │ @@ -1,27 +1,27 @@
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/bin/
│ │ │ │  -rwxr-xr-x   0 root         (0) root         (0)    67928 2020-06-14 23:21:19.000000 ./usr/bin/htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    15001 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10917 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1418 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    14129 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8267 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      781 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    12237 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8739 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1075 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     4763 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/bugs.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      737 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/bugs.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3273 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/changelog.Debian.gz
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9989 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11088 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      676 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    13083 2020-06-14 23:16:46.000000 ./usr/share/doc/htp/copyright
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    15806 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    13720 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3601 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     8030 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/default.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3149 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/default.htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/examples/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      536 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/Makefile.sub
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2404 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/album.hti
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1087 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/album.htt
│ │ │ │ @@ -32,64 +32,64 @@
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      818 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/prime.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1576 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/examples/quine.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1576 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/quine.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      604 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/section.def
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1189 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/examples/section.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      918 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/section.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      375 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/section.htt
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9093 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9899 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3702 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    15755 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    16003 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2490 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.htp.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    14293 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/history.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3946 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/history.htp.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3911 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/hlhtp.pl
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      165 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/htp.def
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     4049 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/htp.htt
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    13107 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10422 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      932 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    10054 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10276 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2507 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     8781 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9052 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1168 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9917 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11007 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1092 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     9881 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/include.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1894 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/include.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     4874 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/index.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)       78 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/index.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     7733 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/intro.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3489 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/intro.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    10774 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/license.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      454 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/license.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3782 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/macros.def
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     5088 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/macros.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      388 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/macros.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    17411 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    13416 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2439 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.htp.gz
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     7803 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8441 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      608 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     7809 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/options.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3100 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/options.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     8130 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11546 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      695 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      171 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/arrow.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      262 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/download.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      708 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/htpicon.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    25563 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/logo.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      455 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/manbig.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      491 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/manual.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1313 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/poweredbyhtp.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      679 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/sficon.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      492 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/source.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      523 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pphtp.pl
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     7953 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11412 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      390 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9609 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10220 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1200 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      500 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/styles.css
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    27219 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/template.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2235 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/template.htp.gz
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1914 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/toc.def
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      146 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/footer.hti
│ │ │ │ @@ -102,23 +102,23 @@
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      192 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut2.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      501 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut3.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      191 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut3.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      356 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut3.htt
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      297 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut4.htt
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    10517 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tutorial.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3393 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tutorial.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9119 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8009 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      460 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    11312 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9337 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      658 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     7681 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/usage.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2959 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/usage.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    12088 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    13207 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3300 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    10243 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10425 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      938 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     5288 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/wishlist.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1311 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/wishlist.htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc-base/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      235 2020-06-14 17:36:12.000000 ./usr/share/doc-base/htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/lintian/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/lintian/overrides/
│ │ │ ├── ./usr/share/doc/htp/alttext.html
│ │ │ │ @@ -114,59 +114,53 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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-attrib">GLOBAL</span><span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">EXPAND</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -text block<br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/BLOCK</a>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; block #1<br>
│ │ │ │ +[<br>
│ │ │ │ +<span class="htp-tag">&lt;ELSEIF <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; block #2<br>
│ │ │ │ +...<br>
│ │ │ │ +]<br>
│ │ │ │ +[<br>
│ │ │ │ +<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; block #3<br>
│ │ │ │ +]<br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <strong>ALTTEXT</strong> declares an ALT attribute for any <A
│ │ │ │  HREF="img.html">IMG</A> tag with a SRC matching the ALTTEXT NAME.
│ │ │ │  Since relative paths can be used to point to the same image, only the
│ │ │ │  filename is considered in all comparisons.
│ │ │ │  <p>
│ │ │ │  When an IMG tag with a matching source is encountered, htp will add an ALT
│ │ │ │  attribute only if one is not already present.  This allows for ALT text to
│ │ │ │  be overridden on specific images and default text on all others.
│ │ │ │  <p>
│ │ │ │  For example:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"0"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; a is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">b</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; b is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"1"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">b</span>&gt;</span><br>
│ │ │ │ -&nbsp; contents of a: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; contents of b: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">b</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">c</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; c is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">d</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; d is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">e</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; e is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"2"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">c</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">d</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">e</span>&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;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>&gt;</span>&amp;nbsp;<span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/table&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;imghr&gt;</span><br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │  </code></p>
│ │ │ │  <p>
│ │ │ │  An ALTTEXT tag with a name but no text attribute removes any ALT
│ │ │ │  mapping for this image.  Successing IMG tags with a matching SRC name are not
│ │ │ │  changed.
│ │ │ │  <p>
│ │ │ │  Since this is useful for an image used throughout a set of documents,
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,59 +1,55 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : ALTTEXT ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]BLOCK NAME="blockname" [GLOBAL] [EXPAND]>
│ │ │ │ │ - Introduction text block
│ │ │ │ │ - License      <[[ref]]/BLOCK>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage        ***** synopsis *****
│ │ │ │ │ - HTP Tags     ALTTEXT declares an ALT attribute for any IMG tag with a SRC matching
│ │ │ │ │ - [>] ALTTEXT  the ALTTEXT NAME. Since relative paths can be used to point to the
│ │ │ │ │ -    BLOCK    same image, only the filename is considered in all comparisons.
│ │ │ │ │ -    BLOCKDEF When an IMG tag with a matching source is encountered, htp will add an
│ │ │ │ │ -    DEF      ALT attribute only if one is not already present. This allows for ALT
│ │ │ │ │ -    FILE     text to be overridden on specific images and default text on all
│ │ │ │ │ -    IF       others.
│ │ │ │ │ -    INC      For example:
│ │ │ │ │ -    IMG        <[[ref]]set time="0">
│ │ │ │ │ -    IMAGEURL   <[[ref]]block name=a>
│ │ │ │ │ -    OPT          a is expanded at time <[[ref]]use time>.
│ │ │ │ │ -    OUTPUT     <[[ref]]/block>
│ │ │ │ │ -    QUOTE      <[[ref]]block name=b expand>
│ │ │ │ │ -    SET          b is expanded at time <[[ref]]use time>.
│ │ │ │ │ -    UNDEF      <[[ref]]/block>
│ │ │ │ │ -    UNSET      <[[ref]]set time="1">
│ │ │ │ │ -    USE,_$     <[[ref]]use a>
│ │ │ │ │ -    WHILE      <[[ref]]use b>
│ │ │ │ │ -    <!---      contents of a: <[[ref]]use a noexpand>
│ │ │ │ │ - History        contents of b: <[[ref]]use b noexpand>
│ │ │ │ │ - Wish_list      <[[ref]]block name=c expand>
│ │ │ │ │ - Bugs             c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ │ -                 <[[ref]]/block>
│ │ │ │ │ -                 <[[ref]]block name=d expand>
│ │ │ │ │ -                   d is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -                 <[[ref]]/block>
│ │ │ │ │ -                 <[[ref]]block name=e>
│ │ │ │ │ -                   e is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -                 <[[ref]]/block>
│ │ │ │ │ -                 <[[ref]]set time="2">
│ │ │ │ │ -                 <[[ref]]block name=a>
│ │ │ │ │ -                   a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ │ -                 <[[ref]]/block>
│ │ │ │ │ -                 <[[ref]]use c>
│ │ │ │ │ -                 <[[ref]]use d>
│ │ │ │ │ -                 <[[ref]]use e>
│ │ │ │ │ -               An ALTTEXT tag with a name but no text attribute removes any ALT
│ │ │ │ │ -               mapping for this image. Successing IMG tags with a matching SRC name
│ │ │ │ │ -               are not changed.
│ │ │ │ │ -               Since this is useful for an image used throughout a set of documents,
│ │ │ │ │ -               ALTTEXT is most appropriate in an include_file or a default_file.
│ │ │ │ │ -               In addition to ALTTEXT, htp can also automatically add WIDTH and
│ │ │ │ │ -               HEIGHT attributes to IMG tags.
│ │ │ │ │ +Table_of_Contents    ***** syntax *****
│ │ │ │ │ + Introduction       <[[ref]]IF [NOT] conditional>
│ │ │ │ │ + License                block #1
│ │ │ │ │ + Tutorial           [
│ │ │ │ │ + Usage              <ELSEIF [NOT] conditional>
│ │ │ │ │ + HTP Tags               block #2
│ │ │ │ │ + [>] ALTTEXT        ...
│ │ │ │ │ +    BLOCK          ]
│ │ │ │ │ +    BLOCKDEF       [
│ │ │ │ │ +    DEF            <ELSE>
│ │ │ │ │ +    FILE               block #3
│ │ │ │ │ +    IF             ]
│ │ │ │ │ +    INC            <[[ref]]/IF>
│ │ │ │ │ +    IMG
│ │ │ │ │ +    IMAGEURL       ***** synopsis *****
│ │ │ │ │ +    OPT            ALTTEXT declares an ALT attribute for any IMG tag with a
│ │ │ │ │ +    OUTPUT         SRC matching the ALTTEXT NAME. Since relative paths can
│ │ │ │ │ +    QUOTE          be used to point to the same image, only the filename is
│ │ │ │ │ +    SET            considered in all comparisons.
│ │ │ │ │ +    UNDEF          When an IMG tag with a matching source is encountered,
│ │ │ │ │ +    UNSET          htp will add an ALT attribute only if one is not already
│ │ │ │ │ +    USE,_$         present. This allows for ALT text to be overridden on
│ │ │ │ │ +    WHILE          specific images and default text on all others.
│ │ │ │ │ +    <!---          For example:
│ │ │ │ │ + History             <[[ref]]def name="imghr">
│ │ │ │ │ + Wish_list             <table border="0" cellspacing="0" cellpadding="0">
│ │ │ │ │ + Bugs                  <tr>
│ │ │ │ │ +                         <td width=10><[[ref]]img src="leftsep.png"></td>
│ │ │ │ │ +                         <td width="95%" background="midsep.png">&nbsp;</td>
│ │ │ │ │ +                         <td width=10><[[ref]]img src="rightsep.png"></td>
│ │ │ │ │ +                        </tr>
│ │ │ │ │ +                        </table>
│ │ │ │ │ +                      <[[ref]]/def>
│ │ │ │ │ +
│ │ │ │ │ +                      paragraph
│ │ │ │ │ +                      <imghr>
│ │ │ │ │ +                      paragraph
│ │ │ │ │ +                     An ALTTEXT tag with a name but no text attribute removes
│ │ │ │ │ +                     any ALT mapping for this image. Successing IMG tags with
│ │ │ │ │ +                     a matching SRC name are not changed.
│ │ │ │ │ +                     Since this is useful for an image used throughout a set
│ │ │ │ │ +                     of documents, ALTTEXT is most appropriate in an include
│ │ │ │ │ +                     file or a default_file.
│ │ │ │ │ +                     In addition to ALTTEXT, htp can also automatically add
│ │ │ │ │ +                     WIDTH and HEIGHT attributes to IMG tags.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -72,17 +68,16 @@
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ -htp]
│ │ │ │ │ +[Powered_by_htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ -terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ +according to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/block.html
│ │ │ │ @@ -114,42 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"0"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; a is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">b</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; b is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"1"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">b</span>&gt;</span><br>
│ │ │ │ -&nbsp; contents of a: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; contents of b: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">b</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">c</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; c is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">d</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; d is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">e</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; e is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"2"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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-value">a</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">c</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">d</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">e</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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="ebnf">[</span> <span class="htp-attrib">path</span>=<span class="htp-string">"path/in/local/filesystem"</span> <span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P>
│ │ │ │  <STRONG>BLOCK and /BLOCK</STRONG> are used to create block macros, which
│ │ │ │  are similar in use to <A HREF="set.html">SET</A> macros, but can be
│ │ │ │  multi-line definitions.
│ │ │ │  </P>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,59 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : BLOCK, /BLOCK ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]set time="0">
│ │ │ │ │ - Introduction   <[[ref]]block name=a>
│ │ │ │ │ - License          a is expanded at time <[[ref]]use time>.
│ │ │ │ │ - Tutorial       <[[ref]]/block>
│ │ │ │ │ - Usage          <[[ref]]block name=b expand>
│ │ │ │ │ - HTP Tags         b is expanded at time <[[ref]]use time>.
│ │ │ │ │ -    ALTTEXT    <[[ref]]/block>
│ │ │ │ │ - [>] BLOCK      <[[ref]]set time="1">
│ │ │ │ │ -    BLOCKDEF   <[[ref]]use a>
│ │ │ │ │ -    DEF        <[[ref]]use b>
│ │ │ │ │ -    FILE       contents of a: <[[ref]]use a noexpand>
│ │ │ │ │ -    IF         contents of b: <[[ref]]use b noexpand>
│ │ │ │ │ -    INC        <[[ref]]block name=c expand>
│ │ │ │ │ -    IMG          c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ │ -    IMAGEURL   <[[ref]]/block>
│ │ │ │ │ -    OPT        <[[ref]]block name=d expand>
│ │ │ │ │ -    OUTPUT       d is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    QUOTE      <[[ref]]/block>
│ │ │ │ │ -    SET        <[[ref]]block name=e>
│ │ │ │ │ -    UNDEF        e is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    UNSET      <[[ref]]/block>
│ │ │ │ │ -    USE,_$     <[[ref]]set time="2">
│ │ │ │ │ -    WHILE      <[[ref]]block name=a>
│ │ │ │ │ -    <!---        a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ │ - History        <[[ref]]/block>
│ │ │ │ │ - Wish_list      <[[ref]]use c>
│ │ │ │ │ - Bugs           <[[ref]]use d>
│ │ │ │ │ -                 <[[ref]]use e>
│ │ │ │ │ -               ***** synopsis *****
│ │ │ │ │ -               BLOCK and /BLOCK are used to create block macros, which are similar in
│ │ │ │ │ -               use to SET macros, but can be multi-line definitions.
│ │ │ │ │ -               Any text and formatting may be set inside the block. You can use any
│ │ │ │ │ -               htp or user defined metatag including FILE_INCLUDE. The metatags won't
│ │ │ │ │ -               be expanded before the block is USEd except if you give the EXPAND
│ │ │ │ │ -               parameter.
│ │ │ │ │ -               The block macro is dereferenced (expanded) with the USE_tag_or_the_'$'
│ │ │ │ │ -               operator. See the notes on the USE tag on how to pass parameters to a
│ │ │ │ │ -               block macro.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction               <[[ref]]imageurl url="imageurl" [ path="path/in/
│ │ │ │ │ + License                    local/filesystem" ]>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage                      ***** synopsis *****
│ │ │ │ │ + HTP Tags                   BLOCK and /BLOCK are used to create block macros,
│ │ │ │ │ +    ALTTEXT                which are similar in use to SET macros, but can be
│ │ │ │ │ + [>] BLOCK                  multi-line definitions.
│ │ │ │ │ +    BLOCKDEF               Any text and formatting may be set inside the
│ │ │ │ │ +    DEF                    block. You can use any htp or user defined metatag
│ │ │ │ │ +    FILE                   including FILE_INCLUDE. The metatags won't be
│ │ │ │ │ +    IF                     expanded before the block is USEd except if you
│ │ │ │ │ +    INC                    give the EXPAND parameter.
│ │ │ │ │ +    IMG                    The block macro is dereferenced (expanded) with
│ │ │ │ │ +    IMAGEURL               the USE_tag_or_the_'$'_operator. See the notes on
│ │ │ │ │ +    OPT                    the USE tag on how to pass parameters to a block
│ │ │ │ │ +    OUTPUT                 macro.
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -61,18 +39,17 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ +HTML coding [Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ -terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ +according to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/blockdef.html
│ │ │ │ @@ -114,43 +114,27 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">GLOBAL</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -&nbsp; this line: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; becomes this after processing: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; this line: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; will also have an ALT attribute appended to it<br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; this line: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; remains unchanged.<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <strong>BLOCKDEF</strong> creates block <A
│ │ │ │  HREF="metatag.html">metatags</A>, which is a fancy way of saying it
│ │ │ │  creates new block tags.  A block tag is a tag that takes a whole block
│ │ │ │  as additional parameter.  This block is surrounded by &lt;tagname&gt; and
│ │ │ │  &lt;/tagname&gt;.  The contents of this block are automatically stored
│ │ │ │  in the block macro named BLOCK.
│ │ │ │  <P> For example:</P>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">search</span>=<span class="htp-string">"searchpath"</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">template</span>=<span class="htp-string">"templatefilename"</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <p>
│ │ │ │  All block metatags have the implicit option <a
│ │ │ │  href="expand.html">EXPAND</A>, which tells htp to expand the contents
│ │ │ │  of the block before the definition is expanded.
│ │ │ │  </p>
│ │ │ │  <p>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,53 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : BLOCKDEF, /BLOCKDEF ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]alttext name="logo.gif" text="Company logo">
│ │ │ │ │ - Introduction
│ │ │ │ │ - License        this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ - Tutorial       becomes this after processing: <[[ref]]img src="logo.gif" alt="Company
│ │ │ │ │ - Usage        logo">
│ │ │ │ │ - HTP Tags
│ │ │ │ │ -    ALTTEXT    this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ │ -    BLOCK      will also have an ALT attribute appended to it
│ │ │ │ │ - [>] BLOCKDEF
│ │ │ │ │ -    DEF        this line: <[[ref]]img src="logo.gif" alt="Click here for more
│ │ │ │ │ -    FILE     information!">
│ │ │ │ │ -    IF         remains unchanged.
│ │ │ │ │ -    INC      ***** synopsis *****
│ │ │ │ │ -    IMG      BLOCKDEF creates block metatags, which is a fancy way of saying it
│ │ │ │ │ -    IMAGEURL creates new block tags. A block tag is a tag that takes a whole block as
│ │ │ │ │ -    OPT      additional parameter. This block is surrounded by <tagname> and </
│ │ │ │ │ -    OUTPUT   tagname>. The contents of this block are automatically stored in the
│ │ │ │ │ -    QUOTE    block macro named BLOCK.
│ │ │ │ │ -    SET      For example:
│ │ │ │ │ -    UNDEF    <[[ref]]file execute="command-line" (output="filename" | redirect)
│ │ │ │ │ -    UNSET    [noerror]>
│ │ │ │ │ -    USE,_$   <[[ref]]file include="includefilename" [parameters ...]>
│ │ │ │ │ -    WHILE    <[[ref]]file name>
│ │ │ │ │ -    <!---    <[[ref]]file [ name="filename" ] size[ = (byte|kbyte|mbyte|gbyte) ]
│ │ │ │ │ - History      [precision=n]>
│ │ │ │ │ - Wish_list    <[[ref]]file [ name="filename" ] time[ ="format" ]>
│ │ │ │ │ - Bugs         <[[ref]]file [ name="filename" ] date[ ="format" ]>
│ │ │ │ │ -               <[[ref]]file search="searchpath">
│ │ │ │ │ -               <[[ref]]file template="templatefilename">
│ │ │ │ │ -
│ │ │ │ │ -               All block metatags have the implicit option EXPAND, which tells htp to
│ │ │ │ │ -               expand the contents of the block before the definition is expanded.
│ │ │ │ │ -               A more thorough discussion and more elaborate examples are discussed in
│ │ │ │ │ -               the metatag section.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction               <[[ref]]INC macroname1="increment1"
│ │ │ │ │ + License                    [macroname2="increment2" ... ] [GLOBAL]>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage                      ***** synopsis *****
│ │ │ │ │ + HTP Tags                   BLOCKDEF creates block metatags, which is a fancy
│ │ │ │ │ +    ALTTEXT                way of saying it creates new block tags. A block
│ │ │ │ │ +    BLOCK                  tag is a tag that takes a whole block as
│ │ │ │ │ + [>] BLOCKDEF               additional parameter. This block is surrounded by
│ │ │ │ │ +    DEF                    <tagname> and </tagname>. The contents of this
│ │ │ │ │ +    FILE                   block are automatically stored in the block macro
│ │ │ │ │ +    IF                     named BLOCK.
│ │ │ │ │ +    INC                    For example:
│ │ │ │ │ +    IMG                        <[[ref]]INC i="1" j="-1">
│ │ │ │ │ +    IMAGEURL               All block metatags have the implicit option
│ │ │ │ │ +    OPT                    EXPAND, which tells htp to expand the contents of
│ │ │ │ │ +    OUTPUT                 the block before the definition is expanded.
│ │ │ │ │ +    QUOTE                  A more thorough discussion and more elaborate
│ │ │ │ │ +    SET                    examples are discussed in the metatag section.
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -57,18 +41,17 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ +HTML coding [Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ -terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ +according to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/comment.html
│ │ │ │ @@ -114,48 +114,46 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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-attrib">GLOBAL</span><span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">EXPAND</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -text block<br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/BLOCK</a>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">GLOBAL</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <p>
│ │ │ │  This is a simple comment that is not included in the output.  This is useful
│ │ │ │  when commenting metatags, since the metatags do not appear the output either.
│ │ │ │  Example:
│ │ │ │  </p>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;p <span class="htp-attrib">align</span>=<span class="htp-value">center</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;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>&gt;</span>&amp;nbsp;<span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/table&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;centered&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; This text is centered.<br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;imghr&gt;</span><br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │  </code></p>
│ │ │ │  <p>
│ │ │ │  Note that these comments should not include &lt; or &gt;, that is you
│ │ │ │  should not use it to comment out htp code.  For that purpose use something
│ │ │ │  like this:
│ │ │ │  </p>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;font <span class="htp-attrib">size</span>=<span class="htp-string">"+4"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;/font&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;bigfont&gt;</span>Some large text<span class="htp-tag">&lt;/bigfont&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ │ +&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <p>Make sure that the variable is never defined and xyz should be the
│ │ │ │  reason why you don't want to include this block</p>
│ │ │ │  <p>
│ │ │ │  </td>
│ │ │ │  </tr>
│ │ │ │  <tr>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,42 +1,39 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : <!--- ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]BLOCK NAME="blockname" [GLOBAL] [EXPAND]>
│ │ │ │ │ - License                    text block
│ │ │ │ │ - Tutorial                   <[[ref]]/BLOCK>
│ │ │ │ │ - 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
│ │ │ │ │ -    SET                    htp code. For that purpose use something like
│ │ │ │ │ -    UNDEF                  this:
│ │ │ │ │ -    UNSET                    <[[ref]]def name="bigfont">
│ │ │ │ │ -    USE,_$                     <font size="+4">
│ │ │ │ │ -    WHILE                    <[[ref]]/def>
│ │ │ │ │ - [>] <!---
│ │ │ │ │ - History                      <[[ref]]def name="/bigfont">
│ │ │ │ │ - Wish_list                      </font>
│ │ │ │ │ - Bugs                         <[[ref]]/def>
│ │ │ │ │ -
│ │ │ │ │ -                               <bigfont>Some large text</bigfont>
│ │ │ │ │ -                             Make sure that the variable is never defined and
│ │ │ │ │ -                             xyz should be the reason why you don't want to
│ │ │ │ │ -                             include this block
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents       <[[ref]]INC macroname1="increment1" [macroname2="increment2" ... ]
│ │ │ │ │ + Introduction [GLOBAL]>
│ │ │ │ │ + License
│ │ │ │ │ + Tutorial     ***** synopsis *****
│ │ │ │ │ + Usage        This is a simple comment that is not included in the output. This is
│ │ │ │ │ + HTP Tags     useful when commenting metatags, since the metatags do not appear the
│ │ │ │ │ +    ALTTEXT  output either. Example:
│ │ │ │ │ +    BLOCK     <[[ref]]def name="imghr">
│ │ │ │ │ +    BLOCKDEF    <table border="0" cellspacing="0" cellpadding="0">
│ │ │ │ │ +    DEF         <tr>
│ │ │ │ │ +    FILE         <td width=10><[[ref]]img src="leftsep.png"></td>
│ │ │ │ │ +    IF           <td width="95%" background="midsep.png">&nbsp;</td>
│ │ │ │ │ +    INC          <td width=10><[[ref]]img src="rightsep.png"></td>
│ │ │ │ │ +    IMG         </tr>
│ │ │ │ │ +    IMAGEURL    </table>
│ │ │ │ │ +    OPT       <[[ref]]/def>
│ │ │ │ │ +    OUTPUT
│ │ │ │ │ +    QUOTE     paragraph
│ │ │ │ │ +    SET       <imghr>
│ │ │ │ │ +    UNDEF     paragraph
│ │ │ │ │ +    UNSET    Note that these comments should not include < or >, that is you should
│ │ │ │ │ +    USE,_$   not use it to comment out htp code. For that purpose use something like
│ │ │ │ │ +    WHILE    this:
│ │ │ │ │ + [>] <!---        File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ + History          Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ + Wish_list    NAME="image.gif" DATE>
│ │ │ │ │ + Bugs         Make sure that the variable is never defined and xyz should be the reason
│ │ │ │ │ +               why you don't want to include this block
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -54,17 +51,18 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ +terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/def.html
│ │ │ │ @@ -114,74 +114,63 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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="ebnf">(</span><span class="htp-attrib">output</span>=<span class="htp-string">"filename"</span> <span class="ebnf">|</span> <span class="htp-attrib">redirect</span><span class="ebnf">)</span> <span class="ebnf">[</span><span class="htp-attrib">noerror</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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="ebnf">[</span><span class="htp-attrib">parameters</span> <span class="htp-attrib">...</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="ebnf">[</span> <span class="htp-attrib">name</span>=<span class="htp-string">"filename"</span> <span class="ebnf">]</span> <span class="htp-attrib">size</span><span class="ebnf">[</span> =<span class="htp-value"></span> <span class="ebnf">(</span><span class="htp-attrib">byte</span><span class="ebnf">|</span><span class="htp-attrib">kbyte</span><span class="ebnf">|</span><span class="htp-attrib">mbyte</span><span class="ebnf">|</span><span class="htp-attrib">gbyte</span><span class="ebnf">)</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">precision</span>=<span class="htp-value">n<span class="ebnf">]</span></span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="ebnf">[</span> <span class="htp-attrib">name</span>=<span class="htp-string">"filename"</span> <span class="ebnf">]</span> <span class="htp-attrib">time</span><span class="ebnf">[</span> =<span class="htp-string">"format"</span> <span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="ebnf">[</span> <span class="htp-attrib">name</span>=<span class="htp-string">"filename"</span> <span class="ebnf">]</span> <span class="htp-attrib">date</span><span class="ebnf">[</span> =<span class="htp-string">"format"</span> <span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">search</span>=<span class="htp-string">"searchpath"</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">template</span>=<span class="htp-string">"templatefilename"</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">GLOBAL</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <p>
│ │ │ │  <strong>DEF</strong> creates <a href="metatag.html">metatags</a>, which is a
│ │ │ │  fancy way of saying it creates new tags.  The mechanism is very similar to
│ │ │ │  <a href="block.html">BLOCK</a> macros, except that the <a href="use.html">USE</a>
│ │ │ │  tag is not used to expand them.  Instead, they are expanded by their own name.
│ │ │ │  For example:
│ │ │ │  </p>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; block #1<br>
│ │ │ │ -[<br>
│ │ │ │ -<span class="htp-tag">&lt;ELSEIF <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; block #2<br>
│ │ │ │ -...<br>
│ │ │ │ -]<br>
│ │ │ │ -[<br>
│ │ │ │ -<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; block #3<br>
│ │ │ │ -]<br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;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>&gt;</span>&amp;nbsp;<span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/table&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;imghr&gt;</span><br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  Some metatags will require an opening and closing tag (comparable to
│ │ │ │  <TITLE> and </TITLE>).  In this case, you should use the <A
│ │ │ │  HREF="blockdef.html">BLOCKDEF</A> macro.  Another slightly faster
│ │ │ │  alternative is to use two metatags, the opening tag and the closing
│ │ │ │  tag with a preceding slash. For example:
│ │ │ │  </P>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; This tag will fail: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ │ +&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <p> You should really use <a href="blockdef.html">BLOCKDEF</a>, though,
│ │ │ │  as it will check for matching end tag. It is not that slower.  </p>
│ │ │ │  <P>
│ │ │ │  Options can be passed to a metatag, which can then expand as if it were
│ │ │ │  a <A HREF="set.html">SET</A> macro.  Option names are parameterized with
│ │ │ │  the OPTION attribute.  Multiple options can be listed by separating their
│ │ │ │  name with a space (which therefore requires they be surrounded by quotes.)
│ │ │ │  </P>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(IMGXY|NOIMGXY)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(QUIET|VERBOSE)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(DEPEND|NODEPEND)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(PRECIOUS|NOPRECIOUS)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(CONDENSE|SEMICONDENSE|NOCONDENSE)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">DELIM</span>=<span class="htp-value">(HTML|SQUARE|CURLY)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(XML|XML</span>=<span class="htp-value">FALSE)</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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">conditional</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; block<br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  htp will do very specific checking of parameters when a metatag is
│ │ │ │  invoked.  htp assumes that all parameter options to the metatag are
│ │ │ │  optional.  This is why the HEADERIMG definition uses IF to verify the
│ │ │ │  SIZE option is defined before expanding it in the block.  If a
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,92 +1,71 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : DEF, /DEF ******
│ │ │ │ │ -Table_of_Contents    ***** syntax *****
│ │ │ │ │ - Introduction       <[[ref]]file execute="command-line" (output="filename" |
│ │ │ │ │ - License            redirect) [noerror]>
│ │ │ │ │ - Tutorial           <[[ref]]file include="includefilename" [parameters ...]>
│ │ │ │ │ - Usage              <[[ref]]file name>
│ │ │ │ │ - HTP Tags           <[[ref]]file [ name="filename" ] size[ =
│ │ │ │ │ -    ALTTEXT        (byte|kbyte|mbyte|gbyte) ] [precision=n]>
│ │ │ │ │ -    BLOCK          <[[ref]]file [ name="filename" ] time[ ="format" ]>
│ │ │ │ │ -    BLOCKDEF       <[[ref]]file [ name="filename" ] date[ ="format" ]>
│ │ │ │ │ - [>] DEF            <[[ref]]file search="searchpath">
│ │ │ │ │ -    FILE           <[[ref]]file template="templatefilename">
│ │ │ │ │ -    IF
│ │ │ │ │ -    INC            ***** synopsis *****
│ │ │ │ │ -    IMG            DEF creates metatags, which is a fancy way of saying it
│ │ │ │ │ -    IMAGEURL       creates new tags. The mechanism is very similar to BLOCK
│ │ │ │ │ -    OPT            macros, except that the USE tag is not used to expand
│ │ │ │ │ -    OUTPUT         them. Instead, they are expanded by their own name. For
│ │ │ │ │ -    QUOTE          example:
│ │ │ │ │ -    SET            <[[ref]]IF [NOT] conditional>
│ │ │ │ │ -    UNDEF              block #1
│ │ │ │ │ -    UNSET          [
│ │ │ │ │ -    USE,_$         <ELSEIF [NOT] conditional>
│ │ │ │ │ -    WHILE              block #2
│ │ │ │ │ -    <!---          ...
│ │ │ │ │ - History            ]
│ │ │ │ │ - Wish_list          [
│ │ │ │ │ - Bugs               <ELSE>
│ │ │ │ │ -                         block #3
│ │ │ │ │ -                     ]
│ │ │ │ │ -                     <[[ref]]/IF>
│ │ │ │ │ -
│ │ │ │ │ -                     Some metatags will require an opening and closing tag
│ │ │ │ │ -                     (comparable to
│ │ │ │ │ -                     and
│ │ │ │ │ -                     ). In this case, you should use the BLOCKDEF macro.
│ │ │ │ │ -                     Another slightly faster alternative is to use two
│ │ │ │ │ -                     metatags, the opening tag and the closing tag with a
│ │ │ │ │ -                     preceding slash. For example:
│ │ │ │ │ -                         <[[ref]]FILE INCLUDE="include.hti" name="Jim Nelson"
│ │ │ │ │ -                     email="jnelson@crl.com">
│ │ │ │ │ -                         This tag will fail: <[[ref]]USE name>
│ │ │ │ │ -                     You should really use BLOCKDEF, though, as it will check
│ │ │ │ │ -                     for matching end tag. It is not that slower.
│ │ │ │ │ -                     Options can be passed to a metatag, which can then expand
│ │ │ │ │ -                     as if it were a SET macro. Option names are parameterized
│ │ │ │ │ -                     with the OPTION attribute. Multiple options can be listed
│ │ │ │ │ -                     by separating their name with a space (which therefore
│ │ │ │ │ -                     requires they be surrounded by quotes.)
│ │ │ │ │ -                     <[[ref]]OPT (IMGXY|NOIMGXY)>
│ │ │ │ │ -                     <[[ref]]OPT (QUIET|VERBOSE)>
│ │ │ │ │ -                     <[[ref]]OPT (DEPEND|NODEPEND)>
│ │ │ │ │ -                     <[[ref]]OPT (PRECIOUS|NOPRECIOUS)>
│ │ │ │ │ -                     <[[ref]]OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
│ │ │ │ │ -                     <[[ref]]OPT DELIM=(HTML|SQUARE|CURLY)>
│ │ │ │ │ -                     <[[ref]]OPT (XML|XML=FALSE)>
│ │ │ │ │ -
│ │ │ │ │ -                     htp will do very specific checking of parameters when a
│ │ │ │ │ -                     metatag is invoked. htp assumes that all parameter options
│ │ │ │ │ -                     to the metatag are optional. This is why the HEADERIMG
│ │ │ │ │ -                     definition uses IF to verify the SIZE option is defined
│ │ │ │ │ -                     before expanding it in the block. If a parameter is
│ │ │ │ │ -                     required, simply expand it without first checking. When
│ │ │ │ │ -                     htp expands the metatag and the macro is not defined, it
│ │ │ │ │ -                     will halt processing and complain with an error message
│ │ │ │ │ -                     and the required macro name. Normally htp will not allow
│ │ │ │ │ -                     parameters not listed in the OPTION attribute to be added
│ │ │ │ │ -                     to the tag. This is why the third invocation of HEADERIMG
│ │ │ │ │ -                     will fail. There is no ALT parameter specified in the
│ │ │ │ │ -                     OPTION attribute. However, there is the special option *,
│ │ │ │ │ -                     which matches every other parameter. It should be used to
│ │ │ │ │ -                     pass all other options to another tag.
│ │ │ │ │ -                     Metatags can be removed by using the UNDEF tag. Note that
│ │ │ │ │ -                     both open and close tags must be removed with UNDEF.
│ │ │ │ │ -                     Removing one will not remove both.
│ │ │ │ │ -                     Warning: Although possible, def should not be used to
│ │ │ │ │ -                     override standard HTML and htp tag names, as this can
│ │ │ │ │ -                     cause much confusion and unexpected results. The def tag
│ │ │ │ │ -                     can even be used to override its own tag name. Because of
│ │ │ │ │ -                     the problems this can cause, its highly recommended to not
│ │ │ │ │ -                     override known tag names.
│ │ │ │ │ -                     You can find some other examples in the [[ref]]metatag
│ │ │ │ │ -                     section of the tutorial.
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents       <[[ref]]INC macroname1="increment1" [macroname2="increment2" ... ]
│ │ │ │ │ + Introduction [GLOBAL]>
│ │ │ │ │ + License
│ │ │ │ │ + Tutorial     ***** synopsis *****
│ │ │ │ │ + Usage        DEF creates metatags, which is a fancy way of saying it creates new tags.
│ │ │ │ │ + HTP Tags     The mechanism is very similar to BLOCK macros, except that the USE tag is
│ │ │ │ │ +    ALTTEXT  not used to expand them. Instead, they are expanded by their own name.
│ │ │ │ │ +    BLOCK    For example:
│ │ │ │ │ +    BLOCKDEF  <[[ref]]def name="imghr">
│ │ │ │ │ + [>] DEF         <table border="0" cellspacing="0" cellpadding="0">
│ │ │ │ │ +    FILE        <tr>
│ │ │ │ │ +    IF           <td width=10><[[ref]]img src="leftsep.png"></td>
│ │ │ │ │ +    INC          <td width="95%" background="midsep.png">&nbsp;</td>
│ │ │ │ │ +    IMG          <td width=10><[[ref]]img src="rightsep.png"></td>
│ │ │ │ │ +    IMAGEURL    </tr>
│ │ │ │ │ +    OPT         </table>
│ │ │ │ │ +    OUTPUT    <[[ref]]/def>
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET       paragraph
│ │ │ │ │ +    UNDEF     <imghr>
│ │ │ │ │ +    UNSET     paragraph
│ │ │ │ │ +    USE,_$   Some metatags will require an opening and closing tag (comparable to
│ │ │ │ │ +    WHILE    and
│ │ │ │ │ +    <!---    ). In this case, you should use the BLOCKDEF macro. Another slightly
│ │ │ │ │ + History      faster alternative is to use two metatags, the opening tag and the
│ │ │ │ │ + Wish_list    closing tag with a preceding slash. For example:
│ │ │ │ │ + Bugs             File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ +                   Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ +               NAME="image.gif" DATE>
│ │ │ │ │ +               You should really use BLOCKDEF, though, as it will check for matching end
│ │ │ │ │ +               tag. It is not that slower.
│ │ │ │ │ +               Options can be passed to a metatag, which can then expand as if it were a
│ │ │ │ │ +               SET macro. Option names are parameterized with the OPTION attribute.
│ │ │ │ │ +               Multiple options can be listed by separating their name with a space
│ │ │ │ │ +               (which therefore requires they be surrounded by quotes.)
│ │ │ │ │ +               <[[ref]]WHILE [NOT] conditional>
│ │ │ │ │ +                   block
│ │ │ │ │ +               <[[ref]]/WHILE>
│ │ │ │ │ +
│ │ │ │ │ +               htp will do very specific checking of parameters when a metatag is
│ │ │ │ │ +               invoked. htp assumes that all parameter options to the metatag are
│ │ │ │ │ +               optional. This is why the HEADERIMG definition uses IF to verify the SIZE
│ │ │ │ │ +               option is defined before expanding it in the block. If a parameter is
│ │ │ │ │ +               required, simply expand it without first checking. When htp expands the
│ │ │ │ │ +               metatag and the macro is not defined, it will halt processing and
│ │ │ │ │ +               complain with an error message and the required macro name. Normally htp
│ │ │ │ │ +               will not allow parameters not listed in the OPTION attribute to be added
│ │ │ │ │ +               to the tag. This is why the third invocation of HEADERIMG will fail.
│ │ │ │ │ +               There is no ALT parameter specified in the OPTION attribute. However,
│ │ │ │ │ +               there is the special option *, which matches every other parameter. It
│ │ │ │ │ +               should be used to pass all other options to another tag.
│ │ │ │ │ +               Metatags can be removed by using the UNDEF tag. Note that both open and
│ │ │ │ │ +               close tags must be removed with UNDEF. Removing one will not remove both.
│ │ │ │ │ +               Warning: Although possible, def should not be used to override standard
│ │ │ │ │ +               HTML and htp tag names, as this can cause much confusion and unexpected
│ │ │ │ │ +               results. The def tag can even be used to override its own tag name.
│ │ │ │ │ +               Because of the problems this can cause, its highly recommended to not
│ │ │ │ │ +               override known tag names.
│ │ │ │ │ +               You can find some other examples in the [[ref]]metatag section of the
│ │ │ │ │ +               tutorial.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -105,16 +84,17 @@
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │ -[Powered_by_htp]
│ │ │ │ │ +[Powered_by
│ │ │ │ │ +htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ +terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/expand.html
│ │ │ │ @@ -98,24 +98,29 @@
│ │ │ │  <p>However, if the block tag is marked with the <code>expand</code>
│ │ │ │  modifier it is expanded immediately.  This is useful if you want to
│ │ │ │  store something in a block macro, that depends on the current value of
│ │ │ │  another macro.  This other macro may no longer have the correct value
│ │ │ │  when the macro is expanded.  Here is some code that demonstrate when
│ │ │ │  the htp tags are expanded: </P>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;p <span class="htp-attrib">align</span>=<span class="htp-value">center</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font><br>
│ │ │ │ -<font size="-2">&nbsp;5. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;centered&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;6. </font>&nbsp; &nbsp; This text is centered.<br>
│ │ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp;<span class="htp-tag">&lt;h1&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/h1&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;3. </font>&nbsp; &nbsp;<span class="htp-tag">&lt;p <span class="htp-attrib">class</span>=<span class="htp-string">"section"</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;4. </font>&nbsp; &nbsp; &nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;5. </font>&nbsp; &nbsp;<span class="htp-tag">&lt;/p&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;6. </font>&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;7. </font><br>
│ │ │ │ +<font size="-2">&nbsp;8. </font>&nbsp; <span class="htp-tag">&lt;section <span class="htp-attrib">title</span>=<span class="htp-string">"My Section"</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;9. </font>&nbsp; &nbsp; This is a fancy section.<br>
│ │ │ │ +<font size="-2">10. </font>&nbsp; <span class="htp-tag">&lt;/section&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  This produces the following:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span>...<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="quote.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">QUOTE</a> <span class="htp-attrib">TAG</span> <span class="htp-attrib">[ATTRIBUTE</span>=<span class="htp-value">VALUE</span> <span class="htp-attrib">...]</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  When block a and block b are defined in lines 2-7 the contents of a
│ │ │ │  are taken literally, however, the contents for b are already expanded
│ │ │ │  so the macro <code>time</code> is evaluated.  So a is expanded when it
│ │ │ │  is used, while the contents of b are already expanded.
│ │ │ │  </P>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,80 +1,79 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : global and expand ******
│ │ │ │ │ -Table_of_Contents            ***** The global attribute *****
│ │ │ │ │ - Introduction               Normally when you define a macro it is only
│ │ │ │ │ - License                    defined in the current scope. A scope is for
│ │ │ │ │ - Tutorial                   example the definition of a metatag. Once the
│ │ │ │ │ - Usage                      definition is expanded and the metatag has
│ │ │ │ │ -    Command-line           finished the macro is automatically removed. In
│ │ │ │ │ -    Options                some cases you want to define a macro inside a
│ │ │ │ │ -    Predefined_macros      metatag and use it later. You can do this with the
│ │ │ │ │ - [>] global_and_expand      global attribute that you can add to [[ref]]set, [
│ │ │ │ │ - HTP_Tags                   [ref]]inc, [[ref]]block, [[ref]]def, and [
│ │ │ │ │ - History                    [ref]]blockdef tags.
│ │ │ │ │ - Wish_list                  ***** The expand attribute *****
│ │ │ │ │ - Bugs                       The expand attribute is not a tag of its own but
│ │ │ │ │ -                             is an attribute of all block tags even metatags
│ │ │ │ │ -                             defined with the blockdef macro. Normally htp uses
│ │ │ │ │ -                             a lazy evaluation strategy, i.e. it expands htp
│ │ │ │ │ -                             tags, metatags and macros when the HTML document
│ │ │ │ │ -                             is written not when they're stored into block
│ │ │ │ │ -                             macros. When you use a macro defined with the
│ │ │ │ │ -                             blockdef tag the html code between the tags is
│ │ │ │ │ -                             just copied literally into the macro named block,
│ │ │ │ │ -                             without any expansion going on.
│ │ │ │ │ -                             However, if the block tag is marked with the
│ │ │ │ │ -                             expand modifier it is expanded immediately. This
│ │ │ │ │ -                             is useful if you want to store something in a
│ │ │ │ │ -                             block macro, that depends on the current value of
│ │ │ │ │ -                             another macro. This other macro may no longer have
│ │ │ │ │ -                             the correct value when the macro is expanded. Here
│ │ │ │ │ -                             is some code that demonstrate when the htp tags
│ │ │ │ │ -                             are expanded:
│ │ │ │ │ -                              1.    <[[ref]]def name="centered">
│ │ │ │ │ -                              2.    <p align=center>
│ │ │ │ │ -                              3.    <[[ref]]/def>
│ │ │ │ │ -                              4.
│ │ │ │ │ -                              5.    <centered>
│ │ │ │ │ -                              6.    This text is centered.
│ │ │ │ │ -                             This produces the following:
│ │ │ │ │ -                                 <[[ref]]IF name="Jim">...<[[ref]]/IF>
│ │ │ │ │ -                             When block a and block b are defined in lines 2-
│ │ │ │ │ -                             7 the contents of a are taken literally, however,
│ │ │ │ │ -                             the contents for b are already expanded so the
│ │ │ │ │ -                             macro time is evaluated. So a is expanded when it
│ │ │ │ │ -                             is used, while the contents of b are already
│ │ │ │ │ -                             expanded.
│ │ │ │ │ -                             In line 10 and 12 the [[ref]]use tag is used with
│ │ │ │ │ -                             the noexpand attribute which prevents the
│ │ │ │ │ -                             expansion of the macro value. Here it is used to
│ │ │ │ │ -                             show you what the value of the block macros really
│ │ │ │ │ -                             is.
│ │ │ │ │ -                             A more important reason to use the noexpand
│ │ │ │ │ -                             attribute is to prevent double expansion and to
│ │ │ │ │ -                             restore the original lazy expansion policy when
│ │ │ │ │ -                             you have to use the expand attribute as for block
│ │ │ │ │ -                             d in the example above. See the section example in
│ │ │ │ │ -                             the [[ref]]metatag_tutorial. Rule of thumb: The
│ │ │ │ │ -                             use tags in an expanded block should be tagged
│ │ │ │ │ -                             with noexpand.
│ │ │ │ │ +Table_of_Contents       ***** The global attribute *****
│ │ │ │ │ + Introduction          Normally when you define a macro it is only defined in
│ │ │ │ │ + License               the current scope. A scope is for example the
│ │ │ │ │ + Tutorial              definition of a metatag. Once the definition is
│ │ │ │ │ + Usage                 expanded and the metatag has finished the macro is
│ │ │ │ │ +    Command-line      automatically removed. In some cases you want to
│ │ │ │ │ +    Options           define a macro inside a metatag and use it later. You
│ │ │ │ │ +    Predefined_macros can do this with the global attribute that you can add
│ │ │ │ │ + [>] global_and_expand to [[ref]]set, [[ref]]inc, [[ref]]block, [[ref]]def,
│ │ │ │ │ + HTP_Tags              and [[ref]]blockdef tags.
│ │ │ │ │ + History               ***** The expand attribute *****
│ │ │ │ │ + Wish_list             The expand attribute is not a tag of its own but is an
│ │ │ │ │ + Bugs                  attribute of all block tags even metatags defined with
│ │ │ │ │ +                        the blockdef macro. Normally htp uses a lazy
│ │ │ │ │ +                        evaluation strategy, i.e. it expands htp tags,
│ │ │ │ │ +                        metatags and macros when the HTML document is written
│ │ │ │ │ +                        not when they're stored into block macros. When you
│ │ │ │ │ +                        use a macro defined with the blockdef tag the html
│ │ │ │ │ +                        code between the tags is just copied literally into
│ │ │ │ │ +                        the macro named block, without any expansion going on.
│ │ │ │ │ +                        However, if the block tag is marked with the expand
│ │ │ │ │ +                        modifier it is expanded immediately. This is useful if
│ │ │ │ │ +                        you want to store something in a block macro, that
│ │ │ │ │ +                        depends on the current value of another macro. This
│ │ │ │ │ +                        other macro may no longer have the correct value when
│ │ │ │ │ +                        the macro is expanded. Here is some code that
│ │ │ │ │ +                        demonstrate when the htp tags are expanded:
│ │ │ │ │ +                         1.  <[[ref]]blockdef name="section" option="title">
│ │ │ │ │ +                         2.   <h1><[[ref]]use title></h1>
│ │ │ │ │ +                         3.   <p class="section">
│ │ │ │ │ +                         4.     <[[ref]]use block>
│ │ │ │ │ +                         5.   </p>
│ │ │ │ │ +                         6.  <[[ref]]/blockdef>
│ │ │ │ │ +                         7.
│ │ │ │ │ +                         8.  <section title="My Section">
│ │ │ │ │ +                         9.    This is a fancy section.
│ │ │ │ │ +                        10.  </section>
│ │ │ │ │ +                        This produces the following:
│ │ │ │ │ +                        <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ +
│ │ │ │ │ +                        When block a and block b are defined in lines 2-7 the
│ │ │ │ │ +                        contents of a are taken literally, however, the
│ │ │ │ │ +                        contents for b are already expanded so the macro time
│ │ │ │ │ +                        is evaluated. So a is expanded when it is used, while
│ │ │ │ │ +                        the contents of b are already expanded.
│ │ │ │ │ +                        In line 10 and 12 the [[ref]]use tag is used with the
│ │ │ │ │ +                        noexpand attribute which prevents the expansion of the
│ │ │ │ │ +                        macro value. Here it is used to show you what the
│ │ │ │ │ +                        value of the block macros really is.
│ │ │ │ │ +                        A more important reason to use the noexpand attribute
│ │ │ │ │ +                        is to prevent double expansion and to restore the
│ │ │ │ │ +                        original lazy expansion policy when you have to use
│ │ │ │ │ +                        the expand attribute as for block d in the example
│ │ │ │ │ +                        above. See the section example in the [[ref]]metatag
│ │ │ │ │ +                        tutorial. Rule of thumb: The use tags in an expanded
│ │ │ │ │ +                        block should be tagged with noexpand.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ -htp]
│ │ │ │ │ +HTML coding [Powered
│ │ │ │ │ +by_htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │  Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │  according to terms described in the License_section.
│ │ │ ├── ./usr/share/doc/htp/file.html
│ │ │ │ @@ -114,49 +114,46 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; ...<br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/if</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; contents of a: &nbsp; a is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ +&nbsp; contents of b: &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; &nbsp; c is expanded at time 1; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; d is expanded at time 1; &nbsp; a is expanded at time 2.<br>
│ │ │ │ +&nbsp; &nbsp; e is expanded at time 2; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>FILE</STRONG> has several optional parameters of differing purpose.
│ │ │ │  The output file's name, the current date and time, and the contents of
│ │ │ │  another file may be included.  Another file's time, date, or size may be
│ │ │ │  added to the output file as well.
│ │ │ │  <P>
│ │ │ │  As with all HTML, these tags do not have to be on their own line, so the
│ │ │ │  following is perfectly acceptable:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  <h3><a name="name">NAME</a>, TIME, SIZE</h3>
│ │ │ │  <P>
│ │ │ │  To include information about another file, such as an archive file or
│ │ │ │  graphic image, specify its name with the NAME attribute followed by the
│ │ │ │  type of information to be displayed:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp;<span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp;<span class="htp-tag">&lt;tr&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;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>&gt;</span>&amp;nbsp;<span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp;<span class="htp-tag">&lt;/tr&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp;<span class="htp-tag">&lt;/table&gt;</span><br>
│ │ │ │ -&nbsp;<span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span>;<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -&nbsp;paragraph<br>
│ │ │ │ -&nbsp;<span class="htp-tag">&lt;imghr&gt;</span><br>
│ │ │ │ -&nbsp;paragraph<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  For file size information, the value BYTE, KBYTE, etc. dictates how the
│ │ │ │  information is displayed.  In anything other than byte format, the information
│ │ │ │  is displayed in floating-point notation.  The amount of precision (the number
│ │ │ │  of digits to the right of the decimal point) can be set with the optional
│ │ │ │  PRECISION attribute.  The default precision is zero (0), which means no
│ │ │ │ @@ -185,21 +182,21 @@
│ │ │ │  <P>
│ │ │ │  Additional parameters can be set in the FILE INCLUDE tag, which are
│ │ │ │  interpreted as macros that are "passed" to the included file.  The macros
│ │ │ │  are available only to the include file (and any macros or included files it
│ │ │ │  holds).  After the file is completely included, the macros are no longer
│ │ │ │  available.  So:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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">"bolditalic"</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;b&gt;</span><span class="htp-tag">&lt;i&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;/i&gt;</span><span class="htp-tag">&lt;/b&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │  &nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; This is <span class="htp-tag">&lt;bolditalic&gt;</span>bold and italic<span class="htp-tag">&lt;/bolditalic&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  Macros named "name" and "email" are set, and available inside the included
│ │ │ │  file.  They are not available, however, past the tag (which is why the
│ │ │ │  second statement will fail.)
│ │ │ │  <P>
│ │ │ │  <h3><a name="template">TEMPLATE</a></h3>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,133 +1,112 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : FILE ******
│ │ │ │ │ -Table_of_Contents    ***** syntax *****
│ │ │ │ │ - Introduction       <[[ref]]if disabled_because_xyz>
│ │ │ │ │ - License              ...
│ │ │ │ │ - Tutorial           <[[ref]]/if>
│ │ │ │ │ - Usage              ***** synopsis *****
│ │ │ │ │ - HTP Tags           FILE has several optional parameters of differing
│ │ │ │ │ -    ALTTEXT        purpose. The output file's name, the current date and
│ │ │ │ │ -    BLOCK          time, and the contents of another file may be included.
│ │ │ │ │ -    BLOCKDEF       Another file's time, date, or size may be added to the
│ │ │ │ │ -    DEF            output file as well.
│ │ │ │ │ - [>] FILE           As with all HTML, these tags do not have to be on their
│ │ │ │ │ -    IF             own line, so the following is perfectly acceptable:
│ │ │ │ │ -    INC                <[[ref]]INC i="1" j="-1">
│ │ │ │ │ -    IMG            **** NAME, TIME, SIZE ****
│ │ │ │ │ -    IMAGEURL       To include information about another file, such as an
│ │ │ │ │ -    OPT            archive file or graphic image, specify its name with the
│ │ │ │ │ -    OUTPUT         NAME attribute followed by the type of information to be
│ │ │ │ │ -    QUOTE          displayed:
│ │ │ │ │ -    SET             <[[ref]]def name="imghr">
│ │ │ │ │ -    UNDEF             <table border="0" cellspacing="0" cellpadding="0">
│ │ │ │ │ -    UNSET             <tr>
│ │ │ │ │ -    USE,_$             <td width=10><[[ref]]img src="leftsep.png"></td>
│ │ │ │ │ -    WHILE              <td width="95%" background="midsep.png">&nbsp;</td>
│ │ │ │ │ -    <!---              <td width=10><[[ref]]img src="rightsep.png"></td>
│ │ │ │ │ - History               </tr>
│ │ │ │ │ - Wish_list             </table>
│ │ │ │ │ - Bugs                <[[ref]]/def>
│ │ │ │ │ -
│ │ │ │ │ -                      paragraph
│ │ │ │ │ -                      <imghr>
│ │ │ │ │ -                      paragraph
│ │ │ │ │ -                     For file size information, the value BYTE, KBYTE, etc.
│ │ │ │ │ -                     dictates how the information is displayed. In anything
│ │ │ │ │ -                     other than byte format, the information is displayed in
│ │ │ │ │ -                     floating-point notation. The amount of precision (the
│ │ │ │ │ -                     number of digits to the right of the decimal point) can
│ │ │ │ │ -                     be set with the optional PRECISION attribute. The default
│ │ │ │ │ -                     precision is zero (0), which means no fractional portion
│ │ │ │ │ -                     is displayed.
│ │ │ │ │ -                     At the request of many people, the TIME and DATE
│ │ │ │ │ -                     attributes will now accept formatting characters that are
│ │ │ │ │ -                     passed directly into the ANSI C library function. This
│ │ │ │ │ -                     allows for the time and date to be displayed in virtually
│ │ │ │ │ -                     any format. Users not wishing to mess around with this
│ │ │ │ │ -                     should stick to the default format, which is used if no
│ │ │ │ │ -                     formatting value is specified (i.e., just using 05:04:11
│ │ │ │ │ -                     PM).
│ │ │ │ │ -                     Consult any C programmer's guide discussing the standard
│ │ │ │ │ -                     C library function strftime() for information on how to
│ │ │ │ │ -                     build a format string. If unsure, ask an experienced C
│ │ │ │ │ -                     programmer for help, or consider just sticking to the
│ │ │ │ │ -                     default formatting.
│ │ │ │ │ -                     **** INCLUDE ****
│ │ │ │ │ -                     INCLUDE files are pre-processed as any other file. The
│ │ │ │ │ -                     resulting text is incorporated into the HTML output as if
│ │ │ │ │ -                     the file had been copied into the source at the same
│ │ │ │ │ -                     location as the FILE markup tag.
│ │ │ │ │ -                     htp will automatically convert slashes and backslashes to
│ │ │ │ │ -                     match the operating system's directory separator.
│ │ │ │ │ -                     Additional parameters can be set in the FILE INCLUDE tag,
│ │ │ │ │ -                     which are interpreted as macros that are "passed" to the
│ │ │ │ │ -                     included file. The macros are available only to the
│ │ │ │ │ -                     include file (and any macros or included files it holds).
│ │ │ │ │ -                     After the file is completely included, the macros are no
│ │ │ │ │ -                     longer available. So:
│ │ │ │ │ -                       <[[ref]]blockdef name="bolditalic">
│ │ │ │ │ -                         <b><i>
│ │ │ │ │ -                         <[[ref]]use block>
│ │ │ │ │ -                         </i></b>
│ │ │ │ │ -                       <[[ref]]/blockdef>
│ │ │ │ │ -
│ │ │ │ │ -                       This is <bolditalic>bold and italic</bolditalic>
│ │ │ │ │ -                     Macros named "name" and "email" are set, and available
│ │ │ │ │ -                     inside the included file. They are not available,
│ │ │ │ │ -                     however, past the tag (which is why the second statement
│ │ │ │ │ -                     will fail.)
│ │ │ │ │ -                     **** TEMPLATE ****
│ │ │ │ │ -                     A template file is nothing more than a default include
│ │ │ │ │ -                     file, one that is included once the input text has been
│ │ │ │ │ -                     completely processed. So, an input file can define many
│ │ │ │ │ -                     "standard" macros, which are then expanded by a template
│ │ │ │ │ -                     file to form a consistent page layout.
│ │ │ │ │ -                     The template file can be set many times, but only the
│ │ │ │ │ -                     last filename specified will be processed by htp. If
│ │ │ │ │ -                     multiple template files need to be included, specify one
│ │ │ │ │ -                     template file, and from that file use FILE INCLUDE to
│ │ │ │ │ -                     branch off.
│ │ │ │ │ -                     Template files are most useful when placed inside an htp
│ │ │ │ │ -                     default_file.
│ │ │ │ │ -                     **** SEARCH ****
│ │ │ │ │ -                     A search path can be specified, which is searched if an
│ │ │ │ │ -                     include file cannot be found. This is handy to keep a set
│ │ │ │ │ -                     of "common" include files that many documents in many
│ │ │ │ │ -                     directories may need to access. More than one directory
│ │ │ │ │ -                     can be specified in the search path, if they are
│ │ │ │ │ -                     separated by a semi-colon. Spaces should not precede or
│ │ │ │ │ -                     trail the search path string.
│ │ │ │ │ -                     When htp starts, the search path is clear. FILE SEARCH
│ │ │ │ │ -                     would be a handy command to use in an htp_defaults_file.
│ │ │ │ │ -                     **** EXECUTE ****
│ │ │ │ │ -                     When FILE EXECUTE is used, htp will launch a program (as
│ │ │ │ │ -                     specified by the EXECUTE attribute) and include its
│ │ │ │ │ -                     output as if a FILE INCLUDE was performed on the file.
│ │ │ │ │ -                     Either the OUTPUT or REDIRECT attribute must also be
│ │ │ │ │ -                     included.
│ │ │ │ │ -                     OUTPUT specifies the file the command will produce. This
│ │ │ │ │ -                     is used if the program is either hard-coded to produce
│ │ │ │ │ -                     output to a particular file, or relies on one of its
│ │ │ │ │ -                     command-line arguments to determine where to place the
│ │ │ │ │ -                     output. The output file is deleted after its results have
│ │ │ │ │ -                     been imported into the output file.
│ │ │ │ │ -                     If the program produces output straight to standard
│ │ │ │ │ -                     output (as most UNIX and some DOS programs do), then the
│ │ │ │ │ -                     REDIRECT attribute can be used. In this case htp will
│ │ │ │ │ -                     take care of the redirection. Depending on the OS
│ │ │ │ │ -                     features it will either append a '>' and the name of a
│ │ │ │ │ -                     temporary file or it will use pipe mechanism to directly
│ │ │ │ │ -                     redirect without temporary files.
│ │ │ │ │ -                     htp will halt processing with an error if the executable
│ │ │ │ │ -                     exits with an error code of anything but zero (0). Some
│ │ │ │ │ -                     programs, however, do not specify an error code when
│ │ │ │ │ -                     exiting, so the exit code is undetermined. If htp should
│ │ │ │ │ -                     ignore the error code, specify the NOERROR attribute.
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents           a is expanded at time 1.
│ │ │ │ │ + Introduction     b is expanded at time 0.
│ │ │ │ │ + License        contents of a:   a is expanded at time <[[ref]]use time>.
│ │ │ │ │ + Tutorial       contents of b:   b is expanded at time 0.
│ │ │ │ │ + Usage            c is expanded at time 1;   a is expanded at time 1.
│ │ │ │ │ + HTP Tags         d is expanded at time 1;   a is expanded at time 2.
│ │ │ │ │ +    ALTTEXT      e is expanded at time 2;   a is defined for the 2nd time <[[ref]]use
│ │ │ │ │ +    BLOCK    time>.
│ │ │ │ │ +    BLOCKDEF ***** synopsis *****
│ │ │ │ │ +    DEF      FILE has several optional parameters of differing purpose. The output
│ │ │ │ │ + [>] FILE     file's name, the current date and time, and the contents of another file
│ │ │ │ │ +    IF       may be included. Another file's time, date, or size may be added to the
│ │ │ │ │ +    INC      output file as well.
│ │ │ │ │ +    IMG      As with all HTML, these tags do not have to be on their own line, so the
│ │ │ │ │ +    IMAGEURL following is perfectly acceptable:
│ │ │ │ │ +    OPT      <[[ref]]SET macroname1="macrovalue1" [macroname2="macrovalue2" ...]
│ │ │ │ │ +    OUTPUT   [GLOBAL]>
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET      **** NAME, TIME, SIZE ****
│ │ │ │ │ +    UNDEF    To include information about another file, such as an archive file or
│ │ │ │ │ +    UNSET    graphic image, specify its name with the NAME attribute followed by the
│ │ │ │ │ +    USE,_$   type of information to be displayed:
│ │ │ │ │ +    WHILE      <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ +    <!---        <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ + History        <[[ref]]/def>
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs           <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ +               For file size information, the value BYTE, KBYTE, etc. dictates how the
│ │ │ │ │ +               information is displayed. In anything other than byte format, the
│ │ │ │ │ +               information is displayed in floating-point notation. The amount of
│ │ │ │ │ +               precision (the number of digits to the right of the decimal point) can be
│ │ │ │ │ +               set with the optional PRECISION attribute. The default precision is zero
│ │ │ │ │ +               (0), which means no fractional portion is displayed.
│ │ │ │ │ +               At the request of many people, the TIME and DATE attributes will now accept
│ │ │ │ │ +               formatting characters that are passed directly into the ANSI C library
│ │ │ │ │ +               function. This allows for the time and date to be displayed in virtually
│ │ │ │ │ +               any format. Users not wishing to mess around with this should stick to the
│ │ │ │ │ +               default format, which is used if no formatting value is specified (i.e.,
│ │ │ │ │ +               just using 05:04:11 PM).
│ │ │ │ │ +               Consult any C programmer's guide discussing the standard C library function
│ │ │ │ │ +               strftime() for information on how to build a format string. If unsure, ask
│ │ │ │ │ +               an experienced C programmer for help, or consider just sticking to the
│ │ │ │ │ +               default formatting.
│ │ │ │ │ +               **** INCLUDE ****
│ │ │ │ │ +               INCLUDE files are pre-processed as any other file. The resulting text is
│ │ │ │ │ +               incorporated into the HTML output as if the file had been copied into the
│ │ │ │ │ +               source at the same location as the FILE markup tag.
│ │ │ │ │ +               htp will automatically convert slashes and backslashes to match the
│ │ │ │ │ +               operating system's directory separator.
│ │ │ │ │ +               Additional parameters can be set in the FILE INCLUDE tag, which are
│ │ │ │ │ +               interpreted as macros that are "passed" to the included file. The macros
│ │ │ │ │ +               are available only to the include file (and any macros or included files it
│ │ │ │ │ +               holds). After the file is completely included, the macros are no longer
│ │ │ │ │ +               available. So:
│ │ │ │ │ +                   <[[ref]]unset email_addr>
│ │ │ │ │ +               <[[ref]]blockdef name="section">
│ │ │ │ │ +                   <[[ref]]inc sect-ctr>
│ │ │ │ │ +                   <[[ref]]block name="sect-${sect-ctr}" expand global>
│ │ │ │ │ +                     <[[ref]]use block noexpand>
│ │ │ │ │ +                   <[[ref]]/block>
│ │ │ │ │ +                 <[[ref]]/blockdef>
│ │ │ │ │ +               Macros named "name" and "email" are set, and available inside the included
│ │ │ │ │ +               file. They are not available, however, past the tag (which is why the
│ │ │ │ │ +               second statement will fail.)
│ │ │ │ │ +               **** TEMPLATE ****
│ │ │ │ │ +               A template file is nothing more than a default include file, one that is
│ │ │ │ │ +               included once the input text has been completely processed. So, an input
│ │ │ │ │ +               file can define many "standard" macros, which are then expanded by a
│ │ │ │ │ +               template file to form a consistent page layout.
│ │ │ │ │ +               The template file can be set many times, but only the last filename
│ │ │ │ │ +               specified will be processed by htp. If multiple template files need to be
│ │ │ │ │ +               included, specify one template file, and from that file use FILE INCLUDE to
│ │ │ │ │ +               branch off.
│ │ │ │ │ +               Template files are most useful when placed inside an htp default_file.
│ │ │ │ │ +               **** SEARCH ****
│ │ │ │ │ +               A search path can be specified, which is searched if an include file cannot
│ │ │ │ │ +               be found. This is handy to keep a set of "common" include files that many
│ │ │ │ │ +               documents in many directories may need to access. More than one directory
│ │ │ │ │ +               can be specified in the search path, if they are separated by a semi-colon.
│ │ │ │ │ +               Spaces should not precede or trail the search path string.
│ │ │ │ │ +               When htp starts, the search path is clear. FILE SEARCH would be a handy
│ │ │ │ │ +               command to use in an htp_defaults_file.
│ │ │ │ │ +               **** EXECUTE ****
│ │ │ │ │ +               When FILE EXECUTE is used, htp will launch a program (as specified by the
│ │ │ │ │ +               EXECUTE attribute) and include its output as if a FILE INCLUDE was
│ │ │ │ │ +               performed on the file. Either the OUTPUT or REDIRECT attribute must also be
│ │ │ │ │ +               included.
│ │ │ │ │ +               OUTPUT specifies the file the command will produce. This is used if the
│ │ │ │ │ +               program is either hard-coded to produce output to a particular file, or
│ │ │ │ │ +               relies on one of its command-line arguments to determine where to place the
│ │ │ │ │ +               output. The output file is deleted after its results have been imported
│ │ │ │ │ +               into the output file.
│ │ │ │ │ +               If the program produces output straight to standard output (as most UNIX
│ │ │ │ │ +               and some DOS programs do), then the REDIRECT attribute can be used. In this
│ │ │ │ │ +               case htp will take care of the redirection. Depending on the OS features it
│ │ │ │ │ +               will either append a '>' and the name of a temporary file or it will use
│ │ │ │ │ +               pipe mechanism to directly redirect without temporary files.
│ │ │ │ │ +               htp will halt processing with an error if the executable exits with an
│ │ │ │ │ +               error code of anything but zero (0). Some programs, however, do not specify
│ │ │ │ │ +               an error code when exiting, so the exit code is undetermined. If htp should
│ │ │ │ │ +               ignore the error code, specify the NOERROR attribute.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -146,16 +125,17 @@
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │ -[Powered_by_htp]
│ │ │ │ │ +[Powered_by
│ │ │ │ │ +htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to terms
│ │ │ │ │ +described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/if.html
│ │ │ │ @@ -114,55 +114,45 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">GLOBAL</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;h1&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/h1&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;p <span class="htp-attrib">class</span>=<span class="htp-string">"section"</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/p&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;section <span class="htp-attrib">title</span>=<span class="htp-string">"My Section"</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; This is a fancy section.<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;/section&gt;</span><br>
│ │ │ │ +time 1.<br>
│ │ │ │ +&nbsp; &nbsp; d is expanded at time 1; &nbsp; a is expanded at time 2.<br>
│ │ │ │ +&nbsp; &nbsp; e is expanded at time 2; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>IF, NOT, ELSEIF, ELSE, and /IF</STRONG> are the building
│ │ │ │  blocks for conditional processing.  The basic form is shown above.
│ │ │ │  <P> "Conditional" is either a "compare" or "is defined" operation.  A
│ │ │ │  compare operator is a test of the value of a macro against a literal
│ │ │ │  string:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ │ -&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="quote.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">QUOTE</a> <span class="htp-attrib">TAG</span> <span class="htp-attrib">[ATTRIBUTE</span>=<span class="htp-value">VALUE</span> <span class="htp-attrib">...]</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  and a defined operator is a test of a macro's existance:
│ │ │ │  <P>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;FONT <span class="htp-attrib">SIZE</span>=<span class="htp-value"><span class="htp-macro">${size}</span></span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;/FONT&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; This will fail:<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -&nbsp; Instead, use * like this:<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  If the NOT tag is present in the IF markup, the evaluation of the
│ │ │ │  conditional is reversed.  The first IF or ELSEIF condition that
│ │ │ │  evaluates to true is chosen.  If none of the conditions is true the
│ │ │ │  ELSE block is taken if it is present.  A conditional block
│ │ │ │  <EM>must</EM> be closed with the /IF tag.  IF tags can be nested.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,52 +1,41 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IF, ELSEIF, ELSE, /IF ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]INC macroname1="increment1" [macroname2="increment2" ... ]
│ │ │ │ │ - Introduction [GLOBAL]>
│ │ │ │ │ - License
│ │ │ │ │ - Tutorial     ***** synopsis *****
│ │ │ │ │ - Usage        IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for conditional
│ │ │ │ │ - HTP Tags     processing. The basic form is shown above.
│ │ │ │ │ -    ALTTEXT  "Conditional" is either a "compare" or "is defined" operation. A compare
│ │ │ │ │ -    BLOCK    operator is a test of the value of a macro against a literal string:
│ │ │ │ │ -    BLOCKDEF     File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ -    DEF          Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ -    FILE     NAME="image.gif" DATE>
│ │ │ │ │ - [>] IF       and a defined operator is a test of a macro's existance:
│ │ │ │ │ -    INC        <[[ref]]DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
│ │ │ │ │ -    IMG          <[[ref]]IF size>
│ │ │ │ │ -    IMAGEURL         <FONT SIZE=${size}>
│ │ │ │ │ -    OPT          <[[ref]]/IF>
│ │ │ │ │ -    OUTPUT       <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ │ -    QUOTE        <[[ref]]USE title>
│ │ │ │ │ -    SET          <[[ref]]IF size>
│ │ │ │ │ -    UNDEF            </FONT>
│ │ │ │ │ -    UNSET        <[[ref]]/IF>
│ │ │ │ │ -    USE,_$     <[[ref]]/DEF>
│ │ │ │ │ -    WHILE
│ │ │ │ │ -    <!---      <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │ +Contents         <[[ref]]blockdef name="section" option="title">
│ │ │ │ │ + Introduction    <h1><[[ref]]use title></h1>
│ │ │ │ │ + License         <p class="section">
│ │ │ │ │ + Tutorial          <[[ref]]use block>
│ │ │ │ │ + Usage           </p>
│ │ │ │ │ + HTP Tags       <[[ref]]/blockdef>
│ │ │ │ │ +    ALTTEXT
│ │ │ │ │ +    BLOCK      <section title="My Section">
│ │ │ │ │ +    BLOCKDEF     This is a fancy section.
│ │ │ │ │ +    DEF        </section>
│ │ │ │ │ +    FILE     time 1.
│ │ │ │ │ + [>] IF           d is expanded at time 1;   a is expanded at time 2.
│ │ │ │ │ +    INC          e is expanded at time 2;   a is defined for the 2nd time <[[ref]]use
│ │ │ │ │ +    IMG      time>.
│ │ │ │ │ +    IMAGEURL ***** synopsis *****
│ │ │ │ │ +    OPT      IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for conditional
│ │ │ │ │ +    OUTPUT   processing. The basic form is shown above.
│ │ │ │ │ +    QUOTE    "Conditional" is either a "compare" or "is defined" operation. A compare
│ │ │ │ │ +    SET      operator is a test of the value of a macro against a literal string:
│ │ │ │ │ +    UNDEF    <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$   and a defined operator is a test of a macro's existance:
│ │ │ │ │ +    WHILE    <[[ref]]unset macroname>
│ │ │ │ │ +    <!---    <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │   History
│ │ │ │ │ - Wish_list      <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ │ - Bugs
│ │ │ │ │ -                 This will fail:
│ │ │ │ │ -                 <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another title">
│ │ │ │ │ -
│ │ │ │ │ -                 Instead, use * like this:
│ │ │ │ │ -                 <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ │ -                   <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ │ -                 <[[ref]]/DEF>
│ │ │ │ │ -                  
│ │ │ │ │ -                 <MYIMG SRC="logo.gif" ALT="Our logo">
│ │ │ │ │ -               If the NOT tag is present in the IF markup, the evaluation of the
│ │ │ │ │ -               conditional is reversed. The first IF or ELSEIF condition that evaluates
│ │ │ │ │ -               to true is chosen. If none of the conditions is true the ELSE block is
│ │ │ │ │ -               taken if it is present. A conditional block must be closed with the /IF
│ │ │ │ │ -               tag. IF tags can be nested.
│ │ │ │ │ + Wish_list    If the NOT tag is present in the IF markup, the evaluation of the
│ │ │ │ │ + Bugs         conditional is reversed. The first IF or ELSEIF condition that evaluates to
│ │ │ │ │ +               true is chosen. If none of the conditions is true the ELSE block is taken
│ │ │ │ │ +               if it is present. A conditional block must be closed with the /IF tag. IF
│ │ │ │ │ +               tags can be nested.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -72,10 +61,10 @@
│ │ │ │ │  [Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ -terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to terms
│ │ │ │ │ +described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/imageurl.html
│ │ │ │ @@ -114,23 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;font <span class="htp-attrib">size</span>=<span class="htp-string">"+4"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;/font&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;bigfont&gt;</span>Some large text<span class="htp-tag">&lt;/bigfont&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span>...<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +ast updated <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">FILE</a> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">FILE</a> <span class="htp-attrib">DATE</span>&gt;</span><span class="htp-tag">&lt;/EM&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P>
│ │ │ │  <STRONG>IMAGEURL</STRONG> tells htp, where to find images on the local
│ │ │ │  file system.  declares an URL replacement that is used for
│ │ │ │  size lookups in any <A HREF="img.html">IMG</A> tag. This definitions
│ │ │ │  takes effect only if the <A HREF="opt.html">IMGXY</A> option is
│ │ │ │ @@ -144,15 +137,16 @@
│ │ │ │  checks (case-insensitive) if it is a prefix of the image's SRC
│ │ │ │  attribute. If it matches this prefix is replaced by the given PATH.
│ │ │ │  If no IMAGEURL matches the SRC is considered as relative link and
│ │ │ │  looked up in the current directory.</P>
│ │ │ │  <P>
│ │ │ │  For example:</P>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span>...<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ │ +&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  If IMAGEURL is specified with a URL but no PATH attribute, it is treated as
│ │ │ │  an undefine, and is removed.</P>
│ │ │ │  <P>
│ │ │ │  Since you usually need the url mapping for a number of images used throughout
│ │ │ │  a set of documents, IMAGEURL is most appropriately put into an
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,51 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IMAGEURL ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction                 <[[ref]]def name="bigfont">
│ │ │ │ │ - License                        <font size="+4">
│ │ │ │ │ - Tutorial                     <[[ref]]/def>
│ │ │ │ │ - Usage
│ │ │ │ │ - HTP Tags                     <[[ref]]def name="/bigfont">
│ │ │ │ │ -    ALTTEXT                    </font>
│ │ │ │ │ -    BLOCK                    <[[ref]]/def>
│ │ │ │ │ -    BLOCKDEF
│ │ │ │ │ -    DEF                      <bigfont>Some large text</bigfont>
│ │ │ │ │ -    FILE                   ***** synopsis *****
│ │ │ │ │ -    IF                     IMAGEURL tells htp, where to find images on the
│ │ │ │ │ -    INC                    local file system. declares an URL replacement
│ │ │ │ │ -    IMG                    that is used for size lookups in any IMG tag. This
│ │ │ │ │ - [>] IMAGEURL               definitions takes effect only if the IMGXY option
│ │ │ │ │ -    OPT                    is enabled. Beacause htp can't lookup files in the
│ │ │ │ │ -    OUTPUT                 world wide web you have to map absolute image URLs
│ │ │ │ │ -    QUOTE                  to a directory in the local file system.
│ │ │ │ │ -    SET                    When an IMG tag is encountered where htp has to
│ │ │ │ │ -    UNDEF                  insert width and height the defined URL
│ │ │ │ │ -    UNSET                  replacements will be taken into account (later
│ │ │ │ │ -    USE,_$                 definitions take precedence to earlier): For each
│ │ │ │ │ -    WHILE                  defined imageurl it checks (case-insensitive) if
│ │ │ │ │ -    <!---                  it is a prefix of the image's SRC attribute. If it
│ │ │ │ │ - History                    matches this prefix is replaced by the given PATH.
│ │ │ │ │ - Wish_list                  If no IMAGEURL matches the SRC is considered as
│ │ │ │ │ - Bugs                       relative link and looked up in the current
│ │ │ │ │ -                             directory.
│ │ │ │ │ -                             For example:
│ │ │ │ │ -                                 <[[ref]]IF name="Jim">...<[[ref]]/IF>
│ │ │ │ │ -                             If IMAGEURL is specified with a URL but no PATH
│ │ │ │ │ -                             attribute, it is treated as an undefine, and is
│ │ │ │ │ -                             removed.
│ │ │ │ │ -                             Since you usually need the url mapping for a
│ │ │ │ │ -                             number of images used throughout a set of
│ │ │ │ │ -                             documents, IMAGEURL is most appropriately put into
│ │ │ │ │ -                             an include_file or the htp.def file.
│ │ │ │ │ -                             In addition to WIDTH and HEIGHT, htp can also
│ │ │ │ │ -                             (semi-)automatically add an ALT_text attribute to
│ │ │ │ │ -                             IMG tags.
│ │ │ │ │ -
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents           <[[ref]]IF name="Jim">...<[[ref]]/IF>
│ │ │ │ │ + Introduction ast updated <[[ref]]FILE TIME>, <[[ref]]FILE DATE></EM>
│ │ │ │ │ + License      ***** synopsis *****
│ │ │ │ │ + Tutorial     IMAGEURL tells htp, where to find images on the local file system.
│ │ │ │ │ + Usage        declares an URL replacement that is used for size lookups in any IMG tag.
│ │ │ │ │ + HTP Tags     This definitions takes effect only if the IMGXY option is enabled.
│ │ │ │ │ +    ALTTEXT  Beacause htp can't lookup files in the world wide web you have to map
│ │ │ │ │ +    BLOCK    absolute image URLs to a directory in the local file system.
│ │ │ │ │ +    BLOCKDEF When an IMG tag is encountered where htp has to insert width and height
│ │ │ │ │ +    DEF      the defined URL replacements will be taken into account (later
│ │ │ │ │ +    FILE     definitions take precedence to earlier): For each defined imageurl it
│ │ │ │ │ +    IF       checks (case-insensitive) if it is a prefix of the image's SRC attribute.
│ │ │ │ │ +    INC      If it matches this prefix is replaced by the given PATH. If no IMAGEURL
│ │ │ │ │ +    IMG      matches the SRC is considered as relative link and looked up in the
│ │ │ │ │ + [>] IMAGEURL current directory.
│ │ │ │ │ +    OPT      For example:
│ │ │ │ │ +    OUTPUT       File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ +    QUOTE        Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ +    SET      NAME="image.gif" DATE>
│ │ │ │ │ +    UNDEF    If IMAGEURL is specified with a URL but no PATH attribute, it is treated
│ │ │ │ │ +    UNSET    as an undefine, and is removed.
│ │ │ │ │ +    USE,_$   Since you usually need the url mapping for a number of images used
│ │ │ │ │ +    WHILE    throughout a set of documents, IMAGEURL is most appropriately put into an
│ │ │ │ │ +    <!---    include_file or the htp.def file.
│ │ │ │ │ + History      In addition to WIDTH and HEIGHT, htp can also (semi-)automatically add an
│ │ │ │ │ + Wish_list    ALT_text attribute to IMG tags.
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -62,17 +49,18 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ +terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/img.html
│ │ │ │ @@ -114,16 +114,21 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">GLOBAL</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ +&nbsp; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; contents of a: &nbsp; a is expanded at time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │ +&nbsp; contents of b: &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; &nbsp; c is expanded at time 1; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; d is expanded at time 1; &nbsp; a is expanded at time 2.<br>
│ │ │ │ +&nbsp; &nbsp; e is expanded at time 2; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<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>&gt;</span>.<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P> <STRONG>img</STRONG> is a standard HTML tag.  htp can add the specified
│ │ │ │  image's width and height to the tag automatically.  This has the advantage
│ │ │ │  of not having to determine each image's size manually, which is especially
│ │ │ │  useful if the image may change frequently. </P>
│ │ │ │  <P> htp adds this information with the WIDTH and HEIGHT markup
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,41 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IMG ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]INC macroname1="increment1"
│ │ │ │ │ - License                    [macroname2="increment2" ... ] [GLOBAL]>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage                      ***** synopsis *****
│ │ │ │ │ - HTP Tags                   img is a standard HTML tag. htp can add the
│ │ │ │ │ -    ALTTEXT                specified image's width and height to the tag
│ │ │ │ │ -    BLOCK                  automatically. This has the advantage of not
│ │ │ │ │ -    BLOCKDEF               having to determine each image's size manually,
│ │ │ │ │ -    DEF                    which is especially useful if the image may change
│ │ │ │ │ -    FILE                   frequently.
│ │ │ │ │ -    IF                     htp adds this information with the WIDTH and
│ │ │ │ │ -    INC                    HEIGHT markup attributes. If htp detects these
│ │ │ │ │ - [>] IMG                    attributes are already present in the tag, it will
│ │ │ │ │ -    IMAGEURL               not modify the values. If htp cannot find the
│ │ │ │ │ -    OPT                    image file, it will issue a warning but not halt
│ │ │ │ │ -    OUTPUT                 processing.
│ │ │ │ │ -    QUOTE                  At this time, GIF (Graphic Interchange Format),
│ │ │ │ │ -    SET                    PNG (Portable Network Graphics), and JFIF (JPEG
│ │ │ │ │ -    UNDEF                  File Interchange Format) are supported.
│ │ │ │ │ -    UNSET                  The IMGXY_and_NOIMGXY options control whether or
│ │ │ │ │ -    USE,_$                 not htp actually adds this information as it
│ │ │ │ │ -    WHILE                  executes.
│ │ │ │ │ -    <!---                  Since htp is able to lookup files only in the
│ │ │ │ │ - History                    local filesystem, the IMAGEURL tag may be used to
│ │ │ │ │ - Wish_list                  map URLs to local files.
│ │ │ │ │ - Bugs                       htp can also add default ALT text to IMG tags
│ │ │ │ │ -                             using ALTTEXT.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents           a is expanded at time 1.
│ │ │ │ │ + Introduction     b is expanded at time 0.
│ │ │ │ │ + License        contents of a:   a is expanded at time <[[ref]]use time>.
│ │ │ │ │ + Tutorial       contents of b:   b is expanded at time 0.
│ │ │ │ │ + Usage            c is expanded at time 1;   a is expanded at time 1.
│ │ │ │ │ + HTP Tags         d is expanded at time 1;   a is expanded at time 2.
│ │ │ │ │ +    ALTTEXT      e is expanded at time 2;   a is defined for the 2nd time <[[ref]]use
│ │ │ │ │ +    BLOCK    time>.
│ │ │ │ │ +    BLOCKDEF ***** synopsis *****
│ │ │ │ │ +    DEF      img is a standard HTML tag. htp can add the specified image's width and
│ │ │ │ │ +    FILE     height to the tag automatically. This has the advantage of not having to
│ │ │ │ │ +    IF       determine each image's size manually, which is especially useful if the
│ │ │ │ │ +    INC      image may change frequently.
│ │ │ │ │ + [>] IMG      htp adds this information with the WIDTH and HEIGHT markup attributes. If
│ │ │ │ │ +    IMAGEURL htp detects these attributes are already present in the tag, it will not
│ │ │ │ │ +    OPT      modify the values. If htp cannot find the image file, it will issue a
│ │ │ │ │ +    OUTPUT   warning but not halt processing.
│ │ │ │ │ +    QUOTE    At this time, GIF (Graphic Interchange Format), PNG (Portable Network
│ │ │ │ │ +    SET      Graphics), and JFIF (JPEG File Interchange Format) are supported.
│ │ │ │ │ +    UNDEF    The IMGXY_and_NOIMGXY options control whether or not htp actually adds this
│ │ │ │ │ +    UNSET    information as it executes.
│ │ │ │ │ +    USE,_$   Since htp is able to lookup files only in the local filesystem, the
│ │ │ │ │ +    WHILE    IMAGEURL tag may be used to map URLs to local files.
│ │ │ │ │ +    <!---    htp can also add default ALT text to IMG tags using ALTTEXT.
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -50,17 +47,18 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to terms
│ │ │ │ │ +described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/inc.html
│ │ │ │ @@ -114,37 +114,43 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span>...<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;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>&gt;</span>&amp;nbsp;<span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;td <span class="htp-attrib">width</span>=<span class="htp-value">10</span>&gt;</span><span class="htp-tag">&lt;<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>&gt;</span><span class="htp-tag">&lt;/td&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/tr&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp;<span class="htp-tag">&lt;/table&gt;</span><br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │ +&nbsp;<span class="htp-tag">&lt;imghr&gt;</span><br>
│ │ │ │ +&nbsp;paragraph<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  The <STRONG>INC</STRONG> can be used for incrementing/decrementing a
│ │ │ │  variable or for variable addition.  The basic form is shown above.
│ │ │ │  <P>
│ │ │ │  The "increment" is anything that evaluates to a integer.  It can be a
│ │ │ │  literal string or a macro preceeded by the '$'-operator.  The
│ │ │ │  macroname must be the name of a defined macro that contains an
│ │ │ │  integer.  If the increment is ommitted it defaults to 1.
│ │ │ │  The effect of this operation is that the macro is redefined
│ │ │ │  to contain the sum of its previous value and its increment.
│ │ │ │  <P>
│ │ │ │  To increment or decrement a variable you can use this form:
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(IMGXY|NOIMGXY)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(QUIET|VERBOSE)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(DEPEND|NODEPEND)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(PRECIOUS|NOPRECIOUS)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(CONDENSE|SEMICONDENSE|NOCONDENSE)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">DELIM</span>=<span class="htp-value">(HTML|SQUARE|CURLY)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(XML|XML</span>=<span class="htp-value">FALSE)</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ +&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ │ +&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <p>
│ │ │ │  Note that INC doesn't check if the strings really denote integers.  It
│ │ │ │  may give weired results when used on arbitrary strings.  The integer
│ │ │ │  values are limited to the range -2^31..2^31.
│ │ │ │  <P>
│ │ │ │  Note further that htp wasn't designed to do extensive calculations.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,42 +1,43 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : INC ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction                   <[[ref]]IF name="Jim">...<[[ref]]/IF>
│ │ │ │ │ - License                    ***** synopsis *****
│ │ │ │ │ - Tutorial                   The INC can be used for incrementing/decrementing
│ │ │ │ │ - Usage                      a variable or for variable addition. The basic
│ │ │ │ │ - HTP Tags                   form is shown above.
│ │ │ │ │ -    ALTTEXT                The "increment" is anything that evaluates to a
│ │ │ │ │ -    BLOCK                  integer. It can be a literal string or a macro
│ │ │ │ │ -    BLOCKDEF               preceeded by the '$'-operator. The macroname must
│ │ │ │ │ -    DEF                    be the name of a defined macro that contains an
│ │ │ │ │ -    FILE                   integer. If the increment is ommitted it defaults
│ │ │ │ │ -    IF                     to 1. The effect of this operation is that the
│ │ │ │ │ - [>] INC                    macro is redefined to contain the sum of its
│ │ │ │ │ -    IMG                    previous value and its increment.
│ │ │ │ │ -    IMAGEURL               To increment or decrement a variable you can use
│ │ │ │ │ -    OPT                    this form:
│ │ │ │ │ -    OUTPUT                 <[[ref]]OPT (IMGXY|NOIMGXY)>
│ │ │ │ │ -    QUOTE                  <[[ref]]OPT (QUIET|VERBOSE)>
│ │ │ │ │ -    SET                    <[[ref]]OPT (DEPEND|NODEPEND)>
│ │ │ │ │ -    UNDEF                  <[[ref]]OPT (PRECIOUS|NOPRECIOUS)>
│ │ │ │ │ -    UNSET                  <[[ref]]OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
│ │ │ │ │ -    USE,_$                 <[[ref]]OPT DELIM=(HTML|SQUARE|CURLY)>
│ │ │ │ │ -    WHILE                  <[[ref]]OPT (XML|XML=FALSE)>
│ │ │ │ │ -    <!---
│ │ │ │ │ - History                    Note that INC doesn't check if the strings really
│ │ │ │ │ - Wish_list                  denote integers. It may give weired results when
│ │ │ │ │ - Bugs                       used on arbitrary strings. The integer values are
│ │ │ │ │ -                             limited to the range -2^31..2^31.
│ │ │ │ │ -                             Note further that htp wasn't designed to do
│ │ │ │ │ -                             extensive calculations. The INC tag is useful in
│ │ │ │ │ -                             conjunction with WHILE to iterate over the defined
│ │ │ │ │ -                             blocks.
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents        <[[ref]]def name="imghr">
│ │ │ │ │ + Introduction    <table border="0" cellspacing="0" cellpadding="0">
│ │ │ │ │ + License         <tr>
│ │ │ │ │ + Tutorial         <td width=10><[[ref]]img src="leftsep.png"></td>
│ │ │ │ │ + Usage            <td width="95%" background="midsep.png">&nbsp;</td>
│ │ │ │ │ + HTP Tags         <td width=10><[[ref]]img src="rightsep.png"></td>
│ │ │ │ │ +    ALTTEXT     </tr>
│ │ │ │ │ +    BLOCK       </table>
│ │ │ │ │ +    BLOCKDEF  <[[ref]]/def>
│ │ │ │ │ +    DEF
│ │ │ │ │ +    FILE      paragraph
│ │ │ │ │ +    IF        <imghr>
│ │ │ │ │ + [>] INC       paragraph
│ │ │ │ │ +    IMG      ***** synopsis *****
│ │ │ │ │ +    IMAGEURL The INC can be used for incrementing/decrementing a variable or for
│ │ │ │ │ +    OPT      variable addition. The basic form is shown above.
│ │ │ │ │ +    OUTPUT   The "increment" is anything that evaluates to a integer. It can be a
│ │ │ │ │ +    QUOTE    literal string or a macro preceeded by the '$'-operator. The macroname
│ │ │ │ │ +    SET      must be the name of a defined macro that contains an integer. If the
│ │ │ │ │ +    UNDEF    increment is ommitted it defaults to 1. The effect of this operation is
│ │ │ │ │ +    UNSET    that the macro is redefined to contain the sum of its previous value and
│ │ │ │ │ +    USE,_$   its increment.
│ │ │ │ │ +    WHILE    To increment or decrement a variable you can use this form:
│ │ │ │ │ +    <!---        File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ + History          Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ + Wish_list    NAME="image.gif" DATE>
│ │ │ │ │ + Bugs         Note that INC doesn't check if the strings really denote integers. It may
│ │ │ │ │ +               give weired results when used on arbitrary strings. The integer values
│ │ │ │ │ +               are limited to the range -2^31..2^31.
│ │ │ │ │ +               Note further that htp wasn't designed to do extensive calculations. The
│ │ │ │ │ +               INC tag is useful in conjunction with WHILE to iterate over the defined
│ │ │ │ │ +               blocks.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -54,17 +55,18 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ +terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/metatag.html
│ │ │ │ @@ -88,38 +88,16 @@
│ │ │ │  <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
│ │ │ │  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>
│ │ │ │  <P>
│ │ │ │  As an example we show how to define a tag that builds a
│ │ │ │  fancy horizontal rule out of several images.
│ │ │ │  </P>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;FONT <span class="htp-attrib">SIZE</span>=<span class="htp-value"><span class="htp-macro">${size}</span></span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;5. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;6. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;7. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;8. </font>&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;/FONT&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;9. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ -<font size="-2">10. </font>&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ -<font size="-2">11. </font><br>
│ │ │ │ -<font size="-2">12. </font>&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ -<font size="-2">13. </font><br>
│ │ │ │ -<font size="-2">14. </font>&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ -<font size="-2">15. </font><br>
│ │ │ │ -<font size="-2">16. </font>&nbsp; This will fail:<br>
│ │ │ │ -<font size="-2">17. </font>&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ -<font size="-2">18. </font><br>
│ │ │ │ -<font size="-2">19. </font>&nbsp; Instead, use * like this:<br>
│ │ │ │ -<font size="-2">20. </font>&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">21. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<font size="-2">22. </font>&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ -<font size="-2">23. </font>&nbsp; &nbsp; <br>
│ │ │ │ -<font size="-2">24. </font>&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="quote.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">QUOTE</a> <span class="htp-attrib">TAG</span> <span class="htp-attrib">[ATTRIBUTE</span>=<span class="htp-value">VALUE</span> <span class="htp-attrib">...]</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font><br>
│ │ │ │  </code></p>
│ │ │ │  <P> In line 1 of the above example a new tag named imghr is defined.
│ │ │ │  The html code which implements this rule is following in lines 2-8.
│ │ │ │  between the <a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>def</code> and
│ │ │ │  <code>/def</code></a> tags.  You don't have to understand this
│ │ │ │  html code, but you should understand that this is just pure html to
│ │ │ │  draw the fancy rule. Every time you write <code>&lt;imghr&gt;</code>
│ │ │ │ @@ -129,41 +107,41 @@
│ │ │ │  file</a>.  </p>
│ │ │ │  <P> Often you want to define tags that have an opening and a closing
│ │ │ │  variant.  For this purpose you should use the <a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>blockdef</code></a> tag.  When htp
│ │ │ │  encounters a blockdef tag it will automatically search for the
│ │ │ │  matching closing tag and put everything between these tags in a block
│ │ │ │  macro named <code>block</code>.  Here is an example for this.  </P>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="output.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OUTPUT</a> <span class="htp-attrib">FILE</span>=<span class="htp-string">"outputfilename"</span> <span class="htp-attrib">[APPEND]</span> <span class="htp-attrib">[EXPAND]</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font>text block<br>
│ │ │ │ -<font size="-2">&nbsp;3. </font><span class="htp-tag">&lt;<a href="output.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/OUTPUT</a>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font><span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;3. </font><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>Using parameters</h2>
│ │ │ │  <p> More sophisticated tags accept parameters.  The
│ │ │ │  <code>option</code> parameter lets multiple metatag parameters be
│ │ │ │  named and expanded inside the <code>def</code> or
│ │ │ │  <code>blockdef</code> block: </p>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font><span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;3. </font><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<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">conditional</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; block<br>
│ │ │ │ +<font size="-2">&nbsp;3. </font><span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;4. </font><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>Saving blocks for later</h2>
│ │ │ │  <p>When you are using templates, the html should only be written by
│ │ │ │  the template file.  The normal htp files should just define macros
│ │ │ │  that are used later in the template.  So you may want to write block
│ │ │ │  tags that just save the block in a macro for later use.  Although this
│ │ │ │  is possible with htp it is quite tricky, so here we present the way to
│ │ │ │  do this:</p>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<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">conditional</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; block<br>
│ │ │ │ -<font size="-2">&nbsp;3. </font><span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ │ +<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <p> This defines a block macro named section.  This macro uses a
│ │ │ │  counter <code>sect-ctr</code> that enumerates the sections.  It is
│ │ │ │  increased for every section (line 3) and then the block macro name is
│ │ │ │  build from this counter.  So the first section is stored in block
│ │ │ │  sect-1, the second in sect-2 and so on.  The <a href="expand.html#global" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>global</code></a> flag
│ │ │ │  in line 4 tells htp that these macros should be defined globally
│ │ │ │ @@ -182,15 +160,15 @@
│ │ │ │  contents of block to be expanded twice.  If you omit it, it would be
│ │ │ │  expanded when defining the sect-1 macro and when using it later in the
│ │ │ │  template.  Generally it is a good idea to use noexpand whenever you
│ │ │ │  use expand in a block around it.</p>
│ │ │ │  <p>To close this example we show how to expand the
│ │ │ │  <code>sect-${sect-ctr}</code> blocks in the template:</p>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ │  <font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ │  <font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │  <font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <p>
│ │ │ │  The <a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> tag in line 3 checks whether
│ │ │ │  the macro sect-${sect-ctr} is defined.  If it is defined the body is
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,134 +1,136 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : Metatags ******
│ │ │ │ │ -Table_of        ***** Programming your own tags *****
│ │ │ │ │ -Contents        Metatags allow for defining your own HTML-like tags. When you define
│ │ │ │ │ - Introduction  a metatag you have to provide the HTML code which it abbreviates. In
│ │ │ │ │ - License       fact metatags are just like block macros, but they have a nicer
│ │ │ │ │ - Tutorial      syntax. With metatags you can expand htp's functionality.
│ │ │ │ │ -    Macros    Metatags are defined with the [[ref]]def and [[ref]]blockdef tags and
│ │ │ │ │ -    Including undefined with the [[ref]]undef tag.
│ │ │ │ │ -    Templates As an example we show how to define a tag that builds a fancy
│ │ │ │ │ -    Files     horizontal rule out of several images.
│ │ │ │ │ - [>] Metatags   1.  <[[ref]]DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
│ │ │ │ │ - Usage          2.    <[[ref]]IF size>
│ │ │ │ │ - HTP_Tags       3.        <FONT SIZE=${size}>
│ │ │ │ │ - History        4.    <[[ref]]/IF>
│ │ │ │ │ - Wish_list      5.    <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ │ - Bugs           6.    <[[ref]]USE title>
│ │ │ │ │ -                 7.    <[[ref]]IF size>
│ │ │ │ │ -                 8.        </FONT>
│ │ │ │ │ -                 9.    <[[ref]]/IF>
│ │ │ │ │ -                10.  <[[ref]]/DEF>
│ │ │ │ │ -                11.
│ │ │ │ │ -                12.  <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │ -                13.
│ │ │ │ │ -                14.  <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ │ -                15.
│ │ │ │ │ -                16.  This will fail:
│ │ │ │ │ -                17.  <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another title">
│ │ │ │ │ -                18.
│ │ │ │ │ -                19.  Instead, use * like this:
│ │ │ │ │ -                20.  <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ │ -                21.    <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ │ -                22.  <[[ref]]/DEF>
│ │ │ │ │ -                23.   
│ │ │ │ │ -                24.  <MYIMG SRC="logo.gif" ALT="Our logo">
│ │ │ │ │ -                In line 1 of the above example a new tag named imghr is defined. The
│ │ │ │ │ -                html code which implements this rule is following in lines 2-8.
│ │ │ │ │ -                between the [[ref]]def_and_/def tags. You don't have to understand
│ │ │ │ │ -                this html code, but you should understand that this is just pure html
│ │ │ │ │ -                to draw the fancy rule. Every time you write <imghr> as in line 12
│ │ │ │ │ -                htp will replace this tag with the corresponding html code. To make
│ │ │ │ │ -                metatags available to all htp documents in your project, place them
│ │ │ │ │ -                in a common [[ref]]include_file.
│ │ │ │ │ -                Often you want to define tags that have an opening and a closing
│ │ │ │ │ -                variant. For this purpose you should use the [[ref]]blockdef tag.
│ │ │ │ │ -                When htp encounters a blockdef tag it will automatically search for
│ │ │ │ │ -                the matching closing tag and put everything between these tags in a
│ │ │ │ │ -                block macro named block. Here is an example for this.
│ │ │ │ │ -                 1.<[[ref]]OUTPUT FILE="outputfilename" [APPEND] [EXPAND]>
│ │ │ │ │ -                 2.text block
│ │ │ │ │ -                 3.<[[ref]]/OUTPUT>
│ │ │ │ │ -                 4.
│ │ │ │ │ -                ***** Using parameters *****
│ │ │ │ │ -                More sophisticated tags accept parameters. The option parameter lets
│ │ │ │ │ -                multiple metatag parameters be named and expanded inside the def or
│ │ │ │ │ -                blockdef block:
│ │ │ │ │ -                 1.<[[ref]]unset macroname>
│ │ │ │ │ -                 2.<[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │ -                 3.
│ │ │ │ │ -                ***** Saving blocks for later *****
│ │ │ │ │ -                When you are using templates, the html should only be written by the
│ │ │ │ │ -                template file. The normal htp files should just define macros that
│ │ │ │ │ -                are used later in the template. So you may want to write block tags
│ │ │ │ │ -                that just save the block in a macro for later use. Although this is
│ │ │ │ │ -                possible with htp it is quite tricky, so here we present the way to
│ │ │ │ │ -                do this:
│ │ │ │ │ -                 1.<[[ref]]WHILE [NOT] conditional>
│ │ │ │ │ -                 2.    block
│ │ │ │ │ -                 3.<[[ref]]/WHILE>
│ │ │ │ │ -                 4.
│ │ │ │ │ -                This defines a block macro named section. This macro uses a counter
│ │ │ │ │ -                sect-ctr that enumerates the sections. It is increased for every
│ │ │ │ │ -                section (line 3) and then the block macro name is build from this
│ │ │ │ │ -                counter. So the first section is stored in block sect-1, the second
│ │ │ │ │ -                in sect-2 and so on. The [[ref]]global flag in line 4 tells htp that
│ │ │ │ │ -                these macros should be defined globally for the remaining run.
│ │ │ │ │ -                Otherwise they would be forgotten at the end of the section macro.
│ │ │ │ │ -                The tricky part is the [[ref]]expand and noexpand flags in line 4 and
│ │ │ │ │ -                5. Normally when you define a block macro the code between the start
│ │ │ │ │ -                and end tag is literally copied into the macro value. The expansion
│ │ │ │ │ -                takes place when the macro is used. In this case that doesn't make
│ │ │ │ │ -                sense; all macros sect-1, sect-2 and so on would just contain the
│ │ │ │ │ -                same value, namely <use block> and block wouldn't be defined anymore
│ │ │ │ │ -                when the macros are finally expanded. Therefore we use expand to
│ │ │ │ │ -                expand the use tag already when sect-1 is defined.
│ │ │ │ │ -                The noexpand attribute of the [[ref]]use tag is just the opposite and
│ │ │ │ │ -                prevents the contents of block to be expanded twice. If you omit it,
│ │ │ │ │ -                it would be expanded when defining the sect-1 macro and when using it
│ │ │ │ │ -                later in the template. Generally it is a good idea to use noexpand
│ │ │ │ │ -                whenever you use expand in a block around it.
│ │ │ │ │ -                To close this example we show how to expand the sect-${sect-ctr}
│ │ │ │ │ -                blocks in the template:
│ │ │ │ │ -                 1.  <[[ref]]WHILE NOT i="10">
│ │ │ │ │ -                 2.    ...
│ │ │ │ │ -                 3.    <[[ref]]INC i>
│ │ │ │ │ -                 4.  <[[ref]]/WHILE>
│ │ │ │ │ -                The [[ref]]while tag in line 3 checks whether the macro sect-${sect-
│ │ │ │ │ -                ctr} is defined. If it is defined the body is evaluated, which
│ │ │ │ │ -                expands the macro and increases sect-ctr. Afterwards the while
│ │ │ │ │ -                condition is checked again to check for sect-2 macro. This repeats
│ │ │ │ │ -                until sect-${sect-ctr} is not defined.
│ │ │ │ │ -                ***** Conclusions *****
│ │ │ │ │ -                This closes our short htp tutorial. I hope you did enjoy it and see
│ │ │ │ │ -                the advantages of using htp for your own projects. Please give us
│ │ │ │ │ -                some feedback about this tutorial. What can be improved?
│ │ │ │ │ -                There is more documentation in this manual, see the [[ref]]Usage
│ │ │ │ │ -                chapter or browse the documentations for the htp tags. If you're
│ │ │ │ │ -                looking for examples, in case you haven't already noticed yourself,
│ │ │ │ │ -                there is a link to the source code on the left, where you can get the
│ │ │ │ │ -                source code for every page on this site.
│ │ │ │ │ +Table_of_Contents            ***** Programming your own tags *****
│ │ │ │ │ + Introduction               Metatags allow for defining your own HTML-like
│ │ │ │ │ + License                    tags. When you define a metatag you have to
│ │ │ │ │ + Tutorial                   provide the HTML code which it abbreviates. In
│ │ │ │ │ +    Macros                 fact metatags are just like block macros, but they
│ │ │ │ │ +    Including              have a nicer syntax. With metatags you can expand
│ │ │ │ │ +    Templates              htp's functionality.
│ │ │ │ │ +    Files                  Metatags are defined with the [[ref]]def and [
│ │ │ │ │ + [>] Metatags               [ref]]blockdef tags and undefined with the [
│ │ │ │ │ + Usage                      [ref]]undef tag.
│ │ │ │ │ + HTP_Tags                   As an example we show how to define a tag that
│ │ │ │ │ + History                    builds a fancy horizontal rule out of several
│ │ │ │ │ + Wish_list                  images.
│ │ │ │ │ + Bugs                        1.<[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ +                              2.
│ │ │ │ │ +                             In line 1 of the above example a new tag named
│ │ │ │ │ +                             imghr is defined. The html code which implements
│ │ │ │ │ +                             this rule is following in lines 2-8. between the [
│ │ │ │ │ +                             [ref]]def_and_/def tags. You don't have to
│ │ │ │ │ +                             understand this html code, but you should
│ │ │ │ │ +                             understand that this is just pure html to draw the
│ │ │ │ │ +                             fancy rule. Every time you write <imghr> as in
│ │ │ │ │ +                             line 12 htp will replace this tag with the
│ │ │ │ │ +                             corresponding html code. To make metatags
│ │ │ │ │ +                             available to all htp documents in your project,
│ │ │ │ │ +                             place them in a common [[ref]]include_file.
│ │ │ │ │ +                             Often you want to define tags that have an opening
│ │ │ │ │ +                             and a closing variant. For this purpose you should
│ │ │ │ │ +                             use the [[ref]]blockdef tag. When htp encounters a
│ │ │ │ │ +                             blockdef tag it will automatically search for the
│ │ │ │ │ +                             matching closing tag and put everything between
│ │ │ │ │ +                             these tags in a block macro named block. Here is
│ │ │ │ │ +                             an example for this.
│ │ │ │ │ +                              1.<[[ref]]unset macroname>
│ │ │ │ │ +                              2.<[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │ +                              3.
│ │ │ │ │ +                             ***** Using parameters *****
│ │ │ │ │ +                             More sophisticated tags accept parameters. The
│ │ │ │ │ +                             option parameter lets multiple metatag parameters
│ │ │ │ │ +                             be named and expanded inside the def or blockdef
│ │ │ │ │ +                             block:
│ │ │ │ │ +                              1.<[[ref]]WHILE [NOT] conditional>
│ │ │ │ │ +                              2.    block
│ │ │ │ │ +                              3.<[[ref]]/WHILE>
│ │ │ │ │ +                              4.
│ │ │ │ │ +                             ***** Saving blocks for later *****
│ │ │ │ │ +                             When you are using templates, the html should only
│ │ │ │ │ +                             be written by the template file. The normal htp
│ │ │ │ │ +                             files should just define macros that are used
│ │ │ │ │ +                             later in the template. So you may want to write
│ │ │ │ │ +                             block tags that just save the block in a macro for
│ │ │ │ │ +                             later use. Although this is possible with htp it
│ │ │ │ │ +                             is quite tricky, so here we present the way to do
│ │ │ │ │ +                             this:
│ │ │ │ │ +                              1.  <[[ref]]WHILE NOT i="10">
│ │ │ │ │ +                              2.    ...
│ │ │ │ │ +                              3.    <[[ref]]INC i>
│ │ │ │ │ +                              4.  <[[ref]]/WHILE>
│ │ │ │ │ +                             This defines a block macro named section. This
│ │ │ │ │ +                             macro uses a counter sect-ctr that enumerates the
│ │ │ │ │ +                             sections. It is increased for every section (line
│ │ │ │ │ +                             3) and then the block macro name is build from
│ │ │ │ │ +                             this counter. So the first section is stored in
│ │ │ │ │ +                             block sect-1, the second in sect-2 and so on. The
│ │ │ │ │ +                             [[ref]]global flag in line 4 tells htp that these
│ │ │ │ │ +                             macros should be defined globally for the
│ │ │ │ │ +                             remaining run. Otherwise they would be forgotten
│ │ │ │ │ +                             at the end of the section macro.
│ │ │ │ │ +                             The tricky part is the [[ref]]expand and noexpand
│ │ │ │ │ +                             flags in line 4 and 5. Normally when you define a
│ │ │ │ │ +                             block macro the code between the start and end tag
│ │ │ │ │ +                             is literally copied into the macro value. The
│ │ │ │ │ +                             expansion takes place when the macro is used. In
│ │ │ │ │ +                             this case that doesn't make sense; all macros
│ │ │ │ │ +                             sect-1, sect-2 and so on would just contain the
│ │ │ │ │ +                             same value, namely <use block> and block wouldn't
│ │ │ │ │ +                             be defined anymore when the macros are finally
│ │ │ │ │ +                             expanded. Therefore we use expand to expand the
│ │ │ │ │ +                             use tag already when sect-1 is defined.
│ │ │ │ │ +                             The noexpand attribute of the [[ref]]use tag is
│ │ │ │ │ +                             just the opposite and prevents the contents of
│ │ │ │ │ +                             block to be expanded twice. If you omit it, it
│ │ │ │ │ +                             would be expanded when defining the sect-1 macro
│ │ │ │ │ +                             and when using it later in the template. Generally
│ │ │ │ │ +                             it is a good idea to use noexpand whenever you use
│ │ │ │ │ +                             expand in a block around it.
│ │ │ │ │ +                             To close this example we show how to expand the
│ │ │ │ │ +                             sect-${sect-ctr} blocks in the template:
│ │ │ │ │ +                              1.  <[[ref]]WHILE sect-$i>
│ │ │ │ │ +                              2.    ...
│ │ │ │ │ +                              3.    <[[ref]]INC i>
│ │ │ │ │ +                              4.  <[[ref]]/WHILE>
│ │ │ │ │ +                             The [[ref]]while tag in line 3 checks whether the
│ │ │ │ │ +                             macro sect-${sect-ctr} is defined. If it is
│ │ │ │ │ +                             defined the body is evaluated, which expands the
│ │ │ │ │ +                             macro and increases sect-ctr. Afterwards the while
│ │ │ │ │ +                             condition is checked again to check for sect-
│ │ │ │ │ +                             2 macro. This repeats until sect-${sect-ctr} is
│ │ │ │ │ +                             not defined.
│ │ │ │ │ +                             ***** Conclusions *****
│ │ │ │ │ +                             This closes our short htp tutorial. I hope you did
│ │ │ │ │ +                             enjoy it and see the advantages of using htp for
│ │ │ │ │ +                             your own projects. Please give us some feedback
│ │ │ │ │ +                             about this tutorial. What can be improved?
│ │ │ │ │ +                             There is more documentation in this manual, see
│ │ │ │ │ +                             the [[ref]]Usage chapter or browse the
│ │ │ │ │ +                             documentations for the htp tags. If you're looking
│ │ │ │ │ +                             for examples, in case you haven't already noticed
│ │ │ │ │ +                             yourself, there is a link to the source code on
│ │ │ │ │ +                             the left, where you can get the source code for
│ │ │ │ │ +                             every page on this site.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ +HTML coding [Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ -terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ +according to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/opt.html
│ │ │ │ @@ -114,15 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">SET</a> <span class="htp-attrib">emailaddr</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ │ +&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<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 class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>OPT</STRONG> is an htp tag that can be used to specify processing
│ │ │ │  options inside the actual document being processed.  The options are
│ │ │ │  used exactly as they would be on the command-line, although they are not
│ │ │ │  preceded by a &lsquo;-&rsquo; character.
│ │ │ │  <P>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,19 +1,19 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : OPT ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents           <[[ref]]SET emailaddr="jnelson@crl.com">
│ │ │ │ │ - Introduction ***** synopsis *****
│ │ │ │ │ - License      OPT is an htp tag that can be used to specify processing options inside the
│ │ │ │ │ - Tutorial     actual document being processed. The options are used exactly as they would be
│ │ │ │ │ - Usage        on the command-line, although they are not preceded by a ‘-’ character.
│ │ │ │ │ - HTP Tags     Click here for more_information_on_using_customization_options_with_htp.
│ │ │ │ │ -    ALTTEXT
│ │ │ │ │ -    BLOCK
│ │ │ │ │ +Contents           File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ + Introduction     Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ + License      NAME="image.gif" DATE>
│ │ │ │ │ + Tutorial     ***** synopsis *****
│ │ │ │ │ + Usage        OPT is an htp tag that can be used to specify processing options inside the
│ │ │ │ │ + HTP Tags     actual document being processed. The options are used exactly as they would be
│ │ │ │ │ +    ALTTEXT  on the command-line, although they are not preceded by a ‘-’ character.
│ │ │ │ │ +    BLOCK    Click here for more_information_on_using_customization_options_with_htp.
│ │ │ │ │      BLOCKDEF
│ │ │ │ │      DEF
│ │ │ │ │      FILE
│ │ │ │ │      IF
│ │ │ │ │      INC
│ │ │ │ │      IMG
│ │ │ │ │      IMAGEURL
│ │ │ │ │ @@ -25,14 +25,15 @@
│ │ │ │ │      UNSET
│ │ │ │ │      USE,_$
│ │ │ │ │      WHILE
│ │ │ │ │      <!---
│ │ │ │ │   History
│ │ │ │ │   Wish_list
│ │ │ │ │   Bugs
│ │ │ │ │ +
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │  [Powered_by
│ │ │ ├── ./usr/share/doc/htp/output.html
│ │ │ │ @@ -114,16 +114,38 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="quote.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">QUOTE</a> <span class="htp-attrib">TAG</span> <span class="ebnf">[</span><span class="htp-attrib">ATTRIBUTE</span>=<span class="htp-value">VALUE</span> <span class="htp-attrib">...</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;FONT <span class="htp-attrib">SIZE</span>=<span class="htp-value"><span class="htp-macro">${size}</span></span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;/FONT&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; This will fail:<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Instead, use * like this:<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P> The <STRONG>OUTPUT</STRONG> tag can be used to create auxillary
│ │ │ │  files besides the main HTML file.  The text between this tag and the
│ │ │ │  corresponding &lt;/OUTPUT&gt; tag is written to output file. </P>
│ │ │ │  <P> Normally the outputfile is cleared before writing to it, but you
│ │ │ │  can use the APPEND attribute to extend an existing file.  The text
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,53 +1,74 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : OUTPUT ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ - License
│ │ │ │ │ - Tutorial                   ***** synopsis *****
│ │ │ │ │ - Usage                      The OUTPUT tag can be used to create auxillary
│ │ │ │ │ - HTP Tags                   files besides the main HTML file. The text between
│ │ │ │ │ -    ALTTEXT                this tag and the corresponding </OUTPUT> tag is
│ │ │ │ │ -    BLOCK                  written to output file.
│ │ │ │ │ -    BLOCKDEF               Normally the outputfile is cleared before writing
│ │ │ │ │ -    DEF                    to it, but you can use the APPEND attribute to
│ │ │ │ │ -    FILE                   extend an existing file. The text written to the
│ │ │ │ │ -    IF                     file is normally not expanded, i.e. all tags
│ │ │ │ │ -    INC                    inside this block are not executed but written
│ │ │ │ │ -    IMG                    unmodified to the file. However, you can use the
│ │ │ │ │ -    IMAGEURL               EXPAND attribute to override this behaviour.
│ │ │ │ │ -    OPT
│ │ │ │ │ - [>] OUTPUT
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents         <[[ref]]DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
│ │ │ │ │ + Introduction     <[[ref]]IF size>
│ │ │ │ │ + License              <FONT SIZE=${size}>
│ │ │ │ │ + Tutorial         <[[ref]]/IF>
│ │ │ │ │ + Usage            <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ │ + HTP Tags         <[[ref]]USE title>
│ │ │ │ │ +    ALTTEXT      <[[ref]]IF size>
│ │ │ │ │ +    BLOCK            </FONT>
│ │ │ │ │ +    BLOCKDEF     <[[ref]]/IF>
│ │ │ │ │ +    DEF        <[[ref]]/DEF>
│ │ │ │ │ +    FILE
│ │ │ │ │ +    IF         <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │ +    INC
│ │ │ │ │ +    IMG        <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ │ +    IMAGEURL
│ │ │ │ │ +    OPT        This will fail:
│ │ │ │ │ + [>] OUTPUT     <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another title">
│ │ │ │ │      QUOTE
│ │ │ │ │ -    SET
│ │ │ │ │ -    UNDEF
│ │ │ │ │ -    UNSET
│ │ │ │ │ -    USE,_$
│ │ │ │ │ -    WHILE
│ │ │ │ │ -    <!---
│ │ │ │ │ - History
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs
│ │ │ │ │ +    SET        Instead, use * like this:
│ │ │ │ │ +    UNDEF      <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ │ +    UNSET        <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ │ +    USE,_$     <[[ref]]/DEF>
│ │ │ │ │ +    WHILE       
│ │ │ │ │ +    <!---      <MYIMG SRC="logo.gif" ALT="Our logo">
│ │ │ │ │ + History      ***** synopsis *****
│ │ │ │ │ + Wish_list    The OUTPUT tag can be used to create auxillary files besides the
│ │ │ │ │ + Bugs         main HTML file. The text between this tag and the corresponding </
│ │ │ │ │ +               OUTPUT> tag is written to output file.
│ │ │ │ │ +               Normally the outputfile is cleared before writing to it, but you
│ │ │ │ │ +               can use the APPEND attribute to extend an existing file. The text
│ │ │ │ │ +               written to the file is normally not expanded, i.e. all tags inside
│ │ │ │ │ +               this block are not executed but written unmodified to the file.
│ │ │ │ │ +               However, you can use the EXPAND attribute to override this
│ │ │ │ │ +               behaviour.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according
│ │ │ │ │ +to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/quote.html
│ │ │ │ @@ -117,14 +117,38 @@
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │  <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │  <span class="htp-tag">&lt;<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> &gt;</span><br>
│ │ │ │  <br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;FONT <span class="htp-attrib">SIZE</span>=<span class="htp-value"><span class="htp-macro">${size}</span></span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;/FONT&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; This will fail:<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Instead, use * like this:<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>QUOTE</STRONG> is used to quote a macro that would otherwise
│ │ │ │  be interpreted by HTP.  It may be useful in conjunction with a
│ │ │ │  surrounding <a href="expand.html">EXPAND</a>ed block to prevent early
│ │ │ │  expansion of some contained blocks.  Note that '$' evaluation is still
│ │ │ │  done inside a quote block.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,49 +1,73 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : QUOTE ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]UNDEF tagname>
│ │ │ │ │ - License                    <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents       <[[ref]]UNDEF tagname>
│ │ │ │ │ + Introduction <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ + License
│ │ │ │ │   Tutorial
│ │ │ │ │ - Usage                      ***** synopsis *****
│ │ │ │ │ - HTP Tags                   QUOTE is used to quote a macro that would
│ │ │ │ │ -    ALTTEXT                otherwise be interpreted by HTP. It may be useful
│ │ │ │ │ -    BLOCK                  in conjunction with a surrounding EXPANDed block
│ │ │ │ │ -    BLOCKDEF               to prevent early expansion of some contained
│ │ │ │ │ -    DEF                    blocks. Note that '$' evaluation is still done
│ │ │ │ │ -    FILE                   inside a quote block.
│ │ │ │ │ -    IF
│ │ │ │ │ -    INC
│ │ │ │ │ + Usage            <[[ref]]IF size>
│ │ │ │ │ + HTP Tags             <FONT SIZE=${size}>
│ │ │ │ │ +    ALTTEXT      <[[ref]]/IF>
│ │ │ │ │ +    BLOCK        <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ │ +    BLOCKDEF     <[[ref]]USE title>
│ │ │ │ │ +    DEF          <[[ref]]IF size>
│ │ │ │ │ +    FILE             </FONT>
│ │ │ │ │ +    IF           <[[ref]]/IF>
│ │ │ │ │ +    INC        <[[ref]]/DEF>
│ │ │ │ │      IMG
│ │ │ │ │ -    IMAGEURL
│ │ │ │ │ +    IMAGEURL   <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │      OPT
│ │ │ │ │ -    OUTPUT
│ │ │ │ │ +    OUTPUT     <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ │   [>] QUOTE
│ │ │ │ │ -    SET
│ │ │ │ │ -    UNDEF
│ │ │ │ │ +    SET        This will fail:
│ │ │ │ │ +    UNDEF      <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another title">
│ │ │ │ │      UNSET
│ │ │ │ │ -    USE,_$
│ │ │ │ │ -    WHILE
│ │ │ │ │ -    <!---
│ │ │ │ │ - History
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs
│ │ │ │ │ +    USE,_$     Instead, use * like this:
│ │ │ │ │ +    WHILE      <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ │ +    <!---        <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ │ + History        <[[ref]]/DEF>
│ │ │ │ │ + Wish_list       
│ │ │ │ │ + Bugs           <MYIMG SRC="logo.gif" ALT="Our logo">
│ │ │ │ │ +               ***** synopsis *****
│ │ │ │ │ +               QUOTE is used to quote a macro that would otherwise be interpreted
│ │ │ │ │ +               by HTP. It may be useful in conjunction with a surrounding
│ │ │ │ │ +               EXPANDed block to prevent early expansion of some contained
│ │ │ │ │ +               blocks. Note that '$' evaluation is still done inside a quote
│ │ │ │ │ +               block.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according
│ │ │ │ │ +to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/set.html
│ │ │ │ @@ -114,26 +114,29 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span>;<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>SET</STRONG> creates a macro definition that can later be expanded
│ │ │ │  anywhere in the HTML document.  To create a macro:
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="quote.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">QUOTE</a> <span class="htp-attrib">TAG</span> <span class="htp-attrib">[ATTRIBUTE</span>=<span class="htp-value">VALUE</span> <span class="htp-attrib">...]</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  The macro "emailaddr" can then be expanded later.  The <A HREF="use.html">
│ │ │ │  USE</A> tag is used to expand the macro outside a tag (i.e., into the regular
│ │ │ │  text).  If the macro needs to be expanded inside a markup tag, use the
│ │ │ │  <A HREF="use.html">'$'</A> operator.
│ │ │ │  <P>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,38 +1,43 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : SET ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ - Introduction     <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ - License        <[[ref]]/def>
│ │ │ │ │ +Table_of_Contents    ***** syntax *****
│ │ │ │ │ + Introduction       <[[ref]]unset macroname>
│ │ │ │ │ + License            <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │   Tutorial
│ │ │ │ │ - Usage          <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ - HTP Tags     ***** synopsis *****
│ │ │ │ │ -    ALTTEXT  SET creates a macro definition that can later be expanded
│ │ │ │ │ -    BLOCK    anywhere in the HTML document. To create a macro:
│ │ │ │ │ -    BLOCKDEF <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ -    DEF
│ │ │ │ │ -    FILE     The macro "emailaddr" can then be expanded later. The USE tag is
│ │ │ │ │ -    IF       used to expand the macro outside a tag (i.e., into the regular
│ │ │ │ │ -    INC      text). If the macro needs to be expanded inside a markup tag, use
│ │ │ │ │ -    IMG      the '$' operator.
│ │ │ │ │ -    IMAGEURL Multiple macros can be declared in a single markup tag, as the
│ │ │ │ │ -    OPT      second syntax line shows.
│ │ │ │ │ -    OUTPUT   SET should only be used for a single line's worth of text. Multi-
│ │ │ │ │ -    QUOTE    line macros can be defined with the BLOCK tag. The BLOCK tag is
│ │ │ │ │ - [>] SET      also useful if the macro contains a quotation character and you
│ │ │ │ │ -    UNDEF    don't want to fool around with special escape characters.
│ │ │ │ │ -    UNSET    Macros can be redefined by using another SET command with the
│ │ │ │ │ -    USE,_$   same macro name. The prior definition will be destroyed, however.
│ │ │ │ │ -    WHILE    Also, the macro can be removed (destroyed) with the UNSET tag.
│ │ │ │ │ -    <!---
│ │ │ │ │ - History
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs
│ │ │ │ │ + Usage              ***** synopsis *****
│ │ │ │ │ + HTP Tags           SET creates a macro definition that can later be expanded
│ │ │ │ │ +    ALTTEXT        anywhere in the HTML document. To create a macro:
│ │ │ │ │ +    BLOCK              <[[ref]]unset email_addr>
│ │ │ │ │ +    BLOCKDEF       <[[ref]]blockdef name="section">
│ │ │ │ │ +    DEF                <[[ref]]inc sect-ctr>
│ │ │ │ │ +    FILE               <[[ref]]block name="sect-${sect-ctr}" expand global>
│ │ │ │ │ +    IF                   <[[ref]]use block noexpand>
│ │ │ │ │ +    INC                <[[ref]]/block>
│ │ │ │ │ +    IMG              <[[ref]]/blockdef>
│ │ │ │ │ +    IMAGEURL       The macro "emailaddr" can then be expanded later. The USE
│ │ │ │ │ +    OPT            tag is used to expand the macro outside a tag (i.e., into
│ │ │ │ │ +    OUTPUT         the regular text). If the macro needs to be expanded
│ │ │ │ │ +    QUOTE          inside a markup tag, use the '$' operator.
│ │ │ │ │ + [>] SET            Multiple macros can be declared in a single markup tag, as
│ │ │ │ │ +    UNDEF          the second syntax line shows.
│ │ │ │ │ +    UNSET          SET should only be used for a single line's worth of text.
│ │ │ │ │ +    USE,_$         Multi-line macros can be defined with the BLOCK tag. The
│ │ │ │ │ +    WHILE          BLOCK tag is also useful if the macro contains a quotation
│ │ │ │ │ +    <!---          character and you don't want to fool around with special
│ │ │ │ │ + History            escape characters.
│ │ │ │ │ + Wish_list          Macros can be redefined by using another SET command with
│ │ │ │ │ + Bugs               the same macro name. The prior definition will be
│ │ │ │ │ +                     destroyed, however. Also, the macro can be removed
│ │ │ │ │ +                     (destroyed) with the UNSET tag.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -47,17 +52,16 @@
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ -htp]
│ │ │ │ │ +[Powered_by_htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according
│ │ │ │ │ -to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ +according to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/tut/jh.html
│ │ │ │ @@ -16,10 +16,10 @@
│ │ │ │  <tr><td><b>Phone:</b></td><td>+49 761 203-8243</td></tr>
│ │ │ │  <tr><td><b>Fax:</b></td><td>+49 761 203-8242</td></tr>
│ │ │ │  </table>
│ │ │ │     </td></tr>
│ │ │ │    </table>
│ │ │ │    <hr>
│ │ │ │    Copyright by <a href="mailto:webmaster@domain.com">Joe Doe</a>.<br>
│ │ │ │ -  last updated Sat Jan 06, 2024
│ │ │ │ +  last updated Sat Feb 08, 2025
│ │ │ │   </body>
│ │ │ │  </html>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,8 +1,8 @@
│ │ │ │ │                 ****** Jochen Hoenicke ******
│ │ │ │ │  Navigation bar [Photo]
│ │ │ │ │  Main           Room:  Bld.52 00-020
│ │ │ │ │  Example        Phone: +49 761 203-8243
│ │ │ │ │                 Fax:   +49 761 203-8242
│ │ │ │ │  ===============================================================================
│ │ │ │ │  Copyright by Joe_Doe.
│ │ │ │ │ -last updated Sat Jan 06, 2024
│ │ │ │ │ +last updated Sat Feb 08, 2025
│ │ │ ├── ./usr/share/doc/htp/tut/tut1.html
│ │ │ │ @@ -5,9 +5,9 @@
│ │ │ │  <meta name="Generator" content="htp 1.19">
│ │ │ │  </head>
│ │ │ │  <body>
│ │ │ │  This page was produced by htp.
│ │ │ │  <hr>
│ │ │ │  Copyright by Joe Doe,
│ │ │ │  <a href="mailto:webmaster@domain.com">webmaster@domain.com</a>,
│ │ │ │ -last updated Sat Jan 06, 2024
│ │ │ │ +last updated Sat Feb 08, 2025
│ │ │ │  </body>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,3 +1,3 @@
│ │ │ │ │  This page was produced by htp.
│ │ │ │ │  ===============================================================================
│ │ │ │ │ -Copyright by Joe Doe, webmaster@domain.com, last updated Sat Jan 06, 2024
│ │ │ │ │ +Copyright by Joe Doe, webmaster@domain.com, last updated Sat Feb 08, 2025
│ │ │ ├── ./usr/share/doc/htp/tut/tut2.html
│ │ │ │ @@ -13,10 +13,10 @@
│ │ │ │  <p>
│ │ │ │  As you can see the file contains almost only the contents.
│ │ │ │  </p>
│ │ │ │     </td></tr>
│ │ │ │    </table>
│ │ │ │    <hr>
│ │ │ │    Copyright by <a href="mailto:webmaster@domain.com">Joe Doe</a>.<br>
│ │ │ │ -  last updated Sat Jan 06, 2024
│ │ │ │ +  last updated Sat Feb 08, 2025
│ │ │ │   </body>
│ │ │ │  </html>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,6 +1,6 @@
│ │ │ │ │  Navigation bar ***** Here is the content *****
│ │ │ │ │  Main           As you can see the file contains almost only the contents.
│ │ │ │ │  Example
│ │ │ │ │  ===============================================================================
│ │ │ │ │  Copyright by Joe_Doe.
│ │ │ │ │ -last updated Sat Jan 06, 2024
│ │ │ │ │ +last updated Sat Feb 08, 2025
│ │ │ ├── ./usr/share/doc/htp/tut/tut3.html
│ │ │ │ @@ -13,10 +13,10 @@
│ │ │ │   <p>
│ │ │ │   As you can see the file contains almost only the contents.
│ │ │ │   </p>
│ │ │ │     </td></tr>
│ │ │ │    </table>
│ │ │ │    <hr>
│ │ │ │    Copyright by <a href="webmaster@domain.com">Joe Doe</a>.<br>
│ │ │ │ -  last updated Sat Jan 06, 2024
│ │ │ │ +  last updated Sat Feb 08, 2025
│ │ │ │   </body>
│ │ │ │  </html>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,6 +1,6 @@
│ │ │ │ │  Navigation bar ***** Here are the contents *****
│ │ │ │ │  Main           As you can see the file contains almost only the contents.
│ │ │ │ │  Example
│ │ │ │ │  ===============================================================================
│ │ │ │ │  Copyright by Joe_Doe.
│ │ │ │ │ -last updated Sat Jan 06, 2024
│ │ │ │ │ +last updated Sat Feb 08, 2025
│ │ │ ├── ./usr/share/doc/htp/undef.html
│ │ │ │ @@ -114,21 +114,18 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; block<br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P><STRONG>UNDEF</STRONG> removes a metatag definition.  Metatags
│ │ │ │  created by <A HREF="def.html">DEF</A> and <A
│ │ │ │  HREF="blockdef.html">BLOCKDEF</A> can be removed with the UNDEF
│ │ │ │  command.  Once removed, the metatag will no longer be recognized by
│ │ │ │  htp until it is reassigned.  </P>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,25 +1,25 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : UNDEF ******
│ │ │ │ │ -Table_of_Contents    ***** syntax *****
│ │ │ │ │ - Introduction         <[[ref]]set sect-ctr="0">
│ │ │ │ │ - License              <[[ref]]blockdef name="section">
│ │ │ │ │ - Tutorial               <[[ref]]inc sect-ctr>
│ │ │ │ │ - Usage                  <[[ref]]block name="sect-${sect-ctr}" expand global>
│ │ │ │ │ - HTP Tags                 <[[ref]]use block noexpand>
│ │ │ │ │ -    ALTTEXT            <[[ref]]/block>
│ │ │ │ │ -    BLOCK            <[[ref]]/blockdef>
│ │ │ │ │ -    BLOCKDEF       ***** synopsis *****
│ │ │ │ │ -    DEF            UNDEF removes a metatag definition. Metatags created by
│ │ │ │ │ -    FILE           DEF and BLOCKDEF can be removed with the UNDEF command.
│ │ │ │ │ -    IF             Once removed, the metatag will no longer be recognized by
│ │ │ │ │ -    INC            htp until it is reassigned.
│ │ │ │ │ -    IMG            Multiple metatags can be removed by placing each name as
│ │ │ │ │ -    IMAGEURL       an attribute.
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction               <[[ref]]WHILE [NOT] conditional>
│ │ │ │ │ + License                        block
│ │ │ │ │ + Tutorial                   <[[ref]]/WHILE>
│ │ │ │ │ + Usage
│ │ │ │ │ + HTP Tags                   ***** synopsis *****
│ │ │ │ │ +    ALTTEXT                UNDEF removes a metatag definition. Metatags
│ │ │ │ │ +    BLOCK                  created by DEF and BLOCKDEF can be removed with
│ │ │ │ │ +    BLOCKDEF               the UNDEF command. Once removed, the metatag will
│ │ │ │ │ +    DEF                    no longer be recognized by htp until it is
│ │ │ │ │ +    FILE                   reassigned.
│ │ │ │ │ +    IF                     Multiple metatags can be removed by placing each
│ │ │ │ │ +    INC                    name as an attribute.
│ │ │ │ │ +    IMG
│ │ │ │ │ +    IMAGEURL
│ │ │ │ │      OPT
│ │ │ │ │      OUTPUT
│ │ │ │ │      QUOTE
│ │ │ │ │      SET
│ │ │ │ │   [>] UNDEF
│ │ │ │ │      UNSET
│ │ │ │ │      USE,_$
│ │ │ │ │ @@ -30,23 +30,21 @@
│ │ │ │ │   Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by_htp]
│ │ │ │ │ +HTML coding [Powered_by
│ │ │ │ │ +htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │  Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │  according to terms described in the License_section.
│ │ │ ├── ./usr/share/doc/htp/unset.html
│ │ │ │ @@ -114,40 +114,32 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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">"header.hti"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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">"1"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/while</a>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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">"footer.hti"</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; block<br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>UNSET</STRONG> removes (or deletes) a macro and it's definition.
│ │ │ │  The macro is subsequently not available for use in the pre-processed files.
│ │ │ │  (Note that simply redefining the macro with another <A HREF="set.html">SET</A> or
│ │ │ │  <A HREF="block.html">BLOCK</A> definition with the same name is acceptable.  The
│ │ │ │  old macro definition will be removed automatically.)
│ │ │ │  <P>
│ │ │ │  For example:
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-value"><span class="htp-macro">$email</span></span>&gt;</span>send email<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -This works: &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -But this fails: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -And this fails: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; ...<br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  More than one macro may be removed in the same tag:
│ │ │ │    <p><code>
│ │ │ │  &nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ │  &nbsp; &nbsp; ...<br>
│ │ │ │  &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,45 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : UNSET ******
│ │ │ │ │ -Table_of          ***** syntax *****
│ │ │ │ │ -Contents          <[[ref]]file include="header.hti">
│ │ │ │ │ - Introduction      <[[ref]]set sect-ctr="1">
│ │ │ │ │ - License           <[[ref]]while sect-${sect-ctr}>
│ │ │ │ │ - Tutorial            <[[ref]]use sect-${sect-ctr}>
│ │ │ │ │ - Usage               <[[ref]]inc sect-ctr>
│ │ │ │ │ - HTP Tags          <[[ref]]/while>
│ │ │ │ │ -    ALTTEXT     <[[ref]]file include="footer.hti">
│ │ │ │ │ -    BLOCK       ***** synopsis *****
│ │ │ │ │ -    BLOCKDEF    UNSET removes (or deletes) a macro and it's definition. The
│ │ │ │ │ -    DEF         macro is subsequently not available for use in the pre-
│ │ │ │ │ -    FILE        processed files. (Note that simply redefining the macro with
│ │ │ │ │ -    IF          another SET or BLOCK definition with the same name is
│ │ │ │ │ -    INC         acceptable. The old macro definition will be removed
│ │ │ │ │ -    IMG         automatically.)
│ │ │ │ │ -    IMAGEURL    For example:
│ │ │ │ │ -    OPT         <[[ref]]block stuff>
│ │ │ │ │ -    OUTPUT        <a href=$email>send email</a>
│ │ │ │ │ -    QUOTE       <[[ref]]/block>
│ │ │ │ │ -    SET
│ │ │ │ │ -    UNDEF       <[[ref]]set morestuff=$email>
│ │ │ │ │ - [>] UNSET
│ │ │ │ │ -    USE,_$      This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ │ -    WHILE       But this fails: <[[ref]]use email>
│ │ │ │ │ -    <!---       And this fails: <[[ref]]use morestuff
│ │ │ │ │ - History         email="jnelson@crl.com">
│ │ │ │ │ - Wish_list       More than one macro may be removed in the same tag:
│ │ │ │ │ - Bugs              <[[ref]]WHILE sect-$i>
│ │ │ │ │ -                      ...
│ │ │ │ │ -                      <[[ref]]INC i>
│ │ │ │ │ -                    <[[ref]]/WHILE>
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction               <[[ref]]WHILE [NOT] conditional>
│ │ │ │ │ + License                        block
│ │ │ │ │ + Tutorial                   <[[ref]]/WHILE>
│ │ │ │ │ + Usage
│ │ │ │ │ + HTP Tags                   ***** synopsis *****
│ │ │ │ │ +    ALTTEXT                UNSET removes (or deletes) a macro and it's
│ │ │ │ │ +    BLOCK                  definition. The macro is subsequently not
│ │ │ │ │ +    BLOCKDEF               available for use in the pre-processed files.
│ │ │ │ │ +    DEF                    (Note that simply redefining the macro with
│ │ │ │ │ +    FILE                   another SET or BLOCK definition with the same name
│ │ │ │ │ +    IF                     is acceptable. The old macro definition will be
│ │ │ │ │ +    INC                    removed automatically.)
│ │ │ │ │ +    IMG                    For example:
│ │ │ │ │ +    IMAGEURL                 <[[ref]]WHILE NOT i="10">
│ │ │ │ │ +    OPT                        ...
│ │ │ │ │ +    OUTPUT                     <[[ref]]INC i>
│ │ │ │ │ +    QUOTE                    <[[ref]]/WHILE>
│ │ │ │ │ +    SET                    More than one macro may be removed in the same
│ │ │ │ │ +    UNDEF                  tag:
│ │ │ │ │ + [>] UNSET                    <[[ref]]WHILE sect-$i>
│ │ │ │ │ +    USE,_$                     ...
│ │ │ │ │ +    WHILE                      <[[ref]]INC i>
│ │ │ │ │ +    <!---                    <[[ref]]/WHILE>
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -54,16 +46,16 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by_htp]
│ │ │ │ │ +HTML coding [Powered_by
│ │ │ │ │ +htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │  Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │  according to terms described in the License_section.
│ │ │ ├── ./usr/share/doc/htp/use.html
│ │ │ │ @@ -114,18 +114,21 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; ...<br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <strong>USE</strong> will expand macros that have been previously
│ │ │ │  declared with either <A HREF="set.html">SET</A> or <A
│ │ │ │  HREF="block.html">BLOCK</A>.  USE can only be used outside of other
│ │ │ │  markup tags.
│ │ │ │  <p> If you USE a block macro the value of expanded block macros will
│ │ │ │ @@ -135,15 +138,15 @@
│ │ │ │  attribute to prevent further expansion.  </p>
│ │ │ │  <p> USE will accept additional parameters, which are "local" macros
│ │ │ │  for the expanded macro.  This is only valid for <A
│ │ │ │  HREF="block.html">BLOCK</A> macros.  Macros created using <A
│ │ │ │  HREF="set.html">SET</A> cannot have parameters passed.  For
│ │ │ │  example:</p>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │  <font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ │  <font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │  <font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  (See below for a description of the '$' operator.)  The example on
│ │ │ │  line 7 works because "stuff" has been declared as a block macro, and
│ │ │ │ @@ -157,16 +160,18 @@
│ │ │ │  Inside a markup tag, like <a href="img.html">IMG</a>, 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.
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"mailto:<span class="htp-macro">$email</span>"</span>&gt;</span>mailto hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font><span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"http://<span class="htp-macro">$domain</span>/~<span class="htp-macro">${username}</span>/"</span>&gt;</span>another hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ │ +<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  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 punctuation
│ │ │ │  character or the maximum sequence of letters, digits, &quot;-&quot;
│ │ │ │  and &quot;_&quot; that follows it.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,68 +1,76 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : USE, $ ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]WHILE NOT i="10">
│ │ │ │ │ - Introduction     ...
│ │ │ │ │ - License          <[[ref]]INC i>
│ │ │ │ │ - Tutorial       <[[ref]]/WHILE>
│ │ │ │ │ - Usage        ***** synopsis *****
│ │ │ │ │ - HTP Tags     USE will expand macros that have been previously declared with
│ │ │ │ │ -    ALTTEXT  either SET or BLOCK. USE can only be used outside of other
│ │ │ │ │ -    BLOCK    markup tags.
│ │ │ │ │ -    BLOCKDEF If you USE a block macro the value of expanded block macros will
│ │ │ │ │ -    DEF      be further parsed by htp. This is maybe not what you want, for
│ │ │ │ │ -    FILE     example, if the use is inside a block which expands itself. You
│ │ │ │ │ -    IF       can use the noexpand attribute to prevent further expansion.
│ │ │ │ │ -    INC      USE will accept additional parameters, which are "local" macros
│ │ │ │ │ -    IMG      for the expanded macro. This is only valid for BLOCK macros.
│ │ │ │ │ -    IMAGEURL Macros created using SET cannot have parameters passed. For
│ │ │ │ │ -    OPT      example:
│ │ │ │ │ -    OUTPUT    1.  <[[ref]]WHILE sect-$i>
│ │ │ │ │ -    QUOTE     2.    ...
│ │ │ │ │ -    SET       3.    <[[ref]]INC i>
│ │ │ │ │ -    UNDEF     4.  <[[ref]]/WHILE>
│ │ │ │ │ -    UNSET    (See below for a description of the '$' operator.) The example
│ │ │ │ │ - [>] USE,_$   on line 7 works because "stuff" has been declared as a block
│ │ │ │ │ -    WHILE    macro, and the tag is passing the "email" macro to the "stuff"
│ │ │ │ │ -    <!---    macro. Line 8 fails because the "email" macro is unavailable
│ │ │ │ │ - History      once the block macro is completely expanded, and cannot be
│ │ │ │ │ - Wish_list    passed to a SET macro.
│ │ │ │ │ - Bugs         Note that the "email" macro is available to other 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.<a href="mailto:$email">mailto hyperlink</a>
│ │ │ │ │ -                2.<a href="http://$domain/~${username}/">another hyperlink</a>
│ │ │ │ │ -               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
│ │ │ │ │ -               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 '$'
│ │ │ │ │ -               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
│ │ │ │ │ -               spaces from delimiting the text as if it were additional markup
│ │ │ │ │ -               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:
│ │ │ │ │ -                   <${tagName} ${attrName}=${value$ctr}>
│ │ │ │ │ -               The tagName macro can contain any tag name, even a self-defined
│ │ │ │ │ -               metatag. Note that $ctr is expanded before the valueX macro is
│ │ │ │ │ -               expanded, so assuming that ctr was set to 1 it will expand
│ │ │ │ │ -               value1.
│ │ │ │ │ +Table_of_Contents    ***** syntax *****
│ │ │ │ │ + Introduction           <[[ref]]unset email_addr>
│ │ │ │ │ + License            <[[ref]]blockdef name="section">
│ │ │ │ │ + Tutorial               <[[ref]]inc sect-ctr>
│ │ │ │ │ + Usage                  <[[ref]]block name="sect-${sect-ctr}" expand global>
│ │ │ │ │ + HTP Tags                 <[[ref]]use block noexpand>
│ │ │ │ │ +    ALTTEXT            <[[ref]]/block>
│ │ │ │ │ +    BLOCK            <[[ref]]/blockdef>
│ │ │ │ │ +    BLOCKDEF       ***** synopsis *****
│ │ │ │ │ +    DEF            USE will expand macros that have been previously declared
│ │ │ │ │ +    FILE           with either SET or BLOCK. USE can only be used outside of
│ │ │ │ │ +    IF             other markup tags.
│ │ │ │ │ +    INC            If you USE a block macro the value of expanded block
│ │ │ │ │ +    IMG            macros will be further parsed by htp. This is maybe not
│ │ │ │ │ +    IMAGEURL       what you want, for example, if the use is inside a block
│ │ │ │ │ +    OPT            which expands itself. You can use the noexpand attribute
│ │ │ │ │ +    OUTPUT         to prevent further expansion.
│ │ │ │ │ +    QUOTE          USE will accept additional parameters, which are "local"
│ │ │ │ │ +    SET            macros for the expanded macro. This is only valid for
│ │ │ │ │ +    UNDEF          BLOCK macros. Macros created using SET cannot have
│ │ │ │ │ +    UNSET          parameters passed. For example:
│ │ │ │ │ + [>] USE,_$          1.  <[[ref]]WHILE NOT i="10">
│ │ │ │ │ +    WHILE           2.    ...
│ │ │ │ │ +    <!---           3.    <[[ref]]INC i>
│ │ │ │ │ + History             4.  <[[ref]]/WHILE>
│ │ │ │ │ + Wish_list          (See below for a description of the '$' operator.) The
│ │ │ │ │ + Bugs               example on line 7 works because "stuff" has been declared
│ │ │ │ │ +                     as a block macro, and the tag is 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.
│ │ │ │ │ +                     Note that the "email" macro is available to other 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 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 '$' 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 spaces from delimiting the text as if it
│ │ │ │ │ +                     were additional markup 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:
│ │ │ │ │ +                         <${tagName} ${attrName}=${value$ctr}>
│ │ │ │ │ +                     The tagName macro can contain any tag name, even a self-
│ │ │ │ │ +                     defined metatag. Note that $ctr is expanded before the
│ │ │ │ │ +                     valueX macro is expanded, so assuming that ctr was set to
│ │ │ │ │ +                     1 it will expand value1.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -81,16 +89,15 @@
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ -htp]
│ │ │ │ │ +[Powered_by_htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │  Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │  according to terms described in the License_section.
│ │ │ ├── ./usr/share/doc/htp/while.html
│ │ │ │ @@ -114,21 +114,23 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<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">"header.hti"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<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">"1"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/while</a>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<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">"footer.hti"</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-value"><span class="htp-macro">$email</span></span>&gt;</span>send email<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +<span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +This works: &nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +But this fails: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +And this fails: <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>WHILE</STRONG> is the building block for repeated processing.
│ │ │ │  The basic form is shown above.
│ │ │ │  <P>
│ │ │ │  "Conditional" is either a "compare" or "is defined" operation.
│ │ │ │  A compare operator is a test of the value of a macro against a literal string.
│ │ │ │ @@ -137,16 +139,18 @@
│ │ │ │    <p><code>
│ │ │ │  &nbsp; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span> <span class="htp-attrib">home_url</span> <span class="htp-attrib">login_name</span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  Just as with <a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> you can also check for a
│ │ │ │  macro's existance:
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"mailto:<span class="htp-macro">$email</span>"</span>&gt;</span>mailto hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"http://<span class="htp-macro">$domain</span>/~<span class="htp-macro">${username}</span>/"</span>&gt;</span>another hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; ...<br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<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>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  If the condition is true, the block is evaluated and afterwards the
│ │ │ │  WHILE tag is evaluated again.  If the '$'-operator is used in the
│ │ │ │  WHILE tag it is also reevaluated on each iteration.
│ │ │ │  <P>
│ │ │ │  A loop block <EM>must</EM> be closed with the /WHILE tag.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,37 +1,42 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : WHILE ******
│ │ │ │ │ -Table_of_Contents       ***** syntax *****
│ │ │ │ │ - Introduction          <[[ref]]file include="header.hti">
│ │ │ │ │ - License                 <[[ref]]set sect-ctr="1">
│ │ │ │ │ - Tutorial                <[[ref]]while sect-${sect-ctr}>
│ │ │ │ │ - Usage                     <[[ref]]use sect-${sect-ctr}>
│ │ │ │ │ - HTP Tags                  <[[ref]]inc sect-ctr>
│ │ │ │ │ -    ALTTEXT             <[[ref]]/while>
│ │ │ │ │ -    BLOCK             <[[ref]]file include="footer.hti">
│ │ │ │ │ -    BLOCKDEF          ***** synopsis *****
│ │ │ │ │ -    DEF               WHILE is the building block for repeated
│ │ │ │ │ -    FILE              processing. The basic form is shown above.
│ │ │ │ │ -    IF                "Conditional" is either a "compare" or "is defined"
│ │ │ │ │ -    INC               operation. A compare operator is a test of the
│ │ │ │ │ -    IMG               value of a macro against a literal string. If the
│ │ │ │ │ -    IMAGEURL          NOT tag is present in the WHILE markup, the
│ │ │ │ │ -    OPT               evaluation of the conditional is reversed:
│ │ │ │ │ -    OUTPUT                <[[ref]]unset email_addr home_url login_name>
│ │ │ │ │ -    QUOTE             Just as with [[ref]]IF you can also check for a
│ │ │ │ │ -    SET               macro's existance:
│ │ │ │ │ -    UNDEF             <a href="mailto:$email">mailto hyperlink</a>
│ │ │ │ │ -    UNSET             <a href="http://$domain/~${username}/">another
│ │ │ │ │ -    USE,_$            hyperlink</a>
│ │ │ │ │ - [>] WHILE             If the condition is true, the block is evaluated
│ │ │ │ │ -    <!---             and afterwards the WHILE tag is evaluated again. If
│ │ │ │ │ - History               the '$'-operator is used in the WHILE tag it is
│ │ │ │ │ - Wish_list             also reevaluated on each iteration.
│ │ │ │ │ - Bugs                  A loop block must be closed with the /WHILE tag.
│ │ │ │ │ +Table_of          ***** syntax *****
│ │ │ │ │ +Contents          <[[ref]]block stuff>
│ │ │ │ │ + Introduction      <a href=$email>send email</a>
│ │ │ │ │ + License         <[[ref]]/block>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage           <[[ref]]set morestuff=$email>
│ │ │ │ │ + HTP Tags
│ │ │ │ │ +    ALTTEXT     This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ │ +    BLOCK       But this fails: <[[ref]]use email>
│ │ │ │ │ +    BLOCKDEF    And this fails: <[[ref]]use morestuff
│ │ │ │ │ +    DEF         email="jnelson@crl.com">
│ │ │ │ │ +    FILE        ***** synopsis *****
│ │ │ │ │ +    IF          WHILE is the building block for repeated processing. The
│ │ │ │ │ +    INC         basic form is shown above.
│ │ │ │ │ +    IMG         "Conditional" is either a "compare" or "is defined"
│ │ │ │ │ +    IMAGEURL    operation. A compare operator is a test of the value of a
│ │ │ │ │ +    OPT         macro against a literal string. If the NOT tag is present in
│ │ │ │ │ +    OUTPUT      the WHILE markup, the evaluation of the conditional is
│ │ │ │ │ +    QUOTE       reversed:
│ │ │ │ │ +    SET             <[[ref]]unset email_addr home_url login_name>
│ │ │ │ │ +    UNDEF       Just as with [[ref]]IF you can also check for a macro's
│ │ │ │ │ +    UNSET       existance:
│ │ │ │ │ +    USE,_$        <[[ref]]WHILE sect-$i>
│ │ │ │ │ + [>] WHILE           ...
│ │ │ │ │ +    <!---           <[[ref]]INC i>
│ │ │ │ │ + History           <[[ref]]/WHILE>
│ │ │ │ │ + Wish_list       If the condition is true, the block is evaluated and
│ │ │ │ │ + Bugs            afterwards the WHILE tag is evaluated again. If the '$'-
│ │ │ │ │ +                  operator is used in the WHILE tag it is also reevaluated on
│ │ │ │ │ +                  each iteration.
│ │ │ │ │ +                  A loop block must be closed with the /WHILE tag.
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -49,16 +54,16 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered
│ │ │ │ │ -by_htp]
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by_htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │  Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │  according to terms described in the License_section.