Sophie

Sophie

distrib > Fedora > 13 > i386 > media > os > by-pkgid > f806c0f24240b25bde21a53f71766070 > files > 549

erlang-doc-R13B-04.6.fc13.noarch.rpm

<!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="&lt;part&gt;"><a href="user_guide_dtds.html#id2252604">&lt;part&gt;</a></li>
<li title="&lt;description&gt;"><a href="user_guide_dtds.html#id2257848">&lt;description&gt;</a></li>
<li title="&lt;include&gt;"><a href="user_guide_dtds.html#id2259250">&lt;include&gt;</a></li>
<li title="The chapter DTD"><a href="user_guide_dtds.html#id2260255">The chapter DTD</a></li>
<li title="&lt;chapter&gt;"><a href="user_guide_dtds.html#id2259926">&lt;chapter&gt;</a></li>
<li title="&lt;section&gt;"><a href="user_guide_dtds.html#id2259200">&lt;section&gt;</a></li>
<li title="&lt;title&gt;"><a href="user_guide_dtds.html#id2252192">&lt;title&gt;</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="&lt;application&gt;"><a href="refman_dtds.html#id2258600">&lt;application&gt;</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="&lt;description&gt;"><a href="refman_dtds.html#id2252314">&lt;description&gt;</a></li>
<li title="&lt;section&gt;"><a href="refman_dtds.html#id2261020">&lt;section&gt;</a></li>
<li title="&lt;funcs&gt;"><a href="refman_dtds.html#id2261064">&lt;funcs&gt;</a></li>
<li title="&lt;func&gt;"><a href="refman_dtds.html#id2261090">&lt;func&gt;</a></li>
<li title="&lt;name&gt;"><a href="refman_dtds.html#id2261135">&lt;name&gt;</a></li>
<li title="&lt;fsummary&gt;"><a href="refman_dtds.html#id2265198">&lt;fsummary&gt;</a></li>
<li title="&lt;type&gt;"><a href="refman_dtds.html#id2265227">&lt;type&gt;</a></li>
<li title="&lt;v&gt;"><a href="refman_dtds.html#id2265260">&lt;v&gt;</a></li>
<li title="&lt;d&gt;"><a href="refman_dtds.html#id2265277">&lt;d&gt;</a></li>
<li title="&lt;desc&gt;"><a href="refman_dtds.html#id2265306">&lt;desc&gt;</a></li>
<li title="&lt;authors&gt;"><a href="refman_dtds.html#id2265337">&lt;authors&gt;</a></li>
<li title="&lt;aname&gt;"><a href="refman_dtds.html#id2265373">&lt;aname&gt;</a></li>
<li title="&lt;email&gt;"><a href="refman_dtds.html#id2265389">&lt;email&gt;</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="&lt;fascicules&gt;"><a href="fasc_dtds.html#id2265565">&lt;fascicules&gt;</a></li>
<li title="&lt;fascicule&gt;"><a href="fasc_dtds.html#id2265595">&lt;fascicule&gt;</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="&lt;header&gt;"><a href="header_tags.html#id2263347">&lt;header&gt;</a></li>
<li title="&lt;copyright&gt;"><a href="header_tags.html#id2263363">&lt;copyright&gt;</a></li>
<li title="&lt;legalnotice&gt;"><a href="header_tags.html#id2263412">&lt;legalnotice&gt;</a></li>
<li title="&lt;title&gt;"><a href="header_tags.html#id2263441">&lt;title&gt;</a></li>
<li title="&lt;shorttitle&gt;"><a href="header_tags.html#id2263474">&lt;shorttitle&gt;</a></li>
<li title="&lt;prepared&gt;"><a href="header_tags.html#id2263492">&lt;prepared&gt;</a></li>
<li title="&lt;responsible&gt;"><a href="header_tags.html#id2263509">&lt;responsible&gt;</a></li>
<li title="&lt;docno&gt;"><a href="header_tags.html#id2263526">&lt;docno&gt;</a></li>
<li title="&lt;approved&gt;"><a href="header_tags.html#id2263559">&lt;approved&gt;</a></li>
<li title="&lt;checked&gt;"><a href="header_tags.html#id2263576">&lt;checked&gt;</a></li>
<li title="&lt;date&gt;"><a href="header_tags.html#id2263594">&lt;date&gt;</a></li>
<li title="&lt;rev&gt;"><a href="header_tags.html#id2263611">&lt;rev&gt;</a></li>
<li title="&lt;file&gt;"><a href="header_tags.html#id2263644">&lt;file&gt;</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="&lt;br&gt; - Line Break"><a href="block_tags.html#id2263775">&lt;br&gt; - Line Break</a></li>
<li title="&lt;code&gt; - Code Example"><a href="block_tags.html#id2263814">&lt;code&gt; - Code Example</a></li>
<li title="&lt;codeinclude&gt; - Code Inclusion"><a href="block_tags.html#id2263872">&lt;codeinclude&gt; - Code Inclusion</a></li>
<li title="&lt;erleval&gt; - Erlang Evaluation"><a href="block_tags.html#id2263953">&lt;erleval&gt; - Erlang Evaluation</a></li>
<li title="&lt;list&gt; - List"><a href="block_tags.html#id2263989">&lt;list&gt; - List</a></li>
<li title="&lt;marker&gt; - Marker"><a href="block_tags.html#id2264076">&lt;marker&gt; - Marker</a></li>
<li title="&lt;p&gt; - Paragraph"><a href="block_tags.html#id2264104">&lt;p&gt; - Paragraph</a></li>
<li title="&lt;note&gt; - Note"><a href="block_tags.html#id2264149">&lt;note&gt; - Note</a></li>
<li title="&lt;pre&gt; - Pre-formatted Text"><a href="block_tags.html#id2264198">&lt;pre&gt; - Pre-formatted Text</a></li>
<li title="&lt;quote&gt; - Quotation"><a href="block_tags.html#id2264278">&lt;quote&gt; - Quotation</a></li>
<li title="&lt;taglist&gt; - Definition List"><a href="block_tags.html#id2264331">&lt;taglist&gt; - Definition List</a></li>
<li title="&lt;warning&gt; - Warning"><a href="block_tags.html#id2264437">&lt;warning&gt; - Warning</a></li>
<li title="&lt;image&gt; - Image"><a href="block_tags.html#id2264492">&lt;image&gt; - Image</a></li>
<li title="&lt;table&gt; - Table"><a href="block_tags.html#id2264557">&lt;table&gt; - 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="&lt;br&gt; - Line Break"><a href="inline_tags.html#id2264769">&lt;br&gt; - Line Break</a></li>
<li title="&lt;c&gt; - Code"><a href="inline_tags.html#id2264797">&lt;c&gt; - Code</a></li>
<li title="&lt;em&gt; - Emphasis"><a href="inline_tags.html#id2264848">&lt;em&gt; - Emphasis</a></li>
<li title="&lt;marker&gt; - Marker"><a href="inline_tags.html#id2264891">&lt;marker&gt; - Marker</a></li>
<li title="&lt;path&gt; - Path"><a href="inline_tags.html#id2264939">&lt;path&gt; - Path</a></li>
<li title="&lt;seealso&gt; - Local Cross Reference"><a href="inline_tags.html#id2265025">&lt;seealso&gt; - Local Cross Reference</a></li>
<li title="&lt;url&gt; - Non-Local Cross Reference"><a href="inline_tags.html#id2265132">&lt;url&gt; - Non-Local Cross Reference</a></li>
<li title="&lt;term&gt;, &lt;termdef&gt; - Glossary"><a href="inline_tags.html#id2266646">&lt;term&gt;, &lt;termdef&gt; - Glossary</a></li>
<li title="&lt;cite&gt;, &lt;citedef&gt; - Bibliography"><a href="inline_tags.html#id2266761">&lt;cite&gt;, &lt;citedef&gt; - 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>
&lt;?xml version="1.0" encoding="latin1" ?&gt;
&lt;!DOCTYPE part SYSTEM "part.dtd"&gt;
&lt;part&gt;
  &lt;header&gt;
    &lt;title&gt;The chapter title&lt;/title&gt;
    &lt;prepared&gt;The author&lt;/prepared&gt;
    &lt;docno/&gt;
    &lt;date/&gt;
    &lt;rev/&gt;
  &lt;/header&gt;

  &lt;description&gt;
    &lt;p&gt;Some text..&lt;/p&gt;
  &lt;/description&gt;

  &lt;include file="file1"&gt;&lt;/include&gt;
  &lt;include file="file2"&gt;&lt;/include&gt;
&lt;/part&gt;
    </pre></div>
  

  <h3><a name="id2252604">2.2 
        &lt;part&gt;</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">&lt;header&gt;</a></span>,
      an optional
      <span class="bold_code"><a href="#descriptionTAG">&lt;description&gt;</a></span>,
      followed by one or more
      <span class="bold_code"><a href="#includeTAG">&lt;include&gt;</a></span>.</p>
  

  <h3><a name="id2257848">2.3 
        &lt;description&gt;</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">&lt;image&gt;</span> and <span class="code">&lt;table&gt;</span>.</p>
  

  <h3><a name="id2259250">2.4 
        &lt;include&gt;</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>
&lt;include file="notes"&gt;&lt;/include&gt;
    </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>
&lt;?xml version="1.0" encoding="latin1" ?&gt;
&lt;!DOCTYPE chapter SYSTEM "chapter.dtd"&gt;
&lt;chapter&gt;
  &lt;header&gt;
    &lt;title&gt;Title on first level&lt;/title&gt;
    &lt;prepared/&gt;
    &lt;docno/&gt;
    &lt;date/&gt;
    &lt;rev/&gt;
  &lt;/header&gt;
  
  &lt;p&gt;Introduction...&lt;/p&gt;

  &lt;section&gt;
    &lt;title&gt;Title on second level&lt;/title&gt;

    &lt;p&gt;First paragraph.&lt;/p&gt;

    &lt;p&gt;Second paragraph etc.&lt;/p&gt;

    &lt;section&gt;
      &lt;title&gt;Title on third level&lt;/title&gt;

      &lt;p&gt;...&lt;/p&gt;
    &lt;/section&gt;
  &lt;/section&gt;

  ...
&lt;/chapter&gt;
    </pre></div>
  

  <h3><a name="id2259926">2.6 
        &lt;chapter&gt;</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">&lt;header&gt;</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">&lt;section&gt;</a></span>.</p>
  

  <h3><a name="id2259200">2.7 
        &lt;section&gt;</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">&lt;marker&gt;</a></span>,
      a <span class="bold_code"><a href="#titleTAG">&lt;title&gt;</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">&lt;section&gt;</span>.</p>
  

  <h3><a name="id2252192">2.8 
        &lt;title&gt;</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>