--- /srv/reproducible-results/rbuild-debian/r-b-build.iBBitfo5/b1/htp_1.19-8_arm64.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.iBBitfo5/b2/htp_1.19-8_arm64.changes
├── Files
│ @@ -1,3 +1,3 @@
│  
│   775750816c4512e0e2cf0d189b33beed 69840 debug optional htp-dbgsym_1.19-8_arm64.deb
│ - df6c0e5bddbae0a741cf661d3051a96f 116092 web optional htp_1.19-8_arm64.deb
│ + 2786079731b24af44602aff38b653a7e 116524 web optional htp_1.19-8_arm64.deb
├── htp_1.19-8_arm64.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     3608 2020-06-14 23:21:19.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0   112292 2020-06-14 23:21:19.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0     3616 2020-06-14 23:21:19.000000 control.tar.xz
│ │ +-rw-r--r--   0        0        0   112716 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: arm64
│ │ │ │  Maintainer: Marcelo Soares Mota <motasmarcelo@gmail.com>
│ │ │ │ -Installed-Size: 647
│ │ │ │ +Installed-Size: 662
│ │ │ │  Depends: libc6 (>= 2.34)
│ │ │ │  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)    67816 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)    12414 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9201 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)    11050 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9256 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)    11867 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    15071 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)      878 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/changelog.Debian.gz
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9160 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    13195 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)    11994 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    14165 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)    10816 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11752 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)    13465 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    17356 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)     9313 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    12817 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)    10382 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11797 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)    11448 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)     9504 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9559 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)    16792 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    14776 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)     7911 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11327 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)     7777 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9337 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)     7959 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8008 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)     8890 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8739 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)     8633 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     7759 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)    10904 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)    11448 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.html
│ │ │ │ +-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)     3300 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     9257 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10341 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.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,45 +114,42 @@
│ │ │ │        <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="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">"imagename"</span> <span class="ebnf">[</span> <span class="htp-attrib">text</span>=<span class="htp-string">"imagetext"</span> <span class="ebnf">]</span>&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="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>
│ │ │ │ +<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>
│ │ │ │  <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>
│ │ │ │  </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,46 +1,39 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : ALTTEXT ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]file execute="command-line"
│ │ │ │ │ - License                    (output="filename" | redirect) [noerror]>
│ │ │ │ │ - Tutorial                   <[[ref]]file include="includefilename" [parameters
│ │ │ │ │ - Usage                      ...]>
│ │ │ │ │ - HTP Tags                   <[[ref]]file name>
│ │ │ │ │ - [>] ALTTEXT                <[[ref]]file [ name="filename" ] size[ =
│ │ │ │ │ -    BLOCK                  (byte|kbyte|mbyte|gbyte) ] [precision=n]>
│ │ │ │ │ -    BLOCKDEF               <[[ref]]file [ name="filename" ] time[ ="format"
│ │ │ │ │ -    DEF                    ]>
│ │ │ │ │ -    FILE                   <[[ref]]file [ name="filename" ] date[ ="format"
│ │ │ │ │ -    IF                     ]>
│ │ │ │ │ -    INC                    <[[ref]]file search="searchpath">
│ │ │ │ │ -    IMG                    <[[ref]]file template="templatefilename">
│ │ │ │ │ -    IMAGEURL
│ │ │ │ │ -    OPT                    ***** synopsis *****
│ │ │ │ │ -    OUTPUT                 ALTTEXT declares an ALT attribute for any IMG tag
│ │ │ │ │ -    QUOTE                  with a SRC matching the ALTTEXT NAME. Since
│ │ │ │ │ -    SET                    relative paths can be used to point to the same
│ │ │ │ │ -    UNDEF                  image, only the filename is considered in all
│ │ │ │ │ -    UNSET                  comparisons.
│ │ │ │ │ -    USE,_$                 When an IMG tag with a matching source is
│ │ │ │ │ -    WHILE                  encountered, htp will add an ALT attribute only if
│ │ │ │ │ -    <!---                  one is not already present. This allows for ALT
│ │ │ │ │ - History                    text to be overridden on specific images and
│ │ │ │ │ - Wish_list                  default text on all others.
│ │ │ │ │ - Bugs                       For example:
│ │ │ │ │ -                               <[[ref]]def name="bigfont">
│ │ │ │ │ -                                 <font size="+4">
│ │ │ │ │ -                               <[[ref]]/def>
│ │ │ │ │ + Introduction               <[[ref]]alttext name="imagename"
│ │ │ │ │ + License                    [ text="imagetext" ]>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage                      ***** synopsis *****
│ │ │ │ │ + HTP Tags                   ALTTEXT declares an ALT attribute for any IMG tag
│ │ │ │ │ + [>] ALTTEXT                with a SRC matching the ALTTEXT NAME. Since
│ │ │ │ │ +    BLOCK                  relative paths can be used to point to the same
│ │ │ │ │ +    BLOCKDEF               image, only the filename is considered in all
│ │ │ │ │ +    DEF                    comparisons.
│ │ │ │ │ +    FILE                   When an IMG tag with a matching source is
│ │ │ │ │ +    IF                     encountered, htp will add an ALT attribute only if
│ │ │ │ │ +    INC                    one is not already present. This allows for ALT
│ │ │ │ │ +    IMG                    text to be overridden on specific images and
│ │ │ │ │ +    IMAGEURL               default text on all others.
│ │ │ │ │ +    OPT                    For example:
│ │ │ │ │ +    OUTPUT                 <[[ref]]IF [NOT] conditional>
│ │ │ │ │ +    QUOTE                      block #1
│ │ │ │ │ +    SET                    [
│ │ │ │ │ +    UNDEF                  <ELSEIF [NOT] conditional>
│ │ │ │ │ +    UNSET                      block #2
│ │ │ │ │ +    USE,_$                 ...
│ │ │ │ │ +    WHILE                  ]
│ │ │ │ │ +    <!---                  [
│ │ │ │ │ + History                    <ELSE>
│ │ │ │ │ + Wish_list                      block #3
│ │ │ │ │ + Bugs                       ]
│ │ │ │ │ +                             <[[ref]]/IF>
│ │ │ │ │  
│ │ │ │ │ -                               <[[ref]]def name="/bigfont">
│ │ │ │ │ -                                 </font>
│ │ │ │ │ -                               <[[ref]]/def>
│ │ │ │ │ -
│ │ │ │ │ -                               <bigfont>Some large text</bigfont>
│ │ │ │ │                               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
│ │ │ ├── ./usr/share/doc/htp/block.html
│ │ │ │ @@ -114,23 +114,24 @@
│ │ │ │        <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>
│ │ │ │ +&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>
│ │ │ │  </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,41 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : BLOCK, /BLOCK ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]file execute="command-line"
│ │ │ │ │ - License                    (output="filename" | redirect) [noerror]>
│ │ │ │ │ - Tutorial                   <[[ref]]file include="includefilename" [parameters
│ │ │ │ │ - Usage                      ...]>
│ │ │ │ │ - HTP Tags                   <[[ref]]file name>
│ │ │ │ │ -    ALTTEXT                <[[ref]]file [ name="filename" ] size[ =
│ │ │ │ │ - [>] BLOCK                  (byte|kbyte|mbyte|gbyte) ] [precision=n]>
│ │ │ │ │ -    BLOCKDEF               <[[ref]]file [ name="filename" ] time[ ="format"
│ │ │ │ │ -    DEF                    ]>
│ │ │ │ │ -    FILE                   <[[ref]]file [ name="filename" ] date[ ="format"
│ │ │ │ │ -    IF                     ]>
│ │ │ │ │ -    INC                    <[[ref]]file search="searchpath">
│ │ │ │ │ -    IMG                    <[[ref]]file template="templatefilename">
│ │ │ │ │ -    IMAGEURL
│ │ │ │ │ -    OPT                    ***** synopsis *****
│ │ │ │ │ -    OUTPUT                 BLOCK and /BLOCK are used to create block macros,
│ │ │ │ │ -    QUOTE                  which are similar in use to SET macros, but can be
│ │ │ │ │ -    SET                    multi-line definitions.
│ │ │ │ │ -    UNDEF                  Any text and formatting may be set inside the
│ │ │ │ │ -    UNSET                  block. You can use any htp or user defined metatag
│ │ │ │ │ -    USE,_$                 including FILE_INCLUDE. The metatags won't be
│ │ │ │ │ -    WHILE                  expanded before the block is USEd except if you
│ │ │ │ │ -    <!---                  give the EXPAND parameter.
│ │ │ │ │ - History                    The block macro is dereferenced (expanded) with
│ │ │ │ │ - Wish_list                  the USE_tag_or_the_'$'_operator. See the notes on
│ │ │ │ │ - Bugs                       the USE tag on how to pass parameters to a block
│ │ │ │ │ -                             macro.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ + Introduction                 <[[ref]]blockdef name="section" option="title">
│ │ │ │ │ + License                       <h1><[[ref]]use title></h1>
│ │ │ │ │ + Tutorial                      <p class="section">
│ │ │ │ │ + Usage                           <[[ref]]use block>
│ │ │ │ │ + HTP Tags                      </p>
│ │ │ │ │ +    ALTTEXT                  <[[ref]]/blockdef>
│ │ │ │ │ + [>] BLOCK
│ │ │ │ │ +    BLOCKDEF                 <section title="My Section">
│ │ │ │ │ +    DEF                        This is a fancy section.
│ │ │ │ │ +    FILE                     </section>
│ │ │ │ │ +    IF                     ***** synopsis *****
│ │ │ │ │ +    INC                    BLOCK and /BLOCK are used to create block macros,
│ │ │ │ │ +    IMG                    which are similar in use to SET macros, but can be
│ │ │ │ │ +    IMAGEURL               multi-line definitions.
│ │ │ │ │ +    OPT                    Any text and formatting may be set inside the
│ │ │ │ │ +    OUTPUT                 block. You can use any htp or user defined metatag
│ │ │ │ │ +    QUOTE                  including FILE_INCLUDE. The metatags won't be
│ │ │ │ │ +    SET                    expanded before the block is USEd except if you
│ │ │ │ │ +    UNDEF                  give the EXPAND parameter.
│ │ │ │ │ +    UNSET                  The block macro is dereferenced (expanded) with
│ │ │ │ │ +    USE,_$                 the USE_tag_or_the_'$'_operator. See the notes on
│ │ │ │ │ +    WHILE                  the USE tag on how to pass parameters to a block
│ │ │ │ │ +    <!---                  macro.
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ ├── ./usr/share/doc/htp/blockdef.html
│ │ │ │ @@ -114,59 +114,54 @@
│ │ │ │        <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="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>
│ │ │ │ +&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>
│ │ │ │  </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>
│ │ │ │ -&nbsp; <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">"http://my.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/my.domain/"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <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">"other.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/other.domain/"</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; For 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; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ │ -&nbsp; (no URL replacement).<br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; For 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">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ -&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; But for 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">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ -&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ │ -&nbsp; will not be added.<br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ │ -&nbsp; <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">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <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">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&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">"/image.gif"</span>&gt;</span>&nbsp;and <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">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ │ -&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ │ -&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ │ -&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<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>
│ │ │ │  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,57 +1,53 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : BLOCKDEF, /BLOCKDEF ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]IF [NOT] conditional>
│ │ │ │ │ - Introduction     block #1
│ │ │ │ │ - License      [
│ │ │ │ │ - Tutorial     <ELSEIF [NOT] conditional>
│ │ │ │ │ - Usage            block #2
│ │ │ │ │ - HTP Tags     ...
│ │ │ │ │ -    ALTTEXT  ]
│ │ │ │ │ -    BLOCK    [
│ │ │ │ │ - [>] BLOCKDEF <ELSE>
│ │ │ │ │ -    DEF          block #3
│ │ │ │ │ -    FILE     ]
│ │ │ │ │ -    IF       <[[ref]]/IF>
│ │ │ │ │ -    INC
│ │ │ │ │ -    IMG      ***** synopsis *****
│ │ │ │ │ -    IMAGEURL BLOCKDEF creates block metatags, which is a fancy way of saying it creates
│ │ │ │ │ -    OPT      new block tags. A block tag is a tag that takes a whole block as additional
│ │ │ │ │ -    OUTPUT   parameter. This block is surrounded by <tagname> and </tagname>. The contents
│ │ │ │ │ -    QUOTE    of this block are automatically stored in the block macro named BLOCK.
│ │ │ │ │ -    SET      For example:
│ │ │ │ │ -    UNDEF      <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ -    UNSET      <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ -    USE,_$
│ │ │ │ │ -    WHILE      For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ -    <!---      the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ - History        (no URL replacement).
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs           For this line: <[[ref]]img src="http://my.domain.org/logo.gif">
│ │ │ │ │ -                 the local filename "/var/www/my.domain/logo.gif" will be used.
│ │ │ │ │ -
│ │ │ │ │ -                 But for this line: <[[ref]]img src="http://other.domain.org/logo.gif">
│ │ │ │ │ -                 the local file cannot be found (no prefix match), so the image dimensions
│ │ │ │ │ -                 will not be added.
│ │ │ │ │ -
│ │ │ │ │ -                 Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ │ -                 <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ │ -                 <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ │ -
│ │ │ │ │ -                 <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/image.gif"> are
│ │ │ │ │ -               mapped to
│ │ │ │ │ -                 /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
│ │ │ │ │ -                 If the order of the imageurl lines would be swapped, the second
│ │ │ │ │ -                 image would be mapped to /var/www/htdocs/test/image.gif.
│ │ │ │ │ -               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.
│ │ │ │ │ +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 *****
│ │ │ │ │ +               BLOCKDEF creates block metatags, 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 <tagname> and </
│ │ │ │ │ +               tagname>. The contents of this block are automatically stored in the
│ │ │ │ │ +               block macro named BLOCK.
│ │ │ │ │ +               For example:
│ │ │ │ │ +                   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>
│ │ │ │ │ +               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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -77,10 +73,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/comment.html
│ │ │ │ @@ -135,23 +135,51 @@
│ │ │ │  <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="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="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">"http://my.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/my.domain/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"other.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/other.domain/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ │ +&nbsp; (no URL replacement).<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; But for 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">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ │ +&nbsp; will not be added.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ │ +&nbsp; <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">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&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">"/image.gif"</span>&gt;</span>&nbsp;and <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">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ │ +&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ │ +&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ │ +&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<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; &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>&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="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>
│ │ │ │  </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,38 +1,63 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : <!--- ******
│ │ │ │ │ -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                    This is a simple comment that is not included in
│ │ │ │ │ -    OUTPUT                 the output. This is useful when commenting
│ │ │ │ │ -    QUOTE                  metatags, since the metatags do not appear the
│ │ │ │ │ -    SET                    output either. Example:
│ │ │ │ │ -    UNDEF                      <[[ref]]IF name="Jim">...<[[ref]]/IF>
│ │ │ │ │ -    UNSET                  Note that these comments should not include < or
│ │ │ │ │ -    USE,_$                 >, that is you should not use it to comment out
│ │ │ │ │ -    WHILE                  htp code. For that purpose use something like
│ │ │ │ │ - [>] <!---                  this:
│ │ │ │ │ - History                        <[[ref]]IF name>...<[[ref]]/IF>
│ │ │ │ │ - Wish_list                  Make sure that the variable is never defined and
│ │ │ │ │ - Bugs                       xyz should be the reason why you don't want to
│ │ │ │ │ -                             include this block
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents       <[[ref]]IF [NOT] conditional>
│ │ │ │ │ + Introduction     block #1
│ │ │ │ │ + License      [
│ │ │ │ │ + Tutorial     <ELSEIF [NOT] conditional>
│ │ │ │ │ + Usage            block #2
│ │ │ │ │ + HTP Tags     ...
│ │ │ │ │ +    ALTTEXT  ]
│ │ │ │ │ +    BLOCK    [
│ │ │ │ │ +    BLOCKDEF <ELSE>
│ │ │ │ │ +    DEF          block #3
│ │ │ │ │ +    FILE     ]
│ │ │ │ │ +    IF       <[[ref]]/IF>
│ │ │ │ │ +    INC
│ │ │ │ │ +    IMG      ***** synopsis *****
│ │ │ │ │ +    IMAGEURL This is a simple comment that is not included in the output. This is useful
│ │ │ │ │ +    OPT      when commenting metatags, since the metatags do not appear the output either.
│ │ │ │ │ +    OUTPUT   Example:
│ │ │ │ │ +    QUOTE      <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ +    SET        <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET      For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ +    USE,_$     the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ +    WHILE      (no URL replacement).
│ │ │ │ │ + [>] <!---
│ │ │ │ │ + History        For this line: <[[ref]]img src="http://my.domain.org/logo.gif">
│ │ │ │ │ + Wish_list      the local filename "/var/www/my.domain/logo.gif" will be used.
│ │ │ │ │ + Bugs
│ │ │ │ │ +                 But for this line: <[[ref]]img src="http://other.domain.org/logo.gif">
│ │ │ │ │ +                 the local file cannot be found (no prefix match), so the image dimensions
│ │ │ │ │ +                 will not be added.
│ │ │ │ │ +
│ │ │ │ │ +                 Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ │ +                 <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ │ +                 <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ │ +
│ │ │ │ │ +                 <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/image.gif"> are
│ │ │ │ │ +               mapped to
│ │ │ │ │ +                 /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
│ │ │ │ │ +                 If the order of the imageurl lines would be swapped, the second
│ │ │ │ │ +                 image would be mapped to /var/www/htdocs/test/image.gif.
│ │ │ │ │ +               Note that these comments should not include < or >, that is you should not
│ │ │ │ │ +               use it to comment out htp code. For that purpose use something like this:
│ │ │ │ │ +                   <[[ref]]IF name>...<[[ref]]/IF>
│ │ │ │ │ +               <[[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)>
│ │ │ │ │ +
│ │ │ │ │ +               Make sure that the variable is never defined and xyz should be the reason why
│ │ │ │ │ +               you don't want to include this block
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -50,17 +75,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
│ │ │ │ @@ -137,44 +137,52 @@
│ │ │ │  <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">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;<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>
│ │ │ │ -<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>
│ │ │ │ -text block<br>
│ │ │ │ -<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>
│ │ │ │ +&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; <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> 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="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>
│ │ │ │ +<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>
│ │ │ │  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,87 +1,87 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : DEF, /DEF ******
│ │ │ │ │ -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                    DEF creates metatags, which is a fancy way of
│ │ │ │ │ -    OUTPUT                 saying it creates new tags. The mechanism is very
│ │ │ │ │ -    QUOTE                  similar to BLOCK macros, except that the USE tag
│ │ │ │ │ -    SET                    is not used to expand them. Instead, they are
│ │ │ │ │ -    UNDEF                  expanded by their own name. For example:
│ │ │ │ │ -    UNSET                  <[[ref]]if disabled_because_xyz>
│ │ │ │ │ -    USE,_$                   ...
│ │ │ │ │ -    WHILE                  <[[ref]]/if>
│ │ │ │ │ -    <!---                  Some metatags will require an opening and closing
│ │ │ │ │ - History                    tag (comparable to
│ │ │ │ │ - Wish_list                  and
│ │ │ │ │ - Bugs                       ). 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]]OUTPUT FILE="outputfilename" [APPEND]
│ │ │ │ │ -                             [EXPAND]>
│ │ │ │ │ -                             text block
│ │ │ │ │ -                             <[[ref]]/OUTPUT>
│ │ │ │ │ -
│ │ │ │ │ -                             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]]UNDEF tagname>
│ │ │ │ │ -                             <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ -
│ │ │ │ │ -                             .. >
│ │ │ │ │ -
│ │ │ │ │ -                             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]]IF [NOT] conditional>
│ │ │ │ │ + Introduction     block #1
│ │ │ │ │ + License      [
│ │ │ │ │ + Tutorial     <ELSEIF [NOT] conditional>
│ │ │ │ │ + Usage            block #2
│ │ │ │ │ + HTP Tags     ...
│ │ │ │ │ +    ALTTEXT  ]
│ │ │ │ │ +    BLOCK    [
│ │ │ │ │ +    BLOCKDEF <ELSE>
│ │ │ │ │ + [>] DEF          block #3
│ │ │ │ │ +    FILE     ]
│ │ │ │ │ +    IF       <[[ref]]/IF>
│ │ │ │ │ +    INC
│ │ │ │ │ +    IMG      ***** synopsis *****
│ │ │ │ │ +    IMAGEURL DEF creates metatags, which is a fancy way of saying it creates
│ │ │ │ │ +    OPT      new tags. The mechanism is very similar to BLOCK macros, except
│ │ │ │ │ +    OUTPUT   that the USE tag is not used to expand them. Instead, they are
│ │ │ │ │ +    QUOTE    expanded by their own name. For example:
│ │ │ │ │ +    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
│ │ │ │ │ +               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]]def name="sharedimg" option="name alt">
│ │ │ │ │ +                   <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ +                 <[[ref]]/def>
│ │ │ │ │ +
│ │ │ │ │ +                 <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ +               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]]SET macroname1="macrovalue1" [macroname2="macrovalue2"
│ │ │ │ │ +               ...] [GLOBAL]>
│ │ │ │ │ +
│ │ │ │ │ +               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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -99,17 +99,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/expand.html
│ │ │ │ @@ -98,32 +98,40 @@
│ │ │ │  <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;7. </font>er 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>
│ │ │ │ -<font size="-2">&nbsp;8. </font><br>
│ │ │ │ -<font size="-2">&nbsp;9. </font>&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>
│ │ │ │ -<font size="-2">10. </font>&nbsp; will also have an ALT attribute appended to it<br>
│ │ │ │ -<font size="-2">11. </font><br>
│ │ │ │ -<font size="-2">12. </font>&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>
│ │ │ │ -<font size="-2">13. </font>&nbsp; remains unchanged.<br>
│ │ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;EM&gt;</span>File "<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>" last 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>
│ │ │ │  This produces the following:
│ │ │ │    <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>
│ │ │ │ +&nbsp; <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">"http://my.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/my.domain/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"other.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/other.domain/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ │ +&nbsp; (no URL replacement).<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; But for 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">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ │ +&nbsp; will not be added.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ │ +&nbsp; <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">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&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">"/image.gif"</span>&gt;</span>&nbsp;and <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">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ │ +&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ │ +&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ │ +&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<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,62 +1,68 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : global and expand ******
│ │ │ │ │  Table_of         ***** The global attribute *****
│ │ │ │ │ -Contents         Normally when you define a macro it is only defined in the current scope.
│ │ │ │ │ - Introduction   A scope is for example the definition of a metatag. Once the definition
│ │ │ │ │ - License        is expanded and the metatag has finished the macro is automatically
│ │ │ │ │ - Tutorial       removed. In some cases you want to define a macro inside a metatag and
│ │ │ │ │ - Usage          use it later. You can do this with the global attribute that you can add
│ │ │ │ │ -    Command-   to [[ref]]set, [[ref]]inc, [[ref]]block, [[ref]]def, and [[ref]]blockdef
│ │ │ │ │ -      line       tags.
│ │ │ │ │ -    Options    ***** The expand attribute *****
│ │ │ │ │ -    Predefined The expand attribute is not a tag of its own but is an attribute of all
│ │ │ │ │ -      macros     block tags even metatags defined with the blockdef macro. Normally htp
│ │ │ │ │ - [>] global_and uses a lazy evaluation strategy, i.e. it expands htp tags, metatags and
│ │ │ │ │ -      expand     macros when the HTML document is written not when they're stored into
│ │ │ │ │ - HTP_Tags       block macros. When you use a macro defined with the blockdef tag the html
│ │ │ │ │ - History        code between the tags is just copied literally into the macro named
│ │ │ │ │ - Wish_list      block, without any expansion going on.
│ │ │ │ │ - Bugs           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.
│ │ │ │ │ -                  7.er processing: <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ │ -                  8.
│ │ │ │ │ -                  9.  this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ │ -                 10.  will also have an ALT attribute appended to it
│ │ │ │ │ -                 11.
│ │ │ │ │ -                 12.  this line: <[[ref]]img src="logo.gif" alt="Click here for more
│ │ │ │ │ -                 information!">
│ │ │ │ │ -                 13.  remains unchanged.
│ │ │ │ │ +Contents         Normally when you define a macro it is only defined in the current scope. A
│ │ │ │ │ + Introduction   scope is for example the definition of a metatag. Once the definition is
│ │ │ │ │ + License        expanded and the metatag has finished the macro is automatically removed. In
│ │ │ │ │ + Tutorial       some cases you want to define a macro inside a metatag and use it later. You
│ │ │ │ │ + Usage          can do this with the global attribute that you can add to [[ref]]set, [
│ │ │ │ │ +    Command-   [ref]]inc, [[ref]]block, [[ref]]def, and [[ref]]blockdef tags.
│ │ │ │ │ +      line       ***** The expand attribute *****
│ │ │ │ │ +    Options    The expand attribute is not a tag of its own but is an attribute of all block
│ │ │ │ │ +    Predefined tags even metatags defined with the blockdef macro. Normally htp uses a lazy
│ │ │ │ │ +      macros     evaluation strategy, i.e. it expands htp tags, metatags and macros when the
│ │ │ │ │ + [>] global_and HTML document is written not when they're stored into block macros. When you
│ │ │ │ │ +      expand     use a macro defined with the blockdef tag the html code between the tags is
│ │ │ │ │ + HTP_Tags       just copied literally into the macro named block, without any expansion going
│ │ │ │ │ + History        on.
│ │ │ │ │ + Wish_list      However, if the block tag is marked with the expand modifier it is expanded
│ │ │ │ │ + Bugs           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.    <EM>File "<[[ref]]FILE NAME>" last updated <[[ref]]FILE TIME>, <[
│ │ │ │ │ +                 [ref]]FILE DATE></EM>
│ │ │ │ │                   This produces the following:
│ │ │ │ │ -                     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>
│ │ │ │ │ -                 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.
│ │ │ │ │ +                   <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ +                   <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ +
│ │ │ │ │ +                   For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ +                   the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ +                   (no URL replacement).
│ │ │ │ │ +
│ │ │ │ │ +                   For this line: <[[ref]]img src="http://my.domain.org/logo.gif">
│ │ │ │ │ +                   the local filename "/var/www/my.domain/logo.gif" will be used.
│ │ │ │ │ +
│ │ │ │ │ +                   But for this line: <[[ref]]img src="http://other.domain.org/logo.gif">
│ │ │ │ │ +                   the local file cannot be found (no prefix match), so the image dimensions
│ │ │ │ │ +                   will not be added.
│ │ │ │ │ +
│ │ │ │ │ +                   Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ │ +                   <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ │ +                   <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ │ +
│ │ │ │ │ +                   <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/image.gif"> are
│ │ │ │ │ +                 mapped to
│ │ │ │ │ +                   /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
│ │ │ │ │ +                   If the order of the imageurl lines would be swapped, the second
│ │ │ │ │ +                   image would be mapped to /var/www/htdocs/test/image.gif.
│ │ │ │ │ +                 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.
│ │ │ │ │ +                 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.
│ │ │ ├── ./usr/share/doc/htp/file.html
│ │ │ │ @@ -114,37 +114,68 @@
│ │ │ │        <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="comment">&lt;!---  This comment doesn't appear in the HTML file ---&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>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>
│ │ │ │ -<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; <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">"http://my.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/my.domain/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"other.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/other.domain/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ │ +&nbsp; (no URL replacement).<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; But for 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">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ │ +&nbsp; will not be added.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ │ +&nbsp; <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">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&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">"/image.gif"</span>&gt;</span>&nbsp;and <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">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ │ +&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ │ +&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ │ +&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<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; &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>&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; <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>
│ │ │ │  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
│ │ │ │ @@ -173,18 +204,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>
│ │ │ │ -<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>
│ │ │ │ -text block<br>
│ │ │ │ -<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>
│ │ │ │ +&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; <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,132 +1,131 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : FILE ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <!--- This comment doesn't appear in the HTML file
│ │ │ │ │ - License                    --->
│ │ │ │ │ - Tutorial                   ***** synopsis *****
│ │ │ │ │ - Usage                      FILE has several optional parameters of differing
│ │ │ │ │ - HTP Tags                   purpose. The output file's name, the current date
│ │ │ │ │ -    ALTTEXT                and time, and the contents of another file may be
│ │ │ │ │ -    BLOCK                  included. Another file's time, date, or size may
│ │ │ │ │ -    BLOCKDEF               be added to the output file as well.
│ │ │ │ │ -    DEF                    As with all HTML, these tags do not have to be on
│ │ │ │ │ - [>] FILE                   their own line, so the following is perfectly
│ │ │ │ │ -    IF                     acceptable:
│ │ │ │ │ -    INC                    <[[ref]]if disabled_because_xyz>
│ │ │ │ │ -    IMG                      ...
│ │ │ │ │ -    IMAGEURL               <[[ref]]/if>
│ │ │ │ │ -    OPT                    **** NAME, TIME, SIZE ****
│ │ │ │ │ -    OUTPUT                 To include information about another file, such as
│ │ │ │ │ -    QUOTE                  an archive file or graphic image, specify its name
│ │ │ │ │ -    SET                    with the NAME attribute followed by the type of
│ │ │ │ │ -    UNDEF                  information to be displayed:
│ │ │ │ │ -    UNSET                      <[[ref]]IF name>...<[[ref]]/IF>
│ │ │ │ │ -    USE,_$                 For file size information, the value BYTE, KBYTE,
│ │ │ │ │ -    WHILE                  etc. dictates how the information is displayed. In
│ │ │ │ │ -    <!---                  anything other than byte format, the information
│ │ │ │ │ - History                    is displayed in floating-point notation. The
│ │ │ │ │ - Wish_list                  amount of precision (the number of digits to the
│ │ │ │ │ - Bugs                       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]]OUTPUT FILE="outputfilename" [APPEND]
│ │ │ │ │ -                             [EXPAND]>
│ │ │ │ │ -                             text block
│ │ │ │ │ -                             <[[ref]]/OUTPUT>
│ │ │ │ │ -
│ │ │ │ │ -                             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       <[[ref]]IF [NOT] conditional>
│ │ │ │ │ + Introduction     block #1
│ │ │ │ │ + License      [
│ │ │ │ │ + Tutorial     <ELSEIF [NOT] conditional>
│ │ │ │ │ + Usage            block #2
│ │ │ │ │ + HTP Tags     ...
│ │ │ │ │ +    ALTTEXT  ]
│ │ │ │ │ +    BLOCK    [
│ │ │ │ │ +    BLOCKDEF <ELSE>
│ │ │ │ │ +    DEF          block #3
│ │ │ │ │ + [>] FILE     ]
│ │ │ │ │ +    IF       <[[ref]]/IF>
│ │ │ │ │ +    INC
│ │ │ │ │ +    IMG      ***** synopsis *****
│ │ │ │ │ +    IMAGEURL FILE has several optional parameters of differing purpose. The output file's
│ │ │ │ │ +    OPT      name, the current date and time, and the contents of another file may be
│ │ │ │ │ +    OUTPUT   included. Another file's time, date, or size may be added to the output file
│ │ │ │ │ +    QUOTE    as well.
│ │ │ │ │ +    SET      As with all HTML, these tags do not have to be on their own line, so the
│ │ │ │ │ +    UNDEF    following is perfectly acceptable:
│ │ │ │ │ +    UNSET      <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ +    USE,_$     <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---      For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ + History        the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ + Wish_list      (no URL replacement).
│ │ │ │ │ + Bugs
│ │ │ │ │ +                 For this line: <[[ref]]img src="http://my.domain.org/logo.gif">
│ │ │ │ │ +                 the local filename "/var/www/my.domain/logo.gif" will be used.
│ │ │ │ │ +
│ │ │ │ │ +                 But for this line: <[[ref]]img src="http://other.domain.org/logo.gif">
│ │ │ │ │ +                 the local file cannot be found (no prefix match), so the image dimensions
│ │ │ │ │ +                 will not be added.
│ │ │ │ │ +
│ │ │ │ │ +                 Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ │ +                 <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ │ +                 <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ │ +
│ │ │ │ │ +                 <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/image.gif"> are
│ │ │ │ │ +               mapped to
│ │ │ │ │ +                 /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
│ │ │ │ │ +                 If the order of the imageurl lines would be swapped, the second
│ │ │ │ │ +                 image would be mapped to /var/www/htdocs/test/image.gif.
│ │ │ │ │ +               **** NAME, TIME, SIZE ****
│ │ │ │ │ +               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:
│ │ │ │ │ +                   <[[ref]]INC i="1" j="-1">
│ │ │ │ │ +               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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -144,17 +143,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/if.html
│ │ │ │ @@ -114,33 +114,56 @@
│ │ │ │        <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="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">"http://my.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/my.domain/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"other.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/other.domain/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ │ +&nbsp; (no URL replacement).<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; But for 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">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ │ +&nbsp; will not be added.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ │ +&nbsp; <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">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&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">"/image.gif"</span>&gt;</span>&nbsp;and <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">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ │ +&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ │ +&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ │ +&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<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>
│ │ │ │ +&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>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  and a defined operator is a test of a macro's existance:
│ │ │ │  <P>
│ │ │ │    <p><code>
│ │ │ │ -<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>
│ │ │ │ -text block<br>
│ │ │ │ -<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>
│ │ │ │ +&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; <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>
│ │ │ │  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,38 +1,62 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IF, ELSEIF, ELSE, /IF ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       ***** synopsis *****
│ │ │ │ │ - Introduction IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for conditional
│ │ │ │ │ - License      processing. The basic form is shown above.
│ │ │ │ │ - Tutorial     "Conditional" is either a "compare" or "is defined" operation. A compare
│ │ │ │ │ - Usage        operator is a test of the value of a macro against a literal string:
│ │ │ │ │ - HTP Tags         File image.gif <[[ref]]FILE NAME="image.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ -    ALTTEXT      Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ -    BLOCK    NAME="image.gif" DATE>
│ │ │ │ │ -    BLOCKDEF and a defined operator is a test of a macro's existance:
│ │ │ │ │ -    DEF      <[[ref]]OUTPUT FILE="outputfilename" [APPEND] [EXPAND]>
│ │ │ │ │ -    FILE     text block
│ │ │ │ │ - [>] IF       <[[ref]]/OUTPUT>
│ │ │ │ │ -    INC
│ │ │ │ │ -    IMG      If the NOT tag is present in the IF markup, the evaluation of the
│ │ │ │ │ -    IMAGEURL conditional is reversed. The first IF or ELSEIF condition that evaluates
│ │ │ │ │ -    OPT      to true is chosen. If none of the conditions is true the ELSE block is
│ │ │ │ │ -    OUTPUT   taken if it is present. A conditional block must be closed with the /IF
│ │ │ │ │ -    QUOTE    tag. IF tags can be nested.
│ │ │ │ │ -    SET
│ │ │ │ │ -    UNDEF
│ │ │ │ │ -    UNSET
│ │ │ │ │ -    USE,_$
│ │ │ │ │ -    WHILE
│ │ │ │ │ -    <!---
│ │ │ │ │ - History
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs
│ │ │ │ │ +Contents         <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ + Introduction   <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ + License
│ │ │ │ │ + Tutorial       For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ + Usage          the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ + HTP Tags       (no URL replacement).
│ │ │ │ │ +    ALTTEXT
│ │ │ │ │ +    BLOCK      For this line: <[[ref]]img src="http://my.domain.org/logo.gif">
│ │ │ │ │ +    BLOCKDEF   the local filename "/var/www/my.domain/logo.gif" will be used.
│ │ │ │ │ +    DEF
│ │ │ │ │ +    FILE       But for this line: <[[ref]]img src="http://other.domain.org/logo.gif">
│ │ │ │ │ + [>] IF         the local file cannot be found (no prefix match), so the image dimensions
│ │ │ │ │ +    INC        will not be added.
│ │ │ │ │ +    IMG
│ │ │ │ │ +    IMAGEURL   Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ │ +    OPT        <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ │ +    OUTPUT     <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET        <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/image.gif"> are
│ │ │ │ │ +    UNDEF    mapped to
│ │ │ │ │ +    UNSET      /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
│ │ │ │ │ +    USE,_$     If the order of the imageurl lines would be swapped, the second
│ │ │ │ │ +    WHILE      image would be mapped to /var/www/htdocs/test/image.gif.
│ │ │ │ │ +    <!---    ***** synopsis *****
│ │ │ │ │ + History      IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for conditional
│ │ │ │ │ + Wish_list    processing. The basic form is shown above.
│ │ │ │ │ + Bugs         "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:
│ │ │ │ │ +                   <[[ref]]FILE INCLUDE="include.hti" name="Jim Nelson"
│ │ │ │ │ +               email="jnelson@crl.com">
│ │ │ │ │ +                   This tag will fail: <[[ref]]USE name>
│ │ │ │ │ +               and a defined operator is a test of a macro's existance:
│ │ │ │ │ +                 <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ +                   <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ +                 <[[ref]]/def>
│ │ │ │ │ +
│ │ │ │ │ +                 <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ +               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.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -49,10 +73,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,17 +114,14 @@
│ │ │ │        <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>
│ │ │ │  </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
│ │ │ │ @@ -138,22 +135,36 @@
│ │ │ │  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>
│ │ │ │ -<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>
│ │ │ │ +&nbsp; <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">"http://my.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/my.domain/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"other.domain.org/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/other.domain/"</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ +&nbsp; For 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; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ │ +&nbsp; (no URL replacement).<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; For 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">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; But for 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">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ │ +&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ │ +&nbsp; will not be added.<br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ │ +&nbsp; <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">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <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">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&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">"/image.gif"</span>&gt;</span>&nbsp;and <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">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ │ +&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ │ +&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ │ +&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<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,54 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IMAGEURL ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]if disabled_because_xyz>
│ │ │ │ │ - License                      ...
│ │ │ │ │ - Tutorial                   <[[ref]]/if>
│ │ │ │ │ - Usage                      ***** synopsis *****
│ │ │ │ │ - HTP Tags                   IMAGEURL tells htp, where to find images on the
│ │ │ │ │ -    ALTTEXT                local file system. declares an URL replacement
│ │ │ │ │ -    BLOCK                  that is used for size lookups in any IMG tag. This
│ │ │ │ │ -    BLOCKDEF               definitions takes effect only if the IMGXY option
│ │ │ │ │ -    DEF                    is enabled. Beacause htp can't lookup files in the
│ │ │ │ │ -    FILE                   world wide web you have to map absolute image URLs
│ │ │ │ │ -    IF                     to a directory in the local file system.
│ │ │ │ │ -    INC                    When an IMG tag is encountered where htp has to
│ │ │ │ │ -    IMG                    insert width and height the defined URL
│ │ │ │ │ - [>] IMAGEURL               replacements will be taken into account (later
│ │ │ │ │ -    OPT                    definitions take precedence to earlier): For each
│ │ │ │ │ -    OUTPUT                 defined imageurl it checks (case-insensitive) if
│ │ │ │ │ -    QUOTE                  it is a prefix of the image's SRC attribute. If it
│ │ │ │ │ -    SET                    matches this prefix is replaced by the given PATH.
│ │ │ │ │ -    UNDEF                  If no IMAGEURL matches the SRC is considered as
│ │ │ │ │ -    UNSET                  relative link and looked up in the current
│ │ │ │ │ -    USE,_$                 directory.
│ │ │ │ │ -    WHILE                  For example:
│ │ │ │ │ -    <!---                  <[[ref]]OPT (IMGXY|NOIMGXY)>
│ │ │ │ │ - History                    <[[ref]]OPT (QUIET|VERBOSE)>
│ │ │ │ │ - Wish_list                  <[[ref]]OPT (DEPEND|NODEPEND)>
│ │ │ │ │ - Bugs                       <[[ref]]OPT (PRECIOUS|NOPRECIOUS)>
│ │ │ │ │ -                             <[[ref]]OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
│ │ │ │ │ -                             <[[ref]]OPT DELIM=(HTML|SQUARE|CURLY)>
│ │ │ │ │ -                             <[[ref]]OPT (XML|XML=FALSE)>
│ │ │ │ │ -
│ │ │ │ │ -                             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       ***** synopsis *****
│ │ │ │ │ + Introduction IMAGEURL tells htp, where to find images on the local file system. declares
│ │ │ │ │ + License      an URL replacement that is used for size lookups in any IMG tag. This
│ │ │ │ │ + Tutorial     definitions takes effect only if the IMGXY option is enabled. Beacause htp
│ │ │ │ │ + Usage        can't lookup files in the world wide web you have to map absolute image URLs
│ │ │ │ │ + HTP Tags     to a directory in the local file system.
│ │ │ │ │ +    ALTTEXT  When an IMG tag is encountered where htp has to insert width and height the
│ │ │ │ │ +    BLOCK    defined URL replacements will be taken into account (later definitions take
│ │ │ │ │ +    BLOCKDEF precedence to earlier): For each defined imageurl it checks (case-
│ │ │ │ │ +    DEF      insensitive) if it is a prefix of the image's SRC attribute. If it matches
│ │ │ │ │ +    FILE     this prefix is replaced by the given PATH. If no IMAGEURL matches the SRC is
│ │ │ │ │ +    IF       considered as relative link and looked up in the current directory.
│ │ │ │ │ +    INC      For example:
│ │ │ │ │ +    IMG        <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ + [>] IMAGEURL   <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ +    OPT
│ │ │ │ │ +    OUTPUT     For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ +    QUOTE      the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ +    SET        (no URL replacement).
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET      For this line: <[[ref]]img src="http://my.domain.org/logo.gif">
│ │ │ │ │ +    USE,_$     the local filename "/var/www/my.domain/logo.gif" will be used.
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---      But for this line: <[[ref]]img src="http://other.domain.org/logo.gif">
│ │ │ │ │ + History        the local file cannot be found (no prefix match), so the image dimensions
│ │ │ │ │ + Wish_list      will not be added.
│ │ │ │ │ + Bugs
│ │ │ │ │ +                 Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ │ +                 <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ │ +                 <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ │ +
│ │ │ │ │ +                 <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/image.gif"> are
│ │ │ │ │ +               mapped to
│ │ │ │ │ +                 /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
│ │ │ │ │ +                 If the order of the imageurl lines would be swapped, the second
│ │ │ │ │ +                 image would be mapped to /var/www/htdocs/test/image.gif.
│ │ │ │ │ +               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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -63,17 +66,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,34 +114,37 @@
│ │ │ │        <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; 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="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>
│ │ │ │  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="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>
│ │ │ │ -text block<br>
│ │ │ │ -<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>
│ │ │ │ +&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; <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>
│ │ │ │  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,38 +1,47 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : INC ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -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        The INC can be used for incrementing/decrementing a variable or for
│ │ │ │ │ - HTP Tags     variable addition. The basic form is shown above.
│ │ │ │ │ -    ALTTEXT  The "increment" is anything that evaluates to a integer. It can be a
│ │ │ │ │ -    BLOCK    literal string or a macro preceeded by the '$'-operator. The macroname
│ │ │ │ │ -    BLOCKDEF must be the name of a defined macro that contains an integer. If the
│ │ │ │ │ -    DEF      increment is ommitted it defaults to 1. The effect of this operation is
│ │ │ │ │ -    FILE     that the macro is redefined to contain the sum of its previous value and
│ │ │ │ │ -    IF       its increment.
│ │ │ │ │ - [>] INC      To increment or decrement a variable you can use this form:
│ │ │ │ │ -    IMG      <[[ref]]OUTPUT FILE="outputfilename" [APPEND] [EXPAND]>
│ │ │ │ │ -    IMAGEURL text block
│ │ │ │ │ -    OPT      <[[ref]]/OUTPUT>
│ │ │ │ │ -    OUTPUT
│ │ │ │ │ -    QUOTE    Note that INC doesn't check if the strings really denote integers. It may
│ │ │ │ │ -    SET      give weired results when used on arbitrary strings. The integer values
│ │ │ │ │ -    UNDEF    are limited to the range -2^31..2^31.
│ │ │ │ │ -    UNSET    Note further that htp wasn't designed to do extensive calculations. The
│ │ │ │ │ -    USE,_$   INC tag is useful in conjunction with WHILE to iterate over the defined
│ │ │ │ │ -    WHILE    blocks.
│ │ │ │ │ +Table_of_Contents       ***** syntax *****
│ │ │ │ │ + Introduction          <[[ref]]INC macroname1="increment1"
│ │ │ │ │ + License               [macroname2="increment2" ... ] [GLOBAL]>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage                 ***** synopsis *****
│ │ │ │ │ + HTP Tags              The INC can be used for incrementing/decrementing a
│ │ │ │ │ +    ALTTEXT           variable or for variable addition. The basic form
│ │ │ │ │ +    BLOCK             is shown above.
│ │ │ │ │ +    BLOCKDEF          The "increment" is anything that evaluates to a
│ │ │ │ │ +    DEF               integer. It can be a literal string or a macro
│ │ │ │ │ +    FILE              preceeded by the '$'-operator. The macroname must
│ │ │ │ │ +    IF                be the name of a defined macro that contains an
│ │ │ │ │ + [>] INC               integer. If the increment is ommitted it defaults
│ │ │ │ │ +    IMG               to 1. The effect of this operation is that the
│ │ │ │ │ +    IMAGEURL          macro is redefined to contain the sum of its
│ │ │ │ │ +    OPT               previous value and its increment.
│ │ │ │ │ +    OUTPUT            To increment or decrement a variable you can use
│ │ │ │ │ +    QUOTE             this form:
│ │ │ │ │ +    SET                 <[[ref]]blockdef name="bolditalic">
│ │ │ │ │ +    UNDEF                 <b><i>
│ │ │ │ │ +    UNSET                 <[[ref]]use block>
│ │ │ │ │ +    USE,_$                </i></b>
│ │ │ │ │ +    WHILE               <[[ref]]/blockdef>
│ │ │ │ │      <!---
│ │ │ │ │ - History
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs
│ │ │ │ │ + History                 This is <bolditalic>bold and italic</bolditalic>
│ │ │ │ │ + Wish_list             Note that INC doesn't check if the strings really
│ │ │ │ │ + Bugs                  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.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -46,18 +55,17 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   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.
│ │ │ │ │ +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,40 +88,15 @@
│ │ │ │  <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><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;5. </font><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;6. </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;7. </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;8. </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;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> <span class="htp-attrib">size</span>&gt;</span><br>
│ │ │ │ -<font size="-2">10. </font>&nbsp; &nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;/FONT&gt;</span><br>
│ │ │ │ -<font size="-2">11. </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">12. </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">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">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">15. </font><br>
│ │ │ │ -<font size="-2">16. </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">17. </font><br>
│ │ │ │ -<font size="-2">18. </font>&nbsp; This will fail:<br>
│ │ │ │ -<font size="-2">19. </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">20. </font><br>
│ │ │ │ -<font size="-2">21. </font>&nbsp; Instead, use * like this:<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> <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">23. </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">24. </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">25. </font>&nbsp; &nbsp; <br>
│ │ │ │ -<font size="-2">26. </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>&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>&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>
│ │ │ │  </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>
│ │ │ │ @@ -131,35 +106,42 @@
│ │ │ │  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="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>&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>
│ │ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;b&gt;</span><span class="htp-tag">&lt;i&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;3. </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">block</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;4. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;/i&gt;</span><span class="htp-tag">&lt;/b&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;5. </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;6. </font><br>
│ │ │ │ +<font size="-2">&nbsp;7. </font>&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>
│ │ │ │  <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>&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>
│ │ │ │ +<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>
│ │ │ │  <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>&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>
│ │ │ │ +<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>
│ │ │ │  <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
│ │ │ │ @@ -178,18 +160,23 @@
│ │ │ │  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">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>
│ │ │ │ +<font size="-2">&nbsp;1. </font><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>
│ │ │ │ +<font size="-2">&nbsp;2. </font>&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>
│ │ │ │ +<font size="-2">&nbsp;3. </font><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>
│ │ │ │ +<font size="-2">&nbsp;4. </font><br>
│ │ │ │ +<font size="-2">&nbsp;5. </font><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>
│ │ │ │ +<font size="-2">&nbsp;6. </font><br>
│ │ │ │ +<font size="-2">&nbsp;7. </font>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>
│ │ │ │ +<font size="-2">&nbsp;8. </font>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>
│ │ │ │ +<font size="-2">&nbsp;9. </font>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>
│ │ │ │  <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
│ │ │ │  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.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,114 +1,104 @@
│ │ │ │ │  
│ │ │ │ │  [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]]OUTPUT FILE="outputfilename" [APPEND] [EXPAND]>
│ │ │ │ │ - Usage          2.text block
│ │ │ │ │ - HTP_Tags       3.<[[ref]]/OUTPUT>
│ │ │ │ │ - History        4.
│ │ │ │ │ - Wish_list      5.<FONT SIZE=${size}>
│ │ │ │ │ - Bugs           6.    <[[ref]]/IF>
│ │ │ │ │ -                 7.    <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ │ -                 8.    <[[ref]]USE title>
│ │ │ │ │ -                 9.    <[[ref]]IF size>
│ │ │ │ │ -                10.        </FONT>
│ │ │ │ │ -                11.    <[[ref]]/IF>
│ │ │ │ │ -                12.  <[[ref]]/DEF>
│ │ │ │ │ -                13.
│ │ │ │ │ -                14.  <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │ -                15.
│ │ │ │ │ -                16.  <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ │ -                17.
│ │ │ │ │ -                18.  This will fail:
│ │ │ │ │ -                19.  <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another title">
│ │ │ │ │ -                20.
│ │ │ │ │ -                21.  Instead, use * like this:
│ │ │ │ │ -                22.  <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ │ -                23.    <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ │ -                24.  <[[ref]]/DEF>
│ │ │ │ │ -                25.   
│ │ │ │ │ -                26.  <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.
│ │ │ │ │ +Contents        Metatags allow for defining your own HTML-like tags. When you
│ │ │ │ │ + Introduction  define a metatag you have to provide the HTML code which it
│ │ │ │ │ + License       abbreviates. In fact metatags are just like block macros, but they
│ │ │ │ │ + Tutorial      have a nicer syntax. With metatags you can expand htp's
│ │ │ │ │ +    Macros    functionality.
│ │ │ │ │ +    Including Metatags are defined with the [[ref]]def and [[ref]]blockdef tags
│ │ │ │ │ +    Templates and undefined with the [[ref]]undef tag.
│ │ │ │ │ +    Files     As an example we show how to define a tag that builds a fancy
│ │ │ │ │ + [>] Metatags  horizontal rule out of several images.
│ │ │ │ │ + Usage          1.    <[[ref]]IF name>...<[[ref]]/IF>
│ │ │ │ │ + HTP_Tags      In line 1 of the above example a new tag named imghr is defined.
│ │ │ │ │ + History       The html code which implements this rule is following in lines 2-
│ │ │ │ │ + Wish_list     8. between the [[ref]]def_and_/def tags. You don't have to
│ │ │ │ │ + Bugs          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.
│ │ │ │ │ +                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]]blockdef name="bolditalic">
│ │ │ │ │ +                 2.    <b><i>
│ │ │ │ │ +                 3.    <[[ref]]use block>
│ │ │ │ │ +                 4.    </i></b>
│ │ │ │ │ +                 5.  <[[ref]]/blockdef>
│ │ │ │ │ +                 6.
│ │ │ │ │ +                 7.  This is <bolditalic>bold and italic</bolditalic>
│ │ │ │ │ +                ***** 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]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ +                 2.
│ │ │ │ │ +                ***** 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]]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]]unset email_addr>
│ │ │ │ │ -                ***** 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]]unset email_addr home_url login_name>
│ │ │ │ │ -                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.
│ │ │ │ │ +                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.
│ │ │ │ │ +                 1.<[[ref]]block stuff>
│ │ │ │ │ +                 2.  <a href=$email>send email</a>
│ │ │ │ │ +                 3.<[[ref]]/block>
│ │ │ │ │ +                 4.
│ │ │ │ │ +                 5.<[[ref]]set morestuff=$email>
│ │ │ │ │ +                 6.
│ │ │ │ │ +                 7.This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ │ +                 8.But this fails: <[[ref]]use email>
│ │ │ │ │ +                 9.And this fails: <[[ref]]use morestuff email="jnelson@crl.com">
│ │ │ │ │ +                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?
│ │ │ │ │ +                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.
│ │ │ │ │ +                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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -121,10 +111,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/opt.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>
│ │ │ │  <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,38 +1,60 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : OPT ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ - Introduction
│ │ │ │ │ - License      ***** synopsis *****
│ │ │ │ │ - Tutorial     OPT is an htp tag that can be used to specify processing options inside the
│ │ │ │ │ - Usage        actual document being processed. The options are used exactly as they would be
│ │ │ │ │ - HTP Tags     on the command-line, although they are not preceded by a ‘-’ character.
│ │ │ │ │ -    ALTTEXT  Click here for more_information_on_using_customization_options_with_htp.
│ │ │ │ │ -    BLOCK
│ │ │ │ │ -    BLOCKDEF
│ │ │ │ │ -    DEF
│ │ │ │ │ +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
│ │ │ │ │ +    IF         <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │      INC
│ │ │ │ │ -    IMG
│ │ │ │ │ +    IMG        <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ │      IMAGEURL
│ │ │ │ │ - [>] OPT
│ │ │ │ │ -    OUTPUT
│ │ │ │ │ + [>] 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    OPT is an htp tag that can be used to specify processing options inside the
│ │ │ │ │ + Bugs         actual document being processed. The options are used exactly as they would be
│ │ │ │ │ +               on the command-line, although they are not preceded by a ‘-’ character.
│ │ │ │ │ +               Click here for more_information_on_using_customization_options_with_htp.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │  [Powered_by
│ │ │ ├── ./usr/share/doc/htp/output.html
│ │ │ │ @@ -114,14 +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="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>
│ │ │ │  </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,28 +1,28 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : OUTPUT ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               ***** synopsis *****
│ │ │ │ │ - License                    The OUTPUT tag can be used to create auxillary
│ │ │ │ │ - Tutorial                   files besides the main HTML file. The text between
│ │ │ │ │ - Usage                      this tag and the corresponding </OUTPUT> tag is
│ │ │ │ │ - HTP Tags                   written to output file.
│ │ │ │ │ -    ALTTEXT                Normally the outputfile is cleared before writing
│ │ │ │ │ -    BLOCK                  to it, but you can use the APPEND attribute to
│ │ │ │ │ -    BLOCKDEF               extend an existing file. The text written to the
│ │ │ │ │ -    DEF                    file is normally not expanded, i.e. all tags
│ │ │ │ │ -    FILE                   inside this block are not executed but written
│ │ │ │ │ -    IF                     unmodified to the file. However, you can use the
│ │ │ │ │ -    INC                    EXPAND attribute to override this behaviour.
│ │ │ │ │ -    IMG
│ │ │ │ │ -    IMAGEURL
│ │ │ │ │ -    OPT
│ │ │ │ │ - [>] OUTPUT
│ │ │ │ │ -    QUOTE
│ │ │ │ │ +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            The OUTPUT tag can be used to create auxillary files
│ │ │ │ │ +    FILE           besides the main HTML file. The text between this tag and
│ │ │ │ │ +    IF             the corresponding </OUTPUT> tag is written to output file.
│ │ │ │ │ +    INC            Normally the outputfile is cleared before writing to it,
│ │ │ │ │ +    IMG            but you can use the APPEND attribute to extend an existing
│ │ │ │ │ +    IMAGEURL       file. The text written to the file is normally not
│ │ │ │ │ +    OPT            expanded, i.e. all tags inside this block are not executed
│ │ │ │ │ + [>] OUTPUT         but written unmodified to the file. However, you can use
│ │ │ │ │ +    QUOTE          the EXPAND attribute to override this behaviour.
│ │ │ │ │      SET
│ │ │ │ │      UNDEF
│ │ │ │ │      UNSET
│ │ │ │ │      USE,_$
│ │ │ │ │      WHILE
│ │ │ │ │      <!---
│ │ │ │ │   History
│ │ │ │ │ @@ -30,21 +30,26 @@
│ │ │ │ │   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/quote.html
│ │ │ │ @@ -114,16 +114,15 @@
│ │ │ │        <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="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>
│ │ │ │ +<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"macrovalue2"</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>
│ │ │ │  <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
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,13 +1,13 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : QUOTE ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]unset macroname>
│ │ │ │ │ - License                    <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │ + Introduction               <[[ref]]SET macroname1="macrovalue1"
│ │ │ │ │ + License                    [macroname2="macrovalue2" ...] [GLOBAL]>
│ │ │ │ │   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
│ │ │ ├── ./usr/share/doc/htp/set.html
│ │ │ │ @@ -114,23 +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="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>
│ │ │ │ +<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="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"macrovalue2"</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>
│ │ │ │  <STRONG>SET</STRONG> creates a macro definition that can later be expanded
│ │ │ │  anywhere in the HTML document.  To create a macro:
│ │ │ │    <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>&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,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : SET ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]unset macroname>
│ │ │ │ │ - License                    <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │ + Introduction               <[[ref]]SET macroname1="macrovalue1"
│ │ │ │ │ + License                    [macroname2="macrovalue2" ...] [GLOBAL]>
│ │ │ │ │   Tutorial
│ │ │ │ │   Usage                      ***** synopsis *****
│ │ │ │ │   HTP Tags                   SET creates a macro definition that can later be
│ │ │ │ │      ALTTEXT                expanded anywhere in the HTML document. To create
│ │ │ │ │      BLOCK                  a macro:
│ │ │ │ │ -    BLOCKDEF                   <[[ref]]unset email_addr>
│ │ │ │ │ -    DEF                    The macro "emailaddr" can then be expanded later.
│ │ │ │ │ -    FILE                   The USE tag is used to expand the macro outside a
│ │ │ │ │ -    IF                     tag (i.e., into the regular text). If the macro
│ │ │ │ │ -    INC                    needs to be expanded inside a markup tag, use the
│ │ │ │ │ -    IMG                    '$' operator.
│ │ │ │ │ -    IMAGEURL               Multiple macros can be declared in a single markup
│ │ │ │ │ -    OPT                    tag, as the second syntax line shows.
│ │ │ │ │ -    OUTPUT                 SET should only be used for a single line's worth
│ │ │ │ │ -    QUOTE                  of text. Multi-line macros can be defined with the
│ │ │ │ │ - [>] SET                    BLOCK tag. The BLOCK tag is also useful if the
│ │ │ │ │ -    UNDEF                  macro contains a quotation character and you don't
│ │ │ │ │ -    UNSET                  want to fool around with special escape
│ │ │ │ │ -    USE,_$                 characters.
│ │ │ │ │ -    WHILE                  Macros can be redefined by using another SET
│ │ │ │ │ -    <!---                  command with the same macro name. The prior
│ │ │ │ │ - History                    definition will be destroyed, however. Also, the
│ │ │ │ │ - Wish_list                  macro can be removed (destroyed) with the UNSET
│ │ │ │ │ - Bugs                       tag.
│ │ │ │ │ -
│ │ │ │ │ +    BLOCKDEF               The macro "emailaddr" can then be expanded later.
│ │ │ │ │ +    DEF                    The USE tag is used to expand the macro outside a
│ │ │ │ │ +    FILE                   tag (i.e., into the regular text). If the macro
│ │ │ │ │ +    IF                     needs to be expanded inside a markup tag, use the
│ │ │ │ │ +    INC                    '$' operator.
│ │ │ │ │ +    IMG                    Multiple macros can be declared in a single markup
│ │ │ │ │ +    IMAGEURL               tag, as the second syntax line shows.
│ │ │ │ │ +    OPT                    SET should only be used for a single line's worth
│ │ │ │ │ +    OUTPUT                 of text. Multi-line macros can be defined with the
│ │ │ │ │ +    QUOTE                  BLOCK tag. The BLOCK tag is also useful if the
│ │ │ │ │ + [>] SET                    macro contains a quotation character and you don't
│ │ │ │ │ +    UNDEF                  want to fool around with special escape
│ │ │ │ │ +    UNSET                  characters.
│ │ │ │ │ +    USE,_$                 Macros can be redefined by using another SET
│ │ │ │ │ +    WHILE                  command with the same macro name. The prior
│ │ │ │ │ +    <!---                  definition will be destroyed, however. Also, the
│ │ │ │ │ + History                    macro can be removed (destroyed) with the UNSET
│ │ │ │ │ + Wish_list                  tag.
│ │ │ │ │ + Bugs
│ │ │ ├── ./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 Feb 08, 2025
│ │ │ │ +  last updated Sun Jan 07, 2024
│ │ │ │   </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 Feb 08, 2025
│ │ │ │ │ +last updated Sun Jan 07, 2024
│ │ │ ├── ./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 Feb 08, 2025
│ │ │ │ +last updated Sun Jan 07, 2024
│ │ │ │  </body>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,3 +1,3 @@
│ │ │ │ │  This page was produced by htp.
│ │ │ │ │  ===============================================================================
│ │ │ │ │ -Copyright by Joe Doe, webmaster@domain.com, last updated Sat Feb 08, 2025
│ │ │ │ │ +Copyright by Joe Doe, webmaster@domain.com, last updated Sun Jan 07, 2024
│ │ │ ├── ./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 Feb 08, 2025
│ │ │ │ +  last updated Sun Jan 07, 2024
│ │ │ │   </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 Feb 08, 2025
│ │ │ │ │ +last updated Sun Jan 07, 2024
│ │ │ ├── ./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 Feb 08, 2025
│ │ │ │ +  last updated Sun Jan 07, 2024
│ │ │ │   </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 Feb 08, 2025
│ │ │ │ │ +last updated Sun Jan 07, 2024
│ │ │ ├── ./usr/share/doc/htp/undef.html
│ │ │ │ @@ -114,19 +114,15 @@
│ │ │ │        <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>
│ │ │ │ -<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>
│ │ │ │ +&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>
│ │ │ │  </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,23 +1,22 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : UNDEF ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ - Introduction     <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ - License        <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage          <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ - HTP Tags     ***** synopsis *****
│ │ │ │ │ -    ALTTEXT  UNDEF removes a metatag definition. Metatags created by DEF and
│ │ │ │ │ -    BLOCK    BLOCKDEF can be removed with the UNDEF command. Once removed, the
│ │ │ │ │ -    BLOCKDEF metatag will no longer be recognized by htp until it is
│ │ │ │ │ -    DEF      reassigned.
│ │ │ │ │ -    FILE     Multiple metatags can be removed by placing each name as an
│ │ │ │ │ -    IF       attribute.
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction                   <[[ref]]unset email_addr>
│ │ │ │ │ + License                    ***** synopsis *****
│ │ │ │ │ + Tutorial                   UNDEF removes a metatag definition. Metatags
│ │ │ │ │ + Usage                      created by DEF and BLOCKDEF can be removed with
│ │ │ │ │ + HTP Tags                   the UNDEF command. Once removed, the metatag will
│ │ │ │ │ +    ALTTEXT                no longer be recognized by htp until it is
│ │ │ │ │ +    BLOCK                  reassigned.
│ │ │ │ │ +    BLOCKDEF               Multiple metatags can be removed by placing each
│ │ │ │ │ +    DEF                    name as an attribute.
│ │ │ │ │ +    FILE
│ │ │ │ │ +    IF
│ │ │ │ │      INC
│ │ │ │ │      IMG
│ │ │ │ │      IMAGEURL
│ │ │ │ │      OPT
│ │ │ │ │      OUTPUT
│ │ │ │ │      QUOTE
│ │ │ │ │      SET
│ │ │ │ │ @@ -28,25 +27,22 @@
│ │ │ │ │      <!---
│ │ │ │ │   History
│ │ │ │ │   Wish_list
│ │ │ │ │   Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │   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/unset.html
│ │ │ │ @@ -114,36 +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>
│ │ │ │ -&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="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>
│ │ │ │ -&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>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>
│ │ │ │ -&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>
│ │ │ │ +&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,35 +1,34 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : UNSET ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ - Introduction     <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ - License        <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage          <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ - HTP Tags     ***** synopsis *****
│ │ │ │ │ -    ALTTEXT  UNSET removes (or deletes) a macro and it's definition. The macro
│ │ │ │ │ -    BLOCK    is subsequently not available for use in the pre-processed files.
│ │ │ │ │ -    BLOCKDEF (Note that simply redefining the macro with another SET or BLOCK
│ │ │ │ │ -    DEF      definition with the same name is acceptable. The old macro
│ │ │ │ │ -    FILE     definition will be removed automatically.)
│ │ │ │ │ -    IF       For example:
│ │ │ │ │ -    INC        <[[ref]]set sect-ctr="0">
│ │ │ │ │ -    IMG        <[[ref]]blockdef name="section">
│ │ │ │ │ -    IMAGEURL     <[[ref]]inc sect-ctr>
│ │ │ │ │ -    OPT          <[[ref]]block name="sect-${sect-ctr}" expand global>
│ │ │ │ │ -    OUTPUT         <[[ref]]use block noexpand>
│ │ │ │ │ -    QUOTE        <[[ref]]/block>
│ │ │ │ │ -    SET        <[[ref]]/blockdef>
│ │ │ │ │ -    UNDEF    More than one macro may be removed in the same tag:
│ │ │ │ │ - [>] UNSET      <[[ref]]WHILE sect-$i>
│ │ │ │ │ -    USE,_$       ...
│ │ │ │ │ -    WHILE        <[[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
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -47,18 +46,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/use.html
│ │ │ │ @@ -114,15 +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; &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>
│ │ │ │ +&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>
│ │ │ │  <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
│ │ │ │ @@ -132,15 +135,18 @@
│ │ │ │  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; &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>
│ │ │ │ +<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>
│ │ │ │  (See below for a description of the '$' operator.)  The 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.
│ │ │ │ @@ -151,18 +157,16 @@
│ │ │ │  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>&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>
│ │ │ │ +<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>
│ │ │ │  </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,71 +1,68 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : USE, $ ******
│ │ │ │ │ -Table_of_Contents       ***** syntax *****
│ │ │ │ │ - Introduction              <[[ref]]unset email_addr>
│ │ │ │ │ - License               ***** synopsis *****
│ │ │ │ │ - Tutorial              USE will expand macros that have been previously
│ │ │ │ │ - Usage                 declared with either SET or BLOCK. USE can only be used
│ │ │ │ │ - HTP Tags              outside of other markup tags.
│ │ │ │ │ -    ALTTEXT           If you USE a block macro the value of expanded block
│ │ │ │ │ -    BLOCK             macros will be further parsed by htp. This is maybe not
│ │ │ │ │ -    BLOCKDEF          what you want, for example, if the use is inside a
│ │ │ │ │ -    DEF               block which expands itself. You can use the noexpand
│ │ │ │ │ -    FILE              attribute to prevent further expansion.
│ │ │ │ │ -    IF                USE will accept additional parameters, which are
│ │ │ │ │ -    INC               "local" macros for the expanded macro. This is only
│ │ │ │ │ -    IMG               valid for BLOCK macros. Macros created using SET cannot
│ │ │ │ │ -    IMAGEURL          have parameters passed. For example:
│ │ │ │ │ -    OPT                1.    <[[ref]]unset email_addr home_url login_name>
│ │ │ │ │ -    OUTPUT            (See below for a description of the '$' operator.) The
│ │ │ │ │ -    QUOTE             example on line 7 works because "stuff" has been
│ │ │ │ │ -    SET               declared as a block macro, and the tag is passing the
│ │ │ │ │ -    UNDEF             "email" macro to the "stuff" macro. Line 8 fails
│ │ │ │ │ -    UNSET             because the "email" macro is unavailable once the block
│ │ │ │ │ - [>] USE,_$            macro is completely expanded, and cannot be passed to a
│ │ │ │ │ -    WHILE             SET macro.
│ │ │ │ │ -    <!---             Note that the "email" macro is available to other
│ │ │ │ │ - History               macros or included files called within the "stuff"
│ │ │ │ │ - Wish_list             block.
│ │ │ │ │ - Bugs                  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.
│ │ │ │ │ +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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -83,16 +80,17 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   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/while.html
│ │ │ │ @@ -125,16 +125,23 @@
│ │ │ │  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.
│ │ │ │  If the NOT tag is present in the WHILE markup, the evaluation of the
│ │ │ │  conditional is reversed:
│ │ │ │    <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>
│ │ │ │ +<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>
│ │ │ │  <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>
│ │ │ │  &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>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,37 +1,45 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : WHILE ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction                   <[[ref]]unset email_addr>
│ │ │ │ │ - License                    ***** synopsis *****
│ │ │ │ │ - Tutorial                   WHILE is the building block for repeated
│ │ │ │ │ - Usage                      processing. The basic form is shown above.
│ │ │ │ │ - HTP Tags                   "Conditional" is either a "compare" or "is
│ │ │ │ │ -    ALTTEXT                defined" operation. A compare operator is a test
│ │ │ │ │ -    BLOCK                  of the value of a macro against a literal string.
│ │ │ │ │ -    BLOCKDEF               If the NOT tag is present in the WHILE markup, the
│ │ │ │ │ -    DEF                    evaluation of the conditional is reversed:
│ │ │ │ │ -    FILE                   <a href="mailto:$email">mailto hyperlink</a>
│ │ │ │ │ -    IF                     <a href="http://$domain/~${username}/">another
│ │ │ │ │ -    INC                    hyperlink</a>
│ │ │ │ │ -    IMG                    Just as with [[ref]]IF you can also check for a
│ │ │ │ │ -    IMAGEURL               macro's existance:
│ │ │ │ │ -    OPT                      <[[ref]]WHILE sect-$i>
│ │ │ │ │ -    OUTPUT                     ...
│ │ │ │ │ -    QUOTE                      <[[ref]]INC i>
│ │ │ │ │ -    SET                      <[[ref]]/WHILE>
│ │ │ │ │ -    UNDEF                  If the condition is true, the block is evaluated
│ │ │ │ │ -    UNSET                  and afterwards the WHILE tag is evaluated again.
│ │ │ │ │ -    USE,_$                 If the '$'-operator is used in the WHILE tag it is
│ │ │ │ │ - [>] WHILE                  also reevaluated on each iteration.
│ │ │ │ │ -    <!---                  A loop block must be closed with the /WHILE tag.
│ │ │ │ │ - History
│ │ │ │ │ - Wish_list
│ │ │ │ │ - Bugs
│ │ │ │ │ +Table_of          ***** syntax *****
│ │ │ │ │ +Contents              <[[ref]]unset email_addr>
│ │ │ │ │ + Introduction    ***** synopsis *****
│ │ │ │ │ + License         WHILE is the building block for repeated processing. The
│ │ │ │ │ + Tutorial        basic form is shown above.
│ │ │ │ │ + Usage           "Conditional" is either a "compare" or "is defined"
│ │ │ │ │ + HTP Tags        operation. A compare operator is a test of the value of a
│ │ │ │ │ +    ALTTEXT     macro against a literal string. If the NOT tag is present in
│ │ │ │ │ +    BLOCK       the WHILE markup, the evaluation of the conditional is
│ │ │ │ │ +    BLOCKDEF    reversed:
│ │ │ │ │ +    DEF         <[[ref]]block stuff>
│ │ │ │ │ +    FILE          <a href=$email>send email</a>
│ │ │ │ │ +    IF          <[[ref]]/block>
│ │ │ │ │ +    INC
│ │ │ │ │ +    IMG         <[[ref]]set morestuff=$email>
│ │ │ │ │ +    IMAGEURL
│ │ │ │ │ +    OPT         This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ │ +    OUTPUT      But this fails: <[[ref]]use email>
│ │ │ │ │ +    QUOTE       And this fails: <[[ref]]use morestuff
│ │ │ │ │ +    SET         email="jnelson@crl.com">
│ │ │ │ │ +    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.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -46,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.