{"diffoscope-json-version": 1, "source1": "/srv/reproducible-results/rbuild-debian/r-b-build.ga3Rxe0M/b1/htp_1.19-8_amd64.changes", "source2": "/srv/reproducible-results/rbuild-debian/r-b-build.ga3Rxe0M/b2/htp_1.19-8_amd64.changes", "unified_diff": null, "details": [{"source1": "Files", "source2": "Files", "unified_diff": "@@ -1,3 +1,3 @@\n \n 10c498351f38ee5e38b27f5cc1d7d1b0 71032 debug optional htp-dbgsym_1.19-8_amd64.deb\n- 3e815a8e79e306abfc55a0526d3d8c40 117580 web optional htp_1.19-8_amd64.deb\n+ 3cc7c2d8e3210cb3c8c4ca5f4ed1b3d2 116776 web optional htp_1.19-8_amd64.deb\n"}, {"source1": "htp_1.19-8_amd64.deb", "source2": "htp_1.19-8_amd64.deb", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -1,3 +1,3 @@\n -rw-r--r-- 0 0 0 4 2020-06-14 23:21:19.000000 debian-binary\n--rw-r--r-- 0 0 0 3608 2020-06-14 23:21:19.000000 control.tar.xz\n--rw-r--r-- 0 0 0 113780 2020-06-14 23:21:19.000000 data.tar.xz\n+-rw-r--r-- 0 0 0 3616 2020-06-14 23:21:19.000000 control.tar.xz\n+-rw-r--r-- 0 0 0 112968 2020-06-14 23:21:19.000000 data.tar.xz\n"}, {"source1": "control.tar.xz", "source2": "control.tar.xz", "unified_diff": null, "details": [{"source1": "control.tar", "source2": "control.tar", "unified_diff": null, "details": [{"source1": "./control", "source2": "./control", "unified_diff": "@@ -1,12 +1,12 @@\n Package: htp\n Version: 1.19-8\n Architecture: amd64\n Maintainer: Marcelo Soares Mota \n-Installed-Size: 658\n+Installed-Size: 655\n Depends: libc6 (>= 2.38)\n Section: web\n Priority: optional\n Homepage: http://htp.sourceforge.net\n Description: nice HTML pre-processor\n htp is an HTML pre-processor. It is designed to be a flexible authoring tool\n that can easily be integrated into the HTML design process.\n"}, {"source1": "./md5sums", "source2": "./md5sums", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "comments": ["Files differ"], "unified_diff": null}]}]}]}, {"source1": "data.tar.xz", "source2": "data.tar.xz", "unified_diff": null, "details": [{"source1": "data.tar", "source2": "data.tar", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -1,27 +1,27 @@\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/bin/\n -rwxr-xr-x 0 root (0) root (0) 72104 2020-06-14 23:21:19.000000 ./usr/bin/htp\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/doc/\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/\n--rw-r--r-- 0 root (0) root (0) 15840 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.html\n+-rw-r--r-- 0 root (0) root (0) 8577 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.html\n -rw-r--r-- 0 root (0) root (0) 1418 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/alttext.htp\n--rw-r--r-- 0 root (0) root (0) 8267 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.html\n+-rw-r--r-- 0 root (0) root (0) 7882 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.html\n -rw-r--r-- 0 root (0) root (0) 781 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/block.htp\n -rw-r--r-- 0 root (0) root (0) 7941 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.html\n -rw-r--r-- 0 root (0) root (0) 1075 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/blockdef.htp\n -rw-r--r-- 0 root (0) root (0) 4763 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/bugs.html\n -rw-r--r-- 0 root (0) root (0) 737 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/bugs.htp\n -rw-r--r-- 0 root (0) root (0) 878 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/changelog.Debian.gz\n--rw-r--r-- 0 root (0) root (0) 8474 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.html\n+-rw-r--r-- 0 root (0) root (0) 7719 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.html\n -rw-r--r-- 0 root (0) root (0) 676 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/comment.htp\n -rw-r--r-- 0 root (0) root (0) 13083 2020-06-14 23:16:46.000000 ./usr/share/doc/htp/copyright\n--rw-r--r-- 0 root (0) root (0) 11412 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.html\n+-rw-r--r-- 0 root (0) root (0) 10237 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.html\n -rw-r--r-- 0 root (0) root (0) 3601 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/def.htp\n -rw-r--r-- 0 root (0) root (0) 8030 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/default.html\n -rw-r--r-- 0 root (0) root (0) 3149 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/default.htp\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/examples/\n -rw-r--r-- 0 root (0) root (0) 536 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/Makefile.sub\n -rw-r--r-- 0 root (0) root (0) 2404 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/album.hti\n -rw-r--r-- 0 root (0) root (0) 1087 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/album.htt\n@@ -32,64 +32,64 @@\n -rw-r--r-- 0 root (0) root (0) 818 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/prime.htp\n -rw-r--r-- 0 root (0) root (0) 1576 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/examples/quine.html\n -rw-r--r-- 0 root (0) root (0) 1576 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/quine.htp\n -rw-r--r-- 0 root (0) root (0) 604 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/section.def\n -rw-r--r-- 0 root (0) root (0) 1189 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/examples/section.html\n -rw-r--r-- 0 root (0) root (0) 918 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/section.htp\n -rw-r--r-- 0 root (0) root (0) 375 2015-05-16 17:04:11.000000 ./usr/share/doc/htp/examples/section.htt\n--rw-r--r-- 0 root (0) root (0) 8581 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.html\n+-rw-r--r-- 0 root (0) root (0) 8490 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.html\n -rw-r--r-- 0 root (0) root (0) 3702 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/expand.htp\n--rw-r--r-- 0 root (0) root (0) 18172 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.html\n+-rw-r--r-- 0 root (0) root (0) 14270 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.html\n -rw-r--r-- 0 root (0) root (0) 2490 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/file.htp.gz\n -rw-r--r-- 0 root (0) root (0) 14293 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/history.html\n -rw-r--r-- 0 root (0) root (0) 3946 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/history.htp.gz\n -rw-r--r-- 0 root (0) root (0) 3911 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/hlhtp.pl\n -rw-r--r-- 0 root (0) root (0) 165 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/htp.def\n -rw-r--r-- 0 root (0) root (0) 4049 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/htp.htt\n--rw-r--r-- 0 root (0) root (0) 12118 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.html\n+-rw-r--r-- 0 root (0) root (0) 9795 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.html\n -rw-r--r-- 0 root (0) root (0) 932 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/if.htp\n--rw-r--r-- 0 root (0) root (0) 8626 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html\n+-rw-r--r-- 0 root (0) root (0) 9130 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.html\n -rw-r--r-- 0 root (0) root (0) 2507 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/imageurl.htp\n--rw-r--r-- 0 root (0) root (0) 10512 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.html\n+-rw-r--r-- 0 root (0) root (0) 8277 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.html\n -rw-r--r-- 0 root (0) root (0) 1168 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/img.htp\n--rw-r--r-- 0 root (0) root (0) 8142 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.html\n+-rw-r--r-- 0 root (0) root (0) 10124 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.html\n -rw-r--r-- 0 root (0) root (0) 1092 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/inc.htp\n -rw-r--r-- 0 root (0) root (0) 9881 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/include.html\n -rw-r--r-- 0 root (0) root (0) 1894 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/include.htp\n -rw-r--r-- 0 root (0) root (0) 4874 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/index.html\n -rw-r--r-- 0 root (0) root (0) 78 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/index.htp\n -rw-r--r-- 0 root (0) root (0) 7733 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/intro.html\n -rw-r--r-- 0 root (0) root (0) 3489 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/intro.htp\n -rw-r--r-- 0 root (0) root (0) 10774 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/license.html\n -rw-r--r-- 0 root (0) root (0) 454 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/license.htp\n -rw-r--r-- 0 root (0) root (0) 3782 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/macros.def\n -rw-r--r-- 0 root (0) root (0) 5088 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/macros.html\n -rw-r--r-- 0 root (0) root (0) 388 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/macros.htp\n--rw-r--r-- 0 root (0) root (0) 18041 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.html\n+-rw-r--r-- 0 root (0) root (0) 14326 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.html\n -rw-r--r-- 0 root (0) root (0) 2439 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/metatag.htp.gz\n--rw-r--r-- 0 root (0) root (0) 7558 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.html\n+-rw-r--r-- 0 root (0) root (0) 13794 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.html\n -rw-r--r-- 0 root (0) root (0) 608 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/opt.htp\n -rw-r--r-- 0 root (0) root (0) 7809 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/options.html\n -rw-r--r-- 0 root (0) root (0) 3100 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/options.htp\n--rw-r--r-- 0 root (0) root (0) 7777 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html\n+-rw-r--r-- 0 root (0) root (0) 14013 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.html\n -rw-r--r-- 0 root (0) root (0) 695 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/output.htp\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/\n -rw-r--r-- 0 root (0) root (0) 171 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/arrow.png\n -rw-r--r-- 0 root (0) root (0) 262 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/download.png\n -rw-r--r-- 0 root (0) root (0) 708 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/htpicon.png\n -rw-r--r-- 0 root (0) root (0) 25563 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/logo.png\n -rw-r--r-- 0 root (0) root (0) 455 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/manbig.png\n -rw-r--r-- 0 root (0) root (0) 491 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/manual.png\n -rw-r--r-- 0 root (0) root (0) 1313 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/poweredbyhtp.png\n -rw-r--r-- 0 root (0) root (0) 679 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/sficon.png\n -rw-r--r-- 0 root (0) root (0) 492 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pic/source.png\n -rw-r--r-- 0 root (0) root (0) 523 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/pphtp.pl\n--rw-r--r-- 0 root (0) root (0) 7953 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.html\n+-rw-r--r-- 0 root (0) root (0) 13750 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.html\n -rw-r--r-- 0 root (0) root (0) 390 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/quote.htp\n--rw-r--r-- 0 root (0) root (0) 12327 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.html\n+-rw-r--r-- 0 root (0) root (0) 14481 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.html\n -rw-r--r-- 0 root (0) root (0) 1200 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/set.htp\n -rw-r--r-- 0 root (0) root (0) 500 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/styles.css\n -rw-r--r-- 0 root (0) root (0) 27219 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/template.html\n -rw-r--r-- 0 root (0) root (0) 2235 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/template.htp.gz\n -rw-r--r-- 0 root (0) root (0) 1914 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/toc.def\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/\n -rw-r--r-- 0 root (0) root (0) 146 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/footer.hti\n@@ -102,23 +102,23 @@\n -rw-r--r-- 0 root (0) root (0) 192 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut2.htp\n -rw-r--r-- 0 root (0) root (0) 501 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut3.html\n -rw-r--r-- 0 root (0) root (0) 191 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut3.htp\n -rw-r--r-- 0 root (0) root (0) 356 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut3.htt\n -rw-r--r-- 0 root (0) root (0) 297 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tut/tut4.htt\n -rw-r--r-- 0 root (0) root (0) 10517 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tutorial.html\n -rw-r--r-- 0 root (0) root (0) 3393 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/tutorial.htp\n--rw-r--r-- 0 root (0) root (0) 7883 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.html\n+-rw-r--r-- 0 root (0) root (0) 7559 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.html\n -rw-r--r-- 0 root (0) root (0) 460 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/undef.htp\n--rw-r--r-- 0 root (0) root (0) 14578 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.html\n+-rw-r--r-- 0 root (0) root (0) 16117 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.html\n -rw-r--r-- 0 root (0) root (0) 658 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/unset.htp\n -rw-r--r-- 0 root (0) root (0) 7681 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/usage.html\n -rw-r--r-- 0 root (0) root (0) 2959 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/usage.htp\n--rw-r--r-- 0 root (0) root (0) 16307 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.html\n+-rw-r--r-- 0 root (0) root (0) 13376 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.html\n -rw-r--r-- 0 root (0) root (0) 3300 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/use.htp\n--rw-r--r-- 0 root (0) root (0) 8923 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html\n+-rw-r--r-- 0 root (0) root (0) 8001 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.html\n -rw-r--r-- 0 root (0) root (0) 938 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/while.htp\n -rw-r--r-- 0 root (0) root (0) 5288 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/wishlist.html\n -rw-r--r-- 0 root (0) root (0) 1311 2020-06-14 23:21:19.000000 ./usr/share/doc/htp/wishlist.htp\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/doc-base/\n -rw-r--r-- 0 root (0) root (0) 235 2020-06-14 17:36:12.000000 ./usr/share/doc-base/htp.htp\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/lintian/\n drwxr-xr-x 0 root (0) root (0) 0 2020-06-14 23:21:19.000000 ./usr/share/lintian/overrides/\n"}, {"source1": "./usr/share/doc/htp/alttext.html", "source2": "./usr/share/doc/htp/alttext.html", "unified_diff": "@@ -114,62 +114,28 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-  <\"[ref]\"set time=\"0\">
\n-  <\"[ref]\"block name=a>
\n-    a is expanded at time <\"[ref]\"use time>.
\n-  <\"[ref]\"/block>
\n-  <\"[ref]\"block name=b expand>
\n-    b is expanded at time <\"[ref]\"use time>.
\n-  <\"[ref]\"/block>
\n-  <\"[ref]\"set time=\"1\">
\n-  <\"[ref]\"use a>
\n-  <\"[ref]\"use b>
\n-  contents of a: <\"[ref]\"use a noexpand>
\n-  contents of b: <\"[ref]\"use b noexpand>
\n-  <\"[ref]\"block name=c expand>
\n-    c is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a>
\n-  <\"[ref]\"/block>
\n-  <\"[ref]\"block name=d expand>
\n-    d is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n-  <\"[ref]\"/block>
\n-  <\"[ref]\"block name=e>
\n-    e is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n-  <\"[ref]\"/block>
\n-  <\"[ref]\"set time=\"2\">
\n-  <\"[ref]\"block name=a>
\n-    a is defined for the 2nd time <\"[ref]\"use time>.
\n-  <\"[ref]\"/block>
\n-  <\"[ref]\"use c>
\n-  <\"[ref]\"use d>
\n-  <\"[ref]\"use e>
\n

\n

synopsis

\n ALTTEXT declares an ALT attribute for any IMG tag with a SRC matching the ALTTEXT NAME.\n Since relative paths can be used to point to the same image, only the\n filename is considered in all comparisons.\n

\n When an IMG tag with a matching source is encountered, htp will add an ALT\n attribute only if one is not already present. This allows for ALT text to\n be overridden on specific images and default text on all others.\n

\n For example:\n

\n-<\"[ref]\"OPT (IMGXY|NOIMGXY)>
\n-<\"[ref]\"OPT (QUIET|VERBOSE)>
\n-<\"[ref]\"OPT (DEPEND|NODEPEND)>
\n-<\"[ref]\"OPT (PRECIOUS|NOPRECIOUS)>
\n-<\"[ref]\"OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
\n-<\"[ref]\"OPT DELIM=(HTML|SQUARE|CURLY)>
\n-<\"[ref]\"OPT (XML|XML=FALSE)>
\n+<\"[ref]\"imageurl url=\"imageurl\" [ path=\"path/in/local/filesystem\" ]>
\n
\n

\n

\n An ALTTEXT tag with a name but no text attribute removes any ALT\n mapping for this image. Successing IMG tags with a matching SRC name are not\n changed.\n

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,73 +1,36 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: A\bAL\bLT\bTT\bTE\bEX\bXT\bT *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"0\">\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl \u00a0 \u00a0 a is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n-\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 HTP Tags \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=b expand>\n-\u00a0 [>] _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 \u00a0 b is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"1\">\n-\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b>\n-\u00a0 \u00a0 _\bI_\bF \u00a0 contents of a: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n-\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 contents of b: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b noexpand>\n-\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=c expand>\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 \u00a0 c is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n-\u00a0 \u00a0 _\bO_\bP_\bT _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=d expand>\n-\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 \u00a0 d is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=e>\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 e is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"2\">\n-\u00a0 _\bB_\bu_\bg_\bs \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n- \u00a0 \u00a0 a is defined for the 2nd time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be\n- time>.\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be c>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be d>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be e>\n- *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n- A\bAL\bLT\bTT\bTE\bEX\bXT\bT declares an ALT attribute for any _\bI_\bM_\bG tag\n- with a SRC matching the ALTTEXT NAME. Since\n- relative paths can be used to point to the same\n- image, only the filename is considered in all\n- comparisons.\n- When an IMG tag with a matching source is\n- encountered, htp will add an ALT attribute only if\n- one is not already present. This allows for ALT\n- text to be overridden on specific images and\n- default text on all others.\n- For example:\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (IMGXY|NOIMGXY)>\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (QUIET|VERBOSE)>\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (DEPEND|NODEPEND)>\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (PRECIOUS|NOPRECIOUS)>\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (CONDENSE|SEMICONDENSE|NOCONDENSE)>\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT DELIM=(HTML|SQUARE|CURLY)>\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (XML|XML=FALSE)>\n-\n- An ALTTEXT tag with a name but no text attribute\n- removes any ALT mapping for this image. Successing\n- IMG tags with a matching SRC name are not changed.\n- Since this is useful for an image used throughout a\n- set of documents, ALTTEXT is most appropriate in an\n- _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b _\bf_\bi_\bl_\be or a _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b _\bf_\bi_\bl_\be.\n- In addition to ALTTEXT, htp can also automatically\n- add WIDTH and HEIGHT attributes to _\bI_\bM_\bG tags.\n-\n-\n-\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be A\bAL\bLT\bTT\bTE\bEX\bXT\bT declares an ALT attribute for any _\bI_\bM_\bG tag\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl with a SRC matching the ALTTEXT NAME. Since\n+\u00a0 _\bU_\bs_\ba_\bg_\be relative paths can be used to point to the same\n+\u00a0 HTP Tags image, only the filename is considered in all\n+\u00a0 [>] _\bA_\bL_\bT_\bT_\bE_\bX_\bT comparisons.\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK When an IMG tag with a matching source is\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF encountered, htp will add an ALT attribute only if\n+\u00a0 \u00a0 _\bD_\bE_\bF one is not already present. This allows for ALT\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE text to be overridden on specific images and\n+\u00a0 \u00a0 _\bI_\bF default text on all others.\n+\u00a0 \u00a0 _\bI_\bN_\bC For example:\n+\u00a0 \u00a0 _\bI_\bM_\bG <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\ba_\bg_\be_\bu_\br_\bl url=\"imageurl\" [ path=\"path/in/\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL local/filesystem\" ]>\n+\u00a0 \u00a0 _\bO_\bP_\bT\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT An ALTTEXT tag with a name but no text attribute\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE removes any ALT mapping for this image. Successing\n+\u00a0 \u00a0 _\bS_\bE_\bT IMG tags with a matching SRC name are not changed.\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF Since this is useful for an image used throughout a\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT set of documents, ALTTEXT is most appropriate in an\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b _\bf_\bi_\bl_\be or a _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b _\bf_\bi_\bl_\be.\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE In addition to ALTTEXT, htp can also automatically\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- add WIDTH and HEIGHT attributes to _\bI_\bM_\bG tags.\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n+\u00a0 _\bB_\bu_\bg_\bs\n \n \n \n \n \n \n \n"}]}, {"source1": "./usr/share/doc/htp/block.html", "source2": "./usr/share/doc/htp/block.html", "unified_diff": "@@ -114,16 +114,14 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-<\"[ref]\"imageurl url=\"imageurl\" [ path=\"path/in/local/filesystem\" ]>
\n-
\n

\n

synopsis

\n

\n BLOCK and /BLOCK are used to create block macros, which\n are similar in use to SET macros, but can be\n multi-line definitions.\n

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,25 +1,25 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: B\bBL\bLO\bOC\bCK\bK,\b, /\b/B\bBL\bLO\bOC\bCK\bK *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\ba_\bg_\be_\bu_\br_\bl url=\"imageurl\" [ path=\"path/in/\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be local/filesystem\" ]>\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl\n-\u00a0 _\bU_\bs_\ba_\bg_\be *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 HTP Tags B\bBL\bLO\bOC\bCK\bK a\ban\bnd\bd /\b/B\bBL\bLO\bOC\bCK\bK are used to create block macros,\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT which are similar in use to _\bS_\bE_\bT macros, but can be\n-\u00a0 [>] _\bB_\bL_\bO_\bC_\bK multi-line definitions.\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF Any text and formatting may be set inside the\n-\u00a0 \u00a0 _\bD_\bE_\bF block. You can use any htp or user defined metatag\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE including _\bF_\bI_\bL_\bE_\b _\bI_\bN_\bC_\bL_\bU_\bD_\bE. The metatags won't be\n-\u00a0 \u00a0 _\bI_\bF expanded before the block is USEd except if you\n-\u00a0 \u00a0 _\bI_\bN_\bC give the _\bE_\bX_\bP_\bA_\bN_\bD parameter.\n-\u00a0 \u00a0 _\bI_\bM_\bG The block macro is dereferenced (expanded) with the\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL _\bU_\bS_\bE_\b _\bt_\ba_\bg_\b _\bo_\br_\b _\bt_\bh_\be_\b _\b'_\b$_\b'_\b _\bo_\bp_\be_\br_\ba_\bt_\bo_\br. See the notes on the\n-\u00a0 \u00a0 _\bO_\bP_\bT _\bU_\bS_\bE tag on how to pass parameters to a block macro.\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be B\bBL\bLO\bOC\bCK\bK a\ban\bnd\bd /\b/B\bBL\bLO\bOC\bCK\bK are used to create block macros,\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl which are similar in use to _\bS_\bE_\bT macros, but can be\n+\u00a0 _\bU_\bs_\ba_\bg_\be multi-line definitions.\n+\u00a0 HTP Tags Any text and formatting may be set inside the\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT block. You can use any htp or user defined metatag\n+\u00a0 [>] _\bB_\bL_\bO_\bC_\bK including _\bF_\bI_\bL_\bE_\b _\bI_\bN_\bC_\bL_\bU_\bD_\bE. The metatags won't be\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF expanded before the block is USEd except if you\n+\u00a0 \u00a0 _\bD_\bE_\bF give the _\bE_\bX_\bP_\bA_\bN_\bD parameter.\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE The block macro is dereferenced (expanded) with the\n+\u00a0 \u00a0 _\bI_\bF _\bU_\bS_\bE_\b _\bt_\ba_\bg_\b _\bo_\br_\b _\bt_\bh_\be_\b _\b'_\b$_\b'_\b _\bo_\bp_\be_\br_\ba_\bt_\bo_\br. See the notes on the\n+\u00a0 \u00a0 _\bI_\bN_\bC _\bU_\bS_\bE tag on how to pass parameters to a block macro.\n+\u00a0 \u00a0 _\bI_\bM_\bG\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n+\u00a0 \u00a0 _\bO_\bP_\bT\n \u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT\n \u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE\n \u00a0 \u00a0 _\bS_\bE_\bT\n \u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF\n \u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n \u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n \u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE\n@@ -29,17 +29,14 @@\n \u00a0 _\bB_\bu_\bg_\bs\n \n \n \n \n \n \n-\n-\n-\n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n \u00a0 _\bh_\bt_\bp_\b _\bp_\br_\bo_\bj_\be_\bc_\bt\n \u00a0 _\bh_\bt_\bp_\b _\bh_\bo_\bm_\be_\bp_\ba_\bg_\be\n hosted by\n _\bS_\bo_\bu_\br_\bc_\be_\bf_\bo_\br_\bg_\be\n HTML coding_\b[_\bP_\bo_\bw_\be_\br_\be_\bd_\b _\bb_\by\n _\bh_\bt_\bp_\b]\n"}]}, {"source1": "./usr/share/doc/htp/comment.html", "source2": "./usr/share/doc/htp/comment.html", "unified_diff": "@@ -114,27 +114,14 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-<\"[ref]\"IF [NOT] conditional>
\n-    block #1
\n-[
\n-<ELSEIF [NOT] conditional>
\n-    block #2
\n-...
\n-]
\n-[
\n-<ELSE>
\n-    block #3
\n-]
\n-<\"[ref]\"/IF>
\n-
\n

\n

synopsis

\n

\n This is a simple comment that is not included in the output. This is useful\n when commenting metatags, since the metatags do not appear the output either.\n Example:\n

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,54 +1,41 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: <\b\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0 block #1\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl [\n-\u00a0 _\bU_\bs_\ba_\bg_\be \n-\u00a0 HTP Tags \u00a0 \u00a0 block #2\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT ...\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK ]\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF [\n-\u00a0 \u00a0 _\bD_\bE_\bF \n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 \u00a0 block #3\n-\u00a0 \u00a0 _\bI_\bF ]\n-\u00a0 \u00a0 _\bI_\bN_\bC <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be This is a simple comment that is not included in\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl the output. This is useful when commenting\n+\u00a0 _\bU_\bs_\ba_\bg_\be metatags, since the metatags do not appear the\n+\u00a0 HTP Tags output either. Example:\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT Note that these comments should not include < or >,\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK that is you should not use it to comment out htp\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF code. For that purpose use something like this:\n+\u00a0 \u00a0 _\bD_\bE_\bF Make sure that the variable is never defined and\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE xyz should be the reason why you don't want to\n+\u00a0 \u00a0 _\bI_\bF include this block\n+\u00a0 \u00a0 _\bI_\bN_\bC\n \u00a0 \u00a0 _\bI_\bM_\bG\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 \u00a0 _\bO_\bP_\bT This is a simple comment that is not included in\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT the output. This is useful when commenting\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE metatags, since the metatags do not appear the\n-\u00a0 \u00a0 _\bS_\bE_\bT output either. Example:\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF Note that these comments should not include < or >,\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT that is you should not use it to comment out htp\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ code. For that purpose use something like this:\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE Make sure that the variable is never defined and\n-\u00a0 [>] _\b<_\b!_\b-_\b-_\b- xyz should be the reason why you don't want to\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by include this block\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n+\u00a0 \u00a0 _\bO_\bP_\bT\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE\n+\u00a0 \u00a0 _\bS_\bE_\bT\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE\n+\u00a0 [>] _\b<_\b!_\b-_\b-_\b-\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n \u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n \u00a0 _\bB_\bu_\bg_\bs\n \n \n \n \n \n-\n-\n-\n-\n-\n-\n-\n-\n-\n-\n-\n-\n-\n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n \u00a0 _\bh_\bt_\bp_\b _\bp_\br_\bo_\bj_\be_\bc_\bt\n \u00a0 _\bh_\bt_\bp_\b _\bh_\bo_\bm_\be_\bp_\ba_\bg_\be\n hosted by\n _\bS_\bo_\bu_\br_\bc_\be_\bf_\bo_\br_\bg_\be\n HTML coding_\b[_\bP_\bo_\bw_\be_\br_\be_\bd_\b _\bb_\by\n _\bh_\bt_\bp_\b]\n"}]}, {"source1": "./usr/share/doc/htp/def.html", "source2": "./usr/share/doc/htp/def.html", "unified_diff": "@@ -114,16 +114,14 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-<\"[ref]\"imageurl url=\"imageurl\" [ path=\"path/in/local/filesystem\" ]>
\n-
\n

\n

synopsis

\n

\n DEF creates metatags, which is a\n fancy way of saying it creates new tags. The mechanism is very similar to\n BLOCK macros, except that the USE\n tag is not used to expand them. Instead, they are expanded by their own name.\n@@ -145,19 +143,15 @@\n

\n Options can be passed to a metatag, which can then expand as if it were\n a SET macro. Option names are parameterized with\n the OPTION attribute. Multiple options can be listed by separating their\n name with a space (which therefore requires they be surrounded by quotes.)\n

\n

\n-  <\"[ref]\"def name=\"sharedimg\" option=\"name alt\">
\n-    <\"[ref]\"img src=\"/home/sharedimages/${name}\" alt=\"${alt}\">;
\n-  <\"[ref]\"/def>
\n-
\n-  <sharedimg name=\"bubble.gif\" alt=\"Bubble image\">
\n+    <\"[ref]\"unset email_addr home_url login_name>
\n

\n

\n htp will do very specific checking of parameters when a metatag is\n invoked. htp assumes that all parameter options to the metatag are\n optional. This is why the HEADERIMG definition uses IF to verify the\n SIZE option is defined before expanding it in the block. If a\n parameter is required, simply expand it without first checking. When\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,44 +1,36 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: D\bDE\bEF\bF,\b, /\b/D\bDE\bEF\bF *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\ba_\bg_\be_\bu_\br_\bl url=\"imageurl\" [ path=\"path/in/\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be local/filesystem\" ]>\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl\n-\u00a0 _\bU_\bs_\ba_\bg_\be *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 HTP Tags D\bDE\bEF\bF creates _\bm_\be_\bt_\ba_\bt_\ba_\bg_\bs, which is a fancy way of\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT saying it creates new tags. The mechanism is very\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK similar to _\bB_\bL_\bO_\bC_\bK macros, except that the _\bU_\bS_\bE tag is\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF not used to expand them. Instead, they are expanded\n-\u00a0 [>] _\bD_\bE_\bF by their own name. For example:\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE Some metatags will require an opening and closing\n-\u00a0 \u00a0 _\bI_\bF tag (comparable to\n-\u00a0 \u00a0 _\bI_\bN_\bC and\n-\u00a0 \u00a0 _\bI_\bM_\bG ). In this case, you should use the _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF macro.\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL Another slightly faster alternative is to use two\n-\u00a0 \u00a0 _\bO_\bP_\bT metatags, the opening tag and the closing tag with\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT a preceding slash. For example:\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE You should really use _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF, though, as it will\n-\u00a0 \u00a0 _\bS_\bE_\bT check for matching end tag. It is not that slower.\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF Options can be passed to a metatag, which can then\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT expand as if it were a _\bS_\bE_\bT macro. Option names are\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ parameterized with the OPTION attribute. Multiple\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE options can be listed by separating their name with\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- a space (which therefore requires they be\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by surrounded by quotes.)\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bd_\be_\bf name=\"sharedimg\" option=\"name alt\">\n-\u00a0 _\bB_\bu_\bg_\bs \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\bg src=\"/home/sharedimages/${name}\"\n- alt=\"${alt}\">;\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bd_\be_\bf>\n-\n- \u00a0 \n- htp will do very specific checking of parameters\n- when a metatag is invoked. htp assumes that all\n- parameter options to the metatag are optional. This\n- is why the HEADERIMG definition uses IF to verify\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be D\bDE\bEF\bF creates _\bm_\be_\bt_\ba_\bt_\ba_\bg_\bs, which is a fancy way of\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl saying it creates new tags. The mechanism is very\n+\u00a0 _\bU_\bs_\ba_\bg_\be similar to _\bB_\bL_\bO_\bC_\bK macros, except that the _\bU_\bS_\bE tag is\n+\u00a0 HTP Tags not used to expand them. Instead, they are expanded\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT by their own name. For example:\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK Some metatags will require an opening and closing\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF tag (comparable to\n+\u00a0 [>] _\bD_\bE_\bF and\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE ). In this case, you should use the _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF macro.\n+\u00a0 \u00a0 _\bI_\bF Another slightly faster alternative is to use two\n+\u00a0 \u00a0 _\bI_\bN_\bC metatags, the opening tag and the closing tag with\n+\u00a0 \u00a0 _\bI_\bM_\bG a preceding slash. For example:\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL You should really use _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF, though, as it will\n+\u00a0 \u00a0 _\bO_\bP_\bT check for matching end tag. It is not that slower.\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT Options can be passed to a metatag, which can then\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE expand as if it were a _\bS_\bE_\bT macro. Option names are\n+\u00a0 \u00a0 _\bS_\bE_\bT parameterized with the OPTION attribute. Multiple\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF options can be listed by separating their name with\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT a space (which therefore requires they be\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ surrounded by quotes.)\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bs_\be_\bt email_addr home_url login_name>\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- htp will do very specific checking of parameters\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by when a metatag is invoked. htp assumes that all\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt parameter options to the metatag are optional. This\n+\u00a0 _\bB_\bu_\bg_\bs is why the HEADERIMG definition uses IF to verify\n the SIZE option is defined before expanding it in\n the block. If a parameter is required, simply\n expand it without first checking. When htp expands\n the metatag and the macro is not defined, it will\n halt processing and complain with an error message\n and the required macro name. Normally htp will not\n allow parameters not listed in the OPTION attribute\n"}]}, {"source1": "./usr/share/doc/htp/expand.html", "source2": "./usr/share/doc/htp/expand.html", "unified_diff": "@@ -98,18 +98,21 @@\n

However, if the block tag is marked with the expand\n modifier it is expanded immediately. This is useful if you want to\n store something in a block macro, that depends on the current value of\n another macro. This other macro may no longer have the correct value\n when the macro is expanded. Here is some code that demonstrate when\n the htp tags are expanded:

\n

\n- 1.     <EM>File \"<\"[ref]\"FILE NAME>\" last updated <\"[ref]\"FILE TIME>, <\"[ref]\"FILE DATE></EM>
\n

\n This produces the following:\n

\n+  <\"[ref]\"WHILE sect-$i>
\n+    ...
\n+    <\"[ref]\"INC i>
\n+  <\"[ref]\"/WHILE>
\n

\n

\n When block a and block b are defined in lines 2-7 the contents of a\n are taken literally, however, the contents for b are already expanded\n so the macro time is evaluated. So a is expanded when it\n is used, while the contents of b are already expanded.\n

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -24,17 +24,19 @@\n However, if the block tag is marked with the expand\n modifier it is expanded immediately. This is useful\n if you want to store something in a block macro,\n that depends on the current value of another macro.\n This other macro may no longer have the correct\n value when the macro is expanded. Here is some code\n that demonstrate when the htp tags are expanded:\n- \u00a01. \u00a0 \u00a0 File \"<_\b[_\b[_\br_\be_\bf_\b]_\b]_\bF_\bI_\bL_\bE NAME>\" last updated\n- <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bF_\bI_\bL_\bE TIME>, <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bF_\bI_\bL_\bE DATE>\n This produces the following:\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE sect-$i>\n+ \u00a0 \u00a0 ...\n+ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC i>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n When block a and block b are defined in lines 2-\n 7 the contents of a are taken literally, however,\n the contents for b are already expanded so the\n macro time is evaluated. So a is expanded when it\n is used, while the contents of b are already\n expanded.\n In line 10 and 12 the _\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be tag is used with\n"}]}, {"source1": "./usr/share/doc/htp/file.html", "source2": "./usr/share/doc/htp/file.html", "unified_diff": "@@ -114,44 +114,47 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-<\"[ref]\"img src=\"filename\" ...>
\n+  <\"[ref]\"WHILE NOT i=\"10\">
\n+    ...
\n+    <\"[ref]\"INC i>
\n+  <\"[ref]\"/WHILE>
\n
\n+
\n+  <\"[ref]\"def name=\"/bigfont\">
\n+    </font>
\n+  <\"[ref]\"/def>
\n+
\n+  <bigfont>Some large text</bigfont>
\n

\n

synopsis

\n FILE has several optional parameters of differing purpose.\n The output file's name, the current date and time, and the contents of\n another file may be included. Another file's time, date, or size may be\n added to the output file as well.\n

\n As with all HTML, these tags do not have to be on their own line, so the\n following is perfectly acceptable:\n

\n-    <\"[ref]\"IF name=\"Jim\">...<\"[ref]\"/IF>
\n+  <\"[ref]\"WHILE sect-$i>
\n+    ...
\n+    <\"[ref]\"INC i>
\n+  <\"[ref]\"/WHILE>
\n

\n

\n

NAME, TIME, SIZE

\n

\n To include information about another file, such as an archive file or\n graphic image, specify its name with the NAME attribute followed by the\n type of information to be displayed:\n

\n-<\"[ref]\"block stuff>
\n-  <a href=$email>send email</a>
\n-<\"[ref]\"/block>
\n-
\n-<\"[ref]\"set morestuff=$email>
\n-
\n-This works:     <\"[ref]\"use stuff email=\"jnelson@crl.com\">
\n-But this fails: <\"[ref]\"use email>
\n-And this fails: <\"[ref]\"use morestuff email=\"jnelson@crl.com\">
\n

\n

\n For file size information, the value BYTE, KBYTE, etc. dictates how the\n information is displayed. In anything other than byte format, the information\n is displayed in floating-point notation. The amount of precision (the number\n of digits to the right of the decimal point) can be set with the optional\n PRECISION attribute. The default precision is zero (0), which means no\n@@ -180,38 +183,15 @@\n

\n Additional parameters can be set in the FILE INCLUDE tag, which are\n interpreted as macros that are \"passed\" to the included file. The macros\n are available only to the include file (and any macros or included files it\n holds). After the file is completely included, the macros are no longer\n available. So:\n

\n-  <\"[ref]\"DEF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE SIZE\">
\n-    <\"[ref]\"IF size>
\n-        <FONT SIZE=${size}>
\n-    <\"[ref]\"/IF>
\n-    <\"[ref]\"IMG SRC=pics/${src}>
\n-    <\"[ref]\"USE title>
\n-    <\"[ref]\"IF size>
\n-        </FONT>
\n-    <\"[ref]\"/IF>
\n-  <\"[ref]\"/DEF>
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" SIZE=\"+2\" TITLE=\"A title\">
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" TITLE=\"Normal sized title\">
\n-
\n-  This will fail:
\n-  <HEADERIMG SRC=\"logo.gif\" ALT=\"Our logo\" TITLE=\"Another title\">
\n-
\n-  Instead, use * like this:
\n-  <\"[ref]\"DEF NAME=\"MYIMG\" OPTION=\"SRC *\">
\n-    <\"[ref]\"IMG SRC=\"pics/${src}\" $*>
\n-  <\"[ref]\"/DEF>
\n-   
\n-  <MYIMG SRC=\"logo.gif\" ALT=\"Our logo\">
\n+    <\"[ref]\"unset email_addr home_url login_name>
\n

\n

\n Macros named \"name\" and \"email\" are set, and available inside the included\n file. They are not available, however, past the tag (which is why the\n second statement will fail.)\n

\n

TEMPLATE

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,38 +1,39 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: F\bFI\bIL\bLE\bE *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\bg src=\"filename\" ...>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bU_\bs_\ba_\bg_\be F\bFI\bIL\bLE\bE has several optional parameters of differing\n-\u00a0 HTP Tags purpose. The output file's name, the current date\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT and time, and the contents of another file may be\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK included. Another file's time, date, or size may be\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF added to the output file as well.\n-\u00a0 \u00a0 _\bD_\bE_\bF As with all HTML, these tags do not have to be on\n-\u00a0 [>] _\bF_\bI_\bL_\bE their own line, so the following is perfectly\n-\u00a0 \u00a0 _\bI_\bF acceptable:\n-\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF name=\"Jim\">...<_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 \u00a0 _\bI_\bM_\bG *\b**\b**\b**\b* N\bNA\bAM\bME\bE,\b, T\bTI\bIM\bME\bE,\b, S\bSI\bIZ\bZE\bE *\b**\b**\b**\b*\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL To include information about another file, such as\n-\u00a0 \u00a0 _\bO_\bP_\bT an archive file or graphic image, specify its name\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT with the NAME attribute followed by the type of\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE information to be displayed:\n-\u00a0 \u00a0 _\bS_\bE_\bT <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk stuff>\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF \u00a0 send email\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt morestuff=$email>\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by This works: \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be stuff\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt email=\"jnelson@crl.com\">\n-\u00a0 _\bB_\bu_\bg_\bs But this fails: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be email>\n- And this fails: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be morestuff\n- email=\"jnelson@crl.com\">\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE NOT i=\"10\">\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0 ...\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC i>\n+\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+\u00a0 HTP Tags\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bd_\be_\bf name=\"/bigfont\">\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 \u00a0 \n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bd_\be_\bf>\n+\u00a0 [>] _\bF_\bI_\bL_\bE\n+\u00a0 \u00a0 _\bI_\bF \u00a0 Some large text\n+\u00a0 \u00a0 _\bI_\bN_\bC *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 \u00a0 _\bI_\bM_\bG F\bFI\bIL\bLE\bE has several optional parameters of differing\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL purpose. The output file's name, the current date\n+\u00a0 \u00a0 _\bO_\bP_\bT and time, and the contents of another file may be\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT included. Another file's time, date, or size may be\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE added to the output file as well.\n+\u00a0 \u00a0 _\bS_\bE_\bT As with all HTML, these tags do not have to be on\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF their own line, so the following is perfectly\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT acceptable:\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE sect-$i>\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 ...\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC i>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt *\b**\b**\b**\b* N\bNA\bAM\bME\bE,\b, T\bTI\bIM\bME\bE,\b, S\bSI\bIZ\bZE\bE *\b**\b**\b**\b*\n+\u00a0 _\bB_\bu_\bg_\bs To include information about another file, such as\n+ an archive file or graphic image, specify its name\n+ with the NAME attribute followed by the type of\n+ information to be displayed:\n For file size information, the value BYTE, KBYTE,\n etc. dictates how the information is displayed. In\n anything other than byte format, the information is\n displayed in floating-point notation. The amount of\n precision (the number of digits to the right of the\n decimal point) can be set with the optional\n PRECISION attribute. The default precision is zero\n@@ -63,42 +64,15 @@\n Additional parameters can be set in the FILE\n INCLUDE tag, which are interpreted as macros that\n are \"passed\" to the included file. The macros are\n available only to the include file (and any macros\n or included files it holds). After the file is\n completely included, the macros are no longer\n available. So:\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE\n- SIZE\">\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n- \u00a0 \u00a0 \u00a0 \u00a0 \n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=pics/${src}>\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE title>\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n- \u00a0 \u00a0 \u00a0 \u00a0 \n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n-\n- \u00a0 \n-\n- \u00a0 \n-\n- \u00a0 This will fail:\n- \u00a0 \n-\n- \u00a0 Instead, use * like this:\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"MYIMG\" OPTION=\"SRC *\">\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=\"pics/${src}\" $*>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- \u00a0 \u00a0\n- \u00a0 \n+ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bs_\be_\bt email_addr home_url login_name>\n Macros named \"name\" and \"email\" are set, and\n available inside the included file. They are not\n available, however, past the tag (which is why the\n second statement will fail.)\n *\b**\b**\b**\b* T\bTE\bEM\bMP\bPL\bLA\bAT\bTE\bE *\b**\b**\b**\b*\n A template file is nothing more than a default\n include file, one that is included once the input\n"}]}, {"source1": "./usr/share/doc/htp/if.html", "source2": "./usr/share/doc/htp/if.html", "unified_diff": "@@ -122,47 +122,27 @@\n

synopsis

\n IF, NOT, ELSEIF, ELSE, and /IF are the building\n blocks for conditional processing. The basic form is shown above.\n

\"Conditional\" is either a \"compare\" or \"is defined\" operation. A\n compare operator is a test of the value of a macro against a literal\n string:\n

\n-<\"[ref]\"WHILE [NOT] conditional>
\n-    block
\n-<\"[ref]\"/WHILE>
\n-
\n+    <\"[ref]\"unset email_addr home_url login_name>
\n

\n

\n and a defined operator is a test of a macro's existance:\n

\n

\n-  <\"[ref]\"DEF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE SIZE\">
\n-    <\"[ref]\"IF size>
\n-        <FONT SIZE=${size}>
\n-    <\"[ref]\"/IF>
\n-    <\"[ref]\"IMG SRC=pics/${src}>
\n-    <\"[ref]\"USE title>
\n-    <\"[ref]\"IF size>
\n-        </FONT>
\n-    <\"[ref]\"/IF>
\n-  <\"[ref]\"/DEF>
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" SIZE=\"+2\" TITLE=\"A title\">
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" TITLE=\"Normal sized title\">
\n-
\n-  This will fail:
\n-  <HEADERIMG SRC=\"logo.gif\" ALT=\"Our logo\" TITLE=\"Another title\">
\n-
\n-  Instead, use * like this:
\n-  <\"[ref]\"DEF NAME=\"MYIMG\" OPTION=\"SRC *\">
\n-    <\"[ref]\"IMG SRC=\"pics/${src}\" $*>
\n-  <\"[ref]\"/DEF>
\n-   
\n-  <MYIMG SRC=\"logo.gif\" ALT=\"Our logo\">
\n+  <\"[ref]\"set sect-ctr=\"0\">
\n+  <\"[ref]\"blockdef name=\"section\">
\n+    <\"[ref]\"inc sect-ctr>
\n+    <\"[ref]\"block name=\"sect-${sect-ctr}\" expand global>
\n+      <\"[ref]\"use block noexpand>
\n+    <\"[ref]\"/block>
\n+  <\"[ref]\"/blockdef>
\n

\n

\n If the NOT tag is present in the IF markup, the evaluation of the\n conditional is reversed. The first IF or ELSEIF condition that\n evaluates to true is chosen. If none of the conditions is true the\n ELSE block is taken if it is present. A conditional block\n must be closed with the /IF tag. IF tags can be nested.\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,56 +4,33 @@\n \u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n \u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be I\bIF\bF,\b, N\bNO\bOT\bT,\b, E\bEL\bLS\bSE\bEI\bIF\bF,\b, E\bEL\bLS\bSE\bE,\b, a\ban\bnd\bd /\b/I\bIF\bF are the building\n \u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl blocks for conditional processing. The basic form\n \u00a0 _\bU_\bs_\ba_\bg_\be is shown above.\n \u00a0 HTP Tags \"Conditional\" is either a \"compare\" or \"is defined\"\n \u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT operation. A compare operator is a test of the\n \u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK value of a macro against a literal string:\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE [NOT] conditional>\n-\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 \u00a0 block\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n-\u00a0 [>] _\bI_\bF\n-\u00a0 \u00a0 _\bI_\bN_\bC and a defined operator is a test of a macro's\n-\u00a0 \u00a0 _\bI_\bM_\bG existance:\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE\n-\u00a0 \u00a0 _\bO_\bP_\bT SIZE\">\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a0 \u00a0 \u00a0 \u00a0 \n-\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=pics/${src}>\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE title>\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 \u00a0 \u00a0 \n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n-\u00a0 _\bB_\bu_\bg_\bs \u00a0 \n-\n- \u00a0 \n-\n- \u00a0 This will fail:\n- \u00a0 \n-\n- \u00a0 Instead, use * like this:\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"MYIMG\" OPTION=\"SRC *\">\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=\"pics/${src}\" $*>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- \u00a0 \u00a0\n- \u00a0 \n- If the NOT tag is present in the IF markup, the\n- evaluation of the conditional is reversed. The\n- first IF or ELSEIF condition that evaluates to true\n- is chosen. If none of the conditions is true the\n- ELSE block is taken if it is present. A conditional\n- block m\bmu\bus\bst\bt be closed with the /IF tag. IF tags can\n- be nested.\n-\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bs_\be_\bt email_addr home_url login_name>\n+\u00a0 \u00a0 _\bD_\bE_\bF and a defined operator is a test of a macro's\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE existance:\n+\u00a0 [>] _\bI_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt sect-ctr=\"0\">\n+\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf name=\"section\">\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bn_\bc sect-ctr>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=\"sect-${sect-ctr}\" expand\n+\u00a0 \u00a0 _\bO_\bP_\bT global>\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be block noexpand>\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf>\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF If the NOT tag is present in the IF markup, the\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT evaluation of the conditional is reversed. The\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ first IF or ELSEIF condition that evaluates to true\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE is chosen. If none of the conditions is true the\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- ELSE block is taken if it is present. A conditional\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by block m\bmu\bus\bst\bt be closed with the /IF tag. IF tags can\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt be nested.\n+\u00a0 _\bB_\bu_\bg_\bs\n \n \n \n \n \n \n \n"}]}, {"source1": "./usr/share/doc/htp/imageurl.html", "source2": "./usr/share/doc/htp/imageurl.html", "unified_diff": "@@ -114,14 +114,16 @@\n Bugs\n \n \n \n \n

syntax

\n

\n+<\"[ref]\"INC macroname1=\"increment1\" [macroname2=\"increment2\" ... ] [GLOBAL]>
\n+
\n

\n

synopsis

\n

\n IMAGEURL tells htp, where to find images on the local\n file system. declares an URL replacement that is used for\n size lookups in any IMG tag. This definitions\n takes effect only if the IMGXY option is\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,36 +1,39 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: I\bIM\bMA\bAG\bGE\bEU\bUR\bRL\bL *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be I\bIM\bMA\bAG\bGE\bEU\bUR\bRL\bL tells htp, where to find images on the\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl local file system. declares an URL replacement that\n-\u00a0 _\bU_\bs_\ba_\bg_\be is used for size lookups in any _\bI_\bM_\bG tag. This\n-\u00a0 HTP Tags definitions takes effect only if the _\bI_\bM_\bG_\bX_\bY option\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT is enabled. Beacause htp can't lookup files in the\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK world wide web you have to map absolute image URLs\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF to a directory in the local file system.\n-\u00a0 \u00a0 _\bD_\bE_\bF When an IMG tag is encountered where htp has to\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE insert width and height the defined URL\n-\u00a0 \u00a0 _\bI_\bF replacements will be taken into account (later\n-\u00a0 \u00a0 _\bI_\bN_\bC definitions take precedence to earlier): For each\n-\u00a0 \u00a0 _\bI_\bM_\bG defined imageurl it checks (case-insensitive) if it\n-\u00a0 [>] _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL is a prefix of the image's SRC attribute. If it\n-\u00a0 \u00a0 _\bO_\bP_\bT matches this prefix is replaced by the given PATH.\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT If no IMAGEURL matches the SRC is considered as\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE relative link and looked up in the current\n-\u00a0 \u00a0 _\bS_\bE_\bT directory.\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF For example:\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT If IMAGEURL is specified with a URL but no PATH\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ attribute, it is treated as an undefine, and is\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE removed.\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- Since you usually need the url mapping for a number\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by of images used throughout a set of documents,\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt IMAGEURL is most appropriately put into an _\bi_\bn_\bc_\bl_\bu_\bd_\be\n-\u00a0 _\bB_\bu_\bg_\bs _\bf_\bi_\bl_\be or the _\bh_\bt_\bp_\b._\bd_\be_\bf file.\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC macroname1=\"increment1\"\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be [macroname2=\"increment2\" ... ] [GLOBAL]>\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl\n+\u00a0 _\bU_\bs_\ba_\bg_\be *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 HTP Tags I\bIM\bMA\bAG\bGE\bEU\bUR\bRL\bL tells htp, where to find images on the\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT local file system. declares an URL replacement that\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK is used for size lookups in any _\bI_\bM_\bG tag. This\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF definitions takes effect only if the _\bI_\bM_\bG_\bX_\bY option\n+\u00a0 \u00a0 _\bD_\bE_\bF is enabled. Beacause htp can't lookup files in the\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE world wide web you have to map absolute image URLs\n+\u00a0 \u00a0 _\bI_\bF to a directory in the local file system.\n+\u00a0 \u00a0 _\bI_\bN_\bC When an IMG tag is encountered where htp has to\n+\u00a0 \u00a0 _\bI_\bM_\bG insert width and height the defined URL\n+\u00a0 [>] _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL replacements will be taken into account (later\n+\u00a0 \u00a0 _\bO_\bP_\bT definitions take precedence to earlier): For each\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT defined imageurl it checks (case-insensitive) if it\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE is a prefix of the image's SRC attribute. If it\n+\u00a0 \u00a0 _\bS_\bE_\bT matches this prefix is replaced by the given PATH.\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF If no IMAGEURL matches the SRC is considered as\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT relative link and looked up in the current\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ directory.\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE For example:\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- If IMAGEURL is specified with a URL but no PATH\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by attribute, it is treated as an undefine, and is\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt removed.\n+\u00a0 _\bB_\bu_\bg_\bs Since you usually need the url mapping for a number\n+ of images used throughout a set of documents,\n+ IMAGEURL is most appropriately put into an _\bi_\bn_\bc_\bl_\bu_\bd_\be\n+ _\bf_\bi_\bl_\be or the _\bh_\bt_\bp_\b._\bd_\be_\bf file.\n In addition to WIDTH and HEIGHT, htp can also\n (semi-)automatically add an _\bA_\bL_\bT_\b _\bt_\be_\bx_\bt attribute to\n _\bI_\bM_\bG tags.\n \n \n \n \n"}]}, {"source1": "./usr/share/doc/htp/img.html", "source2": "./usr/share/doc/htp/img.html", "unified_diff": "@@ -114,22 +114,14 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-<\"[ref]\"OPT (IMGXY|NOIMGXY)>
\n-<\"[ref]\"OPT (QUIET|VERBOSE)>
\n-<\"[ref]\"OPT (DEPEND|NODEPEND)>
\n-<\"[ref]\"OPT (PRECIOUS|NOPRECIOUS)>
\n-<\"[ref]\"OPT (CONDENSE|SEMICONDENSE|NOCONDENSE)>
\n-<\"[ref]\"OPT DELIM=(HTML|SQUARE|CURLY)>
\n-<\"[ref]\"OPT (XML|XML=FALSE)>
\n-
\n

\n

synopsis

\n

img is a standard HTML tag. htp can add the specified\n image's width and height to the tag automatically. This has the advantage\n of not having to determine each image's size manually, which is especially\n useful if the image may change frequently.

\n

htp adds this information with the WIDTH and HEIGHT markup\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,44 +1,36 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: I\bIM\bMG\bG *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (IMGXY|NOIMGXY)>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (QUIET|VERBOSE)>\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (DEPEND|NODEPEND)>\n-\u00a0 _\bU_\bs_\ba_\bg_\be <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (PRECIOUS|NOPRECIOUS)>\n-\u00a0 HTP Tags <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (CONDENSE|SEMICONDENSE|NOCONDENSE)>\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT DELIM=(HTML|SQUARE|CURLY)>\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bO_\bP_\bT (XML|XML=FALSE)>\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF\n-\u00a0 \u00a0 _\bD_\bE_\bF *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE i\bim\bmg\bg is a standard HTML tag. htp can add the\n-\u00a0 \u00a0 _\bI_\bF specified image's width and height to the tag\n-\u00a0 \u00a0 _\bI_\bN_\bC automatically. This has the advantage of not having\n-\u00a0 [>] _\bI_\bM_\bG to determine each image's size manually, which is\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL especially useful if the image may change\n-\u00a0 \u00a0 _\bO_\bP_\bT frequently.\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT htp adds this information with the WIDTH and HEIGHT\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE markup attributes. If htp detects these attributes\n-\u00a0 \u00a0 _\bS_\bE_\bT are already present in the tag, it will n\bno\bot\bt modify\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF the values. If htp cannot find the image file, it\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT will issue a warning but not halt processing.\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ At this time, GIF (Graphic Interchange Format), PNG\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE (Portable Network Graphics), and JFIF (JPEG File\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- Interchange Format) are supported.\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by The _\bI_\bM_\bG_\bX_\bY_\b _\ba_\bn_\bd_\b _\bN_\bO_\bI_\bM_\bG_\bX_\bY options control whether or\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt not htp actually adds this information as it\n-\u00a0 _\bB_\bu_\bg_\bs executes.\n- Since htp is able to lookup files only in the local\n- filesystem, the _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL tag may be used to map\n- URLs to local files.\n- htp can also add default ALT text to IMG tags using\n- _\bA_\bL_\bT_\bT_\bE_\bX_\bT.\n-\n-\n-\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be i\bim\bmg\bg is a standard HTML tag. htp can add the\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl specified image's width and height to the tag\n+\u00a0 _\bU_\bs_\ba_\bg_\be automatically. This has the advantage of not having\n+\u00a0 HTP Tags to determine each image's size manually, which is\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT especially useful if the image may change\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK frequently.\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF htp adds this information with the WIDTH and HEIGHT\n+\u00a0 \u00a0 _\bD_\bE_\bF markup attributes. If htp detects these attributes\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE are already present in the tag, it will n\bno\bot\bt modify\n+\u00a0 \u00a0 _\bI_\bF the values. If htp cannot find the image file, it\n+\u00a0 \u00a0 _\bI_\bN_\bC will issue a warning but not halt processing.\n+\u00a0 [>] _\bI_\bM_\bG At this time, GIF (Graphic Interchange Format), PNG\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL (Portable Network Graphics), and JFIF (JPEG File\n+\u00a0 \u00a0 _\bO_\bP_\bT Interchange Format) are supported.\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT The _\bI_\bM_\bG_\bX_\bY_\b _\ba_\bn_\bd_\b _\bN_\bO_\bI_\bM_\bG_\bX_\bY options control whether or\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE not htp actually adds this information as it\n+\u00a0 \u00a0 _\bS_\bE_\bT executes.\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF Since htp is able to lookup files only in the local\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT filesystem, the _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL tag may be used to map\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ URLs to local files.\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE htp can also add default ALT text to IMG tags using\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- _\bA_\bL_\bT_\bT_\bE_\bX_\bT.\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n+\u00a0 _\bB_\bu_\bg_\bs\n \n \n \n \n \n \n \n"}]}, {"source1": "./usr/share/doc/htp/inc.html", "source2": "./usr/share/doc/htp/inc.html", "unified_diff": "@@ -114,14 +114,27 @@\n Bugs\n \n \n \n \n

syntax

\n

\n+ <\"[ref]\"def name=\"imghr\">
\n+   <table border=\"0\" cellspacing=\"0\" cellpadding=\"0\">
\n+   <tr>
\n+    <td width=10><\"[ref]\"img src=\"leftsep.png\"></td>
\n+    <td width=\"95%\" background=\"midsep.png\">&nbsp;</td>
\n+    <td width=10><\"[ref]\"img src=\"rightsep.png\"></td>
\n+   </tr>
\n+   </table>
\n+ <\"[ref]\"/def>
\n+
\n+ paragraph
\n+ <imghr>
\n+ paragraph
\n

\n

synopsis

\n The INC can be used for incrementing/decrementing a\n variable or for variable addition. The basic form is shown above.\n

\n The \"increment\" is anything that evaluates to a integer. It can be a\n literal string or a macro preceeded by the '$'-operator. The\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,36 +1,53 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: I\bIN\bNC\bC *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be The I\bIN\bNC\bC can be used for incrementing/decrementing a\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl variable or for variable addition. The basic form\n-\u00a0 _\bU_\bs_\ba_\bg_\be is shown above.\n-\u00a0 HTP Tags The \"increment\" is anything that evaluates to a\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT integer. It can be a literal string or a macro\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK preceeded by the '$'-operator. The macroname must\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF be the name of a defined macro that contains an\n-\u00a0 \u00a0 _\bD_\bE_\bF integer. If the increment is ommitted it defaults\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE to 1. The effect of this operation is that the\n-\u00a0 \u00a0 _\bI_\bF macro is redefined to contain the sum of its\n-\u00a0 [>] _\bI_\bN_\bC previous value and its increment.\n-\u00a0 \u00a0 _\bI_\bM_\bG To increment or decrement a variable you can use\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL this form:\n-\u00a0 \u00a0 _\bO_\bP_\bT Note that INC doesn't check if the strings really\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT denote integers. It may give weired results when\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE used on arbitrary strings. The integer values are\n-\u00a0 \u00a0 _\bS_\bE_\bT limited to the range -2^31..2^31.\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF Note further that htp wasn't designed to do\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT extensive calculations. The INC tag is useful in\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ conjunction with WHILE to iterate over the defined\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE blocks.\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n-\u00a0 _\bB_\bu_\bg_\bs\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0<_\b[_\b[_\br_\be_\bf_\b]_\b]_\bd_\be_\bf name=\"imghr\">\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0\n+\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 \u00a0\n+\u00a0 HTP Tags \u00a0 \u00a0 \n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 \u00a0 \n+\u00a0 [>] _\bI_\bN_\bC \u00a0 \u00a0
<_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\bg src=\"leftsep.png\">\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 \u00a0  <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bm_\bg src=\"rightsep.png\">\n+\u00a0 \u00a0 _\bI_\bF \u00a0 \u00a0
\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0<_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bd_\be_\bf>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n+\u00a0 \u00a0 _\bO_\bP_\bT \u00a0paragraph\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a0paragraph\n+\u00a0 \u00a0 _\bS_\bE_\bT *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF The I\bIN\bNC\bC can be used for incrementing/decrementing a\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT variable or for variable addition. The basic form\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ is shown above.\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE The \"increment\" is anything that evaluates to a\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- integer. It can be a literal string or a macro\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by preceeded by the '$'-operator. The macroname must\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt be the name of a defined macro that contains an\n+\u00a0 _\bB_\bu_\bg_\bs integer. If the increment is ommitted it defaults\n+ to 1. The effect of this operation is that the\n+ macro is redefined to contain the sum of its\n+ previous value and its increment.\n+ To increment or decrement a variable you can use\n+ this form:\n+ Note that INC doesn't check if the strings really\n+ denote integers. It may give weired results when\n+ used on arbitrary strings. The integer values are\n+ limited to the range -2^31..2^31.\n+ Note further that htp wasn't designed to do\n+ extensive calculations. The INC tag is useful in\n+ conjunction with WHILE to iterate over the defined\n+ blocks.\n+\n+\n+\n+\n \n \n \n \n \n \n \n"}]}, {"source1": "./usr/share/doc/htp/metatag.html", "source2": "./usr/share/doc/htp/metatag.html", "unified_diff": "@@ -88,16 +88,14 @@\n

Metatags are defined with the \"[ref]\"def and \"[ref]\"blockdef tags and\n undefined with the \"[ref]\"undef tag.

\n

\n As an example we show how to define a tag that builds a\n fancy horizontal rule out of several images.\n

\n

\n- 1. <\"[ref]\"QUOTE TAG [ATTRIBUTE=VALUE ...]>
\n- 2.
\n

\n

In line 1 of the above example a new tag named imghr is defined.\n The html code which implements this rule is following in lines 2-8.\n between the \"[ref]\"def and\n /def tags. You don't have to understand this\n html code, but you should understand that this is just pure html to\n draw the fancy rule. Every time you write <imghr>\n@@ -107,59 +105,38 @@\n file.

\n

Often you want to define tags that have an opening and a closing\n variant. For this purpose you should use the \"[ref]\"blockdef tag. When htp\n encounters a blockdef tag it will automatically search for the\n matching closing tag and put everything between these tags in a block\n macro named block. Here is an example for this.

\n

\n- 1.   <\"[ref]\"DEF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE SIZE\">
\n- 2.     <\"[ref]\"IF size>
\n- 3.         <FONT SIZE=${size}>
\n- 4.     <\"[ref]\"/IF>
\n- 5.     <\"[ref]\"IMG SRC=pics/${src}>
\n- 6.     <\"[ref]\"USE title>
\n- 7.     <\"[ref]\"IF size>
\n- 8.         </FONT>
\n- 9.     <\"[ref]\"/IF>
\n-10.   <\"[ref]\"/DEF>
\n-11.
\n-12.   <HEADERIMG SRC=\"logo.gif\" SIZE=\"+2\" TITLE=\"A title\">
\n-13.
\n-14.   <HEADERIMG SRC=\"logo.gif\" TITLE=\"Normal sized title\">
\n-15.
\n-16.   This will fail:
\n-17.   <HEADERIMG SRC=\"logo.gif\" ALT=\"Our logo\" TITLE=\"Another title\">
\n-18.
\n-19.   Instead, use * like this:
\n-20.   <\"[ref]\"DEF NAME=\"MYIMG\" OPTION=\"SRC *\">
\n-21.     <\"[ref]\"IMG SRC=\"pics/${src}\" $*>
\n-22.   <\"[ref]\"/DEF>
\n-23.    
\n-24.   <MYIMG SRC=\"logo.gif\" ALT=\"Our logo\">
\n

\n

Using parameters

\n

More sophisticated tags accept parameters. The\n option parameter lets multiple metatag parameters be\n named and expanded inside the def or\n blockdef block:

\n

\n- 1.   <\"[ref]\"WHILE sect-$i>
\n- 2.     ...
\n- 3.     <\"[ref]\"INC i>
\n- 4.   <\"[ref]\"/WHILE>
\n+ 1.     <\"[ref]\"unset email_addr home_url login_name>
\n

\n

Saving blocks for later

\n

When you are using templates, the html should only be written by\n the template file. The normal htp files should just define macros\n that are used later in the template. So you may want to write block\n tags that just save the block in a macro for later use. Although this\n is possible with htp it is quite tricky, so here we present the way to\n do this:

\n

\n- 1.     <${tagName} ${attrName}=${value$ctr}>
\n+ 1.   <\"[ref]\"set sect-ctr=\"0\">
\n+ 2.   <\"[ref]\"blockdef name=\"section\">
\n+ 3.     <\"[ref]\"inc sect-ctr>
\n+ 4.     <\"[ref]\"block name=\"sect-${sect-ctr}\" expand global>
\n+ 5.       <\"[ref]\"use block noexpand>
\n+ 6.     <\"[ref]\"/block>
\n+ 7.   <\"[ref]\"/blockdef>
\n

\n

This defines a block macro named section. This macro uses a\n counter sect-ctr that enumerates the sections. It is\n increased for every section (line 3) and then the block macro name is\n build from this counter. So the first section is stored in block\n sect-1, the second in sect-2 and so on. The \"[ref]\"global flag\n in line 4 tells htp that these macros should be defined globally\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -9,17 +9,15 @@\n \u00a0 \u00a0 _\bT_\be_\bm_\bp_\bl_\ba_\bt_\be_\bs functionality.\n \u00a0 \u00a0 _\bF_\bi_\bl_\be_\bs Metatags are defined with the _\b[_\b[_\br_\be_\bf_\b]_\b]_\bd_\be_\bf and _\b[\n \u00a0 [>] _\bM_\be_\bt_\ba_\bt_\ba_\bg_\bs _\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf tags and undefined with the _\b[\n \u00a0 _\bU_\bs_\ba_\bg_\be _\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bd_\be_\bf tag.\n \u00a0 _\bH_\bT_\bP_\b _\bT_\ba_\bg_\bs As an example we show how to define a tag that\n \u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by builds a fancy horizontal rule out of several\n \u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt images.\n-\u00a0 _\bB_\bu_\bg_\bs \u00a01. <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bQ_\bU_\bO_\bT_\bE TAG [ATTRIBUTE=VALUE ...]>\n- \u00a02.\n- In line 1 of the above example a new tag named\n+\u00a0 _\bB_\bu_\bg_\bs In line 1 of the above example a new tag named\n imghr is defined. The html code which implements\n this rule is following in lines 2-8. between the _\b[\n _\b[_\br_\be_\bf_\b]_\b]_\bd_\be_\bf_\b _\ba_\bn_\bd_\b _\b/_\bd_\be_\bf tags. You don't have to\n understand this html code, but you should\n understand that this is just pure html to draw the\n fancy rule. Every time you write as in line\n 12 htp will replace this tag with the corresponding\n@@ -29,60 +27,37 @@\n Often you want to define tags that have an opening\n and a closing variant. For this purpose you should\n use the _\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf tag. When htp encounters a\n blockdef tag it will automatically search for the\n matching closing tag and put everything between\n these tags in a block macro named block. Here is an\n example for this.\n- \u00a01. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"HEADERIMG\" OPTION=\"SRC\n- TITLE SIZE\">\n- \u00a02. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n- \u00a03. \u00a0 \u00a0 \u00a0 \u00a0 \n- \u00a04. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- \u00a05. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=pics/${src}>\n- \u00a06. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE title>\n- \u00a07. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n- \u00a08. \u00a0 \u00a0 \u00a0 \u00a0 \n- \u00a09. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- 10. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- 11.\n- 12. \u00a0 \n- 13.\n- 14. \u00a0 \n- 15.\n- 16. \u00a0 This will fail:\n- 17. \u00a0 \n- 18.\n- 19. \u00a0 Instead, use * like this:\n- 20. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"MYIMG\" OPTION=\"SRC *\">\n- 21. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=\"pics/${src}\" $*>\n- 22. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- 23. \u00a0 \u00a0\n- 24. \u00a0 \n *\b**\b**\b**\b**\b* U\bUs\bsi\bin\bng\bg p\bpa\bar\bra\bam\bme\bet\bte\ber\brs\bs *\b**\b**\b**\b**\b*\n More sophisticated tags accept parameters. The\n option parameter lets multiple metatag parameters\n be named and expanded inside the def or blockdef\n block:\n- \u00a01. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE sect-$i>\n- \u00a02. \u00a0 \u00a0 ...\n- \u00a03. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC i>\n- \u00a04. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+ \u00a01. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bs_\be_\bt email_addr home_url\n+ login_name>\n *\b**\b**\b**\b**\b* S\bSa\bav\bvi\bin\bng\bg b\bbl\blo\boc\bck\bks\bs f\bfo\bor\br l\bla\bat\bte\ber\br *\b**\b**\b**\b**\b*\n When you are using templates, the html should only\n be written by the template file. The normal htp\n files should just define macros that are used later\n in the template. So you may want to write block\n tags that just save the block in a macro for later\n use. Although this is possible with htp it is quite\n tricky, so here we present the way to do this:\n- \u00a01. \u00a0 \u00a0 <${tagName} ${attrName}=${value$ctr}>\n+ \u00a01. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt sect-ctr=\"0\">\n+ \u00a02. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf name=\"section\">\n+ \u00a03. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bn_\bc sect-ctr>\n+ \u00a04. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=\"sect-${sect-ctr}\"\n+ expand global>\n+ \u00a05. \u00a0 \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be block noexpand>\n+ \u00a06. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a07. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf>\n This defines a block macro named section. This\n macro uses a counter sect-ctr that enumerates the\n sections. It is increased for every section (line\n 3) and then the block macro name is build from this\n counter. So the first section is stored in block\n sect-1, the second in sect-2 and so on. The _\b[\n _\b[_\br_\be_\bf_\b]_\b]_\bg_\bl_\bo_\bb_\ba_\bl flag in line 4 tells htp that these\n"}]}, {"source1": "./usr/share/doc/htp/opt.html", "source2": "./usr/share/doc/htp/opt.html", "unified_diff": "@@ -114,14 +114,44 @@\n Bugs\n \n \n \n \n

syntax

\n

\n+<\"[ref]\"WHILE [NOT] conditional>
\n+    block
\n+<\"[ref]\"/WHILE>
\n+
\n+anded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=b expand>
\n+    b is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"1\">
\n+  <\"[ref]\"use a>
\n+  <\"[ref]\"use b>
\n+  contents of a: <\"[ref]\"use a noexpand>
\n+  contents of b: <\"[ref]\"use b noexpand>
\n+  <\"[ref]\"block name=c expand>
\n+    c is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=d expand>
\n+    d is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=e>
\n+    e is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"2\">
\n+  <\"[ref]\"block name=a>
\n+    a is defined for the 2nd time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"use c>
\n+  <\"[ref]\"use d>
\n+  <\"[ref]\"use e>
\n

\n

synopsis

\n OPT is an htp tag that can be used to specify processing\n options inside the actual document being processed. The options are\n used exactly as they would be on the command-line, although they are not\n preceded by a ‘-’ character.\n

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,36 +1,70 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: O\bOP\bPT\bT *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be O\bOP\bPT\bT is an htp tag that can be used to specify\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl processing options inside the actual document being\n-\u00a0 _\bU_\bs_\ba_\bg_\be processed. The options are used exactly as they\n-\u00a0 HTP Tags would be on the command-line, although they are not\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT preceded by a \u2018-\u2019 character.\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK Click here for _\bm_\bo_\br_\be_\b _\bi_\bn_\bf_\bo_\br_\bm_\ba_\bt_\bi_\bo_\bn_\b _\bo_\bn_\b _\bu_\bs_\bi_\bn_\bg\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF _\bc_\bu_\bs_\bt_\bo_\bm_\bi_\bz_\ba_\bt_\bi_\bo_\bn_\b _\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b _\bw_\bi_\bt_\bh_\b _\bh_\bt_\bp.\n-\u00a0 \u00a0 _\bD_\bE_\bF\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE\n-\u00a0 \u00a0 _\bI_\bF\n-\u00a0 \u00a0 _\bI_\bN_\bC\n-\u00a0 \u00a0 _\bI_\bM_\bG\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n-\u00a0 [>] _\bO_\bP_\bT\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE\n-\u00a0 \u00a0 _\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n-\u00a0 _\bB_\bu_\bg_\bs\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE [NOT] conditional>\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0 block\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+\u00a0 _\bU_\bs_\ba_\bg_\be\n+\u00a0 HTP Tags anded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=b expand>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 \u00a0 b is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"1\">\n+\u00a0 \u00a0 _\bI_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b>\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 contents of a: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 contents of b: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b noexpand>\n+\u00a0 [>] _\bO_\bP_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=c expand>\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 \u00a0 c is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=d expand>\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a0 \u00a0 d is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=e>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 \u00a0 e is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 _\bB_\bu_\bg_\bs \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"2\">\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+ \u00a0 \u00a0 a is defined for the 2nd time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be\n+ time>.\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be c>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be d>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be e>\n+ *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+ O\bOP\bPT\bT is an htp tag that can be used to specify\n+ processing options inside the actual document being\n+ processed. The options are used exactly as they\n+ would be on the command-line, although they are not\n+ preceded by a \u2018-\u2019 character.\n+ Click here for _\bm_\bo_\br_\be_\b _\bi_\bn_\bf_\bo_\br_\bm_\ba_\bt_\bi_\bo_\bn_\b _\bo_\bn_\b _\bu_\bs_\bi_\bn_\bg\n+ _\bc_\bu_\bs_\bt_\bo_\bm_\bi_\bz_\ba_\bt_\bi_\bo_\bn_\b _\bo_\bp_\bt_\bi_\bo_\bn_\bs_\b _\bw_\bi_\bt_\bh_\b _\bh_\bt_\bp.\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n \n \n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n \u00a0 _\bh_\bt_\bp_\b _\bp_\br_\bo_\bj_\be_\bc_\bt\n \u00a0 _\bh_\bt_\bp_\b _\bh_\bo_\bm_\be_\bp_\ba_\bg_\be\n hosted by\n _\bS_\bo_\bu_\br_\bc_\be_\bf_\bo_\br_\bg_\be\n"}]}, {"source1": "./usr/share/doc/htp/output.html", "source2": "./usr/share/doc/htp/output.html", "unified_diff": "@@ -114,14 +114,44 @@\n Bugs\n \n \n \n \n

syntax

\n

\n+<\"[ref]\"WHILE [NOT] conditional>
\n+    block
\n+<\"[ref]\"/WHILE>
\n+
\n+anded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=b expand>
\n+    b is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"1\">
\n+  <\"[ref]\"use a>
\n+  <\"[ref]\"use b>
\n+  contents of a: <\"[ref]\"use a noexpand>
\n+  contents of b: <\"[ref]\"use b noexpand>
\n+  <\"[ref]\"block name=c expand>
\n+    c is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=d expand>
\n+    d is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=e>
\n+    e is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"2\">
\n+  <\"[ref]\"block name=a>
\n+    a is defined for the 2nd time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"use c>
\n+  <\"[ref]\"use d>
\n+  <\"[ref]\"use e>
\n

\n

synopsis

\n

The OUTPUT tag can be used to create auxillary\n files besides the main HTML file. The text between this tag and the\n corresponding </OUTPUT> tag is written to output file.

\n

Normally the outputfile is cleared before writing to it, but you\n can use the APPEND attribute to extend an existing file. The text\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,36 +1,70 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: O\bOU\bUT\bTP\bPU\bUT\bT *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be The O\bOU\bUT\bTP\bPU\bUT\bT tag can be used to create auxillary\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl files besides the main HTML file. The text between\n-\u00a0 _\bU_\bs_\ba_\bg_\be this tag and the corresponding tag is\n-\u00a0 HTP Tags written to output file.\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT Normally the outputfile is cleared before writing\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK to it, but you can use the APPEND attribute to\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF extend an existing file. The text written to the\n-\u00a0 \u00a0 _\bD_\bE_\bF file is normally not expanded, i.e. all tags inside\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE this block are not executed but written unmodified\n-\u00a0 \u00a0 _\bI_\bF to the file. However, you can use the _\bE_\bX_\bP_\bA_\bN_\bD\n-\u00a0 \u00a0 _\bI_\bN_\bC attribute to override this behaviour.\n-\u00a0 \u00a0 _\bI_\bM_\bG\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n-\u00a0 \u00a0 _\bO_\bP_\bT\n-\u00a0 [>] _\bO_\bU_\bT_\bP_\bU_\bT\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE\n-\u00a0 \u00a0 _\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n-\u00a0 _\bB_\bu_\bg_\bs\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE [NOT] conditional>\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0 block\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+\u00a0 _\bU_\bs_\ba_\bg_\be\n+\u00a0 HTP Tags anded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=b expand>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 \u00a0 b is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"1\">\n+\u00a0 \u00a0 _\bI_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b>\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 contents of a: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 contents of b: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b noexpand>\n+\u00a0 \u00a0 _\bO_\bP_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=c expand>\n+\u00a0 [>] _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 \u00a0 c is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=d expand>\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a0 \u00a0 d is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=e>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 \u00a0 e is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 _\bB_\bu_\bg_\bs \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"2\">\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+ \u00a0 \u00a0 a is defined for the 2nd time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be\n+ time>.\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be c>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be d>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be e>\n+ *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+ The O\bOU\bUT\bTP\bPU\bUT\bT tag can be used to create auxillary\n+ files besides the main HTML file. The text between\n+ this tag and the corresponding tag is\n+ written to output file.\n+ Normally the outputfile is cleared before writing\n+ to it, but you can use the APPEND attribute to\n+ extend an existing file. The text written to the\n+ file is normally not expanded, i.e. all tags inside\n+ this block are not executed but written unmodified\n+ to the file. However, you can use the _\bE_\bX_\bP_\bA_\bN_\bD\n+ attribute to override this behaviour.\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n \n \n \n \n \n \n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n"}]}, {"source1": "./usr/share/doc/htp/quote.html", "source2": "./usr/share/doc/htp/quote.html", "unified_diff": "@@ -114,18 +114,42 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-<\"[ref]\"WHILE [NOT] conditional>
\n-    block
\n-<\"[ref]\"/WHILE>
\n-
\n+  <\"[ref]\"set time=\"0\">
\n+  <\"[ref]\"block name=a>
\n+    a is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=b expand>
\n+    b is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"1\">
\n+  <\"[ref]\"use a>
\n+  <\"[ref]\"use b>
\n+  contents of a: <\"[ref]\"use a noexpand>
\n+  contents of b: <\"[ref]\"use b noexpand>
\n+  <\"[ref]\"block name=c expand>
\n+    c is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=d expand>
\n+    d is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=e>
\n+    e is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"2\">
\n+  <\"[ref]\"block name=a>
\n+    a is defined for the 2nd time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"use c>
\n+  <\"[ref]\"use d>
\n+  <\"[ref]\"use e>
\n

\n

synopsis

\n QUOTE is used to quote a macro that would otherwise\n be interpreted by HTP. It may be useful in conjunction with a\n surrounding EXPANDed block to prevent early\n expansion of some contained blocks. Note that '$' evaluation is still\n done inside a quote block.\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,36 +1,64 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: Q\bQU\bUO\bOT\bTE\bE *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE [NOT] conditional>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0 block\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n-\u00a0 _\bU_\bs_\ba_\bg_\be\n-\u00a0 HTP Tags *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT Q\bQU\bUO\bOT\bTE\bE is used to quote a macro that would otherwise\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK be interpreted by HTP. It may be useful in\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF conjunction with a surrounding _\bE_\bX_\bP_\bA_\bN_\bDed block to\n-\u00a0 \u00a0 _\bD_\bE_\bF prevent early expansion of some contained blocks.\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE Note that '$' evaluation is still done inside a\n-\u00a0 \u00a0 _\bI_\bF quote block.\n-\u00a0 \u00a0 _\bI_\bN_\bC\n-\u00a0 \u00a0 _\bI_\bM_\bG\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n-\u00a0 \u00a0 _\bO_\bP_\bT\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT\n-\u00a0 [>] _\bQ_\bU_\bO_\bT_\bE\n-\u00a0 \u00a0 _\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n-\u00a0 _\bB_\bu_\bg_\bs\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"0\">\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl \u00a0 \u00a0 a is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 HTP Tags \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=b expand>\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 \u00a0 b is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"1\">\n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b>\n+\u00a0 \u00a0 _\bI_\bF \u00a0 contents of a: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 contents of b: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b noexpand>\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=c expand>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 \u00a0 c is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bO_\bP_\bT _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 [>] _\bQ_\bU_\bO_\bT_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=d expand>\n+\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 \u00a0 d is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=e>\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 e is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"2\">\n+\u00a0 _\bB_\bu_\bg_\bs \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+ \u00a0 \u00a0 a is defined for the 2nd time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be\n+ time>.\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be c>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be d>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be e>\n+ *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+ Q\bQU\bUO\bOT\bTE\bE is used to quote a macro that would otherwise\n+ be interpreted by HTP. It may be useful in\n+ conjunction with a surrounding _\bE_\bX_\bP_\bA_\bN_\bDed block to\n+ prevent early expansion of some contained blocks.\n+ Note that '$' evaluation is still done inside a\n+ quote block.\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n+\n \n \n \n \n \n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n \u00a0 _\bh_\bt_\bp_\b _\bp_\br_\bo_\bj_\be_\bc_\bt\n"}]}, {"source1": "./usr/share/doc/htp/set.html", "source2": "./usr/share/doc/htp/set.html", "unified_diff": "@@ -114,44 +114,47 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-    <\"[ref]\"IF name>...<\"[ref]\"/IF>
\n+  <\"[ref]\"set time=\"0\">
\n+  <\"[ref]\"block name=a>
\n+    a is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=b expand>
\n+    b is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"1\">
\n+  <\"[ref]\"use a>
\n+  <\"[ref]\"use b>
\n+  contents of a: <\"[ref]\"use a noexpand>
\n+  contents of b: <\"[ref]\"use b noexpand>
\n+  <\"[ref]\"block name=c expand>
\n+    c is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=d expand>
\n+    d is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=e>
\n+    e is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"2\">
\n+  <\"[ref]\"block name=a>
\n+    a is defined for the 2nd time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"use c>
\n+  <\"[ref]\"use d>
\n+  <\"[ref]\"use e>
\n

\n

synopsis

\n SET creates a macro definition that can later be expanded\n anywhere in the HTML document. To create a macro:\n

\n-  <\"[ref]\"DEF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE SIZE\">
\n-    <\"[ref]\"IF size>
\n-        <FONT SIZE=${size}>
\n-    <\"[ref]\"/IF>
\n-    <\"[ref]\"IMG SRC=pics/${src}>
\n-    <\"[ref]\"USE title>
\n-    <\"[ref]\"IF size>
\n-        </FONT>
\n-    <\"[ref]\"/IF>
\n-  <\"[ref]\"/DEF>
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" SIZE=\"+2\" TITLE=\"A title\">
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" TITLE=\"Normal sized title\">
\n-
\n-  This will fail:
\n-  <HEADERIMG SRC=\"logo.gif\" ALT=\"Our logo\" TITLE=\"Another title\">
\n-
\n-  Instead, use * like this:
\n-  <\"[ref]\"DEF NAME=\"MYIMG\" OPTION=\"SRC *\">
\n-    <\"[ref]\"IMG SRC=\"pics/${src}\" $*>
\n-  <\"[ref]\"/DEF>
\n-   
\n-  <MYIMG SRC=\"logo.gif\" ALT=\"Our logo\">
\n

\n

\n The macro \"emailaddr\" can then be expanded later. The \n USE tag is used to expand the macro outside a tag (i.e., into the regular\n text). If the macro needs to be expanded inside a markup tag, use the\n '$' operator.\n

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,43 +1,46 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: S\bSE\bET\bT *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF name>...<_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl S\bSE\bET\bT creates a macro definition that can later be\n-\u00a0 _\bU_\bs_\ba_\bg_\be expanded anywhere in the HTML document. To create a\n-\u00a0 HTP Tags macro:\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK SIZE\">\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n-\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 \u00a0 \u00a0 \u00a0 \n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 \u00a0 _\bI_\bF \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=pics/${src}>\n-\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE title>\n-\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 \u00a0 \u00a0 \u00a0 \n-\u00a0 \u00a0 _\bO_\bP_\bT \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE\n-\u00a0 [>] _\bS_\bE_\bT \u00a0 \n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 \n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 This will fail:\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 \n-\n- \u00a0 Instead, use * like this:\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"MYIMG\" OPTION=\"SRC *\">\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=\"pics/${src}\" $*>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- \u00a0 \u00a0\n- \u00a0 \n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"0\">\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl \u00a0 \u00a0 a is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 HTP Tags \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=b expand>\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 \u00a0 b is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"1\">\n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b>\n+\u00a0 \u00a0 _\bI_\bF \u00a0 contents of a: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 contents of b: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b noexpand>\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=c expand>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 \u00a0 c is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bO_\bP_\bT _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=d expand>\n+\u00a0 [>] _\bS_\bE_\bT \u00a0 \u00a0 d is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=e>\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 e is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"2\">\n+\u00a0 _\bB_\bu_\bg_\bs \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+ \u00a0 \u00a0 a is defined for the 2nd time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be\n+ time>.\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be c>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be d>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be e>\n+ *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+ S\bSE\bET\bT creates a macro definition that can later be\n+ expanded anywhere in the HTML document. To create a\n+ macro:\n The macro \"emailaddr\" can then be expanded later.\n The _\bU_\bS_\bE tag is used to expand the macro outside a\n tag (i.e., into the regular text). If the macro\n needs to be expanded inside a markup tag, use the\n _\b'_\b$_\b' operator.\n Multiple macros can be declared in a single markup\n tag, as the second syntax line shows.\n"}]}, {"source1": "./usr/share/doc/htp/tut/jh.html", "source2": "./usr/share/doc/htp/tut/jh.html", "unified_diff": "@@ -16,10 +16,10 @@\n Phone:+49 761 203-8243\n Fax:+49 761 203-8242\n \n \n \n


\n Copyright by Joe Doe.
\n- last updated Sun Mar 22, 2026\n+ last updated Mon Feb 17, 2025\n \n \n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,8 +1,8 @@\n *\b**\b**\b**\b**\b**\b* J\bJo\boc\bch\bhe\ben\bn H\bHo\boe\ben\bni\bic\bck\bke\be *\b**\b**\b**\b**\b**\b*\n Navigation bar [Photo]\n _\bM_\ba_\bi_\bn R\bRo\boo\bom\bm:\b: Bld.52 00-020\n _\bE_\bx_\ba_\bm_\bp_\bl_\be P\bPh\bho\bon\bne\be:\b: +49 761 203-8243\n F\bFa\bax\bx:\b: +49 761 203-8242\n ===============================================================================\n Copyright by _\bJ_\bo_\be_\b _\bD_\bo_\be.\n-last updated Sun Mar 22, 2026\n+last updated Mon Feb 17, 2025\n"}]}, {"source1": "./usr/share/doc/htp/tut/tut1.html", "source2": "./usr/share/doc/htp/tut/tut1.html", "unified_diff": "@@ -5,9 +5,9 @@\n \n \n \n This page was produced by htp.\n
\n Copyright by Joe Doe,\n webmaster@domain.com,\n-last updated Sun Mar 22, 2026\n+last updated Mon Feb 17, 2025\n \n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,3 +1,3 @@\n This page was produced by htp.\n ===============================================================================\n-Copyright by Joe Doe, _\bw_\be_\bb_\bm_\ba_\bs_\bt_\be_\br_\b@_\bd_\bo_\bm_\ba_\bi_\bn_\b._\bc_\bo_\bm, last updated Sun Mar 22, 2026\n+Copyright by Joe Doe, _\bw_\be_\bb_\bm_\ba_\bs_\bt_\be_\br_\b@_\bd_\bo_\bm_\ba_\bi_\bn_\b._\bc_\bo_\bm, last updated Mon Feb 17, 2025\n"}]}, {"source1": "./usr/share/doc/htp/tut/tut2.html", "source2": "./usr/share/doc/htp/tut/tut2.html", "unified_diff": "@@ -13,10 +13,10 @@\n

\n As you can see the file contains almost only the contents.\n

\n \n \n
\n Copyright by Joe Doe.
\n- last updated Sun Mar 22, 2026\n+ last updated Mon Feb 17, 2025\n \n \n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,6 +1,6 @@\n Navigation bar *\b**\b**\b**\b**\b* H\bHe\ber\bre\be i\bis\bs t\bth\bhe\be c\bco\bon\bnt\bte\ben\bnt\bt *\b**\b**\b**\b**\b*\n _\bM_\ba_\bi_\bn As you can see the file contains almost only the contents.\n _\bE_\bx_\ba_\bm_\bp_\bl_\be\n ===============================================================================\n Copyright by _\bJ_\bo_\be_\b _\bD_\bo_\be.\n-last updated Sun Mar 22, 2026\n+last updated Mon Feb 17, 2025\n"}]}, {"source1": "./usr/share/doc/htp/tut/tut3.html", "source2": "./usr/share/doc/htp/tut/tut3.html", "unified_diff": "@@ -13,10 +13,10 @@\n

\n As you can see the file contains almost only the contents.\n

\n \n \n
\n Copyright by Joe Doe.
\n- last updated Sun Mar 22, 2026\n+ last updated Mon Feb 17, 2025\n \n \n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,6 +1,6 @@\n Navigation bar *\b**\b**\b**\b**\b* H\bHe\ber\bre\be a\bar\bre\be t\bth\bhe\be c\bco\bon\bnt\bte\ben\bnt\bts\bs *\b**\b**\b**\b**\b*\n _\bM_\ba_\bi_\bn As you can see the file contains almost only the contents.\n _\bE_\bx_\ba_\bm_\bp_\bl_\be\n ===============================================================================\n Copyright by _\bJ_\bo_\be_\b _\bD_\bo_\be.\n-last updated Sun Mar 22, 2026\n+last updated Mon Feb 17, 2025\n"}]}, {"source1": "./usr/share/doc/htp/undef.html", "source2": "./usr/share/doc/htp/undef.html", "unified_diff": "@@ -114,15 +114,14 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-    <\"[ref]\"IF name>...<\"[ref]\"/IF>
\n

\n

synopsis

\n

UNDEF removes a metatag definition. Metatags\n created by DEF and BLOCKDEF can be removed with the UNDEF\n command. Once removed, the metatag will no longer be recognized by\n htp until it is reassigned.

\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,18 +1,18 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: U\bUN\bND\bDE\bEF\bF *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF name>...<_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl U\bUN\bND\bDE\bEF\bF removes a metatag definition. Metatags\n-\u00a0 _\bU_\bs_\ba_\bg_\be created by _\bD_\bE_\bF and _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF can be removed with the\n-\u00a0 HTP Tags UNDEF command. Once removed, the metatag will no\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT longer be recognized by htp until it is reassigned.\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK Multiple metatags can be removed by placing each\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF name as an attribute.\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be U\bUN\bND\bDE\bEF\bF removes a metatag definition. Metatags\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl created by _\bD_\bE_\bF and _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF can be removed with the\n+\u00a0 _\bU_\bs_\ba_\bg_\be UNDEF command. Once removed, the metatag will no\n+\u00a0 HTP Tags longer be recognized by htp until it is reassigned.\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT Multiple metatags can be removed by placing each\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK name as an attribute.\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF\n \u00a0 \u00a0 _\bD_\bE_\bF\n \u00a0 \u00a0 _\bF_\bI_\bL_\bE\n \u00a0 \u00a0 _\bI_\bF\n \u00a0 \u00a0 _\bI_\bN_\bC\n \u00a0 \u00a0 _\bI_\bM_\bG\n \u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL\n \u00a0 \u00a0 _\bO_\bP_\bT\n@@ -24,15 +24,14 @@\n \u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n \u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE\n \u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n \u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n \u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n \u00a0 _\bB_\bu_\bg_\bs\n \n-\n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n \u00a0 _\bh_\bt_\bp_\b _\bp_\br_\bo_\bj_\be_\bc_\bt\n \u00a0 _\bh_\bt_\bp_\b _\bh_\bo_\bm_\be_\bp_\ba_\bg_\be\n hosted by\n _\bS_\bo_\bu_\br_\bc_\be_\bf_\bo_\br_\bg_\be\n HTML coding_\b[_\bP_\bo_\bw_\be_\br_\be_\bd_\b _\bb_\by\n _\bh_\bt_\bp_\b]\n"}]}, {"source1": "./usr/share/doc/htp/unset.html", "source2": "./usr/share/doc/htp/unset.html", "unified_diff": "@@ -114,57 +114,54 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-    <\"[ref]\"IF name>...<\"[ref]\"/IF>
\n-f=$email>send email</a>
\n-<\"[ref]\"/block>
\n-
\n-<\"[ref]\"set morestuff=$email>
\n-
\n-This works:     <\"[ref]\"use stuff email=\"jnelson@crl.com\">
\n-But this fails: <\"[ref]\"use email>
\n-And this fails: <\"[ref]\"use morestuff email=\"jnelson@crl.com\">
\n+  <\"[ref]\"set time=\"0\">
\n+  <\"[ref]\"block name=a>
\n+    a is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=b expand>
\n+    b is expanded at time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"1\">
\n+  <\"[ref]\"use a>
\n+  <\"[ref]\"use b>
\n+  contents of a: <\"[ref]\"use a noexpand>
\n+  contents of b: <\"[ref]\"use b noexpand>
\n+  <\"[ref]\"block name=c expand>
\n+    c is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=d expand>
\n+    d is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"block name=e>
\n+    e is expanded at time <\"[ref]\"use time>; <\"[ref]\"use a noexpand>
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"set time=\"2\">
\n+  <\"[ref]\"block name=a>
\n+    a is defined for the 2nd time <\"[ref]\"use time>.
\n+  <\"[ref]\"/block>
\n+  <\"[ref]\"use c>
\n+  <\"[ref]\"use d>
\n+  <\"[ref]\"use e>
\n

\n

synopsis

\n UNSET removes (or deletes) a macro and it's definition.\n The macro is subsequently not available for use in the pre-processed files.\n (Note that simply redefining the macro with another SET or\n BLOCK definition with the same name is acceptable. The\n old macro definition will be removed automatically.)\n

\n For example:\n

\n-  <\"[ref]\"DEF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE SIZE\">
\n-    <\"[ref]\"IF size>
\n-        <FONT SIZE=${size}>
\n-    <\"[ref]\"/IF>
\n-    <\"[ref]\"IMG SRC=pics/${src}>
\n-    <\"[ref]\"USE title>
\n-    <\"[ref]\"IF size>
\n-        </FONT>
\n-    <\"[ref]\"/IF>
\n-  <\"[ref]\"/DEF>
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" SIZE=\"+2\" TITLE=\"A title\">
\n-
\n-  <HEADERIMG SRC=\"logo.gif\" TITLE=\"Normal sized title\">
\n-
\n-  This will fail:
\n-  <HEADERIMG SRC=\"logo.gif\" ALT=\"Our logo\" TITLE=\"Another title\">
\n-
\n-  Instead, use * like this:
\n-  <\"[ref]\"DEF NAME=\"MYIMG\" OPTION=\"SRC *\">
\n-    <\"[ref]\"IMG SRC=\"pics/${src}\" $*>
\n-  <\"[ref]\"/DEF>
\n-   
\n-  <MYIMG SRC=\"logo.gif\" ALT=\"Our logo\">
\n+    <\"[ref]\"FILE INCLUDE=\"include.hti\" name=\"Jim Nelson\" email=\"jnelson@crl.com\">
\n+    This tag will fail: <\"[ref]\"USE name>
\n

\n

\n More than one macro may be removed in the same tag:\n

\n   <\"[ref]\"set sect-ctr=\"0\">
\n   <\"[ref]\"blockdef name=\"section\">
\n     <\"[ref]\"inc sect-ctr>
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,58 +1,54 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: U\bUN\bNS\bSE\bET\bT *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF name>...<_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be f=$email>send email\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n-\u00a0 _\bU_\bs_\ba_\bg_\be\n-\u00a0 HTP Tags <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt morestuff=$email>\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK This works: \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be stuff\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF email=\"jnelson@crl.com\">\n-\u00a0 \u00a0 _\bD_\bE_\bF But this fails: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be email>\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE And this fails: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be morestuff\n-\u00a0 \u00a0 _\bI_\bF email=\"jnelson@crl.com\">\n-\u00a0 \u00a0 _\bI_\bN_\bC *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 \u00a0 _\bI_\bM_\bG U\bUN\bNS\bSE\bET\bT removes (or deletes) a macro and it's\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL definition. The macro is subsequently not available\n-\u00a0 \u00a0 _\bO_\bP_\bT for use in the pre-processed files. (Note that\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT simply redefining the macro with another _\bS_\bE_\bT or\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE _\bB_\bL_\bO_\bC_\bK definition with the same name is acceptable.\n-\u00a0 \u00a0 _\bS_\bE_\bT The old macro definition will be removed\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF automatically.)\n-\u00a0 [>] _\bU_\bN_\bS_\bE_\bT For example:\n-\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE SIZE\">\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 \u00a0 \u00a0 \u00a0 \n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n-\u00a0 _\bB_\bu_\bg_\bs \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=pics/${src}>\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE title>\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n- \u00a0 \u00a0 \u00a0 \u00a0 \n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n-\n- \u00a0 \n-\n- \u00a0 \n-\n- \u00a0 This will fail:\n- \u00a0 \n-\n- \u00a0 Instead, use * like this:\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"MYIMG\" OPTION=\"SRC *\">\n- \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=\"pics/${src}\" $*>\n- \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- \u00a0 \u00a0\n- \u00a0 \n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"0\">\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl \u00a0 \u00a0 a is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 HTP Tags \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=b expand>\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT \u00a0 \u00a0 b is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>.\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"1\">\n+\u00a0 \u00a0 _\bD_\bE_\bF \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b>\n+\u00a0 \u00a0 _\bI_\bF \u00a0 contents of a: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 \u00a0 _\bI_\bN_\bC \u00a0 contents of b: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be b noexpand>\n+\u00a0 \u00a0 _\bI_\bM_\bG \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=c expand>\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL \u00a0 \u00a0 c is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bO_\bP_\bT _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a>\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=d expand>\n+\u00a0 \u00a0 _\bS_\bE_\bT \u00a0 \u00a0 d is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 [>] _\bU_\bN_\bS_\bE_\bT \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=e>\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a0 \u00a0 e is expanded at time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be time>; <_\b[\n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- _\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be a noexpand>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt time=\"2\">\n+\u00a0 _\bB_\bu_\bg_\bs \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=a>\n+ \u00a0 \u00a0 a is defined for the 2nd time <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be\n+ time>.\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be c>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be d>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be e>\n+ *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+ U\bUN\bNS\bSE\bET\bT removes (or deletes) a macro and it's\n+ definition. The macro is subsequently not available\n+ for use in the pre-processed files. (Note that\n+ simply redefining the macro with another _\bS_\bE_\bT or\n+ _\bB_\bL_\bO_\bC_\bK definition with the same name is acceptable.\n+ The old macro definition will be removed\n+ automatically.)\n+ For example:\n+ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bF_\bI_\bL_\bE INCLUDE=\"include.hti\" name=\"Jim\n+ Nelson\" email=\"jnelson@crl.com\">\n+ \u00a0 \u00a0 This tag will fail: <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE name>\n More than one macro may be removed in the same tag:\n \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt sect-ctr=\"0\">\n \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf name=\"section\">\n \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bn_\bc sect-ctr>\n \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=\"sect-${sect-ctr}\" expand\n global>\n \u00a0 \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be block noexpand>\n"}]}, {"source1": "./usr/share/doc/htp/use.html", "source2": "./usr/share/doc/htp/use.html", "unified_diff": "@@ -114,21 +114,14 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-  <\"[ref]\"blockdef name=\"bolditalic\">
\n-    <b><i>
\n-    <\"[ref]\"use block>
\n-    </i></b>
\n-  <\"[ref]\"/blockdef>
\n-
\n-  This is <bolditalic>bold and italic</bolditalic>
\n

\n

synopsis

\n USE will expand macros that have been previously\n declared with either SET or BLOCK. USE can only be used outside of other\n markup tags.\n

If you USE a block macro the value of expanded block macros will\n@@ -138,38 +131,25 @@\n attribute to prevent further expansion.

\n

USE will accept additional parameters, which are \"local\" macros\n for the expanded macro. This is only valid for BLOCK macros. Macros created using SET cannot have parameters passed. For\n example:

\n

\n- 1.   <\"[ref]\"DEF NAME=\"HEADERIMG\" OPTION=\"SRC TITLE SIZE\">
\n- 2.     <\"[ref]\"IF size>
\n- 3.         <FONT SIZE=${size}>
\n- 4.     <\"[ref]\"/IF>
\n- 5.     <\"[ref]\"IMG SRC=pics/${src}>
\n- 6.     <\"[ref]\"USE title>
\n- 7.     <\"[ref]\"IF size>
\n- 8.         </FONT>
\n- 9.     <\"[ref]\"/IF>
\n-10.   <\"[ref]\"/DEF>
\n-11.
\n-12.   <HEADERIMG SRC=\"logo.gif\" SIZE=\"+2\" TITLE=\"A title\">
\n-13.
\n-14.   <HEADERIMG SRC=\"logo.gif\" TITLE=\"Normal sized title\">
\n-15.
\n-16.   This will fail:
\n-17.   <HEADERIMG SRC=\"logo.gif\" ALT=\"Our logo\" TITLE=\"Another title\">
\n-18.
\n-19.   Instead, use * like this:
\n-20.   <\"[ref]\"DEF NAME=\"MYIMG\" OPTION=\"SRC *\">
\n-21.     <\"[ref]\"IMG SRC=\"pics/${src}\" $*>
\n-22.   <\"[ref]\"/DEF>
\n-23.    
\n-24.   <MYIMG SRC=\"logo.gif\" ALT=\"Our logo\">
\n+ 1.   <\"[ref]\"WHILE NOT i=\"10\">
\n+ 2.     ...
\n+ 3.     <\"[ref]\"INC i>
\n+ 4.   <\"[ref]\"/WHILE>
\n+ 5.
\n+ 6.
\n+ 7.   <\"[ref]\"def name=\"/bigfont\">
\n+ 8.     </font>
\n+ 9.   <\"[ref]\"/def>
\n+10.
\n+11.   <bigfont>Some large text</bigfont>
\n

\n

\n (See below for a description of the '$' operator.) The example on\n line 7 works because \"stuff\" has been declared as a block macro, and\n the tag is passing the \"email\" macro to the \"stuff\" macro. Line 8\n fails because the \"email\" macro is unavailable once the block macro is\n completely expanded, and cannot be passed to a SET macro.\n@@ -180,18 +160,15 @@\n Inside a markup tag, like IMG, A (anchor), or\n any other standard HTML or htp tag, the '$' operator must be used.\n The '$' should be immediately followed by the macro name, which may or\n may not be surrounded by curly braces. When htp encounters this it\n replaces the macro name by the contents of the macro without further\n processing the contents.\n

\n- 1.   <\"[ref]\"WHILE sect-$i>
\n- 2.     ...
\n- 3.     <\"[ref]\"INC i>
\n- 4.   <\"[ref]\"/WHILE>
\n+ 1.     <\"[ref]\"unset email_addr home_url login_name>
\n

\n

\n The use of curly braces is encouraged, since it is more robust and\n should never cause confusion with surrounding text. If no curly\n braces are used the macro name consists either of a single punctuation\n character or the maximum sequence of letters, digits, "-"\n and "_" that follows it.\n@@ -205,15 +182,21 @@\n delimiting the text as if it were additional markup attributes.\n If the '$' macro is surrounded by other text (as in the two examples above),\n quotation marks are not automatically supplied.\n

\n Note that a '$' macro can be placed anywhere in a markup tag and can\n be nested. This is valid:\n

\n-    <${tagName} ${attrName}=${value$ctr}>
\n+  <\"[ref]\"set sect-ctr=\"0\">
\n+  <\"[ref]\"blockdef name=\"section\">
\n+    <\"[ref]\"inc sect-ctr>
\n+    <\"[ref]\"block name=\"sect-${sect-ctr}\" expand global>
\n+      <\"[ref]\"use block noexpand>
\n+    <\"[ref]\"/block>
\n+  <\"[ref]\"/blockdef>
\n

\n

The tagName macro can contain any tag name, even a self-defined\n metatag. Note that $ctr is expanded before the valueX\n macro is expanded, so assuming that ctr was set to 1 it will expand\n value1.\n

\n \n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,60 +1,36 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: U\bUS\bSE\bE,\b, $\b$ *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf name=\"bolditalic\">\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be \u00a0 \u00a0 \n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be block>\n-\u00a0 _\bU_\bs_\ba_\bg_\be \u00a0 \u00a0 \n-\u00a0 HTP Tags \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf>\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK \u00a0 This is bold and italic\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 \u00a0 _\bD_\bE_\bF U\bUS\bSE\bE will expand macros that have been previously\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE declared with either _\bS_\bE_\bT or _\bB_\bL_\bO_\bC_\bK. USE can only be\n-\u00a0 \u00a0 _\bI_\bF used outside of other markup tags.\n-\u00a0 \u00a0 _\bI_\bN_\bC If you USE a block macro the value of expanded\n-\u00a0 \u00a0 _\bI_\bM_\bG block macros will be further parsed by htp. This is\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL maybe not what you want, for example, if the use is\n-\u00a0 \u00a0 _\bO_\bP_\bT inside a block which _\be_\bx_\bp_\ba_\bn_\bd_\bs itself. You can use\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT the noexpand attribute to prevent further\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE expansion.\n-\u00a0 \u00a0 _\bS_\bE_\bT USE will accept additional parameters, which are\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF \"local\" macros for the expanded macro. This is only\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT valid for _\bB_\bL_\bO_\bC_\bK macros. Macros created using _\bS_\bE_\bT\n-\u00a0 [>] _\bU_\bS_\bE_\b,_\b _\b$ cannot have parameters passed. For example:\n-\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a01. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"HEADERIMG\" OPTION=\"SRC\n-\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- TITLE SIZE\">\n-\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by \u00a02. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n-\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt \u00a03. \u00a0 \u00a0 \u00a0 \u00a0 \n-\u00a0 _\bB_\bu_\bg_\bs \u00a04. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- \u00a05. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=pics/${src}>\n- \u00a06. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bU_\bS_\bE title>\n- \u00a07. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF size>\n- \u00a08. \u00a0 \u00a0 \u00a0 \u00a0 \n- \u00a09. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bI_\bF>\n- 10. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- 11.\n- 12. \u00a0 \n- 13.\n- 14. \u00a0 \n- 15.\n- 16. \u00a0 This will fail:\n- 17. \u00a0 \n- 18.\n- 19. \u00a0 Instead, use * like this:\n- 20. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bD_\bE_\bF NAME=\"MYIMG\" OPTION=\"SRC *\">\n- 21. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bM_\bG SRC=\"pics/${src}\" $*>\n- 22. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bD_\bE_\bF>\n- 23. \u00a0 \u00a0\n- 24. \u00a0 \n- (See below for a description of the '$' operator.)\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be U\bUS\bSE\bE will expand macros that have been previously\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl declared with either _\bS_\bE_\bT or _\bB_\bL_\bO_\bC_\bK. USE can only be\n+\u00a0 _\bU_\bs_\ba_\bg_\be used outside of other markup tags.\n+\u00a0 HTP Tags If you USE a block macro the value of expanded\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT block macros will be further parsed by htp. This is\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK maybe not what you want, for example, if the use is\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF inside a block which _\be_\bx_\bp_\ba_\bn_\bd_\bs itself. You can use\n+\u00a0 \u00a0 _\bD_\bE_\bF the noexpand attribute to prevent further\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE expansion.\n+\u00a0 \u00a0 _\bI_\bF USE will accept additional parameters, which are\n+\u00a0 \u00a0 _\bI_\bN_\bC \"local\" macros for the expanded macro. This is only\n+\u00a0 \u00a0 _\bI_\bM_\bG valid for _\bB_\bL_\bO_\bC_\bK macros. Macros created using _\bS_\bE_\bT\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL cannot have parameters passed. For example:\n+\u00a0 \u00a0 _\bO_\bP_\bT \u00a01. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE NOT i=\"10\">\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT \u00a02. \u00a0 \u00a0 ...\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE \u00a03. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC i>\n+\u00a0 \u00a0 _\bS_\bE_\bT \u00a04. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF \u00a05.\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT \u00a06.\n+\u00a0 [>] _\bU_\bS_\bE_\b,_\b _\b$ \u00a07. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bd_\be_\bf name=\"/bigfont\">\n+\u00a0 \u00a0 _\bW_\bH_\bI_\bL_\bE \u00a08. \u00a0 \u00a0 \n+\u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b- \u00a09. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bd_\be_\bf>\n+\u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by 10.\n+\u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt 11. \u00a0 Some large text\n+\u00a0 _\bB_\bu_\bg_\bs (See below for a description of the '$' operator.)\n The example on line 7 works because \"stuff\" has\n been declared as a block macro, and the tag is\n passing the \"email\" macro to the \"stuff\" macro.\n Line 8 fails because the \"email\" macro is\n unavailable once the block macro is completely\n expanded, and cannot be passed to a SET macro.\n Note that the \"email\" macro is available to other\n@@ -63,18 +39,16 @@\n Inside a markup tag, like _\bI_\bM_\bG, A (anchor), or any\n other standard HTML or htp tag, the '$' operator\n must be used. The '$' should be immediately\n followed by the macro name, which may or may not be\n surrounded by curly braces. When htp encounters\n this it replaces the macro name by the contents of\n the macro without further processing the contents.\n- \u00a01. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bW_\bH_\bI_\bL_\bE sect-$i>\n- \u00a02. \u00a0 \u00a0 ...\n- \u00a03. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bN_\bC i>\n- \u00a04. \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bW_\bH_\bI_\bL_\bE>\n+ \u00a01. \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bs_\be_\bt email_addr home_url\n+ login_name>\n The use of curly braces is encouraged, since it is\n more robust and should never cause confusion with\n surrounding text. If no curly braces are used the\n macro name consists either of a single punctuation\n character or the maximum sequence of letters,\n digits, \"-\" and \"_\" that follows it.\n If a '$' character needs to be kept in the final\n@@ -86,15 +60,22 @@\n it with quotation marks to prevent spaces from\n delimiting the text as if it were additional markup\n attributes. If the '$' macro is surrounded by other\n text (as in the two examples above), quotation\n marks are not automatically supplied.\n Note that a '$' macro can be placed anywhere in a\n markup tag and can be nested. This is valid:\n- \u00a0 \u00a0 <${tagName} ${attrName}=${value$ctr}>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bs_\be_\bt sect-ctr=\"0\">\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf name=\"section\">\n+ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bi_\bn_\bc sect-ctr>\n+ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bb_\bl_\bo_\bc_\bk name=\"sect-${sect-ctr}\" expand\n+ global>\n+ \u00a0 \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bs_\be block noexpand>\n+ \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk>\n+ \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\b/_\bb_\bl_\bo_\bc_\bk_\bd_\be_\bf>\n The tagName macro can contain any tag name, even a\n self-defined metatag. Note that $ctr is expanded\n before the valueX macro is expanded, so assuming\n that ctr was set to 1 it will expand value1.\n \n \n \n"}]}, {"source1": "./usr/share/doc/htp/while.html", "source2": "./usr/share/doc/htp/while.html", "unified_diff": "@@ -114,33 +114,29 @@\n Bugs\n \n \n \n \n

syntax

\n

\n-    <\"[ref]\"unset email_addr>
\n

\n

synopsis

\n WHILE is the building block for repeated processing.\n The basic form is shown above.\n

\n \"Conditional\" is either a \"compare\" or \"is defined\" operation.\n A compare operator is a test of the value of a macro against a literal string.\n If the NOT tag is present in the WHILE markup, the evaluation of the\n conditional is reversed:\n

\n-<a href=\"mailto:$email\">mailto hyperlink</a>
\n-<a href=\"http://$domain/~${username}/\">another hyperlink</a>
\n

\n

\n Just as with \"[ref]\"IF you can also check for a\n macro's existance:\n

\n-    <${tagName} ${attrName}=${value$ctr}>
\n

\n

\n If the condition is true, the block is evaluated and afterwards the\n WHILE tag is evaluated again. If the '$'-operator is used in the\n WHILE tag it is also reevaluated on each iteration.\n

\n A loop block must be closed with the /WHILE tag.\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -1,48 +1,43 @@\n [HTP]\n *\b**\b**\b**\b**\b**\b* h\bht\btp\bp o\bon\bn-\b-l\bli\bin\bne\be r\bre\bef\bfe\ber\bre\ben\bnc\bce\be :\b: W\bWH\bHI\bIL\bLE\bE *\b**\b**\b**\b**\b**\b*\n _\bT_\ba_\bb_\bl_\be_\b _\bo_\bf_\b _\bC_\bo_\bn_\bt_\be_\bn_\bt_\bs *\b**\b**\b**\b**\b* s\bsy\byn\bnt\bta\bax\bx *\b**\b**\b**\b**\b*\n-\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn \u00a0 \u00a0 <_\b[_\b[_\br_\be_\bf_\b]_\b]_\bu_\bn_\bs_\be_\bt email_addr>\n-\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n-\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl W\bWH\bHI\bIL\bLE\bE is the building block for repeated\n-\u00a0 _\bU_\bs_\ba_\bg_\be processing. The basic form is shown above.\n-\u00a0 HTP Tags \"Conditional\" is either a \"compare\" or \"is defined\"\n-\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT operation. A compare operator is a test of the\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK value of a macro against a literal string. If the\n-\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF NOT tag is present in the WHILE markup, the\n-\u00a0 \u00a0 _\bD_\bE_\bF evaluation of the conditional is reversed:\n-\u00a0 \u00a0 _\bF_\bI_\bL_\bE mailto hyperlink\n-\u00a0 \u00a0 _\bI_\bF another\n-\u00a0 \u00a0 _\bI_\bN_\bC hyperlink\n-\u00a0 \u00a0 _\bI_\bM_\bG Just as with _\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF you can also check for a\n-\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL macro's existance:\n-\u00a0 \u00a0 _\bO_\bP_\bT \u00a0 \u00a0 <${tagName} ${attrName}=${value$ctr}>\n-\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT If the condition is true, the block is evaluated\n-\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE and afterwards the WHILE tag is evaluated again. If\n-\u00a0 \u00a0 _\bS_\bE_\bT the '$'-operator is used in the WHILE tag it is\n-\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF also reevaluated on each iteration.\n-\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT A loop block m\bmu\bus\bst\bt be closed with the /WHILE tag.\n+\u00a0 _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn *\b**\b**\b**\b**\b* s\bsy\byn\bno\bop\bps\bsi\bis\bs *\b**\b**\b**\b**\b*\n+\u00a0 _\bL_\bi_\bc_\be_\bn_\bs_\be W\bWH\bHI\bIL\bLE\bE is the building block for repeated\n+\u00a0 _\bT_\bu_\bt_\bo_\br_\bi_\ba_\bl processing. The basic form is shown above.\n+\u00a0 _\bU_\bs_\ba_\bg_\be \"Conditional\" is either a \"compare\" or \"is defined\"\n+\u00a0 HTP Tags operation. A compare operator is a test of the\n+\u00a0 \u00a0 _\bA_\bL_\bT_\bT_\bE_\bX_\bT value of a macro against a literal string. If the\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK NOT tag is present in the WHILE markup, the\n+\u00a0 \u00a0 _\bB_\bL_\bO_\bC_\bK_\bD_\bE_\bF evaluation of the conditional is reversed:\n+\u00a0 \u00a0 _\bD_\bE_\bF Just as with _\b[_\b[_\br_\be_\bf_\b]_\b]_\bI_\bF you can also check for a\n+\u00a0 \u00a0 _\bF_\bI_\bL_\bE macro's existance:\n+\u00a0 \u00a0 _\bI_\bF If the condition is true, the block is evaluated\n+\u00a0 \u00a0 _\bI_\bN_\bC and afterwards the WHILE tag is evaluated again. If\n+\u00a0 \u00a0 _\bI_\bM_\bG the '$'-operator is used in the WHILE tag it is\n+\u00a0 \u00a0 _\bI_\bM_\bA_\bG_\bE_\bU_\bR_\bL also reevaluated on each iteration.\n+\u00a0 \u00a0 _\bO_\bP_\bT A loop block m\bmu\bus\bst\bt be closed with the /WHILE tag.\n+\u00a0 \u00a0 _\bO_\bU_\bT_\bP_\bU_\bT\n+\u00a0 \u00a0 _\bQ_\bU_\bO_\bT_\bE\n+\u00a0 \u00a0 _\bS_\bE_\bT\n+\u00a0 \u00a0 _\bU_\bN_\bD_\bE_\bF\n+\u00a0 \u00a0 _\bU_\bN_\bS_\bE_\bT\n \u00a0 \u00a0 _\bU_\bS_\bE_\b,_\b _\b$\n \u00a0 [>] _\bW_\bH_\bI_\bL_\bE\n \u00a0 \u00a0 _\b<_\b!_\b-_\b-_\b-\n \u00a0 _\bH_\bi_\bs_\bt_\bo_\br_\by\n \u00a0 _\bW_\bi_\bs_\bh_\b _\bl_\bi_\bs_\bt\n \u00a0 _\bB_\bu_\bg_\bs\n \n \n \n \n \n \n \n-\n-\n-\n-\n-\n \n \n \u00a0 _\bp_\ba_\bg_\be_\b _\bs_\bo_\bu_\br_\bc_\be\n \u00a0 _\bh_\bt_\bp_\b _\bp_\br_\bo_\bj_\be_\bc_\bt\n \u00a0 _\bh_\bt_\bp_\b _\bh_\bo_\bm_\be_\bp_\ba_\bg_\be\n hosted by\n _\bS_\bo_\bu_\br_\bc_\be_\bf_\bo_\br_\bg_\be\n"}]}]}]}]}]}