--- /srv/reproducible-results/rbuild-debian/r-b-build.7YCR5wm9/b1/htp_1.19-8_i386.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.7YCR5wm9/b2/htp_1.19-8_i386.changes
├── Files
│ @@ -1,3 +1,3 @@
│  
│   c47ab9305f75919f6c3b8fa4fa935992 57940 debug optional htp-dbgsym_1.19-8_i386.deb
│ - 970bb276a6400605fac768881a9072c6 123628 web optional htp_1.19-8_i386.deb
│ + 893ae0d47540d6b7ab2a668b429cb0c2 123336 web optional htp_1.19-8_i386.deb
├── htp_1.19-8_i386.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     3616 2020-06-14 23:21:19.000000 control.tar.xz
│ │ --rw-r--r--   0        0        0   119820 2020-06-14 23:21:19.000000 data.tar.xz
│ │ +-rw-r--r--   0        0        0   119528 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: i386
│ │ │ │  Maintainer: Marcelo Soares Mota <motasmarcelo@gmail.com>
│ │ │ │ -Installed-Size: 679
│ │ │ │ +Installed-Size: 648
│ │ │ │  Depends: libc6 (>= 2.4)
│ │ │ │  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)    75284 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)    15021 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9079 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)    14083 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8141 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)    14793 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8840 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1075 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     4763 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/bugs.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      737 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/bugs.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     3273 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/changelog.Debian.gz
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    15454 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8463 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)    13864 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11820 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)    10473 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9797 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)    13704 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    14285 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)    12620 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    10066 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)     8920 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9370 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     2507 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     8781 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9052 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1168 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.htp
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)    12726 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9695 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)    13634 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    13333 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)     8354 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)     8282 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     8227 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      695 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      171 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/arrow.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      262 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/download.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      708 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/htpicon.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)    25563 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/logo.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      455 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/manbig.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      491 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/manual.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1313 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/poweredbyhtp.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      679 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/sficon.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      492 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/source.png
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      523 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pphtp.pl
│ │ │ │ --rw-r--r--   0 root         (0) root         (0)     7953 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11272 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)     9306 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.html
│ │ │ │ +-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)     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)     8578 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)    11772 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)     9231 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)    14199 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)    11625 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html
│ │ │ │ +-rw-r--r--   0 root         (0) root         (0)    11291 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      938 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.htp
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     5288 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/wishlist.html
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)     1311 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/wishlist.htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/doc-base/
│ │ │ │  -rw-r--r--   0 root         (0) root         (0)      235 2020-06-14 17:36:12.000000 ./usr/share/doc-base/htp
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/lintian/
│ │ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2020-06-14 23:21:19.000000 ./usr/share/lintian/overrides/
│ │ │ ├── ./usr/share/doc/htp/alttext.html
│ │ │ │ @@ -114,42 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<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">"tagname"</span> <span class="ebnf">[</span><span class="htp-attrib">option</span>=<span class="htp-string">"option1 <span class="ebnf">[</span>option2 ...<span class="ebnf">]</span>"</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">global</span><span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">expand</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<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="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"filename"</span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -><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>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>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,65 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : ALTTEXT ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]def name="tagname" [option="option1 [option2 ...]" ] [global]
│ │ │ │ │ - Introduction [expand]>
│ │ │ │ │ - License      <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage        >
│ │ │ │ │ - HTP Tags       <[[ref]]block name=b expand>
│ │ │ │ │ - [>] ALTTEXT      b is expanded at time <[[ref]]use time>.
│ │ │ │ │ -    BLOCK      <[[ref]]/block>
│ │ │ │ │ -    BLOCKDEF   <[[ref]]set time="1">
│ │ │ │ │ -    DEF        <[[ref]]use a>
│ │ │ │ │ -    FILE       <[[ref]]use b>
│ │ │ │ │ -    IF         contents of a: <[[ref]]use a noexpand>
│ │ │ │ │ -    INC        contents of b: <[[ref]]use b noexpand>
│ │ │ │ │ -    IMG        <[[ref]]block name=c expand>
│ │ │ │ │ -    IMAGEURL     c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ │ -    OPT        <[[ref]]/block>
│ │ │ │ │ -    OUTPUT     <[[ref]]block name=d expand>
│ │ │ │ │ -    QUOTE        d is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    SET        <[[ref]]/block>
│ │ │ │ │ -    UNDEF      <[[ref]]block name=e>
│ │ │ │ │ -    UNSET        e is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    USE,_$     <[[ref]]/block>
│ │ │ │ │ -    WHILE      <[[ref]]set time="2">
│ │ │ │ │ -    <!---      <[[ref]]block name=a>
│ │ │ │ │ - History          a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ │ - Wish_list      <[[ref]]/block>
│ │ │ │ │ - Bugs           <[[ref]]use c>
│ │ │ │ │ -                 <[[ref]]use d>
│ │ │ │ │ -                 <[[ref]]use e>
│ │ │ │ │ -               ***** synopsis *****
│ │ │ │ │ -               ALTTEXT declares an ALT attribute for any IMG 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.
│ │ │ │ │ -               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.
│ │ │ │ │ -               For example:
│ │ │ │ │ -                   <EM>File "<[[ref]]FILE NAME>" last updated <[[ref]]FILE TIME>, <[
│ │ │ │ │ -               [ref]]FILE DATE></EM>
│ │ │ │ │ -               An ALTTEXT tag with a name but no text attribute removes any ALT
│ │ │ │ │ -               mapping for this image. Successing IMG tags with a matching SRC name
│ │ │ │ │ -               are not changed.
│ │ │ │ │ -               Since this is useful for an image used throughout a set of documents,
│ │ │ │ │ -               ALTTEXT is most appropriate in an include_file or a default_file.
│ │ │ │ │ -               In addition to ALTTEXT, htp can also automatically add WIDTH and HEIGHT
│ │ │ │ │ -               attributes to IMG tags.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Contents       <[[ref]]img src="filename" ...>
│ │ │ │ │ + Introduction
│ │ │ │ │ + License      ***** synopsis *****
│ │ │ │ │ + Tutorial     ALTTEXT declares an ALT attribute for any IMG tag with a SRC matching
│ │ │ │ │ + Usage        the ALTTEXT NAME. Since relative paths can be used to point to the same
│ │ │ │ │ + HTP Tags     image, only the filename is considered in all comparisons.
│ │ │ │ │ + [>] ALTTEXT  When an IMG tag with a matching source is encountered, htp will add an
│ │ │ │ │ +    BLOCK    ALT attribute only if one is not already present. This allows for ALT
│ │ │ │ │ +    BLOCKDEF text to be overridden on specific images and default text on all
│ │ │ │ │ +    DEF      others.
│ │ │ │ │ +    FILE     For example:
│ │ │ │ │ +    IF           <EM>File "<[[ref]]FILE NAME>" last updated <[[ref]]FILE TIME>, <[
│ │ │ │ │ +    INC      [ref]]FILE DATE></EM>
│ │ │ │ │ +    IMG      An ALTTEXT tag with a name but no text attribute removes any ALT
│ │ │ │ │ +    IMAGEURL mapping for this image. Successing IMG tags with a matching SRC name
│ │ │ │ │ +    OPT      are not changed.
│ │ │ │ │ +    OUTPUT   Since this is useful for an image used throughout a set of documents,
│ │ │ │ │ +    QUOTE    ALTTEXT is most appropriate in an include_file or a default_file.
│ │ │ │ │ +    SET      In addition to ALTTEXT, htp can also automatically add WIDTH and HEIGHT
│ │ │ │ │ +    UNDEF    attributes to IMG tags.
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ ├── ./usr/share/doc/htp/block.html
│ │ │ │ @@ -114,42 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<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">"tagname"</span> <span class="ebnf">[</span><span class="htp-attrib">option</span>=<span class="htp-string">"option1 <span class="ebnf">[</span>option2 ...<span class="ebnf">]</span>"</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">global</span><span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">expand</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<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="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"filename"</span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -><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>
│ │ │ │  <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,79 +1,54 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : BLOCK, /BLOCK ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]def name="tagname" [option="option1 [option2 ...]" ] [global]
│ │ │ │ │ - Introduction [expand]>
│ │ │ │ │ - License      <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage        >
│ │ │ │ │ - HTP Tags       <[[ref]]block name=b expand>
│ │ │ │ │ -    ALTTEXT      b is expanded at time <[[ref]]use time>.
│ │ │ │ │ - [>] BLOCK      <[[ref]]/block>
│ │ │ │ │ -    BLOCKDEF   <[[ref]]set time="1">
│ │ │ │ │ -    DEF        <[[ref]]use a>
│ │ │ │ │ -    FILE       <[[ref]]use b>
│ │ │ │ │ -    IF         contents of a: <[[ref]]use a noexpand>
│ │ │ │ │ -    INC        contents of b: <[[ref]]use b noexpand>
│ │ │ │ │ -    IMG        <[[ref]]block name=c expand>
│ │ │ │ │ -    IMAGEURL     c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ │ -    OPT        <[[ref]]/block>
│ │ │ │ │ -    OUTPUT     <[[ref]]block name=d expand>
│ │ │ │ │ -    QUOTE        d is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    SET        <[[ref]]/block>
│ │ │ │ │ -    UNDEF      <[[ref]]block name=e>
│ │ │ │ │ -    UNSET        e is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    USE,_$     <[[ref]]/block>
│ │ │ │ │ -    WHILE      <[[ref]]set time="2">
│ │ │ │ │ -    <!---      <[[ref]]block name=a>
│ │ │ │ │ - History          a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ │ - Wish_list      <[[ref]]/block>
│ │ │ │ │ - Bugs           <[[ref]]use c>
│ │ │ │ │ -                 <[[ref]]use d>
│ │ │ │ │ -                 <[[ref]]use e>
│ │ │ │ │ -               ***** synopsis *****
│ │ │ │ │ -               BLOCK and /BLOCK are used to create block macros, which are similar in
│ │ │ │ │ -               use to SET macros, but can be multi-line definitions.
│ │ │ │ │ -               Any text and formatting may be set inside the block. You can use any
│ │ │ │ │ -               htp or user defined metatag including FILE_INCLUDE. The metatags won't
│ │ │ │ │ -               be expanded before the block is USEd except if you give the EXPAND
│ │ │ │ │ -               parameter.
│ │ │ │ │ -               The block macro is dereferenced (expanded) with the USE_tag_or_the_'$'
│ │ │ │ │ -               operator. See the notes on the USE tag on how to pass parameters to a
│ │ │ │ │ -               block macro.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction               <[[ref]]img src="filename" ...>
│ │ │ │ │ + License
│ │ │ │ │ + Tutorial                   ***** synopsis *****
│ │ │ │ │ + Usage                      BLOCK and /BLOCK are used to create block macros,
│ │ │ │ │ + HTP Tags                   which are similar in use to SET macros, but can be
│ │ │ │ │ +    ALTTEXT                multi-line definitions.
│ │ │ │ │ + [>] BLOCK                  Any text and formatting may be set inside the
│ │ │ │ │ +    BLOCKDEF               block. You can use any htp or user defined metatag
│ │ │ │ │ +    DEF                    including FILE_INCLUDE. The metatags won't be
│ │ │ │ │ +    FILE                   expanded before the block is USEd except if you
│ │ │ │ │ +    IF                     give the EXPAND parameter.
│ │ │ │ │ +    INC                    The block macro is dereferenced (expanded) with
│ │ │ │ │ +    IMG                    the USE_tag_or_the_'$'_operator. See the notes on
│ │ │ │ │ +    IMAGEURL               the USE tag on how to pass parameters to a block
│ │ │ │ │ +    OPT                    macro.
│ │ │ │ │ +    OUTPUT
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---
│ │ │ │ │ + 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/blockdef.html
│ │ │ │ @@ -114,65 +114,27 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<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">"tagname"</span> <span class="ebnf">[</span><span class="htp-attrib">option</span>=<span class="htp-string">"option1 <span class="ebnf">[</span>option2 ...<span class="ebnf">]</span>"</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">global</span><span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">expand</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<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="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"filename"</span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ -><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>
│ │ │ │ -<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; &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>
│ │ │ │  <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,76 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : BLOCKDEF, /BLOCKDEF ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]def name="tagname" [option="option1 [option2 ...]" ] [global]
│ │ │ │ │ - Introduction [expand]>
│ │ │ │ │ - License      <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage        >
│ │ │ │ │ - HTP Tags       <[[ref]]block name=b expand>
│ │ │ │ │ -    ALTTEXT      b is expanded at time <[[ref]]use time>.
│ │ │ │ │ -    BLOCK      <[[ref]]/block>
│ │ │ │ │ - [>] BLOCKDEF   <[[ref]]set time="1">
│ │ │ │ │ -    DEF        <[[ref]]use a>
│ │ │ │ │ -    FILE       <[[ref]]use b>
│ │ │ │ │ -    IF         contents of a: <[[ref]]use a noexpand>
│ │ │ │ │ -    INC        contents of b: <[[ref]]use b noexpand>
│ │ │ │ │ -    IMG        <[[ref]]block name=c expand>
│ │ │ │ │ -    IMAGEURL     c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ │ -    OPT        <[[ref]]/block>
│ │ │ │ │ -    OUTPUT     <[[ref]]block name=d expand>
│ │ │ │ │ -    QUOTE        d is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    SET        <[[ref]]/block>
│ │ │ │ │ -    UNDEF      <[[ref]]block name=e>
│ │ │ │ │ -    UNSET        e is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    USE,_$     <[[ref]]/block>
│ │ │ │ │ -    WHILE      <[[ref]]set time="2">
│ │ │ │ │ -    <!---      <[[ref]]block name=a>
│ │ │ │ │ - History          a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ │ - Wish_list      <[[ref]]/block>
│ │ │ │ │ - Bugs           <[[ref]]use c>
│ │ │ │ │ -                 <[[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:
│ │ │ │ │ -               <[[ref]]IF [NOT] conditional>
│ │ │ │ │ -                   block #1
│ │ │ │ │ -               [
│ │ │ │ │ -               <ELSEIF [NOT] conditional>
│ │ │ │ │ -                   block #2
│ │ │ │ │ -               ...
│ │ │ │ │ -               ]
│ │ │ │ │ -               [
│ │ │ │ │ -               <ELSE>
│ │ │ │ │ -                   block #3
│ │ │ │ │ -               ]
│ │ │ │ │ -               <[[ref]]/IF>
│ │ │ │ │ -
│ │ │ │ │ -               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]]img src="filename" ...>
│ │ │ │ │ + Introduction
│ │ │ │ │ + License      ***** synopsis *****
│ │ │ │ │ + Tutorial     BLOCKDEF creates block metatags, which is a fancy way of saying it
│ │ │ │ │ + Usage        creates new block tags. A block tag is a tag that takes a whole block
│ │ │ │ │ + HTP Tags     as additional parameter. This block is surrounded by <tagname> and </
│ │ │ │ │ +    ALTTEXT  tagname>. The contents of this block are automatically stored in the
│ │ │ │ │ +    BLOCK    block macro named BLOCK.
│ │ │ │ │ + [>] BLOCKDEF For example:
│ │ │ │ │ +    DEF          <EM>File "<[[ref]]FILE NAME>" last updated <[[ref]]FILE TIME>, <[
│ │ │ │ │ +    FILE     [ref]]FILE DATE></EM>
│ │ │ │ │ +    IF       All block metatags have the implicit option EXPAND, which tells htp to
│ │ │ │ │ +    INC      expand the contents of the block before the definition is expanded.
│ │ │ │ │ +    IMG      A more thorough discussion and more elaborate examples are discussed in
│ │ │ │ │ +    IMAGEURL the metatag section.
│ │ │ │ │ +    OPT
│ │ │ │ │ +    OUTPUT
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$
│ │ │ │ │ +    WHILE
│ │ │ │ │ +    <!---
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ ├── ./usr/share/doc/htp/comment.html
│ │ │ │ @@ -114,72 +114,33 @@
│ │ │ │        <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="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"tagname"</span> <span class="ebnf">[</span><span class="htp-attrib">option</span>=<span class="htp-string">"option1 <span class="ebnf">[</span>option2 ...<span class="ebnf">]</span>"</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">global</span><span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">expand</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<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>
│ │ │ │ -><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>
│ │ │ │  <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>
│ │ │ │ -<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; &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>
│ │ │ │  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; 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="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>
│ │ │ │  </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,75 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : <!--- ******
│ │ │ │ │ -Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]def name="tagname" [option="option1 [option2 ...]" ] [global]
│ │ │ │ │ - Introduction [expand]>
│ │ │ │ │ - License      <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage        >
│ │ │ │ │ - HTP Tags       <[[ref]]block name=b expand>
│ │ │ │ │ -    ALTTEXT      b is expanded at time <[[ref]]use time>.
│ │ │ │ │ -    BLOCK      <[[ref]]/block>
│ │ │ │ │ -    BLOCKDEF   <[[ref]]set time="1">
│ │ │ │ │ -    DEF        <[[ref]]use a>
│ │ │ │ │ -    FILE       <[[ref]]use b>
│ │ │ │ │ -    IF         contents of a: <[[ref]]use a noexpand>
│ │ │ │ │ -    INC        contents of b: <[[ref]]use b noexpand>
│ │ │ │ │ -    IMG        <[[ref]]block name=c expand>
│ │ │ │ │ -    IMAGEURL     c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ │ -    OPT        <[[ref]]/block>
│ │ │ │ │ -    OUTPUT     <[[ref]]block name=d expand>
│ │ │ │ │ -    QUOTE        d is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    SET        <[[ref]]/block>
│ │ │ │ │ -    UNDEF      <[[ref]]block name=e>
│ │ │ │ │ -    UNSET        e is expanded at time <[[ref]]use time>; <[[ref]]use a noexpand>
│ │ │ │ │ -    USE,_$     <[[ref]]/block>
│ │ │ │ │ -    WHILE      <[[ref]]set time="2">
│ │ │ │ │ - [>] <!---      <[[ref]]block name=a>
│ │ │ │ │ - History          a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ │ - Wish_list      <[[ref]]/block>
│ │ │ │ │ - Bugs           <[[ref]]use c>
│ │ │ │ │ -                 <[[ref]]use d>
│ │ │ │ │ -                 <[[ref]]use e>
│ │ │ │ │ -               ***** synopsis *****
│ │ │ │ │ -               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:
│ │ │ │ │ -               <[[ref]]IF [NOT] conditional>
│ │ │ │ │ -                   block #1
│ │ │ │ │ -               [
│ │ │ │ │ -               <ELSEIF [NOT] conditional>
│ │ │ │ │ -                   block #2
│ │ │ │ │ -               ...
│ │ │ │ │ -               ]
│ │ │ │ │ -               [
│ │ │ │ │ -               <ELSE>
│ │ │ │ │ -                   block #3
│ │ │ │ │ -               ]
│ │ │ │ │ -               <[[ref]]/IF>
│ │ │ │ │ -
│ │ │ │ │ -               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:
│ │ │ │ │ -                   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>
│ │ │ │ │ -               Make sure that the variable is never defined and xyz should be the reason
│ │ │ │ │ -               why you don't want to include this block
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of_Contents            ***** syntax *****
│ │ │ │ │ + Introduction               ***** synopsis *****
│ │ │ │ │ + License                    This is a simple comment that is not included in
│ │ │ │ │ + Tutorial                   the output. This is useful when commenting
│ │ │ │ │ + Usage                      metatags, since the metatags do not appear the
│ │ │ │ │ + HTP Tags                   output either. Example:
│ │ │ │ │ +    ALTTEXT                    <[[ref]]INC i="1" j="-1">
│ │ │ │ │ +    BLOCK                  Note that these comments should not include < or
│ │ │ │ │ +    BLOCKDEF               >, that is you should not use it to comment out
│ │ │ │ │ +    DEF                    htp code. For that purpose use something like
│ │ │ │ │ +    FILE                   this:
│ │ │ │ │ +    IF                     <[[ref]]UNDEF tagname>
│ │ │ │ │ +    INC                    <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ +    IMG
│ │ │ │ │ +    IMAGEURL               Make sure that the variable is never defined and
│ │ │ │ │ +    OPT                    xyz should be the reason why you don't want to
│ │ │ │ │ +    OUTPUT                 include this block
│ │ │ │ │ +    QUOTE
│ │ │ │ │ +    SET
│ │ │ │ │ +    UNDEF
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$
│ │ │ │ │ +    WHILE
│ │ │ │ │ + [>] <!---
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -77,18 +39,17 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ +HTML coding [Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted according to
│ │ │ │ │ -terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ +according to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/def.html
│ │ │ │ @@ -136,48 +136,32 @@
│ │ │ │  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="imageurl.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">imageurl</a> <span class="htp-attrib">url</span>=<span class="htp-string">"imageurl"</span> <span class="htp-attrib">[</span> <span class="htp-attrib">path</span>=<span class="htp-string">"path/in/local/filesystem"</span> <span class="htp-attrib">]</span>&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">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>
│ │ │ │  </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>
│ │ │ │ -&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>
│ │ │ │ +&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; 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; <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>
│ │ │ │  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
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,75 +1,64 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : DEF, /DEF ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │  Contents       ***** synopsis *****
│ │ │ │ │ - Introduction DEF creates metatags, which is a fancy way of saying it creates new tags. The
│ │ │ │ │ - License      mechanism is very similar to BLOCK macros, except that the USE tag is not
│ │ │ │ │ - Tutorial     used to expand them. Instead, they are expanded by their own name. For
│ │ │ │ │ - Usage        example:
│ │ │ │ │ + Introduction DEF creates metatags, which is a fancy way of saying it creates
│ │ │ │ │ + License      new tags. The mechanism is very similar to BLOCK macros, except
│ │ │ │ │ + Tutorial     that the USE tag is not used to expand them. Instead, they are
│ │ │ │ │ + Usage        expanded by their own name. For example:
│ │ │ │ │   HTP Tags     <[[ref]]if disabled_because_xyz>
│ │ │ │ │      ALTTEXT    ...
│ │ │ │ │      BLOCK    <[[ref]]/if>
│ │ │ │ │ -    BLOCKDEF Some metatags will require an opening and closing tag (comparable to
│ │ │ │ │ - [>] DEF      and
│ │ │ │ │ -    FILE     ). In this case, you should use the BLOCKDEF macro. Another slightly faster
│ │ │ │ │ -    IF       alternative is to use two metatags, the opening tag and the closing tag with
│ │ │ │ │ -    INC      a preceding slash. For example:
│ │ │ │ │ -    IMG      <[[ref]]imageurl url="imageurl" [ path="path/in/local/filesystem" ]>
│ │ │ │ │ -    IMAGEURL
│ │ │ │ │ -    OPT      You should really use BLOCKDEF, though, as it will check for matching end
│ │ │ │ │ -    OUTPUT   tag. It is not that slower.
│ │ │ │ │ -    QUOTE    Options can be passed to a metatag, which can then expand as if it were a SET
│ │ │ │ │ -    SET      macro. Option names are parameterized with the OPTION attribute. Multiple
│ │ │ │ │ -    UNDEF    options can be listed by separating their name with a space (which therefore
│ │ │ │ │ -    UNSET    requires they be surrounded by quotes.)
│ │ │ │ │ -    USE,_$     <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/my.domain/">
│ │ │ │ │ -    WHILE      <[[ref]]imageurl url="other.domain.org/" path="/var/www/other.domain/">
│ │ │ │ │ -    <!---
│ │ │ │ │ - History        For this line: <[[ref]]img src="logo.gif">
│ │ │ │ │ - Wish_list      the local filename "logo.gif" will be used to determine image dimensions
│ │ │ │ │ - Bugs           (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.
│ │ │ │ │ -               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.
│ │ │ │ │ +    BLOCKDEF Some metatags will require an opening and closing tag (comparable
│ │ │ │ │ + [>] DEF      to
│ │ │ │ │ +    FILE     and
│ │ │ │ │ +    IF       ). In this case, you should use the BLOCKDEF macro. Another
│ │ │ │ │ +    INC      slightly faster alternative is to use two metatags, the opening
│ │ │ │ │ +    IMG      tag and the closing tag with a preceding slash. For example:
│ │ │ │ │ +    IMAGEURL <[[ref]]UNDEF tagname>
│ │ │ │ │ +    OPT      <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ +    OUTPUT
│ │ │ │ │ +    QUOTE    You should really use BLOCKDEF, though, as it will check for
│ │ │ │ │ +    SET      matching end tag. It is not that slower.
│ │ │ │ │ +    UNDEF    Options can be passed to a metatag, which can then expand as if
│ │ │ │ │ +    UNSET    it were a SET macro. Option names are parameterized with the
│ │ │ │ │ +    USE,_$   OPTION attribute. Multiple options can be listed by separating
│ │ │ │ │ +    WHILE    their name with a space (which therefore requires they be
│ │ │ │ │ +    <!---    surrounded by quotes.)
│ │ │ │ │ + History        <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ + Wish_list        <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ + Bugs           <[[ref]]/def>
│ │ │ │ │ +
│ │ │ │ │ +                 <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ +               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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -95,10 +84,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/expand.html
│ │ │ │ @@ -98,34 +98,32 @@
│ │ │ │  <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; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">blockdef</a> <span class="htp-attrib">name</span>=<span class="htp-string">"section"</span> <span class="htp-attrib">option</span>=<span class="htp-string">"title"</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; &nbsp;<span class="htp-tag">&lt;h1&gt;</span><span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">title</span>&gt;</span><span class="htp-tag">&lt;/h1&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; &nbsp;<span class="htp-tag">&lt;p <span class="htp-attrib">class</span>=<span class="htp-string">"section"</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font>&nbsp; &nbsp; &nbsp;<span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">block</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;5. </font>&nbsp; &nbsp;<span class="htp-tag">&lt;/p&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;6. </font>&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;7. </font><br>
│ │ │ │ -<font size="-2">&nbsp;8. </font>&nbsp; <span class="htp-tag">&lt;section <span class="htp-attrib">title</span>=<span class="htp-string">"My Section"</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;9. </font>&nbsp; &nbsp; This is a fancy section.<br>
│ │ │ │ -<font size="-2">10. </font>&nbsp; <span class="htp-tag">&lt;/section&gt;</span><br>
│ │ │ │ -<font size="-2">11. </font>ill also have an ALT attribute appended to it<br>
│ │ │ │ -<font size="-2">12. </font><br>
│ │ │ │ -<font size="-2">13. </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">14. </font>&nbsp; remains unchanged.<br>
│ │ │ │ +<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>
│ │ │ │  </code></p>
│ │ │ │  This produces the following:
│ │ │ │    <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">"bigfont"</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;font <span class="htp-attrib">size</span>=<span class="htp-string">"+4"</span>&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"/bigfont"</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;/font&gt;</span><br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │ +&nbsp; <span class="htp-tag">&lt;bigfont&gt;</span>Some large text<span class="htp-tag">&lt;/bigfont&gt;</span><br>
│ │ │ │  </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,83 +1,89 @@
│ │ │ │ │  
│ │ │ │ │  [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
│ │ │ │ │ - Introduction   scope. A scope is for example the definition of a metatag. Once the
│ │ │ │ │ - License        definition is expanded and the metatag has finished the macro is
│ │ │ │ │ - Tutorial       automatically removed. In some cases you want to define a macro
│ │ │ │ │ - Usage          inside a metatag and use it later. You can do this with the global
│ │ │ │ │ -    Command-   attribute that you can add to [[ref]]set, [[ref]]inc, [[ref]]block,
│ │ │ │ │ -      line       [[ref]]def, and [[ref]]blockdef tags.
│ │ │ │ │ -    Options    ***** The expand attribute *****
│ │ │ │ │ -    Predefined The expand attribute is not a tag of its own but is an attribute of
│ │ │ │ │ -      macros     all block tags even metatags defined with the blockdef macro.
│ │ │ │ │ - [>] global_and Normally htp uses a lazy evaluation strategy, i.e. it expands htp
│ │ │ │ │ -      expand     tags, metatags and macros when the HTML document is written not when
│ │ │ │ │ - HTP_Tags       they're stored into block macros. When you use a macro defined with
│ │ │ │ │ - History        the blockdef tag the html code between the tags is just copied
│ │ │ │ │ - Wish_list      literally into the macro named block, without any expansion going
│ │ │ │ │ - Bugs           on.
│ │ │ │ │ -                 However, if the block tag is marked with the expand modifier it is
│ │ │ │ │ -                 expanded immediately. This is useful if you want to store something
│ │ │ │ │ -                 in a block macro, that depends on the current value of another
│ │ │ │ │ -                 macro. This other macro may no longer have the correct value when
│ │ │ │ │ -                 the macro is expanded. Here is some code that demonstrate when the
│ │ │ │ │ -                 htp tags are expanded:
│ │ │ │ │ -                  1.  <[[ref]]blockdef name="section" option="title">
│ │ │ │ │ -                  2.   <h1><[[ref]]use title></h1>
│ │ │ │ │ -                  3.   <p class="section">
│ │ │ │ │ -                  4.     <[[ref]]use block>
│ │ │ │ │ -                  5.   </p>
│ │ │ │ │ -                  6.  <[[ref]]/blockdef>
│ │ │ │ │ -                  7.
│ │ │ │ │ -                  8.  <section title="My Section">
│ │ │ │ │ -                  9.    This is a fancy section.
│ │ │ │ │ -                 10.  </section>
│ │ │ │ │ -                 11.ill also have an ALT attribute appended to it
│ │ │ │ │ -                 12.
│ │ │ │ │ -                 13.  this line: <[[ref]]img src="logo.gif" alt="Click here for more
│ │ │ │ │ -                 information!">
│ │ │ │ │ -                 14.  remains unchanged.
│ │ │ │ │ -                 This produces the following:
│ │ │ │ │ -                 <[[ref]]if disabled_because_xyz>
│ │ │ │ │ -                   ...
│ │ │ │ │ -                 <[[ref]]/if>
│ │ │ │ │ -                 When block a and block b are defined in lines 2-7 the contents of a
│ │ │ │ │ -                 are taken literally, however, the contents for b are already
│ │ │ │ │ -                 expanded so the macro time is evaluated. So a is expanded when it is
│ │ │ │ │ -                 used, while the contents of b are already expanded.
│ │ │ │ │ -                 In line 10 and 12 the [[ref]]use tag is used with the noexpand
│ │ │ │ │ -                 attribute which prevents the expansion of the macro value. Here it
│ │ │ │ │ -                 is used to show you what the value of the block macros really is.
│ │ │ │ │ -                 A more important reason to use the noexpand attribute is to prevent
│ │ │ │ │ -                 double expansion and to restore the original lazy expansion policy
│ │ │ │ │ -                 when you have to use the expand attribute as for block d in the
│ │ │ │ │ -                 example above. See the section example in the [[ref]]metatag
│ │ │ │ │ -                 tutorial. Rule of thumb: The use tags in an expanded block should be
│ │ │ │ │ -                 tagged with noexpand.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of_Contents            ***** The global attribute *****
│ │ │ │ │ + Introduction               Normally when you define a macro it is only
│ │ │ │ │ + License                    defined in the current scope. A scope is for
│ │ │ │ │ + Tutorial                   example the definition of a metatag. Once the
│ │ │ │ │ + Usage                      definition is expanded and the metatag has
│ │ │ │ │ +    Command-line           finished the macro is automatically removed. In
│ │ │ │ │ +    Options                some cases you want to define a macro inside a
│ │ │ │ │ +    Predefined_macros      metatag and use it later. You can do this with the
│ │ │ │ │ + [>] global_and_expand      global attribute that you can add to [[ref]]set, [
│ │ │ │ │ + HTP_Tags                   [ref]]inc, [[ref]]block, [[ref]]def, and [
│ │ │ │ │ + History                    [ref]]blockdef tags.
│ │ │ │ │ + Wish_list                  ***** The expand attribute *****
│ │ │ │ │ + Bugs                       The expand attribute is not a tag of its own but
│ │ │ │ │ +                             is an attribute of all block tags even metatags
│ │ │ │ │ +                             defined with the blockdef macro. Normally htp uses
│ │ │ │ │ +                             a lazy evaluation strategy, i.e. it expands htp
│ │ │ │ │ +                             tags, metatags and macros when the HTML document
│ │ │ │ │ +                             is written not when they're stored into block
│ │ │ │ │ +                             macros. When you use a macro defined with the
│ │ │ │ │ +                             blockdef tag the html code between the tags is
│ │ │ │ │ +                             just copied literally into the macro named block,
│ │ │ │ │ +                             without any expansion going on.
│ │ │ │ │ +                             However, if the block tag is marked with the
│ │ │ │ │ +                             expand modifier it is expanded immediately. This
│ │ │ │ │ +                             is useful if you want to store something in a
│ │ │ │ │ +                             block macro, that depends on the current value of
│ │ │ │ │ +                             another macro. This other macro may no longer have
│ │ │ │ │ +                             the correct value when the macro is expanded. Here
│ │ │ │ │ +                             is some code that demonstrate when the htp tags
│ │ │ │ │ +                             are expanded:
│ │ │ │ │ +                              1.    <[[ref]]def name="centered">
│ │ │ │ │ +                              2.    <p align=center>
│ │ │ │ │ +                              3.    <[[ref]]/def>
│ │ │ │ │ +                              4.
│ │ │ │ │ +                              5.    <centered>
│ │ │ │ │ +                              6.    This text is centered.
│ │ │ │ │ +                             This produces the following:
│ │ │ │ │ +                               <[[ref]]def name="bigfont">
│ │ │ │ │ +                                 <font size="+4">
│ │ │ │ │ +                               <[[ref]]/def>
│ │ │ │ │ +
│ │ │ │ │ +                               <[[ref]]def name="/bigfont">
│ │ │ │ │ +                                 </font>
│ │ │ │ │ +                               <[[ref]]/def>
│ │ │ │ │ +
│ │ │ │ │ +                               <bigfont>Some large text</bigfont>
│ │ │ │ │ +                             When block a and block b are defined in lines 2-
│ │ │ │ │ +                             7 the contents of a are taken literally, however,
│ │ │ │ │ +                             the contents for b are already expanded so the
│ │ │ │ │ +                             macro time is evaluated. So a is expanded when it
│ │ │ │ │ +                             is used, while the contents of b are already
│ │ │ │ │ +                             expanded.
│ │ │ │ │ +                             In line 10 and 12 the [[ref]]use tag is used with
│ │ │ │ │ +                             the noexpand attribute which prevents the
│ │ │ │ │ +                             expansion of the macro value. Here it is used to
│ │ │ │ │ +                             show you what the value of the block macros really
│ │ │ │ │ +                             is.
│ │ │ │ │ +                             A more important reason to use the noexpand
│ │ │ │ │ +                             attribute is to prevent double expansion and to
│ │ │ │ │ +                             restore the original lazy expansion policy when
│ │ │ │ │ +                             you have to use the expand attribute as for block
│ │ │ │ │ +                             d in the example above. See the section example in
│ │ │ │ │ +                             the [[ref]]metatag_tutorial. Rule of thumb: The
│ │ │ │ │ +                             use tags in an expanded block should be tagged
│ │ │ │ │ +                             with noexpand.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding
│ │ │ │ │ -[Powered_by
│ │ │ │ │ +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/file.html
│ │ │ │ @@ -114,46 +114,47 @@
│ │ │ │        <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>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"centered"</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;p <span class="htp-attrib">align</span>=<span class="htp-value">center</span>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;centered&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; This text is centered.<br>
│ │ │ │ +se time>.<br>
│ │ │ │ +&nbsp; contents of b: &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; &nbsp; c is expanded at time 1; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; d is expanded at time 1; &nbsp; a is expanded at time 2.<br>
│ │ │ │ +&nbsp; &nbsp; e is expanded at time 2; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">time</span>&gt;</span>.<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>FILE</STRONG> has several optional parameters of differing purpose.
│ │ │ │  The output file's name, the current date and time, and the contents of
│ │ │ │  another file may be included.  Another file's time, date, or size may be
│ │ │ │  added to the output file as well.
│ │ │ │  <P>
│ │ │ │  As with all HTML, these tags do not have to be on their own line, so the
│ │ │ │  following is perfectly acceptable:
│ │ │ │    <p><code>
│ │ │ │ +<span class="htp-tag">&lt;<a href="quote.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">QUOTE</a> <span class="htp-attrib">TAG</span> <span class="htp-attrib">[ATTRIBUTE</span>=<span class="htp-value">VALUE</span> <span class="htp-attrib">...]</span>&gt;</span><br>
│ │ │ │ +<br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  <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>
│ │ │ │ -<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="htp-attrib">[macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="htp-attrib">]</span> <span class="htp-attrib">[GLOBAL]</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </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
│ │ │ │ @@ -183,15 +184,15 @@
│ │ │ │  <P>
│ │ │ │  Additional parameters can be set in the FILE INCLUDE tag, which are
│ │ │ │  interpreted as macros that are "passed" to the included file.  The macros
│ │ │ │  are available only to the include file (and any macros or included files it
│ │ │ │  holds).  After the file is completely included, the macros are no longer
│ │ │ │  available.  So:
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &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>
│ │ │ │ +&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>
│ │ │ │  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,138 +1,107 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : FILE ******
│ │ │ │ │ -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                    FILE has several optional parameters of differing
│ │ │ │ │ -    OUTPUT                 purpose. The output file's name, the current date
│ │ │ │ │ -    QUOTE                  and time, and the contents of another file may be
│ │ │ │ │ -    SET                    included. Another file's time, date, or size may
│ │ │ │ │ -    UNDEF                  be added to the output file as well.
│ │ │ │ │ -    UNSET                  As with all HTML, these tags do not have to be on
│ │ │ │ │ -    USE,_$                 their own line, so the following is perfectly
│ │ │ │ │ -    WHILE                  acceptable:
│ │ │ │ │ -    <!---                  **** NAME, TIME, SIZE ****
│ │ │ │ │ - History                    To include information about another file, such as
│ │ │ │ │ - Wish_list                  an archive file or graphic image, specify its name
│ │ │ │ │ - Bugs                       with the NAME attribute followed by the type of
│ │ │ │ │ -                             information to be displayed:
│ │ │ │ │ -                             <[[ref]]INC macroname1="increment1"
│ │ │ │ │ -                             [macroname2="increment2" ... ] [GLOBAL]>
│ │ │ │ │ -
│ │ │ │ │ -                             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]]INC i="1" j="-1">
│ │ │ │ │ -                             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]]def name="centered">
│ │ │ │ │ + Introduction     <p align=center>
│ │ │ │ │ + License          <[[ref]]/def>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage            <centered>
│ │ │ │ │ + HTP Tags         This text is centered.
│ │ │ │ │ +    ALTTEXT  se time>.
│ │ │ │ │ +    BLOCK      contents of b:   b is expanded at time 0.
│ │ │ │ │ +    BLOCKDEF     c is expanded at time 1;   a is expanded at time 1.
│ │ │ │ │ +    DEF          d is expanded at time 1;   a is expanded at time 2.
│ │ │ │ │ + [>] FILE         e is expanded at time 2;   a is defined for the 2nd time <[[ref]]use
│ │ │ │ │ +    IF       time>.
│ │ │ │ │ +    INC      ***** synopsis *****
│ │ │ │ │ +    IMG      FILE has several optional parameters of differing purpose. The output
│ │ │ │ │ +    IMAGEURL file's name, the current date and time, and the contents of another file
│ │ │ │ │ +    OPT      may be included. Another file's time, date, or size may be added to the
│ │ │ │ │ +    OUTPUT   output file as well.
│ │ │ │ │ +    QUOTE    As with all HTML, these tags do not have to be on their own line, so the
│ │ │ │ │ +    SET      following is perfectly acceptable:
│ │ │ │ │ +    UNDEF    <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ +    UNSET
│ │ │ │ │ +    USE,_$   **** NAME, TIME, SIZE ****
│ │ │ │ │ +    WHILE    To include information about another file, such as an archive file or
│ │ │ │ │ +    <!---    graphic image, specify its name with the NAME attribute followed by the
│ │ │ │ │ + History      type of information to be displayed:
│ │ │ │ │ + Wish_list    <[[ref]]unset macroname>
│ │ │ │ │ + Bugs         <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │ +
│ │ │ │ │ +               For file size information, the value BYTE, KBYTE, etc. dictates how the
│ │ │ │ │ +               information is displayed. In anything other than byte format, the
│ │ │ │ │ +               information is displayed in floating-point notation. The amount of
│ │ │ │ │ +               precision (the number of digits to the right of the decimal point) can be
│ │ │ │ │ +               set with the optional PRECISION attribute. The default precision is zero
│ │ │ │ │ +               (0), which means no fractional portion is displayed.
│ │ │ │ │ +               At the request of many people, the TIME and DATE attributes will now accept
│ │ │ │ │ +               formatting characters that are passed directly into the ANSI C library
│ │ │ │ │ +               function. This allows for the time and date to be displayed in virtually
│ │ │ │ │ +               any format. Users not wishing to mess around with this should stick to the
│ │ │ │ │ +               default format, which is used if no formatting value is specified (i.e.,
│ │ │ │ │ +               just using 05:04:11 PM).
│ │ │ │ │ +               Consult any C programmer's guide discussing the standard C library function
│ │ │ │ │ +               strftime() for information on how to build a format string. If unsure, ask
│ │ │ │ │ +               an experienced C programmer for help, or consider just sticking to the
│ │ │ │ │ +               default formatting.
│ │ │ │ │ +               **** INCLUDE ****
│ │ │ │ │ +               INCLUDE files are pre-processed as any other file. The resulting text is
│ │ │ │ │ +               incorporated into the HTML output as if the file had been copied into the
│ │ │ │ │ +               source at the same location as the FILE markup tag.
│ │ │ │ │ +               htp will automatically convert slashes and backslashes to match the
│ │ │ │ │ +               operating system's directory separator.
│ │ │ │ │ +               Additional parameters can be set in the FILE INCLUDE tag, which are
│ │ │ │ │ +               interpreted as macros that are "passed" to the included file. The macros
│ │ │ │ │ +               are available only to the include file (and any macros or included files it
│ │ │ │ │ +               holds). After the file is completely included, the macros are no longer
│ │ │ │ │ +               available. So:
│ │ │ │ │ +                   <[[ref]]unset email_addr>
│ │ │ │ │ +               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.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -150,17 +119,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,60 +114,35 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"bigfont"</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;font <span class="htp-attrib">size</span>=<span class="htp-string">"+4"</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"/bigfont"</span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;/font&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;bigfont&gt;</span>Some large text<span class="htp-tag">&lt;/bigfont&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;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>
│ │ │ │  <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>
│ │ │ │ -<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="htp-attrib">[macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="htp-attrib">]</span> <span class="htp-attrib">[GLOBAL]</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">SET</a> <span class="htp-attrib">macroname1</span>=<span class="htp-string">"macrovalue1"</span> <span class="htp-attrib">[macroname2</span>=<span class="htp-string">"macrovalue2"</span> <span class="htp-attrib">...]</span> <span class="htp-attrib">[GLOBAL]</span>&gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  and a defined operator is a test of a macro's existance:
│ │ │ │  <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>
│ │ │ │ +&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;<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; <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,61 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IF, ELSEIF, ELSE, /IF ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents         <[[ref]]def name="bigfont">
│ │ │ │ │ - Introduction     <font size="+4">
│ │ │ │ │ - License        <[[ref]]/def>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage          <[[ref]]def name="/bigfont">
│ │ │ │ │ - HTP Tags         </font>
│ │ │ │ │ -    ALTTEXT    <[[ref]]/def>
│ │ │ │ │ -    BLOCK
│ │ │ │ │ -    BLOCKDEF   <bigfont>Some large text</bigfont>
│ │ │ │ │ -    DEF      ***** synopsis *****
│ │ │ │ │ -    FILE     IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for conditional
│ │ │ │ │ - [>] IF       processing. The basic form is shown above.
│ │ │ │ │ -    INC      "Conditional" is either a "compare" or "is defined" operation. A compare
│ │ │ │ │ -    IMG      operator is a test of the value of a macro against a literal string:
│ │ │ │ │ -    IMAGEURL <[[ref]]INC macroname1="increment1" [macroname2="increment2" ... ] [GLOBAL]>
│ │ │ │ │ +Contents           <EM>File "<[[ref]]FILE NAME>" last updated <[[ref]]FILE TIME>, <[
│ │ │ │ │ + Introduction [ref]]FILE DATE></EM>
│ │ │ │ │ + License      ***** synopsis *****
│ │ │ │ │ + Tutorial     IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for conditional
│ │ │ │ │ + Usage        processing. The basic form is shown above.
│ │ │ │ │ + HTP Tags     "Conditional" is either a "compare" or "is defined" operation. A
│ │ │ │ │ +    ALTTEXT  compare operator is a test of the value of a macro against a literal
│ │ │ │ │ +    BLOCK    string:
│ │ │ │ │ +    BLOCKDEF <[[ref]]SET macroname1="macrovalue1" [macroname2="macrovalue2" ...]
│ │ │ │ │ +    DEF      [GLOBAL]>
│ │ │ │ │ +    FILE
│ │ │ │ │ + [>] IF       and a defined operator is a test of a macro's existance:
│ │ │ │ │ +    INC        <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ │ +    IMG          <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ +    IMAGEURL   <[[ref]]/def>
│ │ │ │ │      OPT
│ │ │ │ │ -    OUTPUT   and a defined operator is a test of a macro's existance:
│ │ │ │ │ -    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).
│ │ │ │ │ +    OUTPUT     <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ +    QUOTE    If the NOT tag is present in the IF markup, the evaluation of the
│ │ │ │ │ +    SET      conditional is reversed. The first IF or ELSEIF condition that
│ │ │ │ │ +    UNDEF    evaluates to true is chosen. If none of the conditions is true the ELSE
│ │ │ │ │ +    UNSET    block is taken if it is present. A conditional block must be closed
│ │ │ │ │ +    USE,_$   with the /IF tag. IF tags can be nested.
│ │ │ │ │ +    WHILE
│ │ │ │ │      <!---
│ │ │ │ │ - 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.
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │   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.
│ │ │ │ │ -               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.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -76,10 +53,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,14 +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; &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>
│ │ │ │  <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
│ │ │ │ @@ -135,15 +136,17 @@
│ │ │ │  checks (case-insensitive) if it is a prefix of the image's SRC
│ │ │ │  attribute. If it matches this prefix is replaced by the given PATH.
│ │ │ │  If no IMAGEURL matches the SRC is considered as relative link and
│ │ │ │  looked up in the current directory.</P>
│ │ │ │  <P>
│ │ │ │  For example:</P>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">i</span>=<span class="htp-string">"1"</span> <span class="htp-attrib">j</span>=<span class="htp-string">"-1"</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="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>
│ │ │ │  </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,37 +1,40 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IMAGEURL ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               ***** synopsis *****
│ │ │ │ │ - License                    IMAGEURL tells htp, where to find images on the
│ │ │ │ │ - Tutorial                   local file system. declares an URL replacement
│ │ │ │ │ - Usage                      that is used for size lookups in any IMG tag. This
│ │ │ │ │ - HTP Tags                   definitions takes effect only if the IMGXY option
│ │ │ │ │ -    ALTTEXT                is enabled. Beacause htp can't lookup files in the
│ │ │ │ │ -    BLOCK                  world wide web you have to map absolute image URLs
│ │ │ │ │ -    BLOCKDEF               to a directory in the local file system.
│ │ │ │ │ -    DEF                    When an IMG tag is encountered where htp has to
│ │ │ │ │ -    FILE                   insert width and height the defined URL
│ │ │ │ │ -    IF                     replacements will be taken into account (later
│ │ │ │ │ -    INC                    definitions take precedence to earlier): For each
│ │ │ │ │ -    IMG                    defined imageurl it checks (case-insensitive) if
│ │ │ │ │ - [>] IMAGEURL               it is a prefix of the image's SRC attribute. If it
│ │ │ │ │ -    OPT                    matches this prefix is replaced by the given PATH.
│ │ │ │ │ -    OUTPUT                 If no IMAGEURL matches the SRC is considered as
│ │ │ │ │ -    QUOTE                  relative link and looked up in the current
│ │ │ │ │ -    SET                    directory.
│ │ │ │ │ -    UNDEF                  For example:
│ │ │ │ │ -    UNSET                      <[[ref]]INC i="1" j="-1">
│ │ │ │ │ -    USE,_$                 If IMAGEURL is specified with a URL but no PATH
│ │ │ │ │ -    WHILE                  attribute, it is treated as an undefine, and is
│ │ │ │ │ -    <!---                  removed.
│ │ │ │ │ - History                    Since you usually need the url mapping for a
│ │ │ │ │ - Wish_list                  number of images used throughout a set of
│ │ │ │ │ - Bugs                       documents, IMAGEURL is most appropriately put into
│ │ │ │ │ + Introduction                   <[[ref]]INC i="1" j="-1">
│ │ │ │ │ + License                    ***** synopsis *****
│ │ │ │ │ + Tutorial                   IMAGEURL tells htp, where to find images on the
│ │ │ │ │ + Usage                      local file system. declares an URL replacement
│ │ │ │ │ + HTP Tags                   that is used for size lookups in any IMG tag. This
│ │ │ │ │ +    ALTTEXT                definitions takes effect only if the IMGXY option
│ │ │ │ │ +    BLOCK                  is enabled. Beacause htp can't lookup files in the
│ │ │ │ │ +    BLOCKDEF               world wide web you have to map absolute image URLs
│ │ │ │ │ +    DEF                    to a directory in the local file system.
│ │ │ │ │ +    FILE                   When an IMG tag is encountered where htp has to
│ │ │ │ │ +    IF                     insert width and height the defined URL
│ │ │ │ │ +    INC                    replacements will be taken into account (later
│ │ │ │ │ +    IMG                    definitions take precedence to earlier): For each
│ │ │ │ │ + [>] IMAGEURL               defined imageurl it checks (case-insensitive) if
│ │ │ │ │ +    OPT                    it is a prefix of the image's SRC attribute. If it
│ │ │ │ │ +    OUTPUT                 matches this prefix is replaced by the given PATH.
│ │ │ │ │ +    QUOTE                  If no IMAGEURL matches the SRC is considered as
│ │ │ │ │ +    SET                    relative link and looked up in the current
│ │ │ │ │ +    UNDEF                  directory.
│ │ │ │ │ +    UNSET                  For example:
│ │ │ │ │ +    USE,_$                 <[[ref]]UNDEF tagname>
│ │ │ │ │ +    WHILE                  <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ +    <!---
│ │ │ │ │ + History                    If IMAGEURL is specified with a URL but no PATH
│ │ │ │ │ + Wish_list                  attribute, it is treated as an undefine, and is
│ │ │ │ │ + Bugs                       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.
│ │ │ ├── ./usr/share/doc/htp/img.html
│ │ │ │ @@ -114,16 +114,21 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">macroname1</span>=<span class="htp-string">"increment1"</span> <span class="ebnf">[</span><span class="htp-attrib">macroname2</span>=<span class="htp-string">"increment2"</span> <span class="htp-attrib">...</span> <span class="ebnf">]</span> <span class="ebnf">[</span><span class="htp-attrib">GLOBAL</span><span class="ebnf">]</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ +&nbsp; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; contents of a: &nbsp; a is expanded at time <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">time</span>&gt;</span>.<br>
│ │ │ │ +&nbsp; contents of b: &nbsp; b is expanded at time 0.<br>
│ │ │ │ +&nbsp; &nbsp; c is expanded at time 1; &nbsp; a is expanded at time 1.<br>
│ │ │ │ +&nbsp; &nbsp; d is expanded at time 1; &nbsp; a is expanded at time 2.<br>
│ │ │ │ +&nbsp; &nbsp; e is expanded at time 2; &nbsp; a is defined for the 2nd time <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">time</span>&gt;</span>.<br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P> <STRONG>img</STRONG> is a standard HTML tag.  htp can add the specified
│ │ │ │  image's width and height to the tag automatically.  This has the advantage
│ │ │ │  of not having to determine each image's size manually, which is especially
│ │ │ │  useful if the image may change frequently. </P>
│ │ │ │  <P> htp adds this information with the WIDTH and HEIGHT markup
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,41 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : IMG ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]INC macroname1="increment1"
│ │ │ │ │ - License                    [macroname2="increment2" ... ] [GLOBAL]>
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage                      ***** synopsis *****
│ │ │ │ │ - HTP Tags                   img is a standard HTML tag. htp can add the
│ │ │ │ │ -    ALTTEXT                specified image's width and height to the tag
│ │ │ │ │ -    BLOCK                  automatically. This has the advantage of not
│ │ │ │ │ -    BLOCKDEF               having to determine each image's size manually,
│ │ │ │ │ -    DEF                    which is especially useful if the image may change
│ │ │ │ │ -    FILE                   frequently.
│ │ │ │ │ -    IF                     htp adds this information with the WIDTH and
│ │ │ │ │ -    INC                    HEIGHT markup attributes. If htp detects these
│ │ │ │ │ - [>] IMG                    attributes are already present in the tag, it will
│ │ │ │ │ -    IMAGEURL               not modify the values. If htp cannot find the
│ │ │ │ │ -    OPT                    image file, it will issue a warning but not halt
│ │ │ │ │ -    OUTPUT                 processing.
│ │ │ │ │ -    QUOTE                  At this time, GIF (Graphic Interchange Format),
│ │ │ │ │ -    SET                    PNG (Portable Network Graphics), and JFIF (JPEG
│ │ │ │ │ -    UNDEF                  File Interchange Format) are supported.
│ │ │ │ │ -    UNSET                  The IMGXY_and_NOIMGXY options control whether or
│ │ │ │ │ -    USE,_$                 not htp actually adds this information as it
│ │ │ │ │ -    WHILE                  executes.
│ │ │ │ │ -    <!---                  Since htp is able to lookup files only in the
│ │ │ │ │ - History                    local filesystem, the IMAGEURL tag may be used to
│ │ │ │ │ - Wish_list                  map URLs to local files.
│ │ │ │ │ - Bugs                       htp can also add default ALT text to IMG tags
│ │ │ │ │ -                             using ALTTEXT.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents           a is expanded at time 1.
│ │ │ │ │ + Introduction     b is expanded at time 0.
│ │ │ │ │ + License        contents of a:   a is expanded at time <[[ref]]use time>.
│ │ │ │ │ + Tutorial       contents of b:   b is expanded at time 0.
│ │ │ │ │ + Usage            c is expanded at time 1;   a is expanded at time 1.
│ │ │ │ │ + HTP Tags         d is expanded at time 1;   a is expanded at time 2.
│ │ │ │ │ +    ALTTEXT      e is expanded at time 2;   a is defined for the 2nd time <[[ref]]use
│ │ │ │ │ +    BLOCK    time>.
│ │ │ │ │ +    BLOCKDEF ***** synopsis *****
│ │ │ │ │ +    DEF      img is a standard HTML tag. htp can add the specified image's width and
│ │ │ │ │ +    FILE     height to the tag automatically. This has the advantage of not having to
│ │ │ │ │ +    IF       determine each image's size manually, which is especially useful if the
│ │ │ │ │ +    INC      image may change frequently.
│ │ │ │ │ + [>] IMG      htp adds this information with the WIDTH and HEIGHT markup attributes. If
│ │ │ │ │ +    IMAGEURL htp detects these attributes are already present in the tag, it will not
│ │ │ │ │ +    OPT      modify the values. If htp cannot find the image file, it will issue a
│ │ │ │ │ +    OUTPUT   warning but not halt processing.
│ │ │ │ │ +    QUOTE    At this time, GIF (Graphic Interchange Format), PNG (Portable Network
│ │ │ │ │ +    SET      Graphics), and JFIF (JPEG File Interchange Format) are supported.
│ │ │ │ │ +    UNDEF    The IMGXY_and_NOIMGXY options control whether or not htp actually adds this
│ │ │ │ │ +    UNSET    information as it executes.
│ │ │ │ │ +    USE,_$   Since htp is able to lookup files only in the local filesystem, the
│ │ │ │ │ +    WHILE    IMAGEURL tag may be used to map URLs to local files.
│ │ │ │ │ +    <!---    htp can also add default ALT text to IMG tags using ALTTEXT.
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -50,17 +47,18 @@
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according to terms
│ │ │ │ │ +described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/inc.html
│ │ │ │ @@ -114,58 +114,36 @@
│ │ │ │        <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>
│ │ │ │ +&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>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  The <STRONG>INC</STRONG> can be used for incrementing/decrementing a
│ │ │ │  variable or for variable addition.  The basic form is shown above.
│ │ │ │  <P>
│ │ │ │  The "increment" is anything that evaluates to a integer.  It can be a
│ │ │ │  literal string or a macro preceeded by the '$'-operator.  The
│ │ │ │  macroname must be the name of a defined macro that contains an
│ │ │ │  integer.  If the increment is ommitted it defaults to 1.
│ │ │ │  The effect of this operation is that the macro is redefined
│ │ │ │  to contain the sum of its previous value and its increment.
│ │ │ │  <P>
│ │ │ │  To increment or decrement a variable you can use this form:
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(IMGXY|NOIMGXY)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(QUIET|VERBOSE)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(DEPEND|NODEPEND)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(PRECIOUS|NOPRECIOUS)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(CONDENSE|SEMICONDENSE|NOCONDENSE)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">DELIM</span>=<span class="htp-value">(HTML|SQUARE|CURLY)</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(XML|XML</span>=<span class="htp-value">FALSE)</span>&gt;</span><br>
│ │ │ │ +&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,58 +1,38 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : INC ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -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/">
│ │ │ │ │ +Contents           <EM>File "<[[ref]]FILE NAME>" last updated <[[ref]]FILE TIME>, <[
│ │ │ │ │ + Introduction [ref]]FILE DATE></EM>
│ │ │ │ │ + License      ***** synopsis *****
│ │ │ │ │ + Tutorial     The INC can be used for incrementing/decrementing a variable or for
│ │ │ │ │ + Usage        variable addition. The basic form is shown above.
│ │ │ │ │ + HTP Tags     The "increment" is anything that evaluates to a integer. It can be a
│ │ │ │ │ +    ALTTEXT  literal string or a macro preceeded by the '$'-operator. The macroname
│ │ │ │ │ +    BLOCK    must be the name of a defined macro that contains an integer. If the
│ │ │ │ │ +    BLOCKDEF increment is ommitted it defaults to 1. The effect of this operation is
│ │ │ │ │ +    DEF      that the macro is redefined to contain the sum of its previous value
│ │ │ │ │ +    FILE     and its increment.
│ │ │ │ │ +    IF       To increment or decrement a variable you can use this form:
│ │ │ │ │ + [>] INC        <[[ref]]blockdef name="bolditalic">
│ │ │ │ │ +    IMG          <b><i>
│ │ │ │ │ +    IMAGEURL     <[[ref]]use block>
│ │ │ │ │ +    OPT          </i></b>
│ │ │ │ │ +    OUTPUT     <[[ref]]/blockdef>
│ │ │ │ │      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      The INC can be used for incrementing/decrementing a variable or for variable
│ │ │ │ │ - Wish_list    addition. The basic form is shown above.
│ │ │ │ │ - Bugs         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.
│ │ │ │ │ -               To increment or decrement a variable you can use this form:
│ │ │ │ │ -               <[[ref]]OPT (IMGXY|NOIMGXY)>
│ │ │ │ │ -               <[[ref]]OPT (QUIET|VERBOSE)>
│ │ │ │ │ -               <[[ref]]OPT (DEPEND|NODEPEND)>
│ │ │ │ │ -               <[[ref]]OPT (PRECIOUS|NOPRECIOUS)>
│ │ │ │ │ -               <[[ref]]OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
│ │ │ │ │ -               <[[ref]]OPT DELIM=(HTML|SQUARE|CURLY)>
│ │ │ │ │ -               <[[ref]]OPT (XML|XML=FALSE)>
│ │ │ │ │ -
│ │ │ │ │ -               Note that INC doesn't check if the strings really denote integers. It may
│ │ │ │ │ -               give weired results when used on arbitrary strings. The integer values are
│ │ │ │ │ -               limited to the range -2^31..2^31.
│ │ │ │ │ -               Note further that htp wasn't designed to do extensive calculations. The INC
│ │ │ │ │ -               tag is useful in conjunction with WHILE to iterate over the defined blocks.
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +    SET        This is <bolditalic>bold and italic</bolditalic>
│ │ │ │ │ +    UNDEF    Note that INC doesn't check if the strings really denote integers. It
│ │ │ │ │ +    UNSET    may give weired results when used on arbitrary strings. The integer
│ │ │ │ │ +    USE,_$   values are limited to the range -2^31..2^31.
│ │ │ │ │ +    WHILE    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
│ │ │ │ │ + History      blocks.
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -76,10 +56,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/metatag.html
│ │ │ │ @@ -90,14 +90,16 @@
│ │ │ │  <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="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>
│ │ │ │ +<font size="-2">&nbsp;3. </font>e.gif" SIZE=KBYTE> kilobytes<br>
│ │ │ │ +<font size="-2">&nbsp;4. </font>&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> 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>
│ │ │ │ @@ -107,41 +109,35 @@
│ │ │ │  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="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>
│ │ │ │ -<font size="-2">&nbsp;2. </font><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>
│ │ │ │ +<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ +<font size="-2">&nbsp;2. </font><span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │  <font size="-2">&nbsp;3. </font><br>
│ │ │ │  </code></p>
│ │ │ │  <h2>Using parameters</h2>
│ │ │ │  <p> More sophisticated tags accept parameters.  The
│ │ │ │  <code>option</code> parameter lets multiple metatag parameters be
│ │ │ │  named and expanded inside the <code>def</code> or
│ │ │ │  <code>blockdef</code> block: </p>
│ │ │ │    <p><code>
│ │ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">macroname</span> <span class="htp-attrib">[parameters</span> <span class="htp-attrib">...]</span> <span class="htp-attrib">[noexpand]</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font><span class="htp-tag">&lt;... <span class="htp-attrib"><span class="htp-macro">$macroname</span></span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;3. </font><span class="htp-tag">&lt;... <span class="htp-attrib"><span class="htp-macro">${macroname}</span></span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font><br>
│ │ │ │ +<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>
│ │ │ │  </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; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">NOT</span> <span class="htp-attrib">i</span>=<span class="htp-string">"10"</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">i</span>&gt;</span><br>
│ │ │ │ -<font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ +<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>
│ │ │ │  </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
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,125 +1,107 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : Metatags ******
│ │ │ │ │ -Table_of_Contents       ***** Programming your own tags *****
│ │ │ │ │ - Introduction          Metatags allow for defining your own HTML-like tags.
│ │ │ │ │ - License               When you define a metatag you have to provide the HTML
│ │ │ │ │ - Tutorial              code which it abbreviates. In fact metatags are just
│ │ │ │ │ -    Macros            like block macros, but they have a nicer syntax. With
│ │ │ │ │ -    Including         metatags you can expand htp's functionality.
│ │ │ │ │ -    Templates         Metatags are defined with the [[ref]]def and [
│ │ │ │ │ -    Files             [ref]]blockdef tags and undefined with the [
│ │ │ │ │ - [>] Metatags          [ref]]undef tag.
│ │ │ │ │ - Usage                 As an example we show how to define a tag that builds
│ │ │ │ │ - HTP_Tags              a fancy horizontal rule out of several images.
│ │ │ │ │ - History                1.<[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ - Wish_list              2.
│ │ │ │ │ - Bugs                  In line 1 of the above example a new tag named imghr
│ │ │ │ │ -                        is defined. The html code which implements this rule
│ │ │ │ │ -                        is following in lines 2-8. between the [[ref]]def_and
│ │ │ │ │ -                        /def tags. You don't have to understand this html
│ │ │ │ │ -                        code, but you should understand that this is just pure
│ │ │ │ │ -                        html to draw the fancy rule. Every time you write
│ │ │ │ │ -                        <imghr> as in line 12 htp will replace this tag with
│ │ │ │ │ -                        the corresponding html code. To make metatags
│ │ │ │ │ -                        available to all htp documents in your project, place
│ │ │ │ │ -                        them in a common [[ref]]include_file.
│ │ │ │ │ -                        Often you want to define tags that have an opening and
│ │ │ │ │ -                        a closing variant. For this purpose you should use the
│ │ │ │ │ -                        [[ref]]blockdef tag. When htp encounters a blockdef
│ │ │ │ │ -                        tag it will automatically search for the matching
│ │ │ │ │ -                        closing tag and put everything between these tags in a
│ │ │ │ │ -                        block macro named block. Here is an example for this.
│ │ │ │ │ -                         1.<[[ref]]UNDEF tagname>
│ │ │ │ │ -                         2.<[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ -                         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]]use macroname [parameters ...] [noexpand]>
│ │ │ │ │ -                         2.<... $macroname ...>
│ │ │ │ │ -                         3.<... ${macroname} ...>
│ │ │ │ │ -                         4.
│ │ │ │ │ -                        ***** Saving blocks for later *****
│ │ │ │ │ -                        When you are using templates, the html should only be
│ │ │ │ │ -                        written by the template file. The normal htp files
│ │ │ │ │ -                        should just define macros that are used later in the
│ │ │ │ │ -                        template. So you may want to write block tags that
│ │ │ │ │ -                        just save the block in a macro for later use. Although
│ │ │ │ │ -                        this is possible with htp it is quite tricky, so here
│ │ │ │ │ -                        we present the way to do this:
│ │ │ │ │ -                         1.  <[[ref]]WHILE NOT i="10">
│ │ │ │ │ -                         2.    ...
│ │ │ │ │ -                         3.    <[[ref]]INC i>
│ │ │ │ │ -                         4.  <[[ref]]/WHILE>
│ │ │ │ │ -                        This defines a block macro named section. This macro
│ │ │ │ │ -                        uses a counter sect-ctr that enumerates the sections.
│ │ │ │ │ -                        It is increased for every section (line 3) and then
│ │ │ │ │ -                        the block macro name is build from this counter. So
│ │ │ │ │ -                        the first section is stored in block sect-1, the
│ │ │ │ │ -                        second in sect-2 and so on. The [[ref]]global flag in
│ │ │ │ │ -                        line 4 tells htp that these macros should be defined
│ │ │ │ │ -                        globally for the remaining run. Otherwise they would
│ │ │ │ │ -                        be forgotten at the end of the section macro.
│ │ │ │ │ -                        The tricky part is the [[ref]]expand and noexpand
│ │ │ │ │ -                        flags in line 4 and 5. Normally when you define a
│ │ │ │ │ -                        block macro the code between the start and end tag is
│ │ │ │ │ -                        literally copied into the macro value. The expansion
│ │ │ │ │ -                        takes place when the macro is used. In this case that
│ │ │ │ │ -                        doesn't make sense; all macros sect-1, sect-2 and so
│ │ │ │ │ -                        on would just contain the same value, namely <use
│ │ │ │ │ -                        block> and block wouldn't be defined anymore when the
│ │ │ │ │ -                        macros are finally expanded. Therefore we use expand
│ │ │ │ │ -                        to expand the use tag already when sect-1 is defined.
│ │ │ │ │ -                        The noexpand attribute of the [[ref]]use tag is just
│ │ │ │ │ -                        the opposite and prevents the contents of block to be
│ │ │ │ │ -                        expanded twice. If you omit it, it would be expanded
│ │ │ │ │ -                        when defining the sect-1 macro and when using it later
│ │ │ │ │ -                        in the template. Generally it is a good idea to use
│ │ │ │ │ -                        noexpand whenever you use expand in a block around it.
│ │ │ │ │ -                        To close this example we show how to expand the sect-$
│ │ │ │ │ -                        {sect-ctr} blocks in the template:
│ │ │ │ │ -                         1.  <[[ref]]WHILE sect-$i>
│ │ │ │ │ -                         2.    ...
│ │ │ │ │ -                         3.    <[[ref]]INC i>
│ │ │ │ │ -                         4.  <[[ref]]/WHILE>
│ │ │ │ │ -                        The [[ref]]while tag in line 3 checks whether the
│ │ │ │ │ -                        macro sect-${sect-ctr} is defined. If it is defined
│ │ │ │ │ -                        the body is evaluated, which expands the macro and
│ │ │ │ │ -                        increases sect-ctr. Afterwards the while condition is
│ │ │ │ │ -                        checked again to check for sect-2 macro. This repeats
│ │ │ │ │ -                        until sect-${sect-ctr} is not defined.
│ │ │ │ │ -                        ***** Conclusions *****
│ │ │ │ │ -                        This closes our short htp tutorial. I hope you did
│ │ │ │ │ -                        enjoy it and see the advantages of using htp for your
│ │ │ │ │ -                        own projects. Please give us some feedback about this
│ │ │ │ │ -                        tutorial. What can be improved?
│ │ │ │ │ -                        There is more documentation in this manual, see the [
│ │ │ │ │ -                        [ref]]Usage chapter or browse the documentations for
│ │ │ │ │ -                        the htp tags. If you're looking for examples, in case
│ │ │ │ │ -                        you haven't already noticed yourself, there is a link
│ │ │ │ │ -                        to the source code on the left, where you can get the
│ │ │ │ │ -                        source code for every page on this site.
│ │ │ │ │ +Table_of        ***** Programming your own tags *****
│ │ │ │ │ +Contents        Metatags allow for defining your own HTML-like tags. When you define a
│ │ │ │ │ + Introduction  metatag you have to provide the HTML code which it abbreviates. In fact
│ │ │ │ │ + License       metatags are just like block macros, but they have a nicer syntax. With
│ │ │ │ │ + Tutorial      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 horizontal
│ │ │ │ │ +    Files     rule out of several images.
│ │ │ │ │ + [>] Metatags   1.<[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ + Usage          2.
│ │ │ │ │ + HTP_Tags       3.e.gif" SIZE=KBYTE> kilobytes
│ │ │ │ │ + History        4.    Last modified <[[ref]]FILE NAME="image.gif" TIME>, <[[ref]]FILE
│ │ │ │ │ + Wish_list     NAME="image.gif" DATE>
│ │ │ │ │ + Bugs          In line 1 of the above example a new tag named imghr is defined. The html
│ │ │ │ │ +                code which implements this rule is following in lines 2-8. between the [
│ │ │ │ │ +                [ref]]def_and_/def tags. You don't have to understand this html code, but
│ │ │ │ │ +                you should understand that this is just pure html to draw the fancy rule.
│ │ │ │ │ +                Every time you write <imghr> as in line 12 htp will replace this tag with
│ │ │ │ │ +                the corresponding html code. To make metatags available to all htp
│ │ │ │ │ +                documents in your project, place them in a common [[ref]]include_file.
│ │ │ │ │ +                Often you want to define tags that have an opening and a closing variant.
│ │ │ │ │ +                For this purpose you should use the [[ref]]blockdef tag. When htp
│ │ │ │ │ +                encounters a blockdef tag it will automatically search for the matching
│ │ │ │ │ +                closing tag and put everything between these tags in a block macro named
│ │ │ │ │ +                block. Here is an example for this.
│ │ │ │ │ +                 1.<[[ref]]unset macroname>
│ │ │ │ │ +                 2.<[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │ +                 3.
│ │ │ │ │ +                ***** Using parameters *****
│ │ │ │ │ +                More sophisticated tags accept parameters. The option parameter lets
│ │ │ │ │ +                multiple metatag parameters be named and expanded inside the def or
│ │ │ │ │ +                blockdef block:
│ │ │ │ │ +                 1.    <[[ref]]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.
│ │ │ │ │ +                To close this example we show how to expand the sect-${sect-ctr} blocks
│ │ │ │ │ +                in the template:
│ │ │ │ │ +                 1.  <[[ref]]WHILE sect-$i>
│ │ │ │ │ +                 2.    ...
│ │ │ │ │ +                 3.    <[[ref]]INC i>
│ │ │ │ │ +                 4.  <[[ref]]/WHILE>
│ │ │ │ │ +                The [[ref]]while tag in line 3 checks whether the macro sect-${sect-ctr}
│ │ │ │ │ +                is defined. If it is defined the body is evaluated, which expands the
│ │ │ │ │ +                macro and increases sect-ctr. Afterwards the while condition is checked
│ │ │ │ │ +                again to check for sect-2 macro. This repeats until sect-${sect-ctr} is
│ │ │ │ │ +                not defined.
│ │ │ │ │ +                ***** Conclusions *****
│ │ │ │ │ +                This closes our short htp tutorial. I hope you did enjoy it and see the
│ │ │ │ │ +                advantages of using htp for your own projects. Please give us some
│ │ │ │ │ +                feedback about this tutorial. What can be improved?
│ │ │ │ │ +                There is more documentation in this manual, see the [[ref]]Usage chapter
│ │ │ │ │ +                or browse the documentations for the htp tags. If you're looking for
│ │ │ │ │ +                examples, in case you haven't already noticed yourself, there is a link
│ │ │ │ │ +                to the source code on the left, where you can get the source code for
│ │ │ │ │ +                every page on this site.
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered
│ │ │ │ │ -by_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/opt.html
│ │ │ │ @@ -114,16 +114,19 @@
│ │ │ │        <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>
│ │ │ │ +<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>
│ │ │ │ +&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>
│ │ │ │  <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,21 +1,21 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : OPT ******
│ │ │ │ │  Table_of       ***** syntax *****
│ │ │ │ │ -Contents       <[[ref]]QUOTE TAG [ATTRIBUTE=VALUE ...]>
│ │ │ │ │ +Contents       <[[ref]]SET macroname1="macrovalue1" [macroname2="macrovalue2" ...] [GLOBAL]>
│ │ │ │ │   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
│ │ │ │ │ + License       <[[ref]]/blockdef>
│ │ │ │ │ + Tutorial
│ │ │ │ │ + Usage          This is <bolditalic>bold and italic</bolditalic>
│ │ │ │ │ + HTP Tags     ***** synopsis *****
│ │ │ │ │ +    ALTTEXT  OPT is an htp tag that can be used to specify processing options inside the
│ │ │ │ │ +    BLOCK    actual document being processed. The options are used exactly as they would be
│ │ │ │ │ +    BLOCKDEF on the command-line, although they are not preceded by a ‘-’ character.
│ │ │ │ │ +    DEF      Click here for more_information_on_using_customization_options_with_htp.
│ │ │ │ │      FILE
│ │ │ │ │      IF
│ │ │ │ │      INC
│ │ │ │ │      IMG
│ │ │ │ │      IMAGEURL
│ │ │ │ │   [>] OPT
│ │ │ │ │      OUTPUT
│ │ │ │ │ @@ -25,14 +25,17 @@
│ │ │ │ │      UNSET
│ │ │ │ │      USE,_$
│ │ │ │ │      WHILE
│ │ │ │ │      <!---
│ │ │ │ │   History
│ │ │ │ │   Wish_list
│ │ │ │ │   Bugs
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │  [Powered_by
│ │ │ ├── ./usr/share/doc/htp/output.html
│ │ │ │ @@ -114,15 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<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>
│ │ │ │ +<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>
│ │ │ │  </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
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,13 +1,13 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : OUTPUT ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]SET macroname1="macrovalue1"
│ │ │ │ │ - License                    [macroname2="macrovalue2" ...] [GLOBAL]>
│ │ │ │ │ + Introduction               <[[ref]]UNDEF tagname>
│ │ │ │ │ + License                    <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │   Tutorial
│ │ │ │ │   Usage                      ***** synopsis *****
│ │ │ │ │   HTP Tags                   The OUTPUT tag can be used to create auxillary
│ │ │ │ │      ALTTEXT                files besides the main HTML file. The text between
│ │ │ │ │      BLOCK                  this tag and the corresponding </OUTPUT> tag is
│ │ │ │ │      BLOCKDEF               written to output file.
│ │ │ │ │      DEF                    Normally the outputfile is cleared before writing
│ │ │ ├── ./usr/share/doc/htp/quote.html
│ │ │ │ @@ -114,17 +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="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>
│ │ │ │ +&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>QUOTE</STRONG> is used to quote a macro that would otherwise
│ │ │ │  be interpreted by HTP.  It may be useful in conjunction with a
│ │ │ │  surrounding <a href="expand.html">EXPAND</a>ed block to prevent early
│ │ │ │  expansion of some contained blocks.  Note that '$' evaluation is still
│ │ │ │  done inside a quote block.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,49 +1,70 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : QUOTE ******
│ │ │ │ │ -Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]UNDEF tagname>
│ │ │ │ │ - License                    <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ - Tutorial
│ │ │ │ │ - Usage                      ***** synopsis *****
│ │ │ │ │ - HTP Tags                   QUOTE is used to quote a macro that would
│ │ │ │ │ -    ALTTEXT                otherwise be interpreted by HTP. It may be useful
│ │ │ │ │ -    BLOCK                  in conjunction with a surrounding EXPANDed block
│ │ │ │ │ -    BLOCKDEF               to prevent early expansion of some contained
│ │ │ │ │ -    DEF                    blocks. Note that '$' evaluation is still done
│ │ │ │ │ -    FILE                   inside a quote block.
│ │ │ │ │ -    IF
│ │ │ │ │ +Table_of       ***** syntax *****
│ │ │ │ │ +Contents         <[[ref]]DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
│ │ │ │ │ + Introduction     <[[ref]]IF size>
│ │ │ │ │ + License              <FONT SIZE=${size}>
│ │ │ │ │ + Tutorial         <[[ref]]/IF>
│ │ │ │ │ + Usage            <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ │ + HTP Tags         <[[ref]]USE title>
│ │ │ │ │ +    ALTTEXT      <[[ref]]IF size>
│ │ │ │ │ +    BLOCK            </FONT>
│ │ │ │ │ +    BLOCKDEF     <[[ref]]/IF>
│ │ │ │ │ +    DEF        <[[ref]]/DEF>
│ │ │ │ │ +    FILE
│ │ │ │ │ +    IF         <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ │      INC
│ │ │ │ │ -    IMG
│ │ │ │ │ +    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    QUOTE is used to quote a macro that would otherwise be interpreted
│ │ │ │ │ + Bugs         by HTP. It may be useful in conjunction with a surrounding
│ │ │ │ │ +               EXPANDed block to prevent early expansion of some contained
│ │ │ │ │ +               blocks. Note that '$' evaluation is still done inside a quote
│ │ │ │ │ +               block.
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │ -HTML coding [Powered_by
│ │ │ │ │ +HTML coding
│ │ │ │ │ +[Powered_by
│ │ │ │ │  htp]
│ │ │ │ │       htp on-line reference / http://htp.sourceforge.net/ref/
│ │ │ │ │       Authors: Jim Nelson, Jochen_Hoenicke, Michael_Möller.
│ │ │ │ │       Maintainers: Jochen_Hoenicke.
│ │ │ │ │  Copyright © 1995–96 Jim Nelson.
│ │ │ │ │  Copyright © 2001–2014 Jochen_Hoenicke.
│ │ │ │ │ -Permission to reproduce and distribute this hypertext document granted
│ │ │ │ │ -according to terms described in the License_section.
│ │ │ │ │ +Permission to reproduce and distribute this hypertext document granted according
│ │ │ │ │ +to terms described in the License_section.
│ │ │ │ │  last updated Sat May 16, 2015
│ │ │ ├── ./usr/share/doc/htp/set.html
│ │ │ │ @@ -114,26 +114,23 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="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>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname</span>&gt;</span><br>
│ │ │ │ +<span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">macroname1</span> <span class="htp-attrib">macroname2</span> <span class="htp-attrib">...</span> &gt;</span><br>
│ │ │ │  <br>
│ │ │ │  </code></p>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <STRONG>SET</STRONG> creates a macro definition that can later be expanded
│ │ │ │  anywhere in the HTML document.  To create a macro:
│ │ │ │    <p><code>
│ │ │ │ -<span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">macroname</span> <span class="htp-attrib">[parameters</span> <span class="htp-attrib">...]</span> <span class="htp-attrib">[noexpand]</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;... <span class="htp-attrib"><span class="htp-macro">$macroname</span></span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;... <span class="htp-attrib"><span class="htp-macro">${macroname}</span></span> <span class="htp-attrib">...</span>&gt;</span><br>
│ │ │ │ -<br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span>&gt;</span><br>
│ │ │ │  </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,40 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [HTP]
│ │ │ │ │  ****** htp on-line reference : SET ******
│ │ │ │ │  Table_of_Contents            ***** syntax *****
│ │ │ │ │ - Introduction               <[[ref]]UNDEF tagname>
│ │ │ │ │ - License                    <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ │ + Introduction               <[[ref]]unset macroname>
│ │ │ │ │ + License                    <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ │   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]]use macroname [parameters ...] [noexpand]>
│ │ │ │ │ -    DEF                    <... $macroname ...>
│ │ │ │ │ -    FILE                   <... ${macroname} ...>
│ │ │ │ │ -    IF
│ │ │ │ │ -    INC                    The macro "emailaddr" can then be expanded later.
│ │ │ │ │ -    IMG                    The USE tag is used to expand the macro outside a
│ │ │ │ │ -    IMAGEURL               tag (i.e., into the regular text). If the macro
│ │ │ │ │ -    OPT                    needs to be expanded inside a markup tag, use the
│ │ │ │ │ -    OUTPUT                 '$' operator.
│ │ │ │ │ -    QUOTE                  Multiple macros can be declared in a single markup
│ │ │ │ │ - [>] SET                    tag, as the second syntax line shows.
│ │ │ │ │ -    UNDEF                  SET should only be used for a single line's worth
│ │ │ │ │ -    UNSET                  of text. Multi-line macros can be defined with the
│ │ │ │ │ -    USE,_$                 BLOCK tag. The BLOCK tag is also useful if the
│ │ │ │ │ -    WHILE                  macro contains a quotation character and you don't
│ │ │ │ │ -    <!---                  want to fool around with special escape
│ │ │ │ │ - History                    characters.
│ │ │ │ │ - Wish_list                  Macros can be redefined by using another SET
│ │ │ │ │ - Bugs                       command with the same macro name. The prior
│ │ │ │ │ -                             definition will be destroyed, however. Also, the
│ │ │ │ │ -                             macro can be removed (destroyed) with the UNSET
│ │ │ │ │ -                             tag.
│ │ │ │ │ +    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.
│ │ │ ├── ./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 Wed Jan 10, 2024
│ │ │ │ +  last updated Tue Feb 11, 2025
│ │ │ │   </body>
│ │ │ │  </html>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,8 +1,8 @@
│ │ │ │ │                 ****** Jochen Hoenicke ******
│ │ │ │ │  Navigation bar [Photo]
│ │ │ │ │  Main           Room:  Bld.52 00-020
│ │ │ │ │  Example        Phone: +49 761 203-8243
│ │ │ │ │                 Fax:   +49 761 203-8242
│ │ │ │ │  ===============================================================================
│ │ │ │ │  Copyright by Joe_Doe.
│ │ │ │ │ -last updated Wed Jan 10, 2024
│ │ │ │ │ +last updated Tue Feb 11, 2025
│ │ │ ├── ./usr/share/doc/htp/tut/tut1.html
│ │ │ │ @@ -5,9 +5,9 @@
│ │ │ │  <meta name="Generator" content="htp 1.19">
│ │ │ │  </head>
│ │ │ │  <body>
│ │ │ │  This page was produced by htp.
│ │ │ │  <hr>
│ │ │ │  Copyright by Joe Doe,
│ │ │ │  <a href="mailto:webmaster@domain.com">webmaster@domain.com</a>,
│ │ │ │ -last updated Wed Jan 10, 2024
│ │ │ │ +last updated Tue Feb 11, 2025
│ │ │ │  </body>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,3 +1,3 @@
│ │ │ │ │  This page was produced by htp.
│ │ │ │ │  ===============================================================================
│ │ │ │ │ -Copyright by Joe Doe, webmaster@domain.com, last updated Wed Jan 10, 2024
│ │ │ │ │ +Copyright by Joe Doe, webmaster@domain.com, last updated Tue Feb 11, 2025
│ │ │ ├── ./usr/share/doc/htp/tut/tut2.html
│ │ │ │ @@ -13,10 +13,10 @@
│ │ │ │  <p>
│ │ │ │  As you can see the file contains almost only the contents.
│ │ │ │  </p>
│ │ │ │     </td></tr>
│ │ │ │    </table>
│ │ │ │    <hr>
│ │ │ │    Copyright by <a href="mailto:webmaster@domain.com">Joe Doe</a>.<br>
│ │ │ │ -  last updated Wed Jan 10, 2024
│ │ │ │ +  last updated Tue Feb 11, 2025
│ │ │ │   </body>
│ │ │ │  </html>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,6 +1,6 @@
│ │ │ │ │  Navigation bar ***** Here is the content *****
│ │ │ │ │  Main           As you can see the file contains almost only the contents.
│ │ │ │ │  Example
│ │ │ │ │  ===============================================================================
│ │ │ │ │  Copyright by Joe_Doe.
│ │ │ │ │ -last updated Wed Jan 10, 2024
│ │ │ │ │ +last updated Tue Feb 11, 2025
│ │ │ ├── ./usr/share/doc/htp/tut/tut3.html
│ │ │ │ @@ -13,10 +13,10 @@
│ │ │ │   <p>
│ │ │ │   As you can see the file contains almost only the contents.
│ │ │ │   </p>
│ │ │ │     </td></tr>
│ │ │ │    </table>
│ │ │ │    <hr>
│ │ │ │    Copyright by <a href="webmaster@domain.com">Joe Doe</a>.<br>
│ │ │ │ -  last updated Wed Jan 10, 2024
│ │ │ │ +  last updated Tue Feb 11, 2025
│ │ │ │   </body>
│ │ │ │  </html>
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,6 +1,6 @@
│ │ │ │ │  Navigation bar ***** Here are the contents *****
│ │ │ │ │  Main           As you can see the file contains almost only the contents.
│ │ │ │ │  Example
│ │ │ │ │  ===============================================================================
│ │ │ │ │  Copyright by Joe_Doe.
│ │ │ │ │ -last updated Wed Jan 10, 2024
│ │ │ │ │ +last updated Tue Feb 11, 2025
│ │ │ ├── ./usr/share/doc/htp/undef.html
│ │ │ │ @@ -114,15 +114,16 @@
│ │ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │ │    </table>
│ │ │ │    </div>
│ │ │ │  </td>
│ │ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │ │  <h2>syntax</h2>
│ │ │ │    <p><code>
│ │ │ │ -&nbsp; <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="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">SET</a> <span class="htp-attrib">emailaddr</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ │ +lt"><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>
│ │ │ │  <h2>synopsis</h2>
│ │ │ │  <P><STRONG>UNDEF</STRONG> removes a metatag definition.  Metatags
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,24 +1,24 @@
│ │ │ │ │  
│ │ │ │ │  [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.
│ │ │ │ │ -    INC
│ │ │ │ │ +Contents           <[[ref]]SET emailaddr="jnelson@crl.com">
│ │ │ │ │ + Introduction lt">
│ │ │ │ │ + License          <[[ref]]img src="/home/sharedimages/${name}" alt="${alt}">;
│ │ │ │ │ + Tutorial       <[[ref]]/def>
│ │ │ │ │ + Usage
│ │ │ │ │ + HTP Tags       <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ │ +    ALTTEXT  ***** synopsis *****
│ │ │ │ │ +    BLOCK    UNDEF removes a metatag definition. Metatags created by DEF and
│ │ │ │ │ +    BLOCKDEF BLOCKDEF can be removed with the UNDEF command. Once removed, the
│ │ │ │ │ +    DEF      metatag will no longer be recognized by htp until it is
│ │ │ │ │ +    FILE     reassigned.
│ │ │ │ │ +    IF       Multiple metatags can be removed by placing each name as an
│ │ │ │ │ +    INC      attribute.
│ │ │ │ │      IMG
│ │ │ │ │      IMAGEURL
│ │ │ │ │      OPT
│ │ │ │ │      OUTPUT
│ │ │ │ │      QUOTE
│ │ │ │ │      SET
│ │ │ │ │   [>] UNDEF
│ │ │ │ │ @@ -30,14 +30,15 @@
│ │ │ │ │   Wish_list
│ │ │ │ │   Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ +
│ │ │ │ │   page_source
│ │ │ │ │   htp_project
│ │ │ │ │   htp_homepage
│ │ │ │ │  hosted by
│ │ │ │ │  Sourceforge
│ │ │ │ │  HTML coding
│ │ │ │ │  [Powered_by
│ │ │ ├── ./usr/share/doc/htp/unset.html
│ │ │ │ @@ -114,49 +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>
│ │ │ │ -&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>
│ │ │ │ -</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">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>
│ │ │ │ -while sect-${sect-ctr}><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">inc</a> <span class="htp-attrib">sect-ctr</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/while</a>&gt;</span><br>
│ │ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"footer.hti"</span>&gt;</span><br>
│ │ │ │ +</code></p>
│ │ │ │ +<P>
│ │ │ │ +More than one macro may be removed in the same tag:
│ │ │ │ +  <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>
│ │ │ │  </code></p>
│ │ │ │  <p>
│ │ │ │  </td>
│ │ │ │  </tr>
│ │ │ │  <tr>
│ │ │ │  <td width="20%" bgcolor="white" valign="bottom">
│ │ │ │   <table border="0" cellspacing="0" cellpadding="0" width="100%">
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -1,44 +1,37 @@
│ │ │ │ │  
│ │ │ │ │  [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 NOT i="10">
│ │ │ │ │ -    USE,_$       ...
│ │ │ │ │ -    WHILE        <[[ref]]INC i>
│ │ │ │ │ -    <!---      <[[ref]]/WHILE>
│ │ │ │ │ - History      while sect-${sect-ctr}>
│ │ │ │ │ - Wish_list        <[[ref]]use sect-${sect-ctr}>
│ │ │ │ │ - Bugs             <[[ref]]inc sect-ctr>
│ │ │ │ │ -                 <[[ref]]/while>
│ │ │ │ │ -               <[[ref]]file include="footer.hti">
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +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                  <a href="mailto:$email">mailto hyperlink</a>
│ │ │ │ │ +    USE,_$                 <a href="http://$domain/~${username}/">another
│ │ │ │ │ +    WHILE                  hyperlink</a>
│ │ │ │ │ +    <!---
│ │ │ │ │ + History
│ │ │ │ │ + Wish_list
│ │ │ │ │ + Bugs
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │  
│ │ │ │ │ @@ -52,18 +45,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/while.html
│ │ │ │ @@ -143,18 +143,15 @@
│ │ │ │  &nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/while</a>&gt;</span><br>
│ │ │ │  <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"footer.hti"</span>&gt;</span><br>
│ │ │ │  </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>
│ │ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">i</span>&gt;</span><br>
│ │ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<span class="htp-macro">${tagName}</span> <span class="htp-attrib"><span class="htp-macro">${attrName}</span></span>=<span class="htp-value"><span class="htp-macro">${value$ctr}</span></span>&gt;</span><br>
│ │ │ │  </code></p>
│ │ │ │  <P>
│ │ │ │  If the condition is true, the block is evaluated and afterwards the
│ │ │ │  WHILE tag is evaluated again.  If the '$'-operator is used in the
│ │ │ │  WHILE tag it is also reevaluated on each iteration.
│ │ │ │  <P>
│ │ │ │  A loop block <EM>must</EM> be closed with the /WHILE tag.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -22,19 +22,16 @@
│ │ │ │ │      SET              <[[ref]]while sect-${sect-ctr}>
│ │ │ │ │      UNDEF              <[[ref]]use sect-${sect-ctr}>
│ │ │ │ │      UNSET              <[[ref]]inc sect-ctr>
│ │ │ │ │      USE,_$           <[[ref]]/while>
│ │ │ │ │   [>] WHILE          <[[ref]]file include="footer.hti">
│ │ │ │ │      <!---          Just as with [[ref]]IF you can also check for a macro's
│ │ │ │ │   History            existance:
│ │ │ │ │ - Wish_list            <[[ref]]WHILE sect-$i>
│ │ │ │ │ - Bugs                   ...
│ │ │ │ │ -                         <[[ref]]INC i>
│ │ │ │ │ -                       <[[ref]]/WHILE>
│ │ │ │ │ -                     If the condition is true, the block is evaluated and
│ │ │ │ │ + Wish_list              <${tagName} ${attrName}=${value$ctr}>
│ │ │ │ │ + Bugs               If the condition is true, the block is evaluated and
│ │ │ │ │                       afterwards the WHILE tag is evaluated again. If the '$'-
│ │ │ │ │                       operator is used in the WHILE tag it is also reevaluated
│ │ │ │ │                       on each iteration.
│ │ │ │ │                       A loop block must be closed with the /WHILE tag.