Sophie

Sophie

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

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 -- Fascicules 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="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#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="loadscrollpos" title="Fascicules DTDs" expanded="true">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>4 Fascicules DTDs</h1>
  

  <h3><a name="id2265458">4.1 
        The fascicules DTD</a></h3>
    

    <p>The <span class="code">fascicules</span> DTD is a special kind of DTD which can be
      used to specify the different parts of the documentation, and
      which one of those should be shown as default.</p>

    <p>Example:</p>

    <div class="example"><pre>
&lt;?xml version="1.0" encoding="latin1" ?&gt;
&lt;!DOCTYPE fascicules SYSTEM "fascicules.dtd"&gt;
&lt;fascicules&gt;
  &lt;fascicule file="part" href="part_frame.html" entry="no"&gt;
    User's Guide
  &lt;/fascicule&gt;
  &lt;fascicule file="ref_man" href="ref_man_frame.html" entry="yes"&gt;
    Reference Manual
  &lt;/fascicule&gt;
  &lt;fascicule file="part_notes" href="part_notes_frame.html" entry="no"&gt;
    Release Notes
  &lt;/fascicule&gt;
&lt;/fascicules&gt;
    </pre></div>

    <p>In the example, it is specified that the documentation for this
      application consists of three parts: User's Guide, where
      the "cover page" (with the two frames) is located in
      <span class="code">part_frame.html</span>, Reference Manual with the cover page
      <span class="code">ref_man_frame.html</span> and Release Notes with the cover page
      <span class="code">part_notes_frame.html</span>.</p>

    <p>As a result, at the top of the left frame in the generated HTML
      documentation, there will be corresponding links to User's Guide,
      Reference Manual and Release Notes.</p>

    <p>The attribute <span class="code">entry="yes"</span> specifies that it is
      the Reference Manual which should be shown as default. This means
      that when generating the HTML files, <span class="code">application_frame.html</span>
      will be copied to <span class="code">index.html</span>.</p>

    <div class="note">
<div class="label">Note</div>
<div class="content"><p>
      <p>DocBuilder assumes that the XML file written according to
	the <span class="code">fascicules</span> DTD is called <span class="code">fascicules.xml</span>.</p>
    </p></div>
</div>

    <p>This file is optional. If it does not exist, there are no links
      to other parts of the documentation (as they are not known) in
      the left frame, and no <span class="code">index.html</span> is created.</p>
  

  <h3><a name="id2265565">4.2 
        &lt;fascicules&gt;</a></h3>
    <a name="fasciculesTAG"></a>
    

    <p>Top level tag for the <span class="code">fascicules</span> DTD.</p>

    <p>Contains one or more
      <span class="bold_code"><a href="#fasciculeTAG">&lt;fascicule&gt;</a></span>.</p>
  

  <h3><a name="id2265595">4.3 
        &lt;fascicule&gt;</a></h3>
    <a name="fasciculeTAG"></a>
    

    <p>Specifies properties for one "part" of the documentation for an
      application.</p>

    <p>Contains plain text, the name of this part.</p>

    <p>The <span class="code">file</span> attribute should specify the file name for
      the corresponding <span class="code">part</span> or <span class="code">application</span>, without
      the <span class="code">.xml</span> extension.</p>

    <p>The <span class="code">href</span> attribute should specify the file name for
      the corresponding HTML cover page file, without the <span class="code">.html</span>
      extension.</p>

    <p>The optional <span class="code">entry="yes"|"no"</span> attribute specifies if
      the HTML cover page should be copied to <span class="code">index.html</span> or
      not. Default is <span class="code">"no"</span>.</p>
  
</div>
<div class="footer">
<hr>
<p>Copyright © 1997-2010 Ericsson AB. All Rights Reserved.</p>
</div>
</div>
</div></body>
</html>