Change history

Change 24 August 2001

Norman Gray, 24 August 2001

Minor edits, which I noticed the need for after using the documentation.

4.5 History

Added a statement of the syntax for dates, even though this is briefly repeated in element documentation.

Distribution DR-0.7-13

Norman Gray, 16 March 2001

Small documentation changes.

6.2.1 Jade flags

The -javaflags option now takes its argument with an equals sign.

6.2.1 Jade flags

The idindex generation is much speeded up now, making the warning in the previous version redundant.

Distribution DR-0.7-12

Norman Gray, 15 March 2001

RCS Id: ssn70.sgml,v 1.61 2001/03/15 15:45:44 norman Exp

Mentioned the various jadeflags.

6.2.1 Jade flags

Added Jade flags section. The information was present, before, but rather well hidden.

Distribution DR-0.7-11

Norman Gray, 30 August 2000

RCS Id: ssn70.sgml,v 1.59 2000/08/30 14:55:33 norman Exp

Slight changes to explanations of maths elements.

3.2 Entity references

Noted that entity references should not be used inside maths elements.

4.10 Maths

Substantial edit. Changes to shortref cleverness made some of the advice in here wrong. It now tells folk not to use entity references at all in maths.

Distribution DR-0.7-8

Norman Gray, 23 August 2000

RCS Id: ssn70.sgml,v 1.56 2000/08/24 18:16:11 norman Exp

This release took a couple of goes to get right.... But I took the opportunity of reading through the text, correcting and updating things here and there. No big changes, but various things have been clarified.

Distribution DR-0.7

Norman Gray, 11 June 2000

RCS Id: ssn70.sgml,v 1.53 2000/06/11 16:21:27 norman Exp

First real release to programmers not directly concerned with the SGML project.

Change 2 June 2000

Norman Gray, 2 June 2000

Some restructuring. Preparing for distribution

4.11 Output depending on media type

Added this section

B Support utilities

Moved to a section of their own

E The Starlink SGML set for maintainers

Relocated this section to end of appendices.

Change 1 June 2000

Mark Taylor, 1 June 2000

Thoroughly revised documentation of upconverters.

Change 10 May 2000

Norman Gray, 10 May 2000

Miscellaneous tweaks.

6.4 Converting to XML

Added

B Support utilities

Added codecollections for bin and lib directory programs

Change 7 April 2000

Mark Taylor, 7 April 2000

Added a description of the HLP file downconversion tool.

Modified documentation of the programcode upconverter to reflect new usage.

5 Documenting source code

Mention coderef

5.1.1 Example document

Returnvalue is now omissable

6.3 Generating HELP files

Added section on HELP files

Distribution DR-0.6

Norman Gray, 31 March 2000

RCS: Id: ssn70.sgml,v 1.35 2000/03/31 14:35:38 norman Exp

Added sgml2docs command. Significant changes to programcode. Incorporates decisions from Durham, RAL and Cambridge SGML meetings. This is an interim release, intended as a snapshot for distribution to Rodney Warren-Smith and Mark Taylor. There will be a proper distribution before 1 June.

4.6 Cross-references

Noted that the stylesheets deal gracefully with missing FPIs

4.8 Tables

Principal table attributes now supported in LaTeX down-converter.

4.9 Text markup

Added paragraph describing ANGLE element

5.1.2 The programcode element structure

Substantially redone, to match significant changes to programcode DTD

6.2 sgml2docs

Significant change to sgml2docs commands

7 Converting existing text to SGML

Added Mark's upconverter documentation

E.1.3.1 Jade and OpenJade

Included description of, and pointer to, OpenJade

Change 23 September 1999

Norman Gray, 23 September 1999

Misc. clarifications.

4.3 Backmatter - notes and bibliography

Emphasised that notes will not appear unless backmatter element is present

Distribution DR-0.5

Norman Gray, 19 September 1999

Rather rushed distribution, containing implementations of changes to Programcode DTD and implementations of those in the down-converters. Time for few documentation updates.

Change 13 September 1999

Norman Gray, 13 September 1999

Assorted tidyups and clarifications from user comments

4.8 Tables

Clarified description of tabular element, and linebreaks.

Distribution DR-0.4

Norman Gray, 10 September 1999

Smallish DTD and DC changes, arising from the programmers' meeting and discussion with Mark Taylor.

4.7 Figures

Rewrote section to match new figures structure

4.8 Tables

Include description of new tabular element

4.10 Maths

Slight edit to discuss new mline and mlabel elements

6.2 sgml2docs

Added section on sgml2stuff commands, and discussion of very simple processing.

Change 22 June 1999

Norman Gray, 22 June 1999

Assorted tweaks, introduced since the release.

8.1 Further developments

Added extended Oasis table support to the wish list.

Distribution DR-0.3

Norman Gray, 15 June 1999

More substantial release, CD candidate.

Change 6 June 1999

Norman Gray, 6 June 1999

Various edits, great and small. I received comments from Mark Taylor, arising from the DR-0.2 distribution. I made considerable additions to the appendices. Generally tidying up for release.

3.4 Markup minimisation

Added note to the effect that attribute names can be minimised when the value is from a set

3.5 Marked sections

Section added, with text relocated from appendix.

4.3 Backmatter - notes and bibliography

Removed mention of the deleted backmatter content elements

4.8 Tables

Corrected Oasis URL

5.1.1 Example document

Added a note pointing out that returnvalue and argumentlist have optional `none' attributes.

5.1.1 Example document

Returnvalue is now omissable

When there is no return value, in the case of a subroutine, you can either omit the returnvalue element, or give it the attribute none. The argumentlist element is not omissable, however (since if the SGML parser finds a parameter element, it can't know whether it's part of an argumentlist or a parameterlist element), and this also takes an attribute none.

5.1.2 The programcode element structure

Paragraph rewritten to suggest using a CDATA marked section, instead of code edits.

A.5 Marked sections

This section trimmed, and the discussion of the `author-visible' uses of MSs moved to the `Marking up...' section.

E The Starlink SGML set for maintainers

Very substantial additions - this section was barely present before.

Distribution DR-0.2

Norman Gray, 3 June 1999

First real release to other programmers. Distribution contains only SGML lib stuff: Jade has to be built separately.

Version 0

Norman Gray, 21 April 1999

Initial version

Changes in this version

Norman Gray, 21 April 1999

Initial version