<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html xmlns:fn="http://www.w3.org/2005/02/xpath-functions"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" href="../../../../doc/otp_doc.css" type="text/css"> <title>Erlang -- Block Tags</title> </head> <body bgcolor="white" text="#000000" link="#0000ff" vlink="#ff00ff" alink="#ff0000"><div id="container"> <script id="js" type="text/javascript" language="JavaScript" src="../../../../doc/js/flipmenu/flipmenu.js"></script><script id="js2" type="text/javascript" src="../../../../doc/js/erlresolvelinks.js"></script><script language="JavaScript" type="text/javascript"> <!-- function getWinHeight() { var myHeight = 0; if( typeof( window.innerHeight ) == 'number' ) { //Non-IE myHeight = window.innerHeight; } else if( document.documentElement && ( document.documentElement.clientWidth || document.documentElement.clientHeight ) ) { //IE 6+ in 'standards compliant mode' myHeight = document.documentElement.clientHeight; } else if( document.body && ( document.body.clientWidth || document.body.clientHeight ) ) { //IE 4 compatible myHeight = document.body.clientHeight; } return myHeight; } function setscrollpos() { var objf=document.getElementById('loadscrollpos'); document.getElementById("leftnav").scrollTop = objf.offsetTop - getWinHeight()/2; } function addEvent(obj, evType, fn){ if (obj.addEventListener){ obj.addEventListener(evType, fn, true); return true; } else if (obj.attachEvent){ var r = obj.attachEvent("on"+evType, fn); return r; } else { return false; } } addEvent(window, 'load', setscrollpos); //--></script><div id="leftnav"><div class="innertube"> <img alt="Erlang logo" src="../../../../doc/erlang-logo.png"><br><small><a href="users_guide.html">User's Guide</a><br><a href="index.html">Reference Manual</a><br><a href="release_notes.html">Release Notes</a><br><a href="../pdf/erl_docgen-0.3.3.pdf">PDF</a><br><a href="../../../../doc/index.html">Top</a></small><p><strong>Erl_Docgen</strong><br><strong>User's Guide</strong><br><small>Version 0.3.3</small></p> <br><a href="javascript:openAllFlips()">Expand All</a><br><a href="javascript:closeAllFlips()">Contract All</a><p><small><strong>Chapters</strong></small></p> <ul class="flipMenu" imagepath="../../../../doc/js/flipmenu"> <li id="no" title="How to Build OTP like documentation" expanded="false">How to Build OTP like documentation<ul> <li><a href="doc-build.html"> Top of chapter </a></li> <li title="Utilities to prepare XML files"><a href="doc-build.html#id63368">Utilities to prepare XML files</a></li> <li title="Use xsltproc to generate different output formats"><a href="doc-build.html#id61175">Use xsltproc to generate different output formats</a></li> </ul> </li> <li id="no" title="Overview OTP DTDs" expanded="false">Overview OTP DTDs<ul> <li><a href="overview.html"> Top of chapter </a></li> <li title="DTD Suite"><a href="overview.html#id64762">DTD Suite</a></li> <li title="Basic Tags"><a href="overview.html#id68138">Basic Tags</a></li> </ul> </li> <li id="no" title="User's Guide DTDs" expanded="false">User's Guide DTDs<ul> <li><a href="user_guide_dtds.html"> Top of chapter </a></li> <li title="The part DTD"><a href="user_guide_dtds.html#id60222">The part DTD</a></li> <li title="<part>"><a href="user_guide_dtds.html#id60510"><part></a></li> <li title="<description>"><a href="user_guide_dtds.html#id68097"><description></a></li> <li title="<include>"><a href="user_guide_dtds.html#id60627"><include></a></li> <li title="The chapter DTD"><a href="user_guide_dtds.html#id68049">The chapter DTD</a></li> <li title="<chapter>"><a href="user_guide_dtds.html#id63655"><chapter></a></li> <li title="<section>"><a href="user_guide_dtds.html#id62101"><section></a></li> <li title="<title>"><a href="user_guide_dtds.html#id62142"><title></a></li> </ul> </li> <li id="no" title="Reference Manual DTDs" expanded="false">Reference Manual DTDs<ul> <li><a href="refman_dtds.html"> Top of chapter </a></li> <li title="The application DTD"><a href="refman_dtds.html#id64613">The application DTD</a></li> <li title="<application>"><a href="refman_dtds.html#id64497"><application></a></li> <li title="The appref DTD"><a href="refman_dtds.html#id67949">The appref DTD</a></li> <li title="The comref DTD"><a href="refman_dtds.html#id63005">The comref DTD</a></li> <li title="The cref DTD"><a href="refman_dtds.html#id65218">The cref DTD</a></li> <li title="The erlref DTD"><a href="refman_dtds.html#id65347">The erlref DTD</a></li> <li title="The fileref DTD"><a href="refman_dtds.html#id65477">The fileref DTD</a></li> <li title="<description>"><a href="refman_dtds.html#id65618"><description></a></li> <li title="<section>"><a href="refman_dtds.html#id65651"><section></a></li> <li title="<funcs>"><a href="refman_dtds.html#id65692"><funcs></a></li> <li title="<func>"><a href="refman_dtds.html#id65718"><func></a></li> <li title="<name>"><a href="refman_dtds.html#id65761"><name></a></li> <li title="<fsummary>"><a href="refman_dtds.html#id65831"><fsummary></a></li> <li title="<type>"><a href="refman_dtds.html#id65859"><type></a></li> <li title="<v>"><a href="refman_dtds.html#id65891"><v></a></li> <li title="<d>"><a href="refman_dtds.html#id65907"><d></a></li> <li title="<desc>"><a href="refman_dtds.html#id65934"><desc></a></li> <li title="<authors>"><a href="refman_dtds.html#id65964"><authors></a></li> <li title="<aname>"><a href="refman_dtds.html#id66000"><aname></a></li> <li title="<email>"><a href="refman_dtds.html#id66016"><email></a></li> </ul> </li> <li id="no" title="Header Tags" expanded="false">Header Tags<ul> <li><a href="header_tags.html"> Top of chapter </a></li> <li title="<header>"><a href="header_tags.html#id66099"><header></a></li> <li title="<copyright>"><a href="header_tags.html#id66115"><copyright></a></li> <li title="<legalnotice>"><a href="header_tags.html#id66159"><legalnotice></a></li> <li title="<title>"><a href="header_tags.html#id66188"><title></a></li> <li title="<shorttitle>"><a href="header_tags.html#id66219"><shorttitle></a></li> <li title="<prepared>"><a href="header_tags.html#id66234"><prepared></a></li> <li title="<responsible>"><a href="header_tags.html#id66250"><responsible></a></li> <li title="<docno>"><a href="header_tags.html#id66266"><docno></a></li> <li title="<approved>"><a href="header_tags.html#id66297"><approved></a></li> <li title="<checked>"><a href="header_tags.html#id66313"><checked></a></li> <li title="<date>"><a href="header_tags.html#id66328"><date></a></li> <li title="<rev>"><a href="header_tags.html#id66344"><rev></a></li> <li title="<file>"><a href="header_tags.html#id66376"><file></a></li> </ul> </li> <li id="loadscrollpos" title="Block Tags" expanded="true">Block Tags<ul> <li><a href="block_tags.html"> Top of chapter </a></li> <li title="<br> - Line Break"><a href="block_tags.html#id66498"><br> - Line Break</a></li> <li title="<code> - Code Example"><a href="block_tags.html#id66536"><code> - Code Example</a></li> <li title="<codeinclude> - Code Inclusion"><a href="block_tags.html#id66589"><codeinclude> - Code Inclusion</a></li> <li title="<erleval> - Erlang Evaluation"><a href="block_tags.html#id66663"><erleval> - Erlang Evaluation</a></li> <li title="<list> - List"><a href="block_tags.html#id66698"><list> - List</a></li> <li title="<marker> - Marker"><a href="block_tags.html#id66782"><marker> - Marker</a></li> <li title="<p> - Paragraph"><a href="block_tags.html#id66808"><p> - Paragraph</a></li> <li title="<note> - Note"><a href="block_tags.html#id66849"><note> - Note</a></li> <li title="<pre> - Pre-formatted Text"><a href="block_tags.html#id66895"><pre> - Pre-formatted Text</a></li> <li title="<quote> - Quotation"><a href="block_tags.html#id66970"><quote> - Quotation</a></li> <li title="<taglist> - Definition List"><a href="block_tags.html#id67018"><taglist> - Definition List</a></li> <li title="<warning> - Warning"><a href="block_tags.html#id67121"><warning> - Warning</a></li> <li title="<image> - Image"><a href="block_tags.html#id67173"><image> - Image</a></li> <li title="<table> - Table"><a href="block_tags.html#id67236"><table> - Table</a></li> </ul> </li> <li id="no" title="Inline Tags" expanded="false">Inline Tags<ul> <li><a href="inline_tags.html"> Top of chapter </a></li> <li title="<br> - Line Break"><a href="inline_tags.html#id67434"><br> - Line Break</a></li> <li title="<c> - Code"><a href="inline_tags.html#id67460"><c> - Code</a></li> <li title="<em> - Emphasis"><a href="inline_tags.html#id67508"><em> - Emphasis</a></li> <li title="<marker> - Marker"><a href="inline_tags.html#id67549"><marker> - Marker</a></li> <li title="<seealso> - Local Cross Reference"><a href="inline_tags.html#id67607"><seealso> - Local Cross Reference</a></li> <li title="<url> - Non-Local Cross Reference"><a href="inline_tags.html#id67687"><url> - Non-Local Cross Reference</a></li> <li title="<term>, <termdef> - Glossary"><a href="inline_tags.html#id67726"><term>, <termdef> - Glossary</a></li> <li title="<cite>, <citedef> - Bibliography"><a href="inline_tags.html#id67790"><cite>, <citedef> - Bibliography</a></li> </ul> </li> <li id="no" title="Character Entities" expanded="false">Character Entities<ul> <li><a href="character_entities.html"> Top of chapter </a></li> <li title="Added Latin 1"><a href="character_entities.html#id67860">Added Latin 1</a></li> </ul> </li> </ul> </div></div> <div id="content"> <div class="innertube"> <h1>6 Block Tags</h1> <p>Block tags typically define a separate block of information, such as a paragraph or a list.</p> <p>The following subset of block tags are common for all DTDs in the OTP DTD suite: <a name="block_subset"></a> <span class="bold_code"><a href="#pTAG"><p></a></span>, <span class="bold_code"><a href="#preTAG"><pre></a></span>, <span class="bold_code"><a href="#codeTAG"><code></a></span>, <span class="bold_code"><a href="#listTAG"><list></a></span>, <span class="bold_code"><a href="#taglistTAG"><taglist></a></span>, <span class="bold_code"><a href="#codeincludeTAG"><codeinclude></a></span> and <span class="bold_code"><a href="#erlevalTAG"><erleval></a></span>. </p> <h3><a name="id66498">6.1 <br> - Line Break</a></h3> <a name="brTAG"></a> <p>Forces a newline. Example:</p> <div class="example"><pre> Eat yourself<br/>senseless! </pre></div> <p>results in:</p> <p>Eat yourself<br>senseless!</p> <p>The <span class="code"><br></span> tag is both a block- and an inline tag.</p> <h3><a name="id66536">6.2 <code> - Code Example</a></h3> <a name="codeTAG"></a> <p>Highlight code examples. Example:</p> <div class="example"><pre> <code> sum([H|T]) -> H + sum(T); sum([]) -> 0. </code> </pre></div> <p>results in:</p> <div class="example"><pre> sum([H|T]) -> H + sum(T); sum([]) -> 0. </pre></div> <p>There is an attribute <span class="code">type = "erl" | "c" | "none"</span>, but currently this attribute is ignored. Default value is <span class="code">"none"</span></p> <div class="note"> <div class="label">Note</div> <div class="content"><p> <p>No tags are allowed within the tag and no <span class="bold_code"><a href="character_entities.html">character entities</a></span> are expanded.</p> </p></div> </div> <h3><a name="id66589">6.3 <codeinclude> - Code Inclusion</a></h3> <a name="codeincludeTAG"></a> <p>Include external code snippets. The attribute <span class="code">file</span> gives the file name and <span class="code">tag</span> defines a string which delimits the code snippet. Example:</p> <div class="example"><pre> <codeinclude file="example.txt" tag="%% Erlang example"/> </pre></div> <p>results in:</p> <p>provided there is a file named <span class="code">examples.txt</span> looking like this: </p> <div class="example"><pre> ... %% Erlang example -module(example). start() -> {error,"Pid required!"}. start(Pid) -> spawn(fun() -> init(Pid) end). %% Erlang example ... </pre></div> <p>If the <span class="code">tag</span> attribute is omitted, the whole file is included.</p> <p>There is also an attribute <span class="code">type = "erl" | "c" | "none"</span>, but currently this attribute is ignored. Default value is <span class="code">"none"</span></p> <h3><a name="id66663">6.4 <erleval> - Erlang Evaluation</a></h3> <a name="erlevalTAG"></a> <p>Include the result from evaluating an Erlang expression. Example: </p> <div class="example"><pre> <erleval expr="{A,b,C}={a,b,c}. "/> </pre></div> <p>results in:</p> <p>Note the '.' and space after the expression.</p> <h3><a name="id66698">6.5 <list> - List</a></h3> <a name="listTAG"></a> <p>The attribute <span class="code">type = "ordered"|"bulleted"</span> decides if the list is numbered or bulleted. Default is <span class="code">"bulleted"</span>. </p> <p>Lists contains list items, tag <span class="code"><item></span>, which can contain plain text, the <span class="bold_code"><a href="#block_subset">common subset of block tags</a></span> and <span class="bold_code"><a href="inline_tags.html">inline tags</a></span>. Example:</p> <div class="example"><pre> <list type="ordered"> <item>Askosal: <list> <item>Nullalisis</item> <item>Facilisis</item> </list> </item> <item>Ankara</item> </list> </pre></div> <p>results in:</p> <ul> <li> <p>Askosal:</p> <ul> <li>Nullalisis</li> <li>Facilisis</li> </ul> </li> <li>Ankara</li> </ul> <h3><a name="id66782">6.6 <marker> - Marker</a></h3> <a name="markerTAG"></a> <p>Used as an anchor for hypertext references. The <span class="code"><marker></span> tag is both a block- and an inline tag and is described in the <span class="bold_code"><a href="inline_tags.html#markerTAG">Inline Tags</a></span> section.</p> <h3><a name="id66808">6.7 <p> - Paragraph</a></h3> <a name="pTAG"></a> <p>Paragraphs contain plain text and <span class="bold_code"><a href="inline_tags.html">inline tags</a></span>. Example:</p> <div class="example"><pre> <p>I call specific attention to the authority given by the <em>21st Amendment</em> to the Constitution to prohibit transportation or importation of intoxicating liquors into any State in violation of the laws of such State.</p> </pre></div> <p>results in:</p> <p>I call specific attention to the authority given by the <strong>21st Amendment</strong> to the Constitution to prohibit transportation or importation of intoxicating liquors into any State in violation of the laws of such State.</p> <h3><a name="id66849">6.8 <note> - Note</a></h3> <a name="noteTAG"></a> <p>Highlights a note. Can contain block tags except <span class="code"><note></span>, <span class="code"><warning></span>, <span class="code"><image></span> and <span class="code"><table></span>. Example:</p> <div class="example"><pre> <note> <p>This function is mainly intended for debugging.</p> </note> </pre></div> <p>results in:</p> <div class="note"> <div class="label">Note</div> <div class="content"><p> <p>This function is mainly intended for debugging.</p> </p></div> </div> <h3><a name="id66895">6.9 <pre> - Pre-formatted Text</a></h3> <a name="preTAG"></a> <p>Used for documentation of system interaction. Can contain text, <span class="bold_code"><a href="inline_tags.html#seealsoTAG">seealso</a></span>, <span class="bold_code"><a href="inline_tags.html#urlTAG">url</a></span> and <span class="code"><input></span> tags.</p> <p>The <span class="code"><input></span> tag is used to highlight user input. Example:</p> <div class="example"><pre> <pre> $ <input>erl</input> Erlang (BEAM) emulator version 5.5.3 [async-threads:0] [hipe] [kernel-poll:false] Eshell V5.5.3 (abort with ^G) 1> <input>pwd().</input> /home/user 2> <input>halt().</input> </pre> </pre></div> <p> results in:</p> <div class="example"><pre> $ <span class="bold_code">erl</span> Erlang (BEAM) emulator version 5.5.3 [async-threads:0] [hipe] [kernel-poll:false] Eshell V5.5.3 (abort with ^G) 1> <span class="bold_code">pwd().</span> /home/user 2> <span class="bold_code">halt().</span> </pre></div> <p>All <span class="bold_code"><a href="character_entities.html">character entities</a></span> are expanded.</p> <h3><a name="id66970">6.10 <quote> - Quotation</a></h3> <a name="quoteTAG"></a> <p>Highlight quotations from other works, or dialog spoken by characters in a narrative. Contains one or more <span class="bold_code"><a href="#pTAG"><p></a></span> tags. Example:</p> <div class="example"><pre> <p>Whereas Section 217(a) of the Act of Congress entitled "An Act ..." approved June 16, 1933, provides as follows:</p> <quote> <p>Section 217(a) The President shall proclaim the law.</p> </quote> </pre></div> <p>results in:</p> <p>Whereas Section 217(a) of the Act of Congress entitled "An Act ..." approved June 16, 1933, provides as follows:</p> <p>Section 217(a) The President shall proclaim the law.</p> <h3><a name="id67018">6.11 <taglist> - Definition List</a></h3> <a name="taglistTAG"></a> <a name="tagTAG"></a> <p>Definition lists contains pairs of tags, <span class="code"><tag></span>, and list items, <span class="code"><item></span>.</p> <p><span class="code"><tag></span> can contain plain text, <span class="bold_code"><a href="inline_tags.html#cTAG"><c></a></span>, <span class="bold_code"><a href="inline_tags.html#emTAG"><em></a></span>, <span class="bold_code"><a href="inline_tags.html#seealsoTAG"><seealso></a></span> and <span class="bold_code"><a href="inline_tags.html#urlTAG"><url></a></span> tags.</p> <p><span class="code"><item></span> can contain plain text, the <span class="bold_code"><a href="#block_subset">common subset of block tags</a></span> and <span class="bold_code"><a href="inline_tags.html">inline tags</a></span>. Example:</p> <div class="example"><pre> <taglist> <tag><c>eacces</c></tag> <item>Permission denied.</item> <tag><c>enoent</c></tag> <item>No such file or directory.</item> </taglist> </pre></div> <p>results in:</p> <dl> <dt><strong><span class="code">eacces</span></strong></dt> <dd>Permission denied.</dd> <dt><strong><span class="code">enoent</span></strong></dt> <dd>No such file or directory.</dd> </dl> <h3><a name="id67121">6.12 <warning> - Warning</a></h3> <a name="warningTAG"></a> <p>Highlights a warning. Can contain block tags except <span class="code"><note></span>, <span class="code"><warning></span>, <span class="code"><image></span> and <span class="code"><table></span>. Example:</p> <div class="example"><pre> <warning> <p>This function might be removed in a future version without prior warning.</p> </warning> </pre></div> <p>results in:</p> <div class="warning"> <div class="label">Warning</div> <div class="content"><p> <p>This function might be removed in a future version without prior warning.</p> </p></div> </div> <h3><a name="id67173">6.13 <image> - Image</a></h3> <a name="imageTAG"></a> <a name="icaptionTAG"></a> <p>Graphics is imported using the <span class="code"><image></span> tag. An image caption <span class="code"><icaption></span>, containing plain text, must be supplied. Example:</p> <div class="example"><pre> <image file="man"> <icaption>A Silly Man</icaption> </image> </pre></div> <p>results in:</p> <img alt="IMAGE MISSING" src="man.gif"><br> <em>Figure 6.1: A Silly Man</em> <p>This assumes that <span class="code">man.gif</span> exists in the current directory. </p> <h3><a name="id67236">6.14 <table> - Table</a></h3> <a name="tableTAG"></a> <a name="rowTAG"></a> <a name="cellTAG"></a> <a name="tcaptionTAG"></a> <p>The table format is similar to how tables are described in HTML 3.2. A table contains one or more rows, <span class="code"><row></span>, and a table caption <span class="code"><tcaption></span>, containing plain text.</p> <p>Each row contains one or more cells, <span class="code"><cell></span>. The attributes <span class="code">align = "left"|"center"|"right"</span> and <span class="code">valign = "top"|"middle"|"bottom"</span> decides how text is aligned in the cell horizontally and vertically. Default is "<span class="code">left</span>" and "<span class="code">middle</span>".</p> <p>Each cell contains plain text and <span class="bold_code"><a href="inline_tags.html">inline tags</a></span>. Example:</p> <div class="example"><pre> <table> <row> <cell align="left" valign="top"><em>Boys</em></cell> <cell align="center" valign="middle"><em>Girls</em></cell> </row> <row> <cell align="left" valign="middle">Juda</cell> <cell align="right" valign="bottom">Susy</cell> </row> <row> <cell align="left" valign="middle">Anders</cell> <cell align="left" valign="middle">Victoria</cell> </row> <tcaption>A table caption</tcaption> </table> </pre></div> <p>results in:</p> <table border="1" cellpadding="2" cellspacing="0"> <tr> <td align="left" valign="middle"><strong>Boys</strong></td> <td align="left" valign="middle"><strong>Girls</strong></td> </tr> <tr> <td align="left" valign="middle">Juda</td> <td align="left" valign="middle">Susy</td> </tr> <tr> <td align="left" valign="middle">Anders</td> <td align="left" valign="middle">Victoria</td> </tr> </table> <em>Table 6.1: A table caption</em> </div> <div class="footer"> <hr> <p>Copyright © 2004-2012 Ericsson AB. All Rights Reserved.</p> </div> </div> </div></body> </html>