HTML Ada83 LRM Creation and Credits
Special Thanks To
- Lionel Cons'
- Creator of the fine texi2html that was used in version 1.0 of the HTML LRM.
- Larry Wall
- Author of PERL, the Practical Extraction and Report Language,
which made the required high-octane pattern matching and string replacement much easier.
- Magnus Kempe
- Maintainer of the Ada WWW Server at EPFL
for the nifty picture of Ada Lovelace.
- Ada Joint Program Office
- Provider of the raw text of the LRM and the usage statement that allows this
hyper-document to be created. A fine model for other endeavors, IMHO.
Creation
This HTML Ada83 LRM was generated by passing the source of the
LRM through various custom perl scripts written by
gregor@kafka.saic.com
which added HTML annotations
to the file.
Processing was accomplished in these steps:
- Place HTML anchors at appropriate points and add HTML cross-references.
- Detect and format examples, enumerated lists, bulletted lists, tables, and reference blocks.
- Split the single HTML document into separate chapters and fix references.
- Sub-divide the still huge index into sub-chapter files.
File Layout
Division of the LRM was necessary due to it's size. The LRM is split into the following parts:
- lrm-[01][0-9].html
- Chapter files numbered 00 to 15.
- lrm-[01][0-9]-[01][0-9].html
- Sub-sections for each chapter.
- lrm-IDX.html
- Main entry point for the index.
- lrm-IDX-[A-V].html
- File for individual sections of the index.
- lrm-IDX-WXYZ.html
- The rest of the index.
- lrm-FORE.html
- The forward.
Sections within each chapter file have anchors which are named the
same as the section number. For example LRM section 3.2 has an HTML
anchor named "3.2". An URL can be constructed to jump to any section
in the LRM, simply append a reference to the appropriate anchor to a
reference to the appropriate chapter/subsection file. As an example the
aforementioned LRM section 3.2 could be accessed with the URL
"lrm-03-02.html#3.2", and section 3.2.1 could be accessed with
"lrm-03-02.html#3.2.1".
- Fixed links messed up by server reorganization.
- Made some minor changes to match stylistic convention.
- Fixed "UP" links.
- Fixed references within a document.
- Added link from old ada_1.html file some people still used.
- Split chapters into sub-chapters.
- Made icons smaller.
- Added alternate representations for icons.
- Changed references within a document so it won't reload it every time.
- Made named anchors non-null so they finally work.
- Updated some header files.
gmh