--- /srv/rebuilderd/tmp/rebuilderdraCAVq/inputs/htp_1.19-8+b1_loong64.deb
+++ /srv/rebuilderd/tmp/rebuilderdraCAVq/out/htp_1.19-8+b1_loong64.deb
├── file list
│ @@ -1,3 +1,3 @@
│  -rw-r--r--   0        0        0        4 2026-04-21 18:04:17.000000 debian-binary
│ --rw-r--r--   0        0        0     3652 2026-04-21 18:04:17.000000 control.tar.xz
│ --rw-r--r--   0        0        0   115980 2026-04-21 18:04:17.000000 data.tar.xz
│ +-rw-r--r--   0        0        0     3660 2026-04-21 18:04:17.000000 control.tar.xz
│ +-rw-r--r--   0        0        0   114968 2026-04-21 18:04:17.000000 data.tar.xz
├── control.tar.xz
│ ├── control.tar
│ │ ├── ./control
│ │ │ @@ -1,13 +1,13 @@
│ │ │  Package: htp
│ │ │  Source: htp (1.19-8)
│ │ │  Version: 1.19-8+b1
│ │ │  Architecture: loong64
│ │ │  Maintainer: Marcelo Soares Mota <motasmarcelo@gmail.com>
│ │ │ -Installed-Size: 722
│ │ │ +Installed-Size: 713
│ │ │  Depends: libc6 (>= 2.42)
│ │ │  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,28 +1,28 @@
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/bin/
│ │ │  -rwxr-xr-x   0 root         (0) root         (0)   133272 2026-04-21 18:04:17.000000 ./usr/bin/htp
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/doc/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/
│ │ │ --rw-r--r--   0 root         (0) root         (0)     9561 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/alttext.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    12791 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/alttext.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1418 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/alttext.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)     8633 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/block.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     7882 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/block.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      781 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/block.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    14839 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/blockdef.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    12656 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/blockdef.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1075 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/blockdef.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     4763 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/bugs.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      737 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/bugs.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)      878 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/changelog.Debian.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)      213 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/changelog.Debian.loong64.gz
│ │ │ --rw-r--r--   0 root         (0) root         (0)    14968 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/comment.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    12866 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/comment.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      676 2026-04-21 18:04:17.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)    13688 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/def.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    15100 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/def.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3601 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/def.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     8030 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/default.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3149 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/default.htp
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.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
│ │ │ @@ -33,64 +33,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 2026-04-21 18:04:17.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 2026-04-21 18:04:17.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)     9074 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/expand.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    13888 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/expand.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3702 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/expand.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    13579 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/file.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    12655 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/file.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     2490 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/file.htp.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)    14293 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/history.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3946 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/history.htp.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3911 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/hlhtp.pl
│ │ │  -rw-r--r--   0 root         (0) root         (0)      165 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/htp.def
│ │ │  -rw-r--r--   0 root         (0) root         (0)     4049 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/htp.htt
│ │ │ --rw-r--r--   0 root         (0) root         (0)    12273 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/if.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    12666 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/if.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      932 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/if.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)     9642 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/imageurl.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     9130 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/imageurl.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     2507 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/imageurl.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    12046 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/img.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     8781 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/img.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1168 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/img.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    12726 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/inc.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     8646 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/inc.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1092 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/inc.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     9881 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/include.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1894 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/include.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     4874 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/index.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)       78 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/index.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     7733 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/intro.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3489 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/intro.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)    10774 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/license.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      454 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/license.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3782 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/macros.def
│ │ │  -rw-r--r--   0 root         (0) root         (0)     5088 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/macros.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      388 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/macros.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    16425 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/metatag.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    12422 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/metatag.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     2439 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/metatag.htp.gz
│ │ │ --rw-r--r--   0 root         (0) root         (0)     7956 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/opt.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     7558 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/opt.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      608 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/opt.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     7809 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/options.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3100 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/options.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)     8233 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/output.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     7777 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/output.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      695 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/output.htp
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/
│ │ │  -rw-r--r--   0 root         (0) root         (0)      171 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/arrow.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      262 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/download.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      708 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/htpicon.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)    25563 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/logo.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      455 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/manbig.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      491 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/manual.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1313 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/poweredbyhtp.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      679 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/sficon.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      492 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pic/source.png
│ │ │  -rw-r--r--   0 root         (0) root         (0)      523 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/pphtp.pl
│ │ │ --rw-r--r--   0 root         (0) root         (0)     7953 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/quote.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     7503 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/quote.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      390 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/quote.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    10244 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/set.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     9308 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/set.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1200 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/set.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)      500 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/styles.css
│ │ │  -rw-r--r--   0 root         (0) root         (0)    27219 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/template.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     2235 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/template.htp.gz
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1914 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/toc.def
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/
│ │ │  -rw-r--r--   0 root         (0) root         (0)      146 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/footer.hti
│ │ │ @@ -103,23 +103,23 @@
│ │ │  -rw-r--r--   0 root         (0) root         (0)      192 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/tut2.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)      501 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/tut3.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      191 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/tut3.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)      356 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/tut3.htt
│ │ │  -rw-r--r--   0 root         (0) root         (0)      297 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tut/tut4.htt
│ │ │  -rw-r--r--   0 root         (0) root         (0)    10517 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tutorial.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3393 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/tutorial.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)     7804 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/undef.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     7559 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/undef.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      460 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/undef.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)     8949 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/unset.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)     8763 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/unset.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      658 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/unset.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     7681 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/usage.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     2959 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/usage.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    12753 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/use.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    13849 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/use.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     3300 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/use.htp
│ │ │ --rw-r--r--   0 root         (0) root         (0)    10243 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/while.html
│ │ │ +-rw-r--r--   0 root         (0) root         (0)    11051 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/while.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)      938 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/while.htp
│ │ │  -rw-r--r--   0 root         (0) root         (0)     5288 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/wishlist.html
│ │ │  -rw-r--r--   0 root         (0) root         (0)     1311 2026-04-21 18:04:17.000000 ./usr/share/doc/htp/wishlist.htp
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/doc-base/
│ │ │  -rw-r--r--   0 root         (0) root         (0)      235 2020-06-14 17:36:12.000000 ./usr/share/doc-base/htp.htp
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/lintian/
│ │ │  drwxr-xr-x   0 root         (0) root         (0)        0 2026-04-21 18:04:17.000000 ./usr/share/lintian/overrides/
│ │ ├── ./usr/share/doc/htp/alttext.html
│ │ │ @@ -114,36 +114,60 @@
│ │ │        <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>
│ │ │  </code></p>
│ │ │  <h2>synopsis</h2>
│ │ │  <strong>ALTTEXT</strong> declares an ALT attribute for any <A
│ │ │  HREF="img.html">IMG</A> tag with a SRC matching the ALTTEXT NAME.
│ │ │  Since relative paths can be used to point to the same image, only the
│ │ │  filename is considered in all comparisons.
│ │ │  <p>
│ │ │  When an IMG tag with a matching source is encountered, htp will add an ALT
│ │ │  attribute only if one is not already present.  This allows for ALT text to
│ │ │  be overridden on specific images and default text on all others.
│ │ │  <p>
│ │ │  For example:
│ │ │    <p><code>
│ │ │ -&nbsp; &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>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #1<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSEIF <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #2<br>
│ │ │ +...<br>
│ │ │ +]<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #3<br>
│ │ │ +]<br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"../image/logo.gif"</span>&gt;</span><br>
│ │ │ +&nbsp; will also have an ALT attribute appended to it<br>
│ │ │  <br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;centered&gt;</span><br>
│ │ │ -&nbsp; &nbsp; This text is centered.<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Click here for more information!"</span>&gt;</span><br>
│ │ │ +&nbsp; remains unchanged.<br>
│ │ │ +<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>
│ │ │  <p>
│ │ │  An ALTTEXT tag with a name but no text attribute removes any ALT
│ │ │  mapping for this image.  Successing IMG tags with a matching SRC name are not
│ │ │  changed.
│ │ │  <p>
│ │ │  Since this is useful for an image used throughout a set of documents,
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,37 +1,63 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : ALTTEXT ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]def name="tagname" [option="option1 [option2 ...]" ]
│ │ │ │ -  Introduction   [global] [expand]>
│ │ │ │ -  License        <[[ref]]/def>
│ │ │ │ -  Tutorial
│ │ │ │ -  Usage          ***** synopsis *****
│ │ │ │ -  HTP Tags       ALTTEXT declares an ALT attribute for any IMG tag with a SRC
│ │ │ │ -  [>] ALTTEXT    matching the ALTTEXT NAME. Since relative paths can be used to
│ │ │ │ -      BLOCK      point to the same image, only the filename is considered in
│ │ │ │ -      BLOCKDEF   all comparisons.
│ │ │ │ -      DEF        When an IMG tag with a matching source is encountered, htp
│ │ │ │ -      FILE       will add an ALT attribute only if one is not already present.
│ │ │ │ -      IF         This allows for ALT text to be overridden on specific images
│ │ │ │ -      INC        and default text on all others.
│ │ │ │ -      IMG        For example:
│ │ │ │ -      IMAGEURL       <[[ref]]def name="centered">
│ │ │ │ -      OPT            <p align=center>
│ │ │ │ -      OUTPUT         <[[ref]]/def>
│ │ │ │ -      QUOTE
│ │ │ │ -      SET            <centered>
│ │ │ │ -      UNDEF          This text is centered.
│ │ │ │ -      UNSET      An ALTTEXT tag with a name but no text attribute removes any
│ │ │ │ -      USE,_$     ALT mapping for this image. Successing IMG tags with a
│ │ │ │ -      WHILE      matching SRC name are not changed.
│ │ │ │ -      <!---      Since this is useful for an image used throughout a set of
│ │ │ │ -  History        documents, ALTTEXT is most appropriate in an include_file or a
│ │ │ │ -  Wish_list      default_file.
│ │ │ │ -  Bugs           In addition to ALTTEXT, htp can also automatically add WIDTH
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   ALTTEXT declares an ALT attribute for any IMG tag with a SRC
│ │ │ │ +  License        matching the ALTTEXT NAME. Since relative paths can be used to
│ │ │ │ +  Tutorial       point to the same image, only the filename is considered in
│ │ │ │ +  Usage          all comparisons.
│ │ │ │ +  HTP Tags       When an IMG tag with a matching source is encountered, htp
│ │ │ │ +  [>] ALTTEXT    will add an ALT attribute only if one is not already present.
│ │ │ │ +      BLOCK      This allows for ALT text to be overridden on specific images
│ │ │ │ +      BLOCKDEF   and default text on all others.
│ │ │ │ +      DEF        For example:
│ │ │ │ +      FILE       <[[ref]]IF [NOT] conditional>
│ │ │ │ +      IF             block #1
│ │ │ │ +      INC        [
│ │ │ │ +      IMG        <ELSEIF [NOT] conditional>
│ │ │ │ +      IMAGEURL       block #2
│ │ │ │ +      OPT        ...
│ │ │ │ +      OUTPUT     ]
│ │ │ │ +      QUOTE      [
│ │ │ │ +      SET        <ELSE>
│ │ │ │ +      UNDEF          block #3
│ │ │ │ +      UNSET      ]
│ │ │ │ +      USE,_$     <[[ref]]/IF>
│ │ │ │ +      WHILE
│ │ │ │ +      <!---       <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ +  History
│ │ │ │ +  Wish_list        this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ +  Bugs             will also have an ALT attribute appended to it
│ │ │ │ +
│ │ │ │ +                   this line: <[[ref]]img src="logo.gif" alt="Click here for
│ │ │ │ +                 more information!">
│ │ │ │ +                   remains unchanged.
│ │ │ │ +                 <[[ref]]block name=d expand>
│ │ │ │ +                     d is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +                 noexpand>
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]block name=e>
│ │ │ │ +                     e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +                 noexpand>
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]set time="2">
│ │ │ │ +                   <[[ref]]block name=a>
│ │ │ │ +                     a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]use c>
│ │ │ │ +                   <[[ref]]use d>
│ │ │ │ +                   <[[ref]]use e>
│ │ │ │ +                 An ALTTEXT tag with a name but no text attribute removes any
│ │ │ │ +                 ALT mapping for this image. Successing IMG tags with a
│ │ │ │ +                 matching SRC name are not changed.
│ │ │ │ +                 Since this is useful for an image used throughout a set of
│ │ │ │ +                 documents, ALTTEXT is most appropriate in an include_file or a
│ │ │ │ +                 default_file.
│ │ │ │ +                 In addition to ALTTEXT, htp can also automatically add WIDTH
│ │ │ │                   and HEIGHT attributes to IMG tags.
│ │ ├── ./usr/share/doc/htp/block.html
│ │ │ @@ -114,17 +114,14 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="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>
│ │ │  </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,25 +1,25 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : BLOCK, /BLOCK ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]def name="tagname" [option="option1 [option2 ...]" ]
│ │ │ │ -  Introduction   [global] [expand]>
│ │ │ │ -  License        <[[ref]]/def>
│ │ │ │ -  Tutorial
│ │ │ │ -  Usage          ***** synopsis *****
│ │ │ │ -  HTP Tags       BLOCK and /BLOCK are used to create block macros, which are
│ │ │ │ -      ALTTEXT    similar in use to SET macros, but can be multi-line
│ │ │ │ -  [>] BLOCK      definitions.
│ │ │ │ -      BLOCKDEF   Any text and formatting may be set inside the block. You can
│ │ │ │ -      DEF        use any htp or user defined metatag including FILE_INCLUDE.
│ │ │ │ -      FILE       The metatags won't be expanded before the block is USEd except
│ │ │ │ -      IF         if you give the EXPAND parameter.
│ │ │ │ -      INC        The block macro is dereferenced (expanded) with the USE_tag_or
│ │ │ │ -      IMG        the_'$'_operator. See the notes on the USE tag on how to pass
│ │ │ │ -      IMAGEURL   parameters to a block macro.
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   BLOCK and /BLOCK are used to create block macros, which are
│ │ │ │ +  License        similar in use to SET macros, but can be multi-line
│ │ │ │ +  Tutorial       definitions.
│ │ │ │ +  Usage          Any text and formatting may be set inside the block. You can
│ │ │ │ +  HTP Tags       use any htp or user defined metatag including FILE_INCLUDE.
│ │ │ │ +      ALTTEXT    The metatags won't be expanded before the block is USEd except
│ │ │ │ +  [>] BLOCK      if you give the EXPAND parameter.
│ │ │ │ +      BLOCKDEF   The block macro is dereferenced (expanded) with the USE_tag_or
│ │ │ │ +      DEF        the_'$'_operator. See the notes on the USE tag on how to pass
│ │ │ │ +      FILE       parameters to a block macro.
│ │ │ │ +      IF
│ │ │ │ +      INC
│ │ │ │ +      IMG
│ │ │ │ +      IMAGEURL
│ │ │ │        OPT
│ │ │ │        OUTPUT
│ │ │ │        QUOTE
│ │ │ │        SET
│ │ │ │        UNDEF
│ │ │ │        UNSET
│ │ │ │        USE,_$
│ │ │ │ @@ -29,18 +29,14 @@
│ │ │ │    Wish_list
│ │ │ │    Bugs
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │     page_source
│ │ │ │     htp_project
│ │ │ │     htp_homepage
│ │ │ │  hosted by
│ │ │ │  Sourceforge
│ │ │ │  HTML coding
│ │ │ │  [Powered_by_htp]
│ │ ├── ./usr/share/doc/htp/blockdef.html
│ │ │ @@ -114,30 +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="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"0"</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">block</a> <span class="htp-attrib">name</span>=<span class="htp-value">a</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; a is expanded at time <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">time</span>&gt;</span>.<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">block</a> <span class="htp-attrib">name</span>=<span class="htp-value">b</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; b is expanded at time <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">time</span>&gt;</span>.<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">time</span>=<span class="htp-string">"1"</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">b</span>&gt;</span><br>
│ │ │ -&nbsp; contents of a: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ -&nbsp; contents of b: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">b</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">block</a> <span class="htp-attrib">name</span>=<span class="htp-value">c</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; c is expanded at time <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">time</span>&gt;</span>; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">a</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">block</a> <span class="htp-attrib">name</span>=<span class="htp-value">d</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #1<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSEIF <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #2<br>
│ │ │ +...<br>
│ │ │ +]<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #3<br>
│ │ │ +]<br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"../image/logo.gif"</span>&gt;</span><br>
│ │ │ +&nbsp; will also have an ALT attribute appended to it<br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Click here for more information!"</span>&gt;</span><br>
│ │ │ +&nbsp; remains unchanged.<br>
│ │ │ +<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>
│ │ │ @@ -152,27 +157,14 @@
│ │ │  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>
│ │ │  </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,60 +1,53 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : BLOCKDEF, /BLOCKDEF ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents           <[[ref]]set time="0">
│ │ │ │ -  Introduction     <[[ref]]block name=a>
│ │ │ │ -  License            a is expanded at time <[[ref]]use time>.
│ │ │ │ -  Tutorial         <[[ref]]/block>
│ │ │ │ -  Usage            <[[ref]]block name=b expand>
│ │ │ │ -  HTP Tags           b is expanded at time <[[ref]]use time>.
│ │ │ │ -      ALTTEXT      <[[ref]]/block>
│ │ │ │ -      BLOCK        <[[ref]]set time="1">
│ │ │ │ -  [>] BLOCKDEF     <[[ref]]use a>
│ │ │ │ -      DEF          <[[ref]]use b>
│ │ │ │ -      FILE         contents of a: <[[ref]]use a noexpand>
│ │ │ │ -      IF           contents of b: <[[ref]]use b noexpand>
│ │ │ │ -      INC          <[[ref]]block name=c expand>
│ │ │ │ -      IMG            c is expanded at time <[[ref]]use time>; <[[ref]]use a>
│ │ │ │ -      IMAGEURL     <[[ref]]/block>
│ │ │ │ -      OPT          <[[ref]]block name=d expand>
│ │ │ │ -      OUTPUT         d is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ -      QUOTE      noexpand>
│ │ │ │ -      SET          <[[ref]]/block>
│ │ │ │ -      UNDEF        <[[ref]]block name=e>
│ │ │ │ -      UNSET          e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ -      USE,_$     noexpand>
│ │ │ │ -      WHILE        <[[ref]]/block>
│ │ │ │ -      <!---        <[[ref]]set time="2">
│ │ │ │ -  History          <[[ref]]block name=a>
│ │ │ │ -  Wish_list          a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ -  Bugs             <[[ref]]/block>
│ │ │ │ +Contents         <[[ref]]IF [NOT] conditional>
│ │ │ │ +  Introduction       block #1
│ │ │ │ +  License        [
│ │ │ │ +  Tutorial       <ELSEIF [NOT] conditional>
│ │ │ │ +  Usage              block #2
│ │ │ │ +  HTP Tags       ...
│ │ │ │ +      ALTTEXT    ]
│ │ │ │ +      BLOCK      [
│ │ │ │ +  [>] BLOCKDEF   <ELSE>
│ │ │ │ +      DEF            block #3
│ │ │ │ +      FILE       ]
│ │ │ │ +      IF         <[[ref]]/IF>
│ │ │ │ +      INC
│ │ │ │ +      IMG         <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ +      IMAGEURL
│ │ │ │ +      OPT          this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ +      OUTPUT       will also have an ALT attribute appended to it
│ │ │ │ +      QUOTE
│ │ │ │ +      SET          this line: <[[ref]]img src="logo.gif" alt="Click here for
│ │ │ │ +      UNDEF      more information!">
│ │ │ │ +      UNSET        remains unchanged.
│ │ │ │ +      USE,_$     <[[ref]]block name=d expand>
│ │ │ │ +      WHILE          d is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +      <!---      noexpand>
│ │ │ │ +  History          <[[ref]]/block>
│ │ │ │ +  Wish_list        <[[ref]]block name=e>
│ │ │ │ +  Bugs               e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +                 noexpand>
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]set time="2">
│ │ │ │ +                   <[[ref]]block name=a>
│ │ │ │ +                     a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │                     <[[ref]]use c>
│ │ │ │                     <[[ref]]use d>
│ │ │ │                     <[[ref]]use e>
│ │ │ │                   ***** 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.
│ │ ├── ./usr/share/doc/htp/comment.html
│ │ │ @@ -114,30 +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>
│ │ │ -<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="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #1<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSEIF <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #2<br>
│ │ │ +...<br>
│ │ │ +]<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #3<br>
│ │ │ +]<br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │  <br>
│ │ │ -><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;<span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"../image/logo.gif"</span>&gt;</span><br>
│ │ │ +&nbsp; will also have an ALT attribute appended to it<br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Click here for more information!"</span>&gt;</span><br>
│ │ │ +&nbsp; remains unchanged.<br>
│ │ │ +<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>
│ │ │ @@ -150,35 +155,22 @@
│ │ │  <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>
│ │ │  </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>
│ │ │ -<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="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>
│ │ │  <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>
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,63 +1,55 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : <!--- ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]def name="tagname" [option="option1 [option2 ...]" ]
│ │ │ │ -  Introduction   [global] [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
│ │ │ │ -      SET        noexpand>
│ │ │ │ -      UNDEF        <[[ref]]/block>
│ │ │ │ -      UNSET        <[[ref]]block name=e>
│ │ │ │ -      USE,_$         e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ -      WHILE      noexpand>
│ │ │ │ -  [>] <!---        <[[ref]]/block>
│ │ │ │ -  History          <[[ref]]set time="2">
│ │ │ │ -  Wish_list        <[[ref]]block name=a>
│ │ │ │ -  Bugs               a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ +Contents         <[[ref]]IF [NOT] conditional>
│ │ │ │ +  Introduction       block #1
│ │ │ │ +  License        [
│ │ │ │ +  Tutorial       <ELSEIF [NOT] conditional>
│ │ │ │ +  Usage              block #2
│ │ │ │ +  HTP Tags       ...
│ │ │ │ +      ALTTEXT    ]
│ │ │ │ +      BLOCK      [
│ │ │ │ +      BLOCKDEF   <ELSE>
│ │ │ │ +      DEF            block #3
│ │ │ │ +      FILE       ]
│ │ │ │ +      IF         <[[ref]]/IF>
│ │ │ │ +      INC
│ │ │ │ +      IMG         <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ +      IMAGEURL
│ │ │ │ +      OPT          this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ +      OUTPUT       will also have an ALT attribute appended to it
│ │ │ │ +      QUOTE
│ │ │ │ +      SET          this line: <[[ref]]img src="logo.gif" alt="Click here for
│ │ │ │ +      UNDEF      more information!">
│ │ │ │ +      UNSET        remains unchanged.
│ │ │ │ +      USE,_$     <[[ref]]block name=d expand>
│ │ │ │ +      WHILE          d is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +  [>] <!---      noexpand>
│ │ │ │ +  History          <[[ref]]/block>
│ │ │ │ +  Wish_list        <[[ref]]block name=e>
│ │ │ │ +  Bugs               e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +                 noexpand>
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]set time="2">
│ │ │ │ +                   <[[ref]]block name=a>
│ │ │ │ +                     a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │                     <[[ref]]/block>
│ │ │ │                     <[[ref]]use c>
│ │ │ │                     <[[ref]]use d>
│ │ │ │                     <[[ref]]use e>
│ │ │ │                   ***** 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:
│ │ │ │ -                 <[[ref]]imageurl url="imageurl" [ path="path/in/local/
│ │ │ │ -                 filesystem" ]>
│ │ │ │ +                 <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ +                 ... ] [GLOBAL]>
│ │ │ │  
│ │ │ │                   Make sure that the variable is never defined and xyz should be
│ │ │ │                   the reason why you don't want to include this block
│ │ ├── ./usr/share/doc/htp/def.html
│ │ │ @@ -114,70 +114,78 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="alttext.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">alttext</a> <span class="htp-attrib">name</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">text</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #1<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSEIF <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #2<br>
│ │ │ +...<br>
│ │ │ +]<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #3<br>
│ │ │ +]<br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │  <br>
│ │ │ -&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span>&gt;</span><br>
│ │ │ -&nbsp; becomes this after processing: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +&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">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │  <br>
│ │ │  &nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"../image/logo.gif"</span>&gt;</span><br>
│ │ │  &nbsp; will also have an ALT attribute appended to it<br>
│ │ │  <br>
│ │ │  &nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Click here for more information!"</span>&gt;</span><br>
│ │ │  &nbsp; remains unchanged.<br>
│ │ │ +<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>DEF</strong> creates <a href="metatag.html">metatags</a>, which is a
│ │ │  fancy way of saying it creates new tags.  The mechanism is very similar to
│ │ │  <a href="block.html">BLOCK</a> macros, except that the <a href="use.html">USE</a>
│ │ │  tag is not used to expand them.  Instead, they are expanded by their own name.
│ │ │  For example:
│ │ │  </p>
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; block #1<br>
│ │ │ -[<br>
│ │ │ -<span class="htp-tag">&lt;ELSEIF <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; block #2<br>
│ │ │ -...<br>
│ │ │ -]<br>
│ │ │ -[<br>
│ │ │ -<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ -&nbsp; &nbsp; block #3<br>
│ │ │ -]<br>
│ │ │ -<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ -<br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  Some metatags will require an opening and closing tag (comparable to
│ │ │  <TITLE> and </TITLE>).  In this case, you should use the <A
│ │ │  HREF="blockdef.html">BLOCKDEF</A> macro.  Another slightly faster
│ │ │  alternative is to use two metatags, the opening tag and the closing
│ │ │  tag with a preceding slash. For example:
│ │ │  </P>
│ │ │    <p><code>
│ │ │ -&nbsp; &nbsp; File image.gif <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">FILE</a> <span class="htp-attrib">NAME</span>=<span class="htp-string">"image.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-value">KBYTE</span>&gt;</span>&nbsp;kilobytes<br>
│ │ │ -&nbsp; &nbsp; Last modified <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">FILE</a> <span class="htp-attrib">NAME</span>=<span class="htp-string">"image.gif"</span> <span class="htp-attrib">TIME</span>&gt;</span>, <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">FILE</a> <span class="htp-attrib">NAME</span>=<span class="htp-string">"image.gif"</span> <span class="htp-attrib">DATE</span>&gt;</span><br>
│ │ │ +<span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">macroname1</span>=<span class="htp-string">"increment1"</span> <span class="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>
│ │ │ +<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; &nbsp; <span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">FILE</a> <span class="htp-attrib">INCLUDE</span>=<span class="htp-string">"include.hti"</span> <span class="htp-attrib">name</span>=<span class="htp-string">"Jim Nelson"</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; This tag will fail: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">USE</a> <span class="htp-attrib">name</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  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,61 +1,68 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : DEF, /DEF ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents           <[[ref]]alttext name="logo.gif" text="Company logo">
│ │ │ │ -  Introduction
│ │ │ │ -  License          this line: <[[ref]]img src="logo.gif">
│ │ │ │ -  Tutorial         becomes this after processing: <[[ref]]img src="logo.gif"
│ │ │ │ -  Usage          alt="Company logo">
│ │ │ │ -  HTP Tags
│ │ │ │ -      ALTTEXT      this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ -      BLOCK        will also have an ALT attribute appended to it
│ │ │ │ -      BLOCKDEF
│ │ │ │ -  [>] DEF          this line: <[[ref]]img src="logo.gif" alt="Click here for
│ │ │ │ -      FILE       more information!">
│ │ │ │ -      IF           remains unchanged.
│ │ │ │ -      INC        ***** synopsis *****
│ │ │ │ -      IMG        DEF creates metatags, which is a fancy way of saying it
│ │ │ │ -      IMAGEURL   creates new tags. The mechanism is very similar to BLOCK
│ │ │ │ -      OPT        macros, except that the USE tag is not used to expand them.
│ │ │ │ -      OUTPUT     Instead, they are expanded by their own name. For example:
│ │ │ │ -      QUOTE      <[[ref]]IF [NOT] conditional>
│ │ │ │ -      SET            block #1
│ │ │ │ -      UNDEF      [
│ │ │ │ -      UNSET      <ELSEIF [NOT] conditional>
│ │ │ │ -      USE,_$         block #2
│ │ │ │ -      WHILE      ...
│ │ │ │ -      <!---      ]
│ │ │ │ -  History        [
│ │ │ │ -  Wish_list      <ELSE>
│ │ │ │ -  Bugs               block #3
│ │ │ │ -                 ]
│ │ │ │ -                 <[[ref]]/IF>
│ │ │ │ -
│ │ │ │ +Contents         <[[ref]]IF [NOT] conditional>
│ │ │ │ +  Introduction       block #1
│ │ │ │ +  License        [
│ │ │ │ +  Tutorial       <ELSEIF [NOT] conditional>
│ │ │ │ +  Usage              block #2
│ │ │ │ +  HTP Tags       ...
│ │ │ │ +      ALTTEXT    ]
│ │ │ │ +      BLOCK      [
│ │ │ │ +      BLOCKDEF   <ELSE>
│ │ │ │ +  [>] DEF            block #3
│ │ │ │ +      FILE       ]
│ │ │ │ +      IF         <[[ref]]/IF>
│ │ │ │ +      INC
│ │ │ │ +      IMG         <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ +      IMAGEURL
│ │ │ │ +      OPT          this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ +      OUTPUT       will also have an ALT attribute appended to it
│ │ │ │ +      QUOTE
│ │ │ │ +      SET          this line: <[[ref]]img src="logo.gif" alt="Click here for
│ │ │ │ +      UNDEF      more information!">
│ │ │ │ +      UNSET        remains unchanged.
│ │ │ │ +      USE,_$     <[[ref]]block name=d expand>
│ │ │ │ +      WHILE          d is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +      <!---      noexpand>
│ │ │ │ +  History          <[[ref]]/block>
│ │ │ │ +  Wish_list        <[[ref]]block name=e>
│ │ │ │ +  Bugs               e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +                 noexpand>
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]set time="2">
│ │ │ │ +                   <[[ref]]block name=a>
│ │ │ │ +                     a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]use c>
│ │ │ │ +                   <[[ref]]use d>
│ │ │ │ +                   <[[ref]]use e>
│ │ │ │ +                 ***** synopsis *****
│ │ │ │ +                 DEF creates metatags, which is a fancy way of saying it
│ │ │ │ +                 creates new tags. The mechanism is very similar to BLOCK
│ │ │ │ +                 macros, except that the USE tag is not used to expand them.
│ │ │ │ +                 Instead, they are expanded by their own name. For example:
│ │ │ │                   Some metatags will require an opening and closing tag
│ │ │ │                   (comparable to
│ │ │ │                   and
│ │ │ │                   ). In this case, you should use the BLOCKDEF macro. Another
│ │ │ │                   slightly faster alternative is to use two metatags, the
│ │ │ │                   opening tag and the closing tag with a preceding slash. For
│ │ │ │                   example:
│ │ │ │ -                     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>
│ │ │ │ +                 <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ +                 ... ] [GLOBAL]>
│ │ │ │ +
│ │ │ │                   You should really use BLOCKDEF, though, as it will check for
│ │ │ │                   matching end tag. It is not that slower.
│ │ │ │                   Options can be passed to a metatag, which can then expand as
│ │ │ │                   if it were a SET macro. Option names are parameterized with
│ │ │ │                   the OPTION attribute. Multiple options can be listed by
│ │ │ │                   separating their name with a space (which therefore requires
│ │ │ │                   they be surrounded by quotes.)
│ │ │ │ -                     <[[ref]]FILE INCLUDE="include.hti" name="Jim Nelson"
│ │ │ │ -                 email="jnelson@crl.com">
│ │ │ │ -                     This tag will fail: <[[ref]]USE name>
│ │ │ │                   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
│ │ ├── ./usr/share/doc/htp/expand.html
│ │ │ @@ -98,26 +98,52 @@
│ │ │  <p>However, if the block tag is marked with the <code>expand</code>
│ │ │  modifier it is expanded immediately.  This is useful if you want to
│ │ │  store something in a block macro, that depends on the current value of
│ │ │  another macro.  This other macro may no longer have the correct value
│ │ │  when the macro is expanded.  Here is some code that demonstrate when
│ │ │  the htp tags are expanded: </P>
│ │ │    <p><code>
│ │ │ -<font size="-2">&nbsp;1. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"centered"</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;p <span class="htp-attrib">align</span>=<span class="htp-value">center</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;4. </font><br>
│ │ │ -<font size="-2">&nbsp;5. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;centered&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;6. </font>&nbsp; &nbsp; This text is centered.<br>
│ │ │ +<font size="-2">&nbsp;1. </font><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>
│ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; block #1<br>
│ │ │ +<font size="-2">&nbsp;3. </font>[<br>
│ │ │ +<font size="-2">&nbsp;4. </font><span class="htp-tag">&lt;ELSEIF <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;5. </font>&nbsp; &nbsp; block #2<br>
│ │ │ +<font size="-2">&nbsp;6. </font>...<br>
│ │ │ +<font size="-2">&nbsp;7. </font>]<br>
│ │ │ +<font size="-2">&nbsp;8. </font>[<br>
│ │ │ +<font size="-2">&nbsp;9. </font><span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ +<font size="-2">10. </font>&nbsp; &nbsp; block #3<br>
│ │ │ +<font size="-2">11. </font>]<br>
│ │ │ +<font size="-2">12. </font><span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │ +<font size="-2">13. </font><br>
│ │ │ +<font size="-2">14. </font>&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">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +<font size="-2">15. </font><br>
│ │ │ +<font size="-2">16. </font>&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"../image/logo.gif"</span>&gt;</span><br>
│ │ │ +<font size="-2">17. </font>&nbsp; will also have an ALT attribute appended to it<br>
│ │ │ +<font size="-2">18. </font><br>
│ │ │ +<font size="-2">19. </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">20. </font>&nbsp; remains unchanged.<br>
│ │ │ +<font size="-2">21. </font><span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">block</a> <span class="htp-attrib">name</span>=<span class="htp-value">d</span> <span class="htp-attrib">expand</span>&gt;</span><br>
│ │ │ +<font size="-2">22. </font>&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>
│ │ │ +<font size="-2">23. </font>&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>
│ │ │ +<font size="-2">24. </font>&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>
│ │ │ +<font size="-2">25. </font>&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>
│ │ │ +<font size="-2">26. </font>&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>
│ │ │ +<font size="-2">27. </font>&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>
│ │ │ +<font size="-2">28. </font>&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>
│ │ │ +<font size="-2">29. </font>&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>
│ │ │ +<font size="-2">30. </font>&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>
│ │ │ +<font size="-2">31. </font>&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>
│ │ │ +<font size="-2">32. </font>&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>
│ │ │ +<font size="-2">33. </font>&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>
│ │ │  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>
│ │ │ +<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>
│ │ │ +<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 {}
│ │ │ │ @@ -20,24 +20,54 @@
│ │ │ │                    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.
│ │ │ │ +                   1. <[[ref]]IF [NOT] conditional>
│ │ │ │ +                   2.     block #1
│ │ │ │ +                   3. [
│ │ │ │ +                   4. <ELSEIF [NOT] conditional>
│ │ │ │ +                   5.     block #2
│ │ │ │ +                   6. ...
│ │ │ │ +                   7. ]
│ │ │ │ +                   8. [
│ │ │ │ +                   9. <ELSE>
│ │ │ │ +                  10.     block #3
│ │ │ │ +                  11. ]
│ │ │ │ +                  12. <[[ref]]/IF>
│ │ │ │ +                  13.
│ │ │ │ +                  14.  <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ +                  15.
│ │ │ │ +                  16.   this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ +                  17.   will also have an ALT attribute appended to it
│ │ │ │ +                  18.
│ │ │ │ +                  19.   this line: <[[ref]]img src="logo.gif" alt="Click here
│ │ │ │ +                  for more information!">
│ │ │ │ +                  20.   remains unchanged.
│ │ │ │ +                  21. <[[ref]]block name=d expand>
│ │ │ │ +                  22.     d is expanded at time <[[ref]]use time>; <[[ref]]use
│ │ │ │ +                  a noexpand>
│ │ │ │ +                  23.   <[[ref]]/block>
│ │ │ │ +                  24.   <[[ref]]block name=e>
│ │ │ │ +                  25.     e is expanded at time <[[ref]]use time>; <[[ref]]use
│ │ │ │ +                  a noexpand>
│ │ │ │ +                  26.   <[[ref]]/block>
│ │ │ │ +                  27.   <[[ref]]set time="2">
│ │ │ │ +                  28.   <[[ref]]block name=a>
│ │ │ │ +                  29.     a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ +                  30.   <[[ref]]/block>
│ │ │ │ +                  31.   <[[ref]]use c>
│ │ │ │ +                  32.   <[[ref]]use d>
│ │ │ │ +                  33.   <[[ref]]use e>
│ │ │ │                    This produces the following:
│ │ │ │ -                  <[[ref]]if disabled_because_xyz>
│ │ │ │ -                    ...
│ │ │ │ -                  <[[ref]]/if>
│ │ │ │ +                  <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ +                  ... ] [GLOBAL]>
│ │ │ │ +
│ │ │ │                    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
│ │ ├── ./usr/share/doc/htp/file.html
│ │ │ @@ -114,40 +114,34 @@
│ │ │        <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="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>
│ │ │  </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="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>
│ │ │ +<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>
│ │ │ -<br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  For file size information, the value BYTE, KBYTE, etc. dictates how the
│ │ │  information is displayed.  In anything other than byte format, the information
│ │ │  is displayed in floating-point notation.  The amount of precision (the number
│ │ │  of digits to the right of the decimal point) can be set with the optional
│ │ │  PRECISION attribute.  The default precision is zero (0), which means no
│ │ │ @@ -176,15 +170,14 @@
│ │ │  <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>
│ │ │  </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,43 +1,37 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : FILE ******
│ │ │ │  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    ***** synopsis *****
│ │ │ │ -      BLOCK      FILE has several optional parameters of differing purpose. The
│ │ │ │ -      BLOCKDEF   output file's name, the current date and time, and the
│ │ │ │ -      DEF        contents of another file may be included. Another file's time,
│ │ │ │ -  [>] FILE       date, or size may be added to the output file as well.
│ │ │ │ -      IF         As with all HTML, these tags do not have to be on their own
│ │ │ │ -      INC        line, so the following is perfectly acceptable:
│ │ │ │ -      IMG        **** NAME, TIME, SIZE ****
│ │ │ │ -      IMAGEURL   To include information about another file, such as an archive
│ │ │ │ -      OPT        file or graphic image, specify its name with the NAME
│ │ │ │ -      OUTPUT     attribute followed by the type of information to be displayed:
│ │ │ │ -      QUOTE      <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ -      SET        ... ] [GLOBAL]>
│ │ │ │ -      UNDEF
│ │ │ │ -      UNSET      For file size information, the value BYTE, KBYTE, etc.
│ │ │ │ -      USE,_$     dictates how the information is displayed. In anything other
│ │ │ │ -      WHILE      than byte format, the information is displayed in floating-
│ │ │ │ -      <!---      point notation. The amount of precision (the number of digits
│ │ │ │ -  History        to the right of the decimal point) can be set with the
│ │ │ │ -  Wish_list      optional PRECISION attribute. The default precision is zero
│ │ │ │ -  Bugs           (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
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   FILE has several optional parameters of differing purpose. The
│ │ │ │ +  License        output file's name, the current date and time, and the
│ │ │ │ +  Tutorial       contents of another file may be included. Another file's time,
│ │ │ │ +  Usage          date, or size may be added to the output file as well.
│ │ │ │ +  HTP Tags       As with all HTML, these tags do not have to be on their own
│ │ │ │ +      ALTTEXT    line, so the following is perfectly acceptable:
│ │ │ │ +      BLOCK      <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ +      BLOCKDEF   ... ] [GLOBAL]>
│ │ │ │ +      DEF
│ │ │ │ +  [>] FILE       **** NAME, TIME, SIZE ****
│ │ │ │ +      IF         To include information about another file, such as an archive
│ │ │ │ +      INC        file or graphic image, specify its name with the NAME
│ │ │ │ +      IMG        attribute followed by the type of information to be displayed:
│ │ │ │ +      IMAGEURL   For file size information, the value BYTE, KBYTE, etc.
│ │ │ │ +      OPT        dictates how the information is displayed. In anything other
│ │ │ │ +      OUTPUT     than byte format, the information is displayed in floating-
│ │ │ │ +      QUOTE      point notation. The amount of precision (the number of digits
│ │ │ │ +      SET        to the right of the decimal point) can be set with the
│ │ │ │ +      UNDEF      optional PRECISION attribute. The default precision is zero
│ │ │ │ +      UNSET      (0), which means no fractional portion is displayed.
│ │ │ │ +      USE,_$     At the request of many people, the TIME and DATE attributes
│ │ │ │ +      WHILE      will now accept formatting characters that are passed directly
│ │ │ │ +      <!---      into the ANSI C library function. This allows for the time and
│ │ │ │ +  History        date to be displayed in virtually any format. Users not
│ │ │ │ +  Wish_list      wishing to mess around with this should stick to the default
│ │ │ │ +  Bugs           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
│ │ │ │ @@ -48,15 +42,14 @@
│ │ │ │                   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"
│ │ ├── ./usr/share/doc/htp/if.html
│ │ │ @@ -114,54 +114,60 @@
│ │ │        <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="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>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #1<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSEIF <span class="ebnf">[</span><span class="htp-attrib">NOT</span><span class="ebnf">]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #2<br>
│ │ │ +...<br>
│ │ │ +]<br>
│ │ │ +[<br>
│ │ │ +<span class="htp-tag">&lt;ELSE&gt;</span><br>
│ │ │ +&nbsp; &nbsp; block #3<br>
│ │ │ +]<br>
│ │ │ +<span class="htp-tag">&lt;<a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/IF</a>&gt;</span><br>
│ │ │  <br>
│ │ │ +&nbsp;<span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Company logo"</span>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"../image/logo.gif"</span>&gt;</span><br>
│ │ │ +&nbsp; will also have an ALT attribute appended to it<br>
│ │ │ +<br>
│ │ │ +&nbsp; this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Click here for more information!"</span>&gt;</span><br>
│ │ │ +&nbsp; remains unchanged.<br>
│ │ │ +<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>IF, NOT, ELSEIF, ELSE, and /IF</STRONG> are the building
│ │ │  blocks for conditional processing.  The basic form is shown above.
│ │ │  <P> "Conditional" is either a "compare" or "is defined" operation.  A
│ │ │  compare operator is a test of the value of a macro against a literal
│ │ │  string:
│ │ │    <p><code>
│ │ │ -&nbsp; <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>
│ │ │  <P>
│ │ │  and a defined operator is a test of a macro's existance:
│ │ │  <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>
│ │ │  </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,45 +1,53 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : IF, ELSEIF, ELSE, /IF ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]img src="filename" ...>
│ │ │ │ -  Introduction
│ │ │ │ -  License        ***** synopsis *****
│ │ │ │ -  Tutorial       IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for
│ │ │ │ -  Usage          conditional processing. The basic form is shown above.
│ │ │ │ -  HTP Tags       "Conditional" is either a "compare" or "is defined" operation.
│ │ │ │ -      ALTTEXT    A compare operator is a test of the value of a macro against a
│ │ │ │ -      BLOCK      literal string:
│ │ │ │ -      BLOCKDEF     <[[ref]]DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
│ │ │ │ -      DEF            <[[ref]]IF size>
│ │ │ │ -      FILE               <FONT SIZE=${size}>
│ │ │ │ -  [>] IF             <[[ref]]/IF>
│ │ │ │ -      INC            <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ -      IMG            <[[ref]]USE title>
│ │ │ │ -      IMAGEURL       <[[ref]]IF size>
│ │ │ │ -      OPT                </FONT>
│ │ │ │ -      OUTPUT         <[[ref]]/IF>
│ │ │ │ -      QUOTE        <[[ref]]/DEF>
│ │ │ │ -      SET
│ │ │ │ -      UNDEF        <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ -      UNSET
│ │ │ │ -      USE,_$       <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ -      WHILE
│ │ │ │ -      <!---        This will fail:
│ │ │ │ -  History          <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another
│ │ │ │ -  Wish_list      title">
│ │ │ │ -  Bugs
│ │ │ │ -                   Instead, use * like this:
│ │ │ │ -                   <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ -                     <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ -                   <[[ref]]/DEF>
│ │ │ │ -                    
│ │ │ │ -                   <MYIMG SRC="logo.gif" ALT="Our logo">
│ │ │ │ +Contents         <[[ref]]IF [NOT] conditional>
│ │ │ │ +  Introduction       block #1
│ │ │ │ +  License        [
│ │ │ │ +  Tutorial       <ELSEIF [NOT] conditional>
│ │ │ │ +  Usage              block #2
│ │ │ │ +  HTP Tags       ...
│ │ │ │ +      ALTTEXT    ]
│ │ │ │ +      BLOCK      [
│ │ │ │ +      BLOCKDEF   <ELSE>
│ │ │ │ +      DEF            block #3
│ │ │ │ +      FILE       ]
│ │ │ │ +  [>] IF         <[[ref]]/IF>
│ │ │ │ +      INC
│ │ │ │ +      IMG         <[[ref]]img src="logo.gif" alt="Company logo">
│ │ │ │ +      IMAGEURL
│ │ │ │ +      OPT          this line: <[[ref]]img src="../image/logo.gif">
│ │ │ │ +      OUTPUT       will also have an ALT attribute appended to it
│ │ │ │ +      QUOTE
│ │ │ │ +      SET          this line: <[[ref]]img src="logo.gif" alt="Click here for
│ │ │ │ +      UNDEF      more information!">
│ │ │ │ +      UNSET        remains unchanged.
│ │ │ │ +      USE,_$     <[[ref]]block name=d expand>
│ │ │ │ +      WHILE          d is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +      <!---      noexpand>
│ │ │ │ +  History          <[[ref]]/block>
│ │ │ │ +  Wish_list        <[[ref]]block name=e>
│ │ │ │ +  Bugs               e is expanded at time <[[ref]]use time>; <[[ref]]use a
│ │ │ │ +                 noexpand>
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]set time="2">
│ │ │ │ +                   <[[ref]]block name=a>
│ │ │ │ +                     a is defined for the 2nd time <[[ref]]use time>.
│ │ │ │ +                   <[[ref]]/block>
│ │ │ │ +                   <[[ref]]use c>
│ │ │ │ +                   <[[ref]]use d>
│ │ │ │ +                   <[[ref]]use e>
│ │ │ │ +                 ***** synopsis *****
│ │ │ │ +                 IF, NOT, ELSEIF, ELSE, and /IF are the building blocks for
│ │ │ │ +                 conditional processing. The basic form is shown above.
│ │ │ │ +                 "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:
│ │ │ │                   and a defined operator is a test of a macro's existance:
│ │ │ │ -                     <[[ref]]INC i="1" j="-1">
│ │ │ │                   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.
│ │ ├── ./usr/share/doc/htp/imageurl.html
│ │ │ @@ -116,16 +116,14 @@
│ │ │    </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>
│ │ │ -m"><br>
│ │ │ -&nbsp; &nbsp; This tag will fail: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">USE</a> <span class="htp-attrib">name</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <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
│ │ │ @@ -139,15 +137,14 @@
│ │ │  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>
│ │ │  </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,40 +1,37 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : IMAGEURL ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │  Contents         <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │    Introduction   ... ] [GLOBAL]>
│ │ │ │    License
│ │ │ │ -  Tutorial       m">
│ │ │ │ -  Usage              This tag will fail: <[[ref]]USE name>
│ │ │ │ -  HTP Tags       ***** synopsis *****
│ │ │ │ -      ALTTEXT    IMAGEURL tells htp, where to find images on the local file
│ │ │ │ -      BLOCK      system. declares an URL replacement that is used for size
│ │ │ │ -      BLOCKDEF   lookups in any IMG tag. This definitions takes effect only if
│ │ │ │ -      DEF        the IMGXY option is enabled. Beacause htp can't lookup files
│ │ │ │ -      FILE       in the world wide web you have to map absolute image URLs to a
│ │ │ │ -      IF         directory in the local file system.
│ │ │ │ -      INC        When an IMG tag is encountered where htp has to insert width
│ │ │ │ -      IMG        and height the defined URL replacements will be taken into
│ │ │ │ -  [>] IMAGEURL   account (later definitions take precedence to earlier): For
│ │ │ │ -      OPT        each defined imageurl it checks (case-insensitive) if it is a
│ │ │ │ -      OUTPUT     prefix of the image's SRC attribute. If it matches this prefix
│ │ │ │ -      QUOTE      is replaced by the given PATH. If no IMAGEURL matches the SRC
│ │ │ │ -      SET        is considered as relative link and looked up in the current
│ │ │ │ -      UNDEF      directory.
│ │ │ │ -      UNSET      For example:
│ │ │ │ -      USE,_$         <[[ref]]INC i="1" j="-1">
│ │ │ │ -      WHILE      If IMAGEURL is specified with a URL but no PATH attribute, it
│ │ │ │ -      <!---      is treated as an undefine, and is removed.
│ │ │ │ -  History        Since you usually need the url mapping for a number of images
│ │ │ │ -  Wish_list      used throughout a set of documents, IMAGEURL is most
│ │ │ │ -  Bugs           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.
│ │ │ │ -
│ │ │ │ +  Tutorial       ***** synopsis *****
│ │ │ │ +  Usage          IMAGEURL tells htp, where to find images on the local file
│ │ │ │ +  HTP Tags       system. declares an URL replacement that is used for size
│ │ │ │ +      ALTTEXT    lookups in any IMG tag. This definitions takes effect only if
│ │ │ │ +      BLOCK      the IMGXY option is enabled. Beacause htp can't lookup files
│ │ │ │ +      BLOCKDEF   in the world wide web you have to map absolute image URLs to a
│ │ │ │ +      DEF        directory in the local file system.
│ │ │ │ +      FILE       When an IMG tag is encountered where htp has to insert width
│ │ │ │ +      IF         and height the defined URL replacements will be taken into
│ │ │ │ +      INC        account (later definitions take precedence to earlier): For
│ │ │ │ +      IMG        each defined imageurl it checks (case-insensitive) if it is a
│ │ │ │ +  [>] IMAGEURL   prefix of the image's SRC attribute. If it matches this prefix
│ │ │ │ +      OPT        is replaced by the given PATH. If no IMAGEURL matches the SRC
│ │ │ │ +      OUTPUT     is considered as relative link and looked up in the current
│ │ │ │ +      QUOTE      directory.
│ │ │ │ +      SET        For example:
│ │ │ │ +      UNDEF      If IMAGEURL is specified with a URL but no PATH attribute, it
│ │ │ │ +      UNSET      is treated as an undefine, and is removed.
│ │ │ │ +      USE,_$     Since you usually need the url mapping for a number of images
│ │ │ │ +      WHILE      used throughout a set of documents, IMAGEURL is most
│ │ │ │ +      <!---      appropriately put into an include_file or the htp.def file.
│ │ │ │ +  History        In addition to WIDTH and HEIGHT, htp can also (semi-
│ │ │ │ +  Wish_list      )automatically add an ALT_text attribute to IMG tags.
│ │ │ │ +  Bugs
│ │ ├── ./usr/share/doc/htp/img.html
│ │ │ @@ -114,38 +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">"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>
│ │ │ +<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; <span class="htp-tag">&lt;HEADERIMG <span class="htp-attrib">SRC</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">SIZE</span>=<span class="htp-string">"+2"</span> <span class="htp-attrib">TITLE</span>=<span class="htp-string">"A title"</span>&gt;</span><br>
│ │ │ -<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;HEADERIMG <span class="htp-attrib">SRC</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">TITLE</span>=<span class="htp-string">"Normal sized title"</span>&gt;</span><br>
│ │ │ -<br>
│ │ │ -&nbsp; This will fail:<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;HEADERIMG <span class="htp-attrib">SRC</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">ALT</span>=<span class="htp-string">"Our logo"</span> <span class="htp-attrib">TITLE</span>=<span class="htp-string">"Another title"</span>&gt;</span><br>
│ │ │ -<br>
│ │ │ -&nbsp; Instead, use * like this:<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">DEF</a> <span class="htp-attrib">NAME</span>=<span class="htp-string">"MYIMG"</span> <span class="htp-attrib">OPTION</span>=<span class="htp-string">"SRC *"</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IMG</a> <span class="htp-attrib">SRC</span>=<span class="htp-string">"pics/<span class="htp-macro">${src}</span>"</span> <span class="htp-attrib"><span class="htp-macro">$*</span></span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/DEF</a>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;MYIMG <span class="htp-attrib">SRC</span>=<span class="htp-string">"logo.gif"</span> <span class="htp-attrib">ALT</span>=<span class="htp-string">"Our logo"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <h2>synopsis</h2>
│ │ │  <P> <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,59 +1,37 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : IMG ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents           <[[ref]]DEF NAME="HEADERIMG" OPTION="SRC TITLE SIZE">
│ │ │ │ -  Introduction       <[[ref]]IF size>
│ │ │ │ -  License                <FONT SIZE=${size}>
│ │ │ │ -  Tutorial           <[[ref]]/IF>
│ │ │ │ -  Usage              <[[ref]]IMG SRC=pics/${src}>
│ │ │ │ -  HTP Tags           <[[ref]]USE title>
│ │ │ │ -      ALTTEXT        <[[ref]]IF size>
│ │ │ │ -      BLOCK              </FONT>
│ │ │ │ -      BLOCKDEF       <[[ref]]/IF>
│ │ │ │ -      DEF          <[[ref]]/DEF>
│ │ │ │ -      FILE
│ │ │ │ -      IF           <HEADERIMG SRC="logo.gif" SIZE="+2" TITLE="A title">
│ │ │ │ -      INC
│ │ │ │ -  [>] IMG          <HEADERIMG SRC="logo.gif" TITLE="Normal sized title">
│ │ │ │ -      IMAGEURL
│ │ │ │ -      OPT          This will fail:
│ │ │ │ -      OUTPUT       <HEADERIMG SRC="logo.gif" ALT="Our logo" TITLE="Another
│ │ │ │ -      QUOTE      title">
│ │ │ │ -      SET
│ │ │ │ -      UNDEF        Instead, use * like this:
│ │ │ │ -      UNSET        <[[ref]]DEF NAME="MYIMG" OPTION="SRC *">
│ │ │ │ -      USE,_$         <[[ref]]IMG SRC="pics/${src}" $*>
│ │ │ │ -      WHILE        <[[ref]]/DEF>
│ │ │ │ -      <!---         
│ │ │ │ -  History          <MYIMG SRC="logo.gif" ALT="Our logo">
│ │ │ │ -  Wish_list      ***** synopsis *****
│ │ │ │ -  Bugs           img 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.
│ │ │ │ -                 htp adds this information with the WIDTH and HEIGHT markup
│ │ │ │ -                 attributes. If htp detects these attributes are already
│ │ │ │ -                 present in the tag, it will not modify the values. If htp
│ │ │ │ -                 cannot find the image file, it will issue a warning but not
│ │ │ │ -                 halt processing.
│ │ │ │ -                 At this time, GIF (Graphic Interchange Format), PNG (Portable
│ │ │ │ -                 Network Graphics), and JFIF (JPEG File Interchange Format) are
│ │ │ │ -                 supported.
│ │ │ │ -                 The IMGXY_and_NOIMGXY options control whether or not htp
│ │ │ │ -                 actually adds this information as it executes.
│ │ │ │ -                 Since htp is able to lookup files only in the local
│ │ │ │ -                 filesystem, the IMAGEURL tag may be used to map URLs to local
│ │ │ │ -                 files.
│ │ │ │ -                 htp can also add default ALT text to IMG tags using ALTTEXT.
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ +Contents         <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ +  Introduction   ... ] [GLOBAL]>
│ │ │ │ +  License
│ │ │ │ +  Tutorial       ***** synopsis *****
│ │ │ │ +  Usage          img is a standard HTML tag. htp can add the specified image's
│ │ │ │ +  HTP Tags       width and height to the tag automatically. This has the
│ │ │ │ +      ALTTEXT    advantage of not having to determine each image's size
│ │ │ │ +      BLOCK      manually, which is especially useful if the image may change
│ │ │ │ +      BLOCKDEF   frequently.
│ │ │ │ +      DEF        htp adds this information with the WIDTH and HEIGHT markup
│ │ │ │ +      FILE       attributes. If htp detects these attributes are already
│ │ │ │ +      IF         present in the tag, it will not modify the values. If htp
│ │ │ │ +      INC        cannot find the image file, it will issue a warning but not
│ │ │ │ +  [>] IMG        halt processing.
│ │ │ │ +      IMAGEURL   At this time, GIF (Graphic Interchange Format), PNG (Portable
│ │ │ │ +      OPT        Network Graphics), and JFIF (JPEG File Interchange Format) are
│ │ │ │ +      OUTPUT     supported.
│ │ │ │ +      QUOTE      The IMGXY_and_NOIMGXY options control whether or not htp
│ │ │ │ +      SET        actually adds this information as it executes.
│ │ │ │ +      UNDEF      Since htp is able to lookup files only in the local
│ │ │ │ +      UNSET      filesystem, the IMAGEURL tag may be used to map URLs to local
│ │ │ │ +      USE,_$     files.
│ │ │ │ +      WHILE      htp can also add default ALT text to IMG tags using ALTTEXT.
│ │ │ │ +      <!---
│ │ │ │ +  History
│ │ │ │ +  Wish_list
│ │ │ │ +  Bugs
│ │ ├── ./usr/share/doc/htp/inc.html
│ │ │ @@ -114,58 +114,30 @@
│ │ │        <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>
│ │ │ +<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; For this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"logo.gif"</span>&gt;</span><br>
│ │ │ -&nbsp; the local filename "logo.gif" will be used to determine image dimensions<br>
│ │ │ -&nbsp; (no URL replacement).<br>
│ │ │ -<br>
│ │ │ -&nbsp; For this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"http://my.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ -&nbsp; the local filename "/var/www/my.domain/logo.gif" will be used.<br>
│ │ │ -<br>
│ │ │ -&nbsp; But for this line: <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"http://other.domain.org/logo.gif"</span>&gt;</span><br>
│ │ │ -&nbsp; the local file cannot be found (no prefix match), so the image dimensions<br>
│ │ │ -&nbsp; will not be added.<br>
│ │ │ -<br>
│ │ │ -&nbsp; Order is important; last IMAGEURL tag takes precedence:<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="imageurl.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">imageurl</a> <span class="htp-attrib">url</span>=<span class="htp-string">"/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/htdocs/"</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="imageurl.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">imageurl</a> <span class="htp-attrib">url</span>=<span class="htp-string">"/test/"</span> <span class="htp-attrib">path</span>=<span class="htp-string">"/var/www/test/"</span>&gt;</span><br>
│ │ │ -<br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"/image.gif"</span>&gt;</span>&nbsp;and <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"/test/image.gif"</span>&gt;</span>&nbsp;are mapped to<br>
│ │ │ -&nbsp; /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.<br>
│ │ │ -&nbsp; If the order of the imageurl lines would be swapped, the second <br>
│ │ │ -&nbsp; image would be mapped to /var/www/htdocs/test/image.gif.<br>
│ │ │  </code></p>
│ │ │  <h2>synopsis</h2>
│ │ │  The <STRONG>INC</STRONG> can be used for incrementing/decrementing a
│ │ │  variable or for variable addition.  The basic form is shown above.
│ │ │  <P>
│ │ │  The "increment" is anything that evaluates to a integer.  It can be a
│ │ │  literal string or a macro preceeded by the '$'-operator.  The
│ │ │  macroname must be the name of a defined macro that contains an
│ │ │  integer.  If the increment is ommitted it defaults to 1.
│ │ │  The effect of this operation is that the macro is redefined
│ │ │  to contain the sum of its previous value and its increment.
│ │ │  <P>
│ │ │  To increment or decrement a variable you can use this form:
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(IMGXY|NOIMGXY)</span>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(QUIET|VERBOSE)</span>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(DEPEND|NODEPEND)</span>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(PRECIOUS|NOPRECIOUS)</span>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(CONDENSE|SEMICONDENSE|NOCONDENSE)</span>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">DELIM</span>=<span class="htp-value">(HTML|SQUARE|CURLY)</span>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="opt.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">OPT</a> <span class="htp-attrib">(XML|XML</span>=<span class="htp-value">FALSE)</span>&gt;</span><br>
│ │ │ -<br>
│ │ │  </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,73 +1,37 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : INC ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents           <[[ref]]imageurl url="http://my.domain.org/" path="/var/www/
│ │ │ │ -  Introduction   my.domain/">
│ │ │ │ -  License          <[[ref]]imageurl url="other.domain.org/" path="/var/www/
│ │ │ │ -  Tutorial       other.domain/">
│ │ │ │ -  Usage
│ │ │ │ -  HTP Tags         For this line: <[[ref]]img src="logo.gif">
│ │ │ │ -      ALTTEXT      the local filename "logo.gif" will be used to determine
│ │ │ │ -      BLOCK      image dimensions
│ │ │ │ -      BLOCKDEF     (no URL replacement).
│ │ │ │ -      DEF
│ │ │ │ -      FILE         For this line: <[[ref]]img src="http://my.domain.org/
│ │ │ │ -      IF         logo.gif">
│ │ │ │ -  [>] INC          the local filename "/var/www/my.domain/logo.gif" will be
│ │ │ │ -      IMG        used.
│ │ │ │ -      IMAGEURL
│ │ │ │ -      OPT          But for this line: <[[ref]]img src="http://other.domain.org/
│ │ │ │ -      OUTPUT     logo.gif">
│ │ │ │ -      QUOTE        the local file cannot be found (no prefix match), so the
│ │ │ │ -      SET        image dimensions
│ │ │ │ -      UNDEF        will not be added.
│ │ │ │ -      UNSET
│ │ │ │ -      USE,_$       Order is important; last IMAGEURL tag takes precedence:
│ │ │ │ -      WHILE        <[[ref]]imageurl url="/" path="/var/www/htdocs/">
│ │ │ │ -      <!---        <[[ref]]imageurl url="/test/" path="/var/www/test/">
│ │ │ │ +Contents         <[[ref]]INC macroname1="increment1" [macroname2="increment2"
│ │ │ │ +  Introduction   ... ] [GLOBAL]>
│ │ │ │ +  License
│ │ │ │ +  Tutorial       ***** synopsis *****
│ │ │ │ +  Usage          The INC can be used for incrementing/decrementing a variable
│ │ │ │ +  HTP Tags       or for variable addition. The basic form is shown above.
│ │ │ │ +      ALTTEXT    The "increment" is anything that evaluates to a integer. It
│ │ │ │ +      BLOCK      can be a literal string or a macro preceeded by the '$'-
│ │ │ │ +      BLOCKDEF   operator. The macroname must be the name of a defined macro
│ │ │ │ +      DEF        that contains an integer. If the increment is ommitted it
│ │ │ │ +      FILE       defaults to 1. The effect of this operation is that the macro
│ │ │ │ +      IF         is redefined to contain the sum of its previous value and its
│ │ │ │ +  [>] INC        increment.
│ │ │ │ +      IMG        To increment or decrement a variable you can use this form:
│ │ │ │ +      IMAGEURL   Note that INC doesn't check if the strings really denote
│ │ │ │ +      OPT        integers. It may give weired results when used on arbitrary
│ │ │ │ +      OUTPUT     strings. The integer values are limited to the range -
│ │ │ │ +      QUOTE      2^31..2^31.
│ │ │ │ +      SET        Note further that htp wasn't designed to do extensive
│ │ │ │ +      UNDEF      calculations. The INC tag is useful in conjunction with WHILE
│ │ │ │ +      UNSET      to iterate over the defined blocks.
│ │ │ │ +      USE,_$
│ │ │ │ +      WHILE
│ │ │ │ +      <!---
│ │ │ │    History
│ │ │ │ -  Wish_list        <[[ref]]img src="/image.gif"> and <[[ref]]img src="/test/
│ │ │ │ -  Bugs           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.
│ │ │ │ -                 ***** synopsis *****
│ │ │ │ -                 The INC can be used for incrementing/decrementing a variable
│ │ │ │ -                 or for variable addition. The basic form is shown above.
│ │ │ │ -                 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.
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ +  Wish_list
│ │ │ │ +  Bugs
│ │ ├── ./usr/share/doc/htp/metatag.html
│ │ │ @@ -88,22 +88,14 @@
│ │ │  <P> Metatags are defined with the <a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>def</code></a> and <a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>blockdef</code></a> tags and
│ │ │  undefined with the <a href="undef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>undef</code></a> tag.  </P>
│ │ │  <P>
│ │ │  As an example we show how to define a tag that builds a
│ │ │  fancy horizontal rule out of several images.
│ │ │  </P>
│ │ │    <p><code>
│ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="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>
│ │ │ -<font size="-2">&nbsp;2. </font><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>
│ │ │ -<font size="-2">&nbsp;3. </font><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>
│ │ │ -<font size="-2">&nbsp;4. </font><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>
│ │ │ -<font size="-2">&nbsp;5. </font><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>
│ │ │ -<font size="-2">&nbsp;6. </font><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>
│ │ │ -<font size="-2">&nbsp;7. </font><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>
│ │ │ -<font size="-2">&nbsp;8. </font><br>
│ │ │  </code></p>
│ │ │  <P> In line 1 of the above example a new tag named imghr is defined.
│ │ │  The html code which implements this rule is following in lines 2-8.
│ │ │  between the <a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10"><code>def</code> and
│ │ │  <code>/def</code></a> tags.  You don't have to understand this
│ │ │  html code, but you should understand that this is just pure html to
│ │ │  draw the fancy rule. Every time you write <code>&lt;imghr&gt;</code>
│ │ │ @@ -113,43 +105,30 @@
│ │ │  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;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>&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; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span> <span class="htp-attrib">home_url</span> <span class="htp-attrib">login_name</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;2. </font>a><br>
│ │ │ -<font size="-2">&nbsp;3. </font><span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;4. </font><br>
│ │ │ -<font size="-2">&nbsp;5. </font><span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">morestuff</span>=<span class="htp-value"><span class="htp-macro">$email</span></span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;6. </font><br>
│ │ │ -<font size="-2">&nbsp;7. </font>This works: &nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">stuff</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;8. </font>But this fails: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">email</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;9. </font>And this fails: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">morestuff</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <p> 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
│ │ │ @@ -168,21 +147,23 @@
│ │ │  contents of block to be expanded twice.  If you omit it, it would be
│ │ │  expanded when defining the sect-1 macro and when using it later in the
│ │ │  template.  Generally it is a good idea to use noexpand whenever you
│ │ │  use expand in a block around it.</p>
│ │ │  <p>To close this example we show how to expand the
│ │ │  <code>sect-${sect-ctr}</code> blocks in the template:</p>
│ │ │    <p><code>
│ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"header.hti"</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">sect-ctr</span>=<span class="htp-string">"1"</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;4. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;5. </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">sect-ctr</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;6. </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;7. </font><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>
│ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ +<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">i</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;5. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;6. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;7. </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">sect-ctr</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;8. </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;9. </font><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>
│ │ │  The <a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> tag in line 3 checks whether
│ │ │  the macro sect-${sect-ctr} is defined.  If it is defined the body is
│ │ │  evaluated, which expands the macro and increases sect-ctr.  Afterwards
│ │ │  the while condition is checked again to check for sect-2 macro.  This
│ │ │  repeats until sect-${sect-ctr} is not defined.
│ │ │ ├── html2text {}
│ │ │ │ @@ -6,62 +6,40 @@
│ │ │ │    License        abbreviates. In fact metatags are just like block macros, but
│ │ │ │    Tutorial       they have a nicer syntax. With metatags you can expand htp's
│ │ │ │        Macros     functionality.
│ │ │ │        Including  Metatags are defined with the [[ref]]def and [[ref]]blockdef
│ │ │ │        Templates  tags and undefined with the [[ref]]undef tag.
│ │ │ │        Files      As an example we show how to define a tag that builds a fancy
│ │ │ │    [>] Metatags   horizontal rule out of several images.
│ │ │ │ -  Usage           1. <[[ref]]OPT (IMGXY|NOIMGXY)>
│ │ │ │ -  HTP_Tags        2. <[[ref]]OPT (QUIET|VERBOSE)>
│ │ │ │ -  History         3. <[[ref]]OPT (DEPEND|NODEPEND)>
│ │ │ │ -  Wish_list       4. <[[ref]]OPT (PRECIOUS|NOPRECIOUS)>
│ │ │ │ -  Bugs            5. <[[ref]]OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
│ │ │ │ -                  6. <[[ref]]OPT DELIM=(HTML|SQUARE|CURLY)>
│ │ │ │ -                  7. <[[ref]]OPT (XML|XML=FALSE)>
│ │ │ │ -                  8.
│ │ │ │ -                 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
│ │ │ │ +  Usage          In line 1 of the above example a new tag named imghr is
│ │ │ │ +  HTP_Tags       defined. The html code which implements this rule is following
│ │ │ │ +  History        in lines 2-8. between the [[ref]]def_and_/def tags. You don't
│ │ │ │ +  Wish_list      have to understand this html code, but you should understand
│ │ │ │ +  Bugs           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]]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>
│ │ │ │ -                  2. a>
│ │ │ │ -                  3. <[[ref]]/block>
│ │ │ │ -                  4.
│ │ │ │ -                  5. <[[ref]]set morestuff=$email>
│ │ │ │ -                  6.
│ │ │ │ -                  7. This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ -                  8. But this fails: <[[ref]]use email>
│ │ │ │ -                  9. And this fails: <[[ref]]use morestuff
│ │ │ │ -                 email="jnelson@crl.com">
│ │ │ │                   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
│ │ │ │ @@ -79,21 +57,23 @@
│ │ │ │                   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]]file include="header.hti">
│ │ │ │ -                  2.   <[[ref]]set sect-ctr="1">
│ │ │ │ -                  3.   <[[ref]]while sect-${sect-ctr}>
│ │ │ │ -                  4.     <[[ref]]use sect-${sect-ctr}>
│ │ │ │ -                  5.     <[[ref]]inc sect-ctr>
│ │ │ │ -                  6.   <[[ref]]/while>
│ │ │ │ -                  7. <[[ref]]file include="footer.hti">
│ │ │ │ +                  1.   <[[ref]]WHILE sect-$i>
│ │ │ │ +                  2.     ...
│ │ │ │ +                  3.     <[[ref]]INC i>
│ │ │ │ +                  4.   <[[ref]]/WHILE>
│ │ │ │ +                  5.   <[[ref]]while sect-${sect-ctr}>
│ │ │ │ +                  6.     <[[ref]]use sect-${sect-ctr}>
│ │ │ │ +                  7.     <[[ref]]inc sect-ctr>
│ │ │ │ +                  8.   <[[ref]]/while>
│ │ │ │ +                  9. <[[ref]]file include="footer.hti">
│ │ │ │                   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
│ │ ├── ./usr/share/doc/htp/opt.html
│ │ │ @@ -114,18 +114,14 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="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>
│ │ │ -<br>
│ │ │ -oname2="macrovalue2" ...] [GLOBAL]><br>
│ │ │ -<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 ...]>
│ │ │ │ -  Introduction
│ │ │ │ -  License        oname2="macrovalue2" ...] [GLOBAL]>
│ │ │ │ -  Tutorial
│ │ │ │ -  Usage          ***** synopsis *****
│ │ │ │ -  HTP Tags       OPT is an htp tag that can be used to specify processing
│ │ │ │ -      ALTTEXT    options inside the actual document being processed. The
│ │ │ │ -      BLOCK      options are used exactly as they would be on the command-line,
│ │ │ │ -      BLOCKDEF   although they are not preceded by a ‘-’ character.
│ │ │ │ -      DEF        Click here for more_information_on_using_customization_options
│ │ │ │ -      FILE       with_htp.
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   OPT is an htp tag that can be used to specify processing
│ │ │ │ +  License        options inside the actual document being processed. The
│ │ │ │ +  Tutorial       options are used exactly as they would be on the command-line,
│ │ │ │ +  Usage          although they are not preceded by a ‘-’ character.
│ │ │ │ +  HTP Tags       Click here for more_information_on_using_customization_options
│ │ │ │ +      ALTTEXT    with_htp.
│ │ │ │ +      BLOCK
│ │ │ │ +      BLOCKDEF
│ │ │ │ +      DEF
│ │ │ │ +      FILE
│ │ │ │        IF
│ │ │ │        INC
│ │ │ │        IMG
│ │ │ │        IMAGEURL
│ │ │ │    [>] OPT
│ │ │ │        OUTPUT
│ │ │ │        QUOTE
│ │ │ │ @@ -25,18 +25,14 @@
│ │ │ │        USE,_$
│ │ │ │        WHILE
│ │ │ │        <!---
│ │ │ │    History
│ │ │ │    Wish_list
│ │ │ │    Bugs
│ │ │ │  
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │     page_source
│ │ │ │     htp_project
│ │ │ │     htp_homepage
│ │ │ │  hosted by
│ │ │ │  Sourceforge
│ │ │ │  HTML coding
│ │ │ │  [Powered_by_htp]
│ │ ├── ./usr/share/doc/htp/output.html
│ │ │ @@ -114,17 +114,14 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="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>
│ │ │  <P> The <STRONG>OUTPUT</STRONG> tag can be used to create auxillary
│ │ │  files besides the main HTML file.  The text between this tag and the
│ │ │  corresponding &lt;/OUTPUT&gt; tag is written to output file. </P>
│ │ │  <P> Normally the outputfile is cleared before writing to it, but you
│ │ │  can use the APPEND attribute to extend an existing file.  The text
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,23 +1,23 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : OUTPUT ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]unset macroname>
│ │ │ │ -  Introduction   <[[ref]]unset macroname1 macroname2 ... >
│ │ │ │ -  License
│ │ │ │ -  Tutorial       ***** synopsis *****
│ │ │ │ -  Usage          The OUTPUT tag can be used to create auxillary files besides
│ │ │ │ -  HTP Tags       the main HTML file. The text between this tag and the
│ │ │ │ -      ALTTEXT    corresponding </OUTPUT> tag is written to output file.
│ │ │ │ -      BLOCK      Normally the outputfile is cleared before writing to it, but
│ │ │ │ -      BLOCKDEF   you can use the APPEND attribute to extend an existing file.
│ │ │ │ -      DEF        The text written to the file is normally not expanded, i.e.
│ │ │ │ -      FILE       all tags inside this block are not executed but written
│ │ │ │ -      IF         unmodified to the file. However, you can use the EXPAND
│ │ │ │ -      INC        attribute to override this behaviour.
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   The OUTPUT tag can be used to create auxillary files besides
│ │ │ │ +  License        the main HTML file. The text between this tag and the
│ │ │ │ +  Tutorial       corresponding </OUTPUT> tag is written to output file.
│ │ │ │ +  Usage          Normally the outputfile is cleared before writing to it, but
│ │ │ │ +  HTP Tags       you can use the APPEND attribute to extend an existing file.
│ │ │ │ +      ALTTEXT    The text written to the file is normally not expanded, i.e.
│ │ │ │ +      BLOCK      all tags inside this block are not executed but written
│ │ │ │ +      BLOCKDEF   unmodified to the file. However, you can use the EXPAND
│ │ │ │ +      DEF        attribute to override this behaviour.
│ │ │ │ +      FILE
│ │ │ │ +      IF
│ │ │ │ +      INC
│ │ │ │        IMG
│ │ │ │        IMAGEURL
│ │ │ │        OPT
│ │ │ │    [>] OUTPUT
│ │ │ │        QUOTE
│ │ │ │        SET
│ │ │ │        UNDEF
│ │ │ │ @@ -28,17 +28,14 @@
│ │ │ │    History
│ │ │ │    Wish_list
│ │ │ │    Bugs
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │     page_source
│ │ │ │     htp_project
│ │ │ │     htp_homepage
│ │ │ │  hosted by
│ │ │ │  Sourceforge
│ │ │ │  HTML coding
│ │ │ │  [Powered_by_htp]
│ │ ├── ./usr/share/doc/htp/quote.html
│ │ │ @@ -114,17 +114,14 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="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>
│ │ │  <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,19 +1,19 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : QUOTE ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]UNDEF tagname>
│ │ │ │ -  Introduction   <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ -  License
│ │ │ │ -  Tutorial       ***** synopsis *****
│ │ │ │ -  Usage          QUOTE is used to quote a macro that would otherwise be
│ │ │ │ -  HTP Tags       interpreted by HTP. It may be useful in conjunction with a
│ │ │ │ -      ALTTEXT    surrounding EXPANDed block to prevent early expansion of some
│ │ │ │ -      BLOCK      contained blocks. Note that '$' evaluation is still done
│ │ │ │ -      BLOCKDEF   inside a quote block.
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   QUOTE is used to quote a macro that would otherwise be
│ │ │ │ +  License        interpreted by HTP. It may be useful in conjunction with a
│ │ │ │ +  Tutorial       surrounding EXPANDed block to prevent early expansion of some
│ │ │ │ +  Usage          contained blocks. Note that '$' evaluation is still done
│ │ │ │ +  HTP Tags       inside a quote block.
│ │ │ │ +      ALTTEXT
│ │ │ │ +      BLOCK
│ │ │ │ +      BLOCKDEF
│ │ │ │        DEF
│ │ │ │        FILE
│ │ │ │        IF
│ │ │ │        INC
│ │ │ │        IMG
│ │ │ │        IMAGEURL
│ │ │ │        OPT
│ │ │ │ @@ -24,17 +24,14 @@
│ │ │ │        UNSET
│ │ │ │        USE,_$
│ │ │ │        WHILE
│ │ │ │        <!---
│ │ │ │    History
│ │ │ │    Wish_list
│ │ │ │    Bugs
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │     page_source
│ │ │ │     htp_project
│ │ │ │     htp_homepage
│ │ │ │  hosted by
│ │ │ │  Sourceforge
│ │ │ │  HTML coding
│ │ │ │  [Powered_by_htp]
│ │ ├── ./usr/share/doc/htp/set.html
│ │ │ @@ -114,29 +114,24 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="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>
│ │ │  <STRONG>SET</STRONG> creates a macro definition that can later be expanded
│ │ │  anywhere in the HTML document.  To create a macro:
│ │ │    <p><code>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">sect-ctr</span>=<span class="htp-string">"0"</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">blockdef</a> <span class="htp-attrib">name</span>=<span class="htp-string">"section"</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">inc</a> <span class="htp-attrib">sect-ctr</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">block</a> <span class="htp-attrib">name</span>=<span class="htp-string">"sect-<span class="htp-macro">${sect-ctr}</span>"</span> <span class="htp-attrib">expand</span> <span class="htp-attrib">global</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">block</span> <span class="htp-attrib">noexpand</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="blockdef.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/blockdef</a>&gt;</span><br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"sharedimg"</span> <span class="htp-attrib">option</span>=<span class="htp-string">"name alt"</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"/home/sharedimages/<span class="htp-macro">${name}</span>"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"<span class="htp-macro">${alt}</span>"</span>&gt;</span>;<br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;sharedimg <span class="htp-attrib">name</span>=<span class="htp-string">"bubble.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Bubble image"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  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,41 +1,37 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : SET ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents         <[[ref]]UNDEF tagname>
│ │ │ │ -  Introduction   <[[ref]]UNDEF tagname1 tagname2 ... >
│ │ │ │ -  License
│ │ │ │ -  Tutorial       ***** synopsis *****
│ │ │ │ -  Usage          SET creates a macro definition that can later be expanded
│ │ │ │ -  HTP Tags       anywhere in the HTML document. To create a macro:
│ │ │ │ -      ALTTEXT      <[[ref]]set sect-ctr="0">
│ │ │ │ -      BLOCK        <[[ref]]blockdef name="section">
│ │ │ │ -      BLOCKDEF       <[[ref]]inc sect-ctr>
│ │ │ │ -      DEF            <[[ref]]block name="sect-${sect-ctr}" expand global>
│ │ │ │ -      FILE             <[[ref]]use block noexpand>
│ │ │ │ -      IF             <[[ref]]/block>
│ │ │ │ -      INC          <[[ref]]/blockdef>
│ │ │ │ -      IMG        The macro "emailaddr" can then be expanded later. The USE tag
│ │ │ │ -      IMAGEURL   is used to expand the macro outside a tag (i.e., into the
│ │ │ │ -      OPT        regular text). If the macro needs to be expanded inside a
│ │ │ │ -      OUTPUT     markup tag, use the '$' operator.
│ │ │ │ -      QUOTE      Multiple macros can be declared in a single markup tag, as the
│ │ │ │ -  [>] SET        second syntax line shows.
│ │ │ │ -      UNDEF      SET should only be used for a single line's worth of text.
│ │ │ │ -      UNSET      Multi-line macros can be defined with the BLOCK tag. The BLOCK
│ │ │ │ -      USE,_$     tag is also useful if the macro contains a quotation character
│ │ │ │ -      WHILE      and you don't want to fool around with special escape
│ │ │ │ -      <!---      characters.
│ │ │ │ -  History        Macros can be redefined by using another SET command with the
│ │ │ │ -  Wish_list      same macro name. The prior definition will be destroyed,
│ │ │ │ -  Bugs           however. Also, the macro can be removed (destroyed) with the
│ │ │ │ -                 UNSET tag.
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   SET creates a macro definition that can later be expanded
│ │ │ │ +  License        anywhere in the HTML document. To create a macro:
│ │ │ │ +  Tutorial         <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ +  Usage              <[[ref]]img src="/home/sharedimages/${name}" alt="$
│ │ │ │ +  HTP Tags       {alt}">;
│ │ │ │ +      ALTTEXT      <[[ref]]/def>
│ │ │ │ +      BLOCK
│ │ │ │ +      BLOCKDEF     <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ +      DEF        The macro "emailaddr" can then be expanded later. The USE tag
│ │ │ │ +      FILE       is used to expand the macro outside a tag (i.e., into the
│ │ │ │ +      IF         regular text). If the macro needs to be expanded inside a
│ │ │ │ +      INC        markup tag, use the '$' operator.
│ │ │ │ +      IMG        Multiple macros can be declared in a single markup tag, as the
│ │ │ │ +      IMAGEURL   second syntax line shows.
│ │ │ │ +      OPT        SET should only be used for a single line's worth of text.
│ │ │ │ +      OUTPUT     Multi-line macros can be defined with the BLOCK tag. The BLOCK
│ │ │ │ +      QUOTE      tag is also useful if the macro contains a quotation character
│ │ │ │ +  [>] SET        and you don't want to fool around with special escape
│ │ │ │ +      UNDEF      characters.
│ │ │ │ +      UNSET      Macros can be redefined by using another SET command with the
│ │ │ │ +      USE,_$     same macro name. The prior definition will be destroyed,
│ │ │ │ +      WHILE      however. Also, the macro can be removed (destroyed) with the
│ │ │ │ +      <!---      UNSET tag.
│ │ │ │ +  History
│ │ │ │ +  Wish_list
│ │ │ │ +  Bugs
│ │ ├── ./usr/share/doc/htp/tut/jh.html
│ │ │ @@ -16,10 +16,10 @@
│ │ │  <tr><td><b>Phone:</b></td><td>+49 761 203-8243</td></tr>
│ │ │  <tr><td><b>Fax:</b></td><td>+49 761 203-8242</td></tr>
│ │ │  </table>
│ │ │     </td></tr>
│ │ │    </table>
│ │ │    <hr>
│ │ │    Copyright by <a href="mailto:webmaster@domain.com">Joe Doe</a>.<br>
│ │ │ -  last updated Tue Apr 21, 2026
│ │ │ +  last updated Sat Jun 13, 2026
│ │ │   </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 Tue Apr 21, 2026
│ │ │ │ +last updated Sat Jun 13, 2026
│ │ ├── ./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 Tue Apr 21, 2026
│ │ │ +last updated Sat Jun 13, 2026
│ │ │  </body>
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,3 +1,3 @@
│ │ │ │  This page was produced by htp.
│ │ │ │  ===============================================================================
│ │ │ │ -Copyright by Joe Doe, webmaster@domain.com, last updated Tue Apr 21, 2026
│ │ │ │ +Copyright by Joe Doe, webmaster@domain.com, last updated Sat Jun 13, 2026
│ │ ├── ./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 Tue Apr 21, 2026
│ │ │ +  last updated Sat Jun 13, 2026
│ │ │   </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 Tue Apr 21, 2026
│ │ │ │ +last updated Sat Jun 13, 2026
│ │ ├── ./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 Tue Apr 21, 2026
│ │ │ +  last updated Sat Jun 13, 2026
│ │ │   </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 Tue Apr 21, 2026
│ │ │ │ +last updated Sat Jun 13, 2026
│ │ ├── ./usr/share/doc/htp/undef.html
│ │ │ @@ -114,15 +114,14 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -&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>
│ │ │  </code></p>
│ │ │  <h2>synopsis</h2>
│ │ │  <P><STRONG>UNDEF</STRONG> removes a metatag definition.  Metatags
│ │ │  created by <A HREF="def.html">DEF</A> and <A
│ │ │  HREF="blockdef.html">BLOCKDEF</A> can be removed with the UNDEF
│ │ │  command.  Once removed, the metatag will no longer be recognized by
│ │ │  htp until it is reassigned.  </P>
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,18 +1,18 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : UNDEF ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents             <[[ref]]SET emailaddr="jnelson@crl.com">
│ │ │ │ -  Introduction   ***** synopsis *****
│ │ │ │ -  License        UNDEF removes a metatag definition. Metatags created by DEF
│ │ │ │ -  Tutorial       and BLOCKDEF can be removed with the UNDEF command. Once
│ │ │ │ -  Usage          removed, the metatag will no longer be recognized by htp until
│ │ │ │ -  HTP Tags       it is reassigned.
│ │ │ │ -      ALTTEXT    Multiple metatags can be removed by placing each name as an
│ │ │ │ -      BLOCK      attribute.
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   UNDEF removes a metatag definition. Metatags created by DEF
│ │ │ │ +  License        and BLOCKDEF can be removed with the UNDEF command. Once
│ │ │ │ +  Tutorial       removed, the metatag will no longer be recognized by htp until
│ │ │ │ +  Usage          it is reassigned.
│ │ │ │ +  HTP Tags       Multiple metatags can be removed by placing each name as an
│ │ │ │ +      ALTTEXT    attribute.
│ │ │ │ +      BLOCK
│ │ │ │        BLOCKDEF
│ │ │ │        DEF
│ │ │ │        FILE
│ │ │ │        IF
│ │ │ │        INC
│ │ │ │        IMG
│ │ │ │        IMAGEURL
│ │ │ │ @@ -25,15 +25,14 @@
│ │ │ │        USE,_$
│ │ │ │        WHILE
│ │ │ │        <!---
│ │ │ │    History
│ │ │ │    Wish_list
│ │ │ │    Bugs
│ │ │ │  
│ │ │ │ -
│ │ │ │     page_source
│ │ │ │     htp_project
│ │ │ │     htp_homepage
│ │ │ │  hosted by
│ │ │ │  Sourceforge
│ │ │ │  HTML coding
│ │ │ │  [Powered_by_htp]
│ │ ├── ./usr/share/doc/htp/unset.html
│ │ │ @@ -114,37 +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>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">SET</a> <span class="htp-attrib">emailaddr</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">def</a> <span class="htp-attrib">name</span>=<span class="htp-string">"sharedimg"</span> <span class="htp-attrib">option</span>=<span class="htp-string">"name alt"</span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="img.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">img</a> <span class="htp-attrib">src</span>=<span class="htp-string">"/home/sharedimages/<span class="htp-macro">${name}</span>"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"<span class="htp-macro">${alt}</span>"</span>&gt;</span>;<br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="def.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/def</a>&gt;</span><br>
│ │ │ +<br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;sharedimg <span class="htp-attrib">name</span>=<span class="htp-string">"bubble.gif"</span> <span class="htp-attrib">alt</span>=<span class="htp-string">"Bubble image"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <h2>synopsis</h2>
│ │ │  <STRONG>UNSET</STRONG> removes (or deletes) a macro and it's definition.
│ │ │  The macro is subsequently not available for use in the pre-processed files.
│ │ │  (Note that simply redefining the macro with another <A HREF="set.html">SET</A> or
│ │ │  <A HREF="block.html">BLOCK</A> definition with the same name is acceptable.  The
│ │ │  old macro definition will be removed automatically.)
│ │ │  <P>
│ │ │  For example:
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">[NOT]</span> <span class="htp-attrib">conditional</span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; block<br>
│ │ │ -<span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ -<br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  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>
│ │ │  </code></p>
│ │ │  <p>
│ │ │  </td>
│ │ │  </tr>
│ │ │  <tr>
│ │ │  <td width="20%" bgcolor="white" valign="bottom">
│ │ │   <table border="0" cellspacing="0" cellpadding="0" width="100%">
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,28 +1,28 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : UNSET ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents             <[[ref]]SET emailaddr="jnelson@crl.com">
│ │ │ │ -  Introduction   ***** synopsis *****
│ │ │ │ -  License        UNSET removes (or deletes) a macro and it's definition. The
│ │ │ │ -  Tutorial       macro is subsequently not available for use in the pre-
│ │ │ │ -  Usage          processed files. (Note that simply redefining the macro with
│ │ │ │ -  HTP Tags       another SET or BLOCK definition with the same name is
│ │ │ │ -      ALTTEXT    acceptable. The old macro definition will be removed
│ │ │ │ -      BLOCK      automatically.)
│ │ │ │ -      BLOCKDEF   For example:
│ │ │ │ -      DEF        <[[ref]]WHILE [NOT] conditional>
│ │ │ │ -      FILE           block
│ │ │ │ -      IF         <[[ref]]/WHILE>
│ │ │ │ -      INC
│ │ │ │ -      IMG        More than one macro may be removed in the same tag:
│ │ │ │ -      IMAGEURL     <[[ref]]WHILE NOT i="10">
│ │ │ │ -      OPT            ...
│ │ │ │ -      OUTPUT         <[[ref]]INC i>
│ │ │ │ -      QUOTE        <[[ref]]/WHILE>
│ │ │ │ +Contents           <[[ref]]def name="sharedimg" option="name alt">
│ │ │ │ +  Introduction       <[[ref]]img src="/home/sharedimages/${name}" alt="$
│ │ │ │ +  License        {alt}">;
│ │ │ │ +  Tutorial         <[[ref]]/def>
│ │ │ │ +  Usage
│ │ │ │ +  HTP Tags         <sharedimg name="bubble.gif" alt="Bubble image">
│ │ │ │ +      ALTTEXT    ***** synopsis *****
│ │ │ │ +      BLOCK      UNSET removes (or deletes) a macro and it's definition. The
│ │ │ │ +      BLOCKDEF   macro is subsequently not available for use in the pre-
│ │ │ │ +      DEF        processed files. (Note that simply redefining the macro with
│ │ │ │ +      FILE       another SET or BLOCK definition with the same name is
│ │ │ │ +      IF         acceptable. The old macro definition will be removed
│ │ │ │ +      INC        automatically.)
│ │ │ │ +      IMG        For example:
│ │ │ │ +      IMAGEURL   More than one macro may be removed in the same tag:
│ │ │ │ +      OPT
│ │ │ │ +      OUTPUT
│ │ │ │ +      QUOTE
│ │ │ │        SET
│ │ │ │        UNDEF
│ │ │ │    [>] UNSET
│ │ │ │        USE,_$
│ │ │ │        WHILE
│ │ │ │        <!---
│ │ │ │    History
│ │ │ │ @@ -31,17 +31,14 @@
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -
│ │ │ │  
│ │ │ │  
│ │ │ │     page_source
│ │ │ │     htp_project
│ │ │ │     htp_homepage
│ │ │ │  hosted by
│ │ │ │  Sourceforge
│ │ ├── ./usr/share/doc/htp/use.html
│ │ │ @@ -114,15 +114,14 @@
│ │ │        <a class="noline" href="bugs.html">Bugs</a></td></tr>
│ │ │    </table>
│ │ │    </div>
│ │ │  </td>
│ │ │  <td bgcolor="#f0f0d0" rowspan="2" valign="top">
│ │ │  <h2>syntax</h2>
│ │ │    <p><code>
│ │ │ -&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>
│ │ │  <h2>synopsis</h2>
│ │ │  <strong>USE</strong> will expand macros that have been previously
│ │ │  declared with either <A HREF="set.html">SET</A> or <A
│ │ │  HREF="block.html">BLOCK</A>.  USE can only be used outside of other
│ │ │  markup tags.
│ │ │  <p> If you USE a block macro the value of expanded block macros will
│ │ │ @@ -132,21 +131,23 @@
│ │ │  attribute to prevent further expansion.  </p>
│ │ │  <p> USE will accept additional parameters, which are "local" macros
│ │ │  for the expanded macro.  This is only valid for <A
│ │ │  HREF="block.html">BLOCK</A> macros.  Macros created using <A
│ │ │  HREF="set.html">SET</A> cannot have parameters passed.  For
│ │ │  example:</p>
│ │ │    <p><code>
│ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"header.hti"</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;2. </font>&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">sect-ctr</span>=<span class="htp-string">"1"</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;3. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;4. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;5. </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">sect-ctr</span>&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;6. </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;7. </font><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>
│ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="unset.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">unset</a> <span class="htp-attrib">email_addr</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;2. </font>=$email>send email<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;3. </font><span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;4. </font><br>
│ │ │ +<font size="-2">&nbsp;5. </font><span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">morestuff</span>=<span class="htp-value"><span class="htp-macro">$email</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;6. </font><br>
│ │ │ +<font size="-2">&nbsp;7. </font>This works: &nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">stuff</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;8. </font>But this fails: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">email</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;9. </font>And this fails: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">morestuff</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  (See below for a description of the '$' operator.)  The example on
│ │ │  line 7 works because "stuff" has been declared as a block macro, and
│ │ │  the tag is passing the "email" macro to the "stuff" macro.  Line 8
│ │ │  fails because the "email" macro is unavailable once the block macro is
│ │ │  completely expanded, and cannot be passed to a SET macro.
│ │ │ @@ -157,16 +158,23 @@
│ │ │  Inside a markup tag, like <a href="img.html">IMG</a>, A (anchor), or
│ │ │  any other standard HTML or htp tag, the '$' operator must be used.
│ │ │  The '$' should be immediately followed by the macro name, which may or
│ │ │  may not be surrounded by curly braces.  When htp encounters this it
│ │ │  replaces the macro name by the contents of the macro without further
│ │ │  processing the contents.
│ │ │    <p><code>
│ │ │ -<font size="-2">&nbsp;1. </font><span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"mailto:<span class="htp-macro">$email</span>"</span>&gt;</span>mailto hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ -<font size="-2">&nbsp;2. </font><span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"http://<span class="htp-macro">$domain</span>/~<span class="htp-macro">${username}</span>/"</span>&gt;</span>another hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;1. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;2. </font>&nbsp; &nbsp; ...<br>
│ │ │ +<font size="-2">&nbsp;3. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">i</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;4. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;5. </font>&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;6. </font>&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;7. </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">sect-ctr</span>&gt;</span><br>
│ │ │ +<font size="-2">&nbsp;8. </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;9. </font><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>
│ │ │  The use of curly braces is encouraged, since it is more robust and
│ │ │  should never cause confusion with surrounding text.  If no curly
│ │ │  braces are used the macro name consists either of a single punctuation
│ │ │  character or the maximum sequence of letters, digits, &quot;-&quot;
│ │ │  and &quot;_&quot; that follows it.
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,48 +1,56 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : USE, $ ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents             <[[ref]]unset email_addr home_url login_name>
│ │ │ │ -  Introduction   ***** synopsis *****
│ │ │ │ -  License        USE will expand macros that have been previously declared with
│ │ │ │ -  Tutorial       either SET or BLOCK. USE can only be used outside of other
│ │ │ │ -  Usage          markup tags.
│ │ │ │ -  HTP Tags       If you USE a block macro the value of expanded block macros
│ │ │ │ -      ALTTEXT    will be further parsed by htp. This is maybe not what you
│ │ │ │ -      BLOCK      want, for example, if the use is inside a block which expands
│ │ │ │ -      BLOCKDEF   itself. You can use the noexpand attribute to prevent further
│ │ │ │ -      DEF        expansion.
│ │ │ │ -      FILE       USE will accept additional parameters, which are "local"
│ │ │ │ -      IF         macros for the expanded macro. This is only valid for BLOCK
│ │ │ │ -      INC        macros. Macros created using SET cannot have parameters
│ │ │ │ -      IMG        passed. For example:
│ │ │ │ -      IMAGEURL    1. <[[ref]]file include="header.hti">
│ │ │ │ -      OPT         2.   <[[ref]]set sect-ctr="1">
│ │ │ │ -      OUTPUT      3.   <[[ref]]while sect-${sect-ctr}>
│ │ │ │ -      QUOTE       4.     <[[ref]]use sect-${sect-ctr}>
│ │ │ │ -      SET         5.     <[[ref]]inc sect-ctr>
│ │ │ │ -      UNDEF       6.   <[[ref]]/while>
│ │ │ │ -      UNSET       7. <[[ref]]file include="footer.hti">
│ │ │ │ -  [>] USE,_$     (See below for a description of the '$' operator.) The example
│ │ │ │ -      WHILE      on line 7 works because "stuff" has been declared as a block
│ │ │ │ -      <!---      macro, and the tag is passing the "email" macro to the "stuff"
│ │ │ │ -  History        macro. Line 8 fails because the "email" macro is unavailable
│ │ │ │ -  Wish_list      once the block macro is completely expanded, and cannot be
│ │ │ │ -  Bugs           passed to a SET macro.
│ │ │ │ +Contents         ***** synopsis *****
│ │ │ │ +  Introduction   USE will expand macros that have been previously declared with
│ │ │ │ +  License        either SET or BLOCK. USE can only be used outside of other
│ │ │ │ +  Tutorial       markup tags.
│ │ │ │ +  Usage          If you USE a block macro the value of expanded block macros
│ │ │ │ +  HTP Tags       will be further parsed by htp. This is maybe not what you
│ │ │ │ +      ALTTEXT    want, for example, if the use is inside a block which expands
│ │ │ │ +      BLOCK      itself. You can use the noexpand attribute to prevent further
│ │ │ │ +      BLOCKDEF   expansion.
│ │ │ │ +      DEF        USE will accept additional parameters, which are "local"
│ │ │ │ +      FILE       macros for the expanded macro. This is only valid for BLOCK
│ │ │ │ +      IF         macros. Macros created using SET cannot have parameters
│ │ │ │ +      INC        passed. For example:
│ │ │ │ +      IMG         1.     <[[ref]]unset email_addr>
│ │ │ │ +      IMAGEURL    2. =$email>send email</a>
│ │ │ │ +      OPT         3. <[[ref]]/block>
│ │ │ │ +      OUTPUT      4.
│ │ │ │ +      QUOTE       5. <[[ref]]set morestuff=$email>
│ │ │ │ +      SET         6.
│ │ │ │ +      UNDEF       7. This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ +      UNSET       8. But this fails: <[[ref]]use email>
│ │ │ │ +  [>] USE,_$      9. And this fails: <[[ref]]use morestuff
│ │ │ │ +      WHILE      email="jnelson@crl.com">
│ │ │ │ +      <!---      (See below for a description of the '$' operator.) The example
│ │ │ │ +  History        on line 7 works because "stuff" has been declared as a block
│ │ │ │ +  Wish_list      macro, and the tag is passing the "email" macro to the "stuff"
│ │ │ │ +  Bugs           macro. Line 8 fails because the "email" macro is unavailable
│ │ │ │ +                 once the block macro is completely expanded, and cannot be
│ │ │ │ +                 passed to a SET macro.
│ │ │ │                   Note that the "email" macro is available to other macros or
│ │ │ │                   included files called within the "stuff" block.
│ │ │ │                   Inside a markup tag, like IMG, A (anchor), or any other
│ │ │ │                   standard HTML or htp tag, the '$' operator must be used. The
│ │ │ │                   '$' should be immediately followed by the macro name, which
│ │ │ │                   may or may not be surrounded by curly braces. When htp
│ │ │ │                   encounters this it replaces the macro name by the contents of
│ │ │ │                   the macro without further processing the contents.
│ │ │ │ -                  1. <a href="mailto:$email">mailto hyperlink</a>
│ │ │ │ -                  2. <a href="http://$domain/~${username}/">another hyperlink</
│ │ │ │ -                 a>
│ │ │ │ +                  1.   <[[ref]]WHILE sect-$i>
│ │ │ │ +                  2.     ...
│ │ │ │ +                  3.     <[[ref]]INC i>
│ │ │ │ +                  4.   <[[ref]]/WHILE>
│ │ │ │ +                  5.   <[[ref]]while sect-${sect-ctr}>
│ │ │ │ +                  6.     <[[ref]]use sect-${sect-ctr}>
│ │ │ │ +                  7.     <[[ref]]inc sect-ctr>
│ │ │ │ +                  8.   <[[ref]]/while>
│ │ │ │ +                  9. <[[ref]]file include="footer.hti">
│ │ │ │                   The use of curly braces is encouraged, since it is more robust
│ │ │ │                   and should never cause confusion with surrounding text. If no
│ │ │ │                   curly braces are used the macro name consists either of a
│ │ │ │                   single punctuation character or the maximum sequence of
│ │ │ │                   letters, digits, "-" and "_" that follows it.
│ │ │ │                   If a '$' character needs to be kept in the final output, and
│ │ │ │                   not interpreted as a macro name, it must be escaped by another
│ │ ├── ./usr/share/doc/htp/while.html
│ │ │ @@ -114,39 +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>
│ │ │ -&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>
│ │ │ +&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>
│ │ │ +=$email>send email<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ +<span class="htp-tag">&lt;<a href="block.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/block</a>&gt;</span><br>
│ │ │ +<br>
│ │ │ +<span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">morestuff</span>=<span class="htp-value"><span class="htp-macro">$email</span></span>&gt;</span><br>
│ │ │ +<br>
│ │ │ +This works: &nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">stuff</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │ +But this fails: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">email</span>&gt;</span><br>
│ │ │ +And this fails: <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">morestuff</span> <span class="htp-attrib">email</span>=<span class="htp-string">"jnelson@crl.com"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <h2>synopsis</h2>
│ │ │  <STRONG>WHILE</STRONG> is the building block for repeated processing.
│ │ │  The basic form is shown above.
│ │ │  <P>
│ │ │  "Conditional" is either a "compare" or "is defined" operation.
│ │ │  A compare operator is a test of the value of a macro against a literal string.
│ │ │  If the NOT tag is present in the WHILE markup, the evaluation of the
│ │ │  conditional is reversed:
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"header.hti"</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="set.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">set</a> <span class="htp-attrib">sect-ctr</span>=<span class="htp-string">"1"</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ -&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">inc</a> <span class="htp-attrib">sect-ctr</span>&gt;</span><br>
│ │ │ -&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/while</a>&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"footer.hti"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  Just as with <a href="if.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">IF</a> you can also check for a
│ │ │  macro's existance:
│ │ │    <p><code>
│ │ │ -<span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"mailto:<span class="htp-macro">$email</span>"</span>&gt;</span>mailto hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ -<span class="htp-tag">&lt;a <span class="htp-attrib">href</span>=<span class="htp-string">"http://<span class="htp-macro">$domain</span>/~<span class="htp-macro">${username}</span>/"</span>&gt;</span>another hyperlink<span class="htp-tag">&lt;/a&gt;</span><br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">WHILE</a> <span class="htp-attrib">sect-<span class="htp-macro">$i</span></span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; ...<br>
│ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">INC</a> <span class="htp-attrib">i</span>&gt;</span><br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/WHILE</a>&gt;</span><br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">while</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="use.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">use</a> <span class="htp-attrib">sect-<span class="htp-macro">${sect-ctr}</span></span>&gt;</span><br>
│ │ │ +&nbsp; &nbsp; <span class="htp-tag">&lt;<a href="inc.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">inc</a> <span class="htp-attrib">sect-ctr</span>&gt;</span><br>
│ │ │ +&nbsp; <span class="htp-tag">&lt;<a href="while.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">/while</a>&gt;</span><br>
│ │ │ +<span class="htp-tag">&lt;<a href="file.html" ><img src="pic/manual.png" border=0 alt="[ref]" width="10" height="10">file</a> <span class="htp-attrib">include</span>=<span class="htp-string">"footer.hti"</span>&gt;</span><br>
│ │ │  </code></p>
│ │ │  <P>
│ │ │  If the condition is true, the block is evaluated and afterwards the
│ │ │  WHILE tag is evaluated again.  If the '$'-operator is used in the
│ │ │  WHILE tag it is also reevaluated on each iteration.
│ │ │  <P>
│ │ │  A loop block <EM>must</EM> be closed with the /WHILE tag.
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,37 +1,45 @@
│ │ │ │  [HTP]
│ │ │ │  ****** htp on-line reference : WHILE ******
│ │ │ │  Table_of         ***** syntax *****
│ │ │ │ -Contents             <[[ref]]unset email_addr home_url login_name>
│ │ │ │ -  Introduction   ***** synopsis *****
│ │ │ │ -  License        WHILE is the building block for repeated processing. The basic
│ │ │ │ -  Tutorial       form is shown above.
│ │ │ │ -  Usage          "Conditional" is either a "compare" or "is defined" operation.
│ │ │ │ -  HTP Tags       A compare operator is a test of the value of a macro against a
│ │ │ │ -      ALTTEXT    literal string. If the NOT tag is present in the WHILE markup,
│ │ │ │ -      BLOCK      the evaluation of the conditional is reversed:
│ │ │ │ -      BLOCKDEF   <[[ref]]file include="header.hti">
│ │ │ │ -      DEF          <[[ref]]set sect-ctr="1">
│ │ │ │ -      FILE         <[[ref]]while sect-${sect-ctr}>
│ │ │ │ -      IF             <[[ref]]use sect-${sect-ctr}>
│ │ │ │ -      INC            <[[ref]]inc sect-ctr>
│ │ │ │ -      IMG          <[[ref]]/while>
│ │ │ │ -      IMAGEURL   <[[ref]]file include="footer.hti">
│ │ │ │ -      OPT        Just as with [[ref]]IF you can also check for a macro's
│ │ │ │ -      OUTPUT     existance:
│ │ │ │ -      QUOTE      <a href="mailto:$email">mailto hyperlink</a>
│ │ │ │ -      SET        <a href="http://$domain/~${username}/">another hyperlink</a>
│ │ │ │ -      UNDEF      If the condition is true, the block is evaluated and
│ │ │ │ -      UNSET      afterwards the WHILE tag is evaluated again. If the '$'-
│ │ │ │ -      USE,_$     operator is used in the WHILE tag it is also reevaluated on
│ │ │ │ -  [>] WHILE      each iteration.
│ │ │ │ -      <!---      A loop block must be closed with the /WHILE tag.
│ │ │ │ -  History
│ │ │ │ -  Wish_list
│ │ │ │ -  Bugs
│ │ │ │ +Contents             <[[ref]]unset email_addr>
│ │ │ │ +  Introduction   =$email>send email</a>
│ │ │ │ +  License        <[[ref]]/block>
│ │ │ │ +  Tutorial
│ │ │ │ +  Usage          <[[ref]]set morestuff=$email>
│ │ │ │ +  HTP Tags
│ │ │ │ +      ALTTEXT    This works:     <[[ref]]use stuff email="jnelson@crl.com">
│ │ │ │ +      BLOCK      But this fails: <[[ref]]use email>
│ │ │ │ +      BLOCKDEF   And this fails: <[[ref]]use morestuff email="jnelson@crl.com">
│ │ │ │ +      DEF        ***** synopsis *****
│ │ │ │ +      FILE       WHILE is the building block for repeated processing. The basic
│ │ │ │ +      IF         form is shown above.
│ │ │ │ +      INC        "Conditional" is either a "compare" or "is defined" operation.
│ │ │ │ +      IMG        A compare operator is a test of the value of a macro against a
│ │ │ │ +      IMAGEURL   literal string. If the NOT tag is present in the WHILE markup,
│ │ │ │ +      OPT        the evaluation of the conditional is reversed:
│ │ │ │ +      OUTPUT     Just as with [[ref]]IF you can also check for a macro's
│ │ │ │ +      QUOTE      existance:
│ │ │ │ +      SET          <[[ref]]WHILE sect-$i>
│ │ │ │ +      UNDEF          ...
│ │ │ │ +      UNSET          <[[ref]]INC i>
│ │ │ │ +      USE,_$       <[[ref]]/WHILE>
│ │ │ │ +  [>] WHILE        <[[ref]]while sect-${sect-ctr}>
│ │ │ │ +      <!---          <[[ref]]use sect-${sect-ctr}>
│ │ │ │ +  History            <[[ref]]inc sect-ctr>
│ │ │ │ +  Wish_list        <[[ref]]/while>
│ │ │ │ +  Bugs           <[[ref]]file include="footer.hti">
│ │ │ │ +                 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.
│ │ │ │ +
│ │ │ │ +
│ │ │ │ +