pjs/webtools/apidoc
rginda%netscape.com 84a845420c more changes from Petr Cimprich <petr@gingerall.cz>
- Section titles are URL-encoded in link anchors now, thus the titles can include spaces and non-English chars now.

- parse_apidoc.pl generates one more file now: sidebar-toc.html
This is a version of toc functioning as Mozilla sidebar, it links sidebar.css so that it can be customized.
(you can test some sidebars at http://www.gingerall.org/charlie/ga/xml/l_lib.xml)
2003-02-12 08:23:52 +00:00
..
tests
README
api-content.css
api-toc.css
complete-frameset.html
parse_apidoc.pl
parse_devedge_doc.pl
sparse-frameset.html

README

DESCRIPTION:
APIDOC tool source.
Generates HTML API documentation from an xml source.

--

FILES:


===* parse_apidoc.pl

Syntax:
  perl parse_apidoc.pl jsref.xml [<output-directory>]

Requires:
  XML::Parser (http://search.cpan.org/search?dist=XML-Parser)

Description:
  Parses apidoc xml files, producing html output for viewing in normal browsers.
  Output will be placed in the specified directory, or ./apidocs if none is
  specified.  Output pages with content will refer to api-content.css, table
  of content pages will refer to api-toc.css.

See Also:
  http://www.mozilla.org/projects/apidoc

===* parse_devedge_doc.pl

Syntax:
  perl parse_devedge_doc.pl < jsref.htm > jsref.xml

Requires: 
  nothing.

Description: 
  Parses the nasty devedge document (jsref.htm) into somewhat nicer xml.
  The XML source, jsref.xml, located at
  http://www.mozilla.org/js/apidoc/jsapi.xml is now the authoritative place to
  make changes.
  This file should be considered dead.  Do not use it.  It is here for emergency
  use only.
  REPEAT: DO NOT USE THIS SCRIPT!