--- /dev/null
+<HTML>\r
+<HEAD>\r
+ <!-- Created by GNNpress -->\r
+ <TITLE>The DefaultCommandRegistry reference guide.</TITLE>\r
+<!-- Changed by: Anselm Baird-Smith, 4-Feb-1997 -->\r
+</HEAD>\r
+<BODY BGCOLOR="white">\r
+<A HREF="http://www.w3.org/pub/WWW/" TARGET="_top_">\r
+ <IMG SRC="/icons/WWW/w3c_home.gif"\r
+ ALT="W3C"\r
+ BORDER="0" WIDTH="72" HEIGHT="48"></A>\r
+<A HREF="http://www.w3.org/pub/WWW/Jigsaw/" TARGET="_top_">\r
+ <IMG SRC="/icons/jigsaw" ALT="Jigsaw" BORDER="0">\r
+</A>\r
+<HR>\r
+<A HREF="resources.html">All Resources</A> \r
+<A HREF="filters.html">All filters </A>\r
+<HR>\r
+<H1>\r
+ DefaultCommandRegistry\r
+</H1>\r
+<P>\r
+This class provides the most general and commonly-used SSI commands.\r
+Compatibility with the NCSA-style directive set has been maintained as much\r
+as it made sense to, and new functionality adequate to Jigsaw has been added.\r
+<P>\r
+The following summary of the commands only discuss differences from the NCSA\r
+directive set. Please refer to\r
+<A HREF="http://hoohoo.ncsa.uiuc.edu/docs/tutorials/includes.html"> the NCSA\r
+server-side includes tutorial </A> for comparison.\r
+<P>\r
+The full set of commands of the DefaultCommandRegistry is:\r
+<DL>\r
+ <DT>\r
+ <A name="cmd-config"><CODE>config</CODE></A>\r
+ <DD>\r
+ The <CODE>errmsg</CODE> tag is not implemented.\r
+ <DT>\r
+ <A name="cmd-include"><CODE>include</CODE></A>\r
+ <DD>\r
+ The <CODE>file</CODE> and <CODE>virtual</CODE> tags are handled in the same\r
+ way. Both originate an internal request to the URL given as the value of\r
+ the tag. There is no provision for including a file that is not indexed by\r
+ Jigsaw. This command can be used to include the content of <EM>any</EM> resource.\r
+ This includes the SSIResource.\r
+ <P>\r
+ In addition, the following tags are admissible:\r
+ <DL>\r
+ <DT>\r
+ <CODE>ifheader</CODE>\r
+ <DD>\r
+ Its value is interpreted as a header name. It causes the resource to be included\r
+ only if that header was defined in the original (client) request.\r
+ <DT>\r
+ <CODE>else</CODE>\r
+ <DD>\r
+ Used in conjunction with <CODE>ifheader</CODE>, it specifies a URL to be\r
+ included in case the header is <EM>not</EM> defined.\r
+ </DL>\r
+ <DT>\r
+ <A name="cmd-echo"><CODE>echo</CODE></A>\r
+ <DD>\r
+ In addition to the <CODE>var</CODE> tag, which has the NCSA behavior, the\r
+ following tags are admissible:\r
+ <DL>\r
+ <DT>\r
+ <CODE>reqstate</CODE>\r
+ <DD>\r
+ Its value is interpreted as a Jigsaw request state, and is expanded as the\r
+ value of the state. For instance, the command <BR>\r
+ <CODE><!--#echo\r
+ reqstate="w3c.jigsaw.filters.CounterFilter.count"--></CODE><BR>\r
+ will print the current hit-count, assuming a CounterFilter exists for the\r
+ resource.\r
+ <DT>\r
+ <CODE>reqheader</CODE>\r
+ <DD>\r
+ Its value is interpreted as a header in the request, and is expanded as the\r
+ value of the header.\r
+ <DT>\r
+ <CODE>here</CODE> If this tag is present, command is expanded as interpreted\r
+ relative to the innermost internal request. By default, it is interpreted\r
+ relative to the original (client) request.\r
+ </DL>\r
+ <DT>\r
+ <A name="cmd-fsize"><CODE>fsize</CODE></A>\r
+ <DD>\r
+ Behaves like its NCSA counterpart, except that it also recognizes the tag\r
+ <CODE>here</CODE>. If present, this tag indicates to include the file size\r
+ of the innermost included file. Normally, it includes the file size of the\r
+ topmost SSI-parsed file requested by the client. It honors the\r
+ <CODE>sizefmt</CODE> variable, as set by <CODE>config</CODE>.\r
+ <DT>\r
+ <A name="cmd-flastmod"><CODE>flastmod</CODE></A>\r
+ <DD>\r
+ In addition to NCSA behavior, it honors the <CODE>here</CODE> tag, which\r
+ indicates to include the time stamp of the innermost included file.\r
+ <DT>\r
+ <A name="cmd-exec"><CODE>exec</CODE></A>\r
+ <DD>\r
+ It accepts <EM>only</EM> the <CODE>cmd</CODE> tag. Given that the\r
+ <CODE>include</CODE> command can include CgiResources, the <CODE>cgi</CODE>\r
+ tag is superfluous.\r
+ <P>\r
+ If the SSIResource <CODE>secure</CODE> attribute is set, this command will\r
+ be inoperative.\r
+ <DT>\r
+ <A name="cmd-params"><CODE>params</CODE></A>\r
+ <DD>\r
+ This command expands to an HTML unordered list of the parameters that it\r
+ was called with. Provided mainly for instructional purposes.\r
+ <DT>\r
+ <A name="cmd-count"><CODE>count</CODE></A>\r
+ <DD>\r
+ Expands to the access count reported by the CounterFilter. (This may or may\r
+ not mean the access count of the document, depending on the way the CounterFilter\r
+ is set up)\r
+</DL>\r
+<P>\r
+ <HR>\r
+<A href="mailto:anto@w3.org"><I>Antonio Ramírez</I></A><I><BR>\r
+$Id: w3c.jigsaw.ssi.DefaultCommandRegistry.html,v 1.1 2010/06/15 12:22:24 smhuang Exp $</I>\r
+<P>\r
+<P>\r
+</BODY></HTML>\r