Link to "#"; previously the link was to "" which caused a reload --
[irspy-moved-to-github.git] / web / htdocs / help.html
index d0ea596..c211356 100644 (file)
@@ -1,27 +1,75 @@
-%# $Id: help.html,v 1.1 2006-12-01 16:51:32 mike Exp $
+%# $Id: help.html,v 1.5 2006-12-06 14:07:17 mike Exp $
 <%args>
 $help
 </%args>
+<%doc>
+For some totally irrational, retarded and undocumented reason, the <a>
+element in XHTML 1.0 Strict does not have the "target" element, so
+instead I have to use XHTML 1.0 Transitional.  Well, great.  If you
+enjoy reading TOTALLY unhelpful answers, try
+       http://www.w3.org/MarkUp/2004/xhtml-faq#target
+which says:
+
+       Why was the target attribute removed from XHTML 1.1?
+
+       It wasn't. XHTML 1.0 comes in three versions: strict,
+       transitional, and frameset. All three of these were
+       deliberately kept as close as possible to HTML 4.01 as
+       XML would allow. XHTML 1.1 is an updated version of
+       XHTML 1.0 strict, and no version of HTML strict has
+       ever included the target attribute. The other two
+       versions, transitional and frameset, were not updated,
+       because there was nothing to update. If you want to
+       use the target attribute, use XHTML 1.0 transitional.
+
+And, yes, this is the ONLY mention of "target" in the W3C's FAQ.
+
+If you want slightly more information, a thread at
+       http://www.thescripts.com/forum/thread96361.html
+asks and answers the question:
+
+       If this attribute is indeed deprecated, which seems to
+       be the case, is there an alternative to
+       target="_blank" to open hyperlinks in a new/blank
+       window?
+
+       Not that I know of, other than using javascript.
+
+Nice one, W3C!  Way to improve cross-browser portability!
+</%doc>
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE html 
-     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
   <title>IRSpy help: <% $help %></title>
   <style type="text/css">
-   body { background: #ffffc0; font-size: small }
+   body { background: #ffffc0 }
+   h1 { background: #d4e7f3; padding: 0.25em 0.5em;
+       font-size: 150%; text-align: center }
    ul.gappy li { margin-top: 1em }
+   .small { font-size: small }
   </style>
   <script type="text/JavaScript">
    function sendOpener (relativeURI) {
-    /*alert(opener.document.location.host + relativeURI);*/
+%#  alert(opener.document.location.host + relativeURI);
     opener.document.location = relativeURI;
    }
   </script>
  </head>
  <body>
   <h1>IRSpy help: <% $help %></h1>
-% $m->comp("/help/$help.html");
+<%perl>
+my @path = split /\//, $help;
+foreach my $i (0 .. $#path) {
+    my $partialPath = join("/", @path[0..$#path-$i]);
+    eval { $m->comp("/help/$partialPath.html") };
+    print "  <p>[No help for '$partialPath']</p>\n" if $@;
+}
+</%perl>
+  <p style="text-align: center">
+   <input type="button" onclick="self.close()" value="OK"/>
+  </p>
  </body>
 </html>