diff options
Diffstat (limited to 'zend/documentation/manual/core/en/doc-standard.file-formatting.html')
| -rw-r--r-- | zend/documentation/manual/core/en/doc-standard.file-formatting.html | 599 |
1 files changed, 599 insertions, 0 deletions
diff --git a/zend/documentation/manual/core/en/doc-standard.file-formatting.html b/zend/documentation/manual/core/en/doc-standard.file-formatting.html new file mode 100644 index 0000000..b395748 --- /dev/null +++ b/zend/documentation/manual/core/en/doc-standard.file-formatting.html @@ -0,0 +1,599 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <meta http-equiv="content-type" content="text/html; charset=UTF-8"/> + <title>Documentation File Formatting - Zend Framework Manual</title> + +</head> +<body> +<table width="100%"> + <tr valign="top"> + <td width="85%"> + <table width="100%"> + <tr> + <td width="25%" style="text-align: left;"> + <a href="doc-standard.overview.html">Overview</a> + </td> + + <td width="50%" style="text-align: center;"> + <div class="up"><span class="up"><a href="doc-standard.html">Zend Framework Documentation Standard</a></span><br /> + <span class="home"><a href="manual.html">Programmer's Reference Guide</a></span></div> + </td> + + <td width="25%" style="text-align: right;"> + <div class="next" style="text-align: right; float: right;"><a href="doc-standard.recommendations.html">Recommendations</a></div> + </td> + </tr> + </table> +<hr /> +<div id="doc-standard.file-formatting" class="section"><div class="info"><h1 class="title">Documentation File Formatting</h1></div> + + + <div class="section" id="doc-standard.file-formatting.xml-tags" name="doc-standard.file-formatting.xml-tags"><div class="info"><h1 class="title">XML Tags</h1></div> + + + <p class="para"> + Each manual file must include the following <acronym class="acronym">XML</acronym> declarations at + the top of the file: + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><?xml</span> <span style="color: #000066;">version</span>=<span style="color: #ff0000;">"1.0"</span> <span style="color: #000066;">encoding</span>=<span style="color: #ff0000;">"UTF-8"</span><span style="font-weight: bold; color: black;">?></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- Reviewed: no --></span></span></div></li></ol></div></div></div> + + + <p class="para"> + <acronym class="acronym">XML</acronym> files from translated languages must also include a revision + tag containing the revision of the corresponding English-language file the + translation was based on. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><?xml</span> <span style="color: #000066;">version</span>=<span style="color: #ff0000;">"1.0"</span> <span style="color: #000066;">encoding</span>=<span style="color: #ff0000;">"UTF-8"</span><span style="font-weight: bold; color: black;">?></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- EN-Revision: 14978 --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- Reviewed: no --></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.max-line-length" name="doc-standard.file-formatting.max-line-length"><div class="info"><h1 class="title">Maximum Line Length</h1></div> + + + <p class="para"> + The maximum line length, including tags, attributes, and indentation, is not to + exceed 100 characters. There is only one exception to this rule: attribute and value + pairs are allowed to exceed the 100 chars as they are not allowed to be separated. + </p> + </div> + + <div class="section" id="doc-standard.file-formatting.indentation" name="doc-standard.file-formatting.indentation"><div class="info"><h1 class="title">Indentation</h1></div> + + + <p class="para">Indentation should consist of 4 spaces. Tabs are not allowed.</p> + <p class="para">Tags which are at the same level must have the same indentation.</p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + Tags which are one level under the previous tag must be indented with 4 additional + spaces. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + Multiple block tags within the same line are not allowed; multiple inline tags are + allowed, however. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED: --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Magic<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span> does not exist. <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Acl<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span> does.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.line-termination" name="doc-standard.file-formatting.line-termination"><div class="info"><h1 class="title">Line Termination</h1></div> + + + <p class="para"> + Line termination follows the Unix text file convention. Lines must end with a + single linefeed (LF) character. Linefeed characters are represented as ordinal 10, + or hexadecimal 0x0A. + </p> + + <p class="para"> + Note: Do not use carriage returns (<acronym class="acronym">CR</acronym>) as is the convention in + Apple OS's (0x0D) or the carriage return - linefeed combination + (<acronym class="acronym">CRLF</acronym>) as is standard for the Windows OS (0x0D, 0x0A). + </p> + </div> + + <div class="section" id="doc-standard.file-formatting.empty-tags" name="doc-standard.file-formatting.empty-tags"><div class="info"><h1 class="title">Empty tags</h1></div> + + + <p class="para"> + Empty tags are not allowed; all tags must contain text or child tags. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Some text. <span style="color: #009900;"><span style="font-weight: bold; color: black;"><link<span style="font-weight: bold; color: black;">></span></span></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></link<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.whitespace" name="doc-standard.file-formatting.whitespace"><div class="info"><h1 class="title">Usage of whitespace within documents</h1></div> + + + <div class="section" id="doc-standard.file-formatting.whitespace.trailing" name="doc-standard.file-formatting.whitespace.trailing"><div class="info"><h1 class="title">Whitespace within tags</h1></div> + + + <p class="para"> + Opening block tags should have no whitespace immediately following them other + than line breaks (and indentation on the following line). + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span>WHITESPACE</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + Opening inline tags should have no whitespace immediately following them. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;">This is the class <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span> Zend_Class<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span>.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;">This is the class <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span>.</div></li></ol></div></div></div> + + + <p class="para"> + Closing block tags may be preceded by whitespace equivalent to the current + indentation level, but no more than that amount. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + Closing inline tags must not be preceded by any whitespace. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;">This is the class <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class <span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;">This is the class <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.whitespace.multiple-line-breaks" name="doc-standard.file-formatting.whitespace.multiple-line-breaks"><div class="info"><h1 class="title">Multiple line breaks</h1></div> + + + <p class="para"> + Multiple line breaks within or between tags are not allowed. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Some text...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> ... and more text</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Another paragraph.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Some text...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> ... and more text</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Another paragraph.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.whitespace.tag-separation" name="doc-standard.file-formatting.whitespace.tag-separation"><div class="info"><h1 class="title">Separation between tags</h1></div> + + + <p class="para"> + Tags at the same level must be separated by an empty line to improve + readability. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Some text...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> More text...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Some text...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> More text...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + The first child tag should open directly below its parent, with no empty line + between them; the last child tag should close directly before the closing tag of + its parent. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect2<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></sect1<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + </div> + + <div class="section" id="doc-standard.file-formatting.program-listing" name="doc-standard.file-formatting.program-listing"><div class="info"><h1 class="title">Program Listings</h1></div> + + + <p class="para"> + The opening <em class="emphasis"><programlisting></em> tag must indicate the + appropriate "language" attribute and be indented at the same level as its sibling + blocks. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span>Sibling paragraph.<span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"></span</div></li></ol></div></div></div> + + + <p class="para"> + <acronym class="acronym">CDATA</acronym> should be used around all program listings. + </p> + + <p class="para"> + <em class="emphasis"><programlisting></em> sections must not add linebreaks or + whitespace at the beginning or end of the section, as these are then represented in + the final output. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">$render = "xxx";</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">]]></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">$render = "xxx";</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">]]></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + Ending <acronym class="acronym">CDATA</acronym> and <em class="emphasis"><programlisting></em> + tags should be on the same line, without any indentation. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">$render = "xxx";</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">]]></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">$render = "xxx";</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"> ]]></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">$render = "xxx";</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;">]]></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + The <em class="emphasis"><programlisting></em> tag should contain the "language" + attribute with a value appropriate to the contents of the program listing. Typical + values include "css", "html", "ini", "javascript", "php", "text", and "xml". + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- PHP --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;">></span></span><span style="color: #339933;"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"><!-- Javascript --></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"><programlisting language="javascript"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"><!-- XML --></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"><programlisting language="xml"><![CDATA[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #339933;"></span</div></li></ol></div></div></div> + + + <p class="para"> + For program listings containing only <acronym class="acronym">PHP</acronym> code, + <acronym class="acronym">PHP</acronym> tags (e.g., "<?php", "?>") are not required, and + should not be used. They simply clutter the narrative, and are implied by the use + of the <em class="emphasis"><programlisting></em> tag. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;"><</span>!<span style="color: #66cc66;">[</span>CDATA<span style="color: #66cc66;">[</span><span style="font-weight: bold; color: black;"><?php</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> // ...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="font-weight: bold; color: black;">?></span></span>]]><span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><programlisting</span> <span style="color: #000066;">language</span>=<span style="color: #ff0000;">"php"</span><span style="font-weight: bold; color: black;"><</span>!<span style="color: #66cc66;">[</span>CDATA<span style="color: #66cc66;">[</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="font-weight: bold; color: black;"><?php</span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> // ...</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="font-weight: bold; color: black;">?></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;">]]><span style="color: #009900;"><span style="font-weight: bold; color: black;"></programlisting<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + + <p class="para"> + Line lengths within program listings should follow the <a href="coding-standard.php-file-formatting.html#coding-standard.php-file-formatting.max-line-length" class="link">coding standards + recommendations</a>. + </p> + + <p class="para"> + Refrain from using <span class="methodname">require_once()</span>, + <span class="methodname">require()</span>, <span class="methodname">include_once()</span>, and + <span class="methodname">include()</span> calls within <acronym class="acronym">PHP</acronym> listings. + They simply clutter the narrative, and are largely obviated when using an + autoloader. Use them only when they are essential to the example. + </p> + + <blockquote><p><b class="note">Note</b>: <span class="info"><b>Never use short tags</b><br /></span> + + + + Short tags (e.g., "<?", "<?=") should never be used within + <em class="emphasis">programlisting</em> or the narrative of a document. + <br /> + </p></blockquote> + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags" name="doc-standard.file-formatting.inline-tags"><div class="info"><h1 class="title">Notes on specific inline tags</h1></div> + + + <div class="section" id="doc-standard.file-formatting.inline-tags.classname" name="doc-standard.file-formatting.inline-tags.classname"><div class="info"><h1 class="title">classname</h1></div> + + + <p class="para"> + The tag <em class="emphasis"><classname></em> must be used each time a class + name is represented by itself; it should not be used when combined with a + method name, variable name, or constant, and no other content is allowed within + the tag. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> The class <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span>.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags.varname" name="doc-standard.file-formatting.inline-tags.varname"><div class="info"><h1 class="title">varname</h1></div> + + + <p class="para"> + Variables must be wrapped in the <em class="emphasis"><varname></em> tag. + Variables must be written using the "$" sigil. No other content is allowed + within this tag, unless a class name is used, which indicates a class variable. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> The variable <span style="color: #009900;"><span style="font-weight: bold; color: black;"><varname<span style="font-weight: bold; color: black;">></span></span></span>$var<span style="color: #009900;"><span style="font-weight: bold; color: black;"></varname<span style="font-weight: bold; color: black;">></span></span></span> and the class variable</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><varname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class::$var<span style="color: #009900;"><span style="font-weight: bold; color: black;"></varname<span style="font-weight: bold; color: black;">></span></span></span>.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags.methodname" name="doc-standard.file-formatting.inline-tags.methodname"><div class="info"><h1 class="title">methodname</h1></div> + + + <p class="para"> + Methods must be wrapped in the <em class="emphasis"><methodname></em> tag. + Methods must either include the full method signature or at the least a pair of + closing parentheses (e.g., "()"). No other content is allowed within this tag, + unless a class name is used, which indicates a class method. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> The method <span style="color: #009900;"><span style="font-weight: bold; color: black;"><methodname<span style="font-weight: bold; color: black;">></span></span></span>foo()<span style="color: #009900;"><span style="font-weight: bold; color: black;"></methodname<span style="font-weight: bold; color: black;">></span></span></span> and the class method</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><methodname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class::foo()<span style="color: #009900;"><span style="font-weight: bold; color: black;"></methodname<span style="font-weight: bold; color: black;">></span></span></span>. A method with a full signature:</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><methodname<span style="font-weight: bold; color: black;">></span></span></span>foo($bar, $baz)<span style="color: #009900;"><span style="font-weight: bold; color: black;"></methodname<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags.constant" name="doc-standard.file-formatting.inline-tags.constant"><div class="info"><h1 class="title">constant</h1></div> + + + <p class="para"> + Use the <em class="emphasis"><constant></em> tag when denoting constants. + Constants must be written in <acronym class="acronym">UPPERCASE</acronym>. No other content is + allowed within this tag, unless a class name is used, which indicates a class + constant. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> The constant <span style="color: #009900;"><span style="font-weight: bold; color: black;"><constant<span style="font-weight: bold; color: black;">></span></span></span>FOO<span style="color: #009900;"><span style="font-weight: bold; color: black;"></constant<span style="font-weight: bold; color: black;">></span></span></span> and the class constant</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> <span style="color: #009900;"><span style="font-weight: bold; color: black;"><constant<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class::FOO<span style="color: #009900;"><span style="font-weight: bold; color: black;"></constant<span style="font-weight: bold; color: black;">></span></span></span>.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags.filename" name="doc-standard.file-formatting.inline-tags.filename"><div class="info"><h1 class="title">filename</h1></div> + + + <p class="para"> + Filenames and paths must be wrapped in the + <em class="emphasis"><filename></em> tag. No other content is allowed in this + tag. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> The filename <span style="color: #009900;"><span style="font-weight: bold; color: black;"><filename<span style="font-weight: bold; color: black;">></span></span></span>application/Bootstrap.php<span style="color: #009900;"><span style="font-weight: bold; color: black;"></filename<span style="font-weight: bold; color: black;">></span></span></span>.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags.command" name="doc-standard.file-formatting.inline-tags.command"><div class="info"><h1 class="title">command</h1></div> + + + <p class="para"> + Commands, shell scripts, and program calls must be wrapped in the + <em class="emphasis"><command></em> tag. If the command includes arguments, + these should also be included within the tag. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><para<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> Execute <span style="color: #009900;"><span style="font-weight: bold; color: black;"><command<span style="font-weight: bold; color: black;">></span></span></span>zf.sh create project<span style="color: #009900;"><span style="font-weight: bold; color: black;"></command<span style="font-weight: bold; color: black;">></span></span></span>.</div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"></para<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + + <div class="section" id="doc-standard.file-formatting.inline-tags.code" name="doc-standard.file-formatting.inline-tags.code"><div class="info"><h1 class="title">code</h1></div> + + + <p class="para"> + Usage of the <em class="emphasis"><code></em> tag is discouraged, in favor of + the other inline tasks discussed previously. + </p> + </div> + </div> + + <div class="section" id="doc-standard.file-formatting.block-tags" name="doc-standard.file-formatting.block-tags"><div class="info"><h1 class="title">Notes on specific block tags</h1></div> + + + <div class="section" id="doc-standard.file-formatting.block-tags.title" name="doc-standard.file-formatting.block-tags.title"><div class="info"><h1 class="title">title</h1></div> + + + <p class="para"> + The <em class="emphasis"><title></em> tag is not allowed to hold other tags. + </p> + + <div class="programlisting xml"><div class="xmlcode"><div class="xml" style="font-family: monospace;"><ol><li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- NOT ALLOWED --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><title<span style="font-weight: bold; color: black;">></span></span></span>Using <span style="color: #009900;"><span style="font-weight: bold; color: black;"><classname<span style="font-weight: bold; color: black;">></span></span></span>Zend_Class<span style="color: #009900;"><span style="font-weight: bold; color: black;"></classname<span style="font-weight: bold; color: black;">></span></span></span><span style="color: #009900;"><span style="font-weight: bold; color: black;"></title<span style="font-weight: bold; color: black;">></span></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"> </div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="color: #808080; font-style: italic;"><!-- OK --></span></span></div></li> +<li style="font-family: 'Courier New', Courier, monospace; color: black; font-weight: normal; font-style: normal;"><div style="font-family: 'Courier New', Courier, monospace; font-weight: normal;"><span style="color: #009900;"><span style="font-weight: bold; color: black;"><title<span style="font-weight: bold; color: black;">></span></span></span>Using Zend_Class<span style="color: #009900;"><span style="font-weight: bold; color: black;"></title<span style="font-weight: bold; color: black;">></span></span></span></div></li></ol></div></div></div> + + </div> + </div> + </div> + <hr /> + + <table width="100%"> + <tr> + <td width="25%" style="text-align: left;"> + <a href="doc-standard.overview.html">Overview</a> + </td> + + <td width="50%" style="text-align: center;"> + <div class="up"><span class="up"><a href="doc-standard.html">Zend Framework Documentation Standard</a></span><br /> + <span class="home"><a href="manual.html">Programmer's Reference Guide</a></span></div> + </td> + + <td width="25%" style="text-align: right;"> + <div class="next" style="text-align: right; float: right;"><a href="doc-standard.recommendations.html">Recommendations</a></div> + </td> + </tr> + </table> +</td> + <td style="font-size: smaller;" width="15%"> <style type="text/css"> +#leftbar { + float: left; + width: 186px; + padding: 5px; + font-size: smaller; +} +ul.toc { + margin: 0px 5px 5px 5px; + padding: 0px; +} +ul.toc li { + font-size: 85%; + margin: 1px 0 1px 1px; + padding: 1px 0 1px 11px; + list-style-type: none; + background-repeat: no-repeat; + background-position: center left; +} +ul.toc li.header { + font-size: 115%; + padding: 5px 0px 5px 11px; + border-bottom: 1px solid #cccccc; + margin-bottom: 5px; +} +ul.toc li.active { + font-weight: bold; +} +ul.toc li a { + text-decoration: none; +} +ul.toc li a:hover { + text-decoration: underline; +} +</style> + <ul class="toc"> + <li class="header home"><a href="manual.html">Programmer's Reference Guide</a></li> + <li class="header up"><a href="manual.html">Programmer's Reference Guide</a></li> + <li class="header up"><a href="doc-standard.html">Zend Framework Documentation Standard</a></li> + <li><a href="doc-standard.overview.html">Overview</a></li> + <li class="active"><a href="doc-standard.file-formatting.html">Documentation File Formatting</a></li> + <li><a href="doc-standard.recommendations.html">Recommendations</a></li> + </ul> + </td> + </tr> +</table> +</body> +</html>
\ No newline at end of file |