20072013 Ericsson AB. All Rights Reserved. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Fascicules DTDs fasc_dtds.xml
The fascicules DTD

The fascicules 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.

Example:




  
    User's Guide
  
  
    Reference Manual
  
  
    Release Notes
  

    ]]>

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 part_frame.html, Reference Manual with the cover page ref_man_frame.html and Release Notes with the cover page part_notes_frame.html.

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.

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

DocBuilder assumes that the XML file written according to the fascicules DTD is called fascicules.xml.

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 index.html is created.

<fascicules>

Top level tag for the fascicules DTD.

Contains one or more <fascicule>.

<fascicule>

Specifies properties for one "part" of the documentation for an application.

Contains plain text, the name of this part.

The file attribute should specify the file name for the corresponding part or application, without the .xml extension.

The href attribute should specify the file name for the corresponding HTML cover page file, without the .html extension.

The optional entry="yes"|"no" attribute specifies if the HTML cover page should be copied to index.html or not. Default is "no".