<!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 -- User's Guide DTDs</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/docbuilder-0.9.8.7.pdf">PDF</a><br><a href="../../../../doc/index.html">Top</a></small><p><strong>DocBuilder</strong><br><strong>User's Guide</strong><br><small>Version 0.9.8.7</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="Overview" expanded="false">Overview<ul> <li><a href="overview.html"> Top of chapter </a></li> <li title="Background"><a href="overview.html#id2255927">Background</a></li> <li title="DTD Suite"><a href="overview.html#id2261226">DTD Suite</a></li> <li title="Structure of Generated HTML"><a href="overview.html#id2252211">Structure of Generated HTML</a></li> <li title="Basic Tags"><a href="overview.html#id2259883">Basic Tags</a></li> <li title="About This Document"><a href="overview.html#id2259327">About This Document</a></li> <li title="Usage"><a href="overview.html#id2259855">Usage</a></li> </ul> </li> <li id="loadscrollpos" title="User's Guide DTDs" expanded="true">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#id2255918">The part DTD</a></li> <li title="<part>"><a href="user_guide_dtds.html#id2252604"><part></a></li> <li title="<description>"><a href="user_guide_dtds.html#id2257848"><description></a></li> <li title="<include>"><a href="user_guide_dtds.html#id2259250"><include></a></li> <li title="The chapter DTD"><a href="user_guide_dtds.html#id2260255">The chapter DTD</a></li> <li title="<chapter>"><a href="user_guide_dtds.html#id2259926"><chapter></a></li> <li title="<section>"><a href="user_guide_dtds.html#id2259200"><section></a></li> <li title="<title>"><a href="user_guide_dtds.html#id2252192"><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#id2259344">The application DTD</a></li> <li title="<application>"><a href="refman_dtds.html#id2258600"><application></a></li> <li title="The appref DTD"><a href="refman_dtds.html#id2261527">The appref DTD</a></li> <li title="The comref DTD"><a href="refman_dtds.html#id2261698">The comref DTD</a></li> <li title="The cref DTD"><a href="refman_dtds.html#id2261823">The cref DTD</a></li> <li title="The erlref DTD"><a href="refman_dtds.html#id2253008">The erlref DTD</a></li> <li title="The fileref DTD"><a href="refman_dtds.html#id2255212">The fileref DTD</a></li> <li title="<description>"><a href="refman_dtds.html#id2252314"><description></a></li> <li title="<section>"><a href="refman_dtds.html#id2261020"><section></a></li> <li title="<funcs>"><a href="refman_dtds.html#id2261064"><funcs></a></li> <li title="<func>"><a href="refman_dtds.html#id2261090"><func></a></li> <li title="<name>"><a href="refman_dtds.html#id2261135"><name></a></li> <li title="<fsummary>"><a href="refman_dtds.html#id2265198"><fsummary></a></li> <li title="<type>"><a href="refman_dtds.html#id2265227"><type></a></li> <li title="<v>"><a href="refman_dtds.html#id2265260"><v></a></li> <li title="<d>"><a href="refman_dtds.html#id2265277"><d></a></li> <li title="<desc>"><a href="refman_dtds.html#id2265306"><desc></a></li> <li title="<authors>"><a href="refman_dtds.html#id2265337"><authors></a></li> <li title="<aname>"><a href="refman_dtds.html#id2265373"><aname></a></li> <li title="<email>"><a href="refman_dtds.html#id2265389"><email></a></li> </ul> </li> <li id="no" title="Fascicules DTDs" expanded="false">Fascicules DTDs<ul> <li><a href="fasc_dtds.html"> Top of chapter </a></li> <li title="The fascicules DTD"><a href="fasc_dtds.html#id2265458">The fascicules DTD</a></li> <li title="<fascicules>"><a href="fasc_dtds.html#id2265565"><fascicules></a></li> <li title="<fascicule>"><a href="fasc_dtds.html#id2265595"><fascicule></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#id2263347"><header></a></li> <li title="<copyright>"><a href="header_tags.html#id2263363"><copyright></a></li> <li title="<legalnotice>"><a href="header_tags.html#id2263412"><legalnotice></a></li> <li title="<title>"><a href="header_tags.html#id2263441"><title></a></li> <li title="<shorttitle>"><a href="header_tags.html#id2263474"><shorttitle></a></li> <li title="<prepared>"><a href="header_tags.html#id2263492"><prepared></a></li> <li title="<responsible>"><a href="header_tags.html#id2263509"><responsible></a></li> <li title="<docno>"><a href="header_tags.html#id2263526"><docno></a></li> <li title="<approved>"><a href="header_tags.html#id2263559"><approved></a></li> <li title="<checked>"><a href="header_tags.html#id2263576"><checked></a></li> <li title="<date>"><a href="header_tags.html#id2263594"><date></a></li> <li title="<rev>"><a href="header_tags.html#id2263611"><rev></a></li> <li title="<file>"><a href="header_tags.html#id2263644"><file></a></li> </ul> </li> <li id="no" title="Block Tags" expanded="false">Block Tags<ul> <li><a href="block_tags.html"> Top of chapter </a></li> <li title="<br> - Line Break"><a href="block_tags.html#id2263775"><br> - Line Break</a></li> <li title="<code> - Code Example"><a href="block_tags.html#id2263814"><code> - Code Example</a></li> <li title="<codeinclude> - Code Inclusion"><a href="block_tags.html#id2263872"><codeinclude> - Code Inclusion</a></li> <li title="<erleval> - Erlang Evaluation"><a href="block_tags.html#id2263953"><erleval> - Erlang Evaluation</a></li> <li title="<list> - List"><a href="block_tags.html#id2263989"><list> - List</a></li> <li title="<marker> - Marker"><a href="block_tags.html#id2264076"><marker> - Marker</a></li> <li title="<p> - Paragraph"><a href="block_tags.html#id2264104"><p> - Paragraph</a></li> <li title="<note> - Note"><a href="block_tags.html#id2264149"><note> - Note</a></li> <li title="<pre> - Pre-formatted Text"><a href="block_tags.html#id2264198"><pre> - Pre-formatted Text</a></li> <li title="<quote> - Quotation"><a href="block_tags.html#id2264278"><quote> - Quotation</a></li> <li title="<taglist> - Definition List"><a href="block_tags.html#id2264331"><taglist> - Definition List</a></li> <li title="<warning> - Warning"><a href="block_tags.html#id2264437"><warning> - Warning</a></li> <li title="<image> - Image"><a href="block_tags.html#id2264492"><image> - Image</a></li> <li title="<table> - Table"><a href="block_tags.html#id2264557"><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#id2264769"><br> - Line Break</a></li> <li title="<c> - Code"><a href="inline_tags.html#id2264797"><c> - Code</a></li> <li title="<em> - Emphasis"><a href="inline_tags.html#id2264848"><em> - Emphasis</a></li> <li title="<marker> - Marker"><a href="inline_tags.html#id2264891"><marker> - Marker</a></li> <li title="<path> - Path"><a href="inline_tags.html#id2264939"><path> - Path</a></li> <li title="<seealso> - Local Cross Reference"><a href="inline_tags.html#id2265025"><seealso> - Local Cross Reference</a></li> <li title="<url> - Non-Local Cross Reference"><a href="inline_tags.html#id2265132"><url> - Non-Local Cross Reference</a></li> <li title="<term>, <termdef> - Glossary"><a href="inline_tags.html#id2266646"><term>, <termdef> - Glossary</a></li> <li title="<cite>, <citedef> - Bibliography"><a href="inline_tags.html#id2266761"><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#id2266872">Added Latin 1</a></li> </ul> </li> </ul> </div></div> <div id="content"> <div class="innertube"> <h1>2 User's Guide DTDs</h1> <h3><a name="id2255918">2.1 The part DTD</a></h3> <a name="partDTD"></a> <p>The <span class="code">part</span> DTD is intended for a "normal" document, like the User's Guide or Release Notes. First are some paragraphs introducing the main contents. After that follows chapters, written in separate files with the <span class="bold_code"><a href="#chapterDTD">chapter</a></span> DTD.</p> <p>Example:</p> <div class="example"><pre> <?xml version="1.0" encoding="latin1" ?> <!DOCTYPE part SYSTEM "part.dtd"> <part> <header> <title>The chapter title</title> <prepared>The author</prepared> <docno/> <date/> <rev/> </header> <description> <p>Some text..</p> </description> <include file="file1"></include> <include file="file2"></include> </part> </pre></div> <h3><a name="id2252604">2.2 <part></a></h3> <a name="partTAG"></a> <p>The top level tag of a <span class="code">part</span> DTD.</p> <p>Contains a <span class="bold_code"><a href="header_tags.html"><header></a></span>, an optional <span class="bold_code"><a href="#descriptionTAG"><description></a></span>, followed by one or more <span class="bold_code"><a href="#includeTAG"><include></a></span>.</p> <h3><a name="id2257848">2.3 <description></a></h3> <a name="descriptionTAG"></a> <p>The introduction after the title and before the bulk of included chapters/manual pages.</p> <p>Contains any combination and any number of <span class="bold_code"><a href="block_tags.html">block tags</a></span> except <span class="code"><image></span> and <span class="code"><table></span>.</p> <h3><a name="id2259250">2.4 <include></a></h3> <a name="includeTAG"></a> <p>An empty tag. The attribute <span class="code">file</span> specifies a file to include. The <span class="code">.xml</span> file extension should be omitted.</p> <p>Example:</p> <div class="example"><pre> <include file="notes"></include> </pre></div> <h3><a name="id2260255">2.5 The chapter DTD</a></h3> <a name="chapterDTD"></a> <p>The <span class="code">chapter</span> DTD is intended for a chapter in a User's Guide or similar with text divided into sections, which can be nested.</p> <p>Example:</p> <div class="example"><pre> <?xml version="1.0" encoding="latin1" ?> <!DOCTYPE chapter SYSTEM "chapter.dtd"> <chapter> <header> <title>Title on first level</title> <prepared/> <docno/> <date/> <rev/> </header> <p>Introduction...</p> <section> <title>Title on second level</title> <p>First paragraph.</p> <p>Second paragraph etc.</p> <section> <title>Title on third level</title> <p>...</p> </section> </section> ... </chapter> </pre></div> <h3><a name="id2259926">2.6 <chapter></a></h3> <a name="chapterTAG"></a> <p>The top level tag of a <span class="code">chapter</span> DTD.</p> <p>Contains a <span class="bold_code"><a href="header_tags.html"><header></a></span>, an optional introduction consisting of any combination of <span class="bold_code"><a href="block_tags.html">block tags</a></span>, followed by one or more <span class="bold_code"><a href="#sectionTAG"><section></a></span>.</p> <h3><a name="id2259200">2.7 <section></a></h3> <a name="sectionTAG"></a> <p>Subdivision of a chapter.</p> <p>Contains an optional <span class="bold_code"><a href="inline_tags.html#markerTAG"><marker></a></span>, a <span class="bold_code"><a href="#titleTAG"><title></a></span>, followed by any combination and any number of <span class="bold_code"><a href="block_tags.html">block tags</a></span> and <span class="code"><section></span>.</p> <h3><a name="id2252192">2.8 <title></a></h3> <a name="titleTAG"></a> <p>Section title, contains plain text.</p> </div> <div class="footer"> <hr> <p>Copyright © 1997-2010 Ericsson AB. All Rights Reserved.</p> </div> </div> </div></body> </html>