ISO/IEC JTC 1/WG4 N1978

ISO/IEC JTC 1/WG4

Information Technology ---

Document Description Languages

TITLE:	WG4's editing instructions for ISO-HTML
SOURCE:	WG4 SGML RG
PROJECT:	ISO-HTML
PROJECT EDITOR:	D Abrahamson, R. Price
STATUS:	Additional Editing Instructions
ACTION:	For information
DATE:	14 May 1998
DISTRIBUTION:	WG4 and Liaisons
REFER TO:
REPLY TO:	Dr. James David Mason (ISO/IEC JTC1/WG4 Convenor) Lockheed Martin Energy Systems Information Management Services 1060 Commerce Park, M.S. 6480 Oak Ridge, TN 37831-6480 U.S.A. Telephone: +1 423 574-6973 Facsimile: +1 423 574-0004 Network: masonjd@ornl.gov http://www.ornl.gov/sgml/wg4/ ftp://ftp.ornl.gov/pub/sgml/wg4/

WG4's editing instructions for ISO-HTML

Paris, 15th May 1998

JTC 1/WG 4 has discussed the CD of ISO 15445 (as available at http://purl.org/NET/ISO+IEC.15445/FinalCD.html on Tue, 21 Apr 1998) and has the following comments:

1. Re: "10.2 Use of named character references"

This section talks about named character references when it is really referring to the use of public entity sets for character entities.
However, since there is no way to declare character entities which are not already defined in the DTD (because "the document type declaration shall not include a document type declaration subset" (see section 11.)), there is no point in discussing the issue.

Therefore: Section 10.2 should be removed altogether.

2. Re: "11 Document type declaration"

This section mixes public identifiers and document type declarations.

Also, one requirement stated in section 8 is to "Allow HTML to be used as a base architecture for other SGML applications." This is only satisfied in the general sense that any DTD can serve as a base architecture. To satisfy the requirement more explicitly, add a sub-clause providing the architecture support declaration.

Therefore, make the following changes to clause 11:

old:

11 Document type declaration

The DTD provided by this International Standard has the following formal public identifiers:
<!DOCTYPE HTML PUBLIC "ISO/IEC 15445:1998//DTD HyperText Markup
Language//EN">
<!DOCTYPE HTML PUBLIC "ISO/IEC 15445:1998//DTD HTML//EN">

The document type declaration shall not include a document type declaration subset.

proposed:

11 Invocation

The DTD provided by this International Standard has the following formal public identifiers:

"ISO 15445:1998//DTD HyperText Markup Language//EN"

"ISO 15445:1998//DTD HTML//EN"

11.1 Document type declaration

The DTD is typically invoked by one of the following declarations:
<!DOCTYPE HTML PUBLIC "ISO/IEC 15445:1998//DTD HyperText Markup
Language//EN">
<!DOCTYPE HTML PUBLIC "ISO/IEC 15445:1998//DTD HTML//EN">
The document type declaration shall not include a document type declaration subset.

11.2 Architectural support declaration

In order to use the ISO-HTML document type definition as a base architecture for other SGML applications, the following architectural support declaration should be used:
<?IS10744 arch name="html"
public-id="ISO/IEC 15445:1998//DTD HyperText Markup Language//EN"
dtd-system-id="[insert URL to official version here]"
renamer-att="HTMLnames"
doc-elem-form="HTML"
>

Also, add a comment containing the typical document type declarations and architectural support declaration to the top of the DTD.

3. Re: Mention of document preparation mechanism

Add a non-normative reference to the User's Guide and a short explanation of the significance of the document preparation mechanism provided in the DTD.

4. Re: Comment in SGML declaration

There are three problems with the comment following the CHARSET parameter of the SGML declaration:

"/IEC" is missing from the name of standard
There are gaps in 10646 other than those listed
The use of "shall" and "should" in the last sentence is contradictory. In the original wording, no conforming document could contain such code values so there is no point in specifying how they are to be processed.

To fix these problems, change as follows:

old:

In ISO 10646, the positions with hexadecimal values 0000D800-0000DFFF, used in the UTF-16 encoding of UCS-4, are reserved, as well as the last two code values in each plane of UCS-4, ie. all values of the hexadecimal form xxxxFFFE and xxxxFFFF. These code values or the corresponding numeric character references shall not be included when generating an HTML document, and they should be ignored if encountered when processing an HTML document.

proposed:

ISO/IEC 10646 does not define all positions. For example, it reserves positions with hexadecimal values 0000D800 - 0000DFFF, used in the UTF-16 encoding of UCS-4, as well as the last two code values in each plane of UCS-4, ie. all values of the hexadecimal form xxxxFFFE and xxxxFFFF. Undefined code values and the corresponding numeric character references should not be included in an HTML document, and they shall be ignored if encountered when processing an HTML document.

5. Re: Comment at beginning of DTD

Remove the maintenance information.

6. Re: Typo in DTD

In the attribute definition list declaration for AREA, the first comment should begin "One of the HREF and NOHREF shall be..." (i.e. change NOREF to NOHREF).

7. Re: ISO-HTML icon

WG4 approves the design of the proposed icon but instructs the authors to improve the quality by making it transparent and anti-aliasing the fonts...