Re: Editorial comments on HTML 2.0 Draft 3/31/95

lilley (lilley@afs.mcc.ac.uk)
Wed, 19 Apr 95 09:41:01 EDT

>
> The following are items I found in the 3/31/95 draft of the HTML 2.0 Spec.
> After the IETF decision to keep editorial comments confined to the mail group
> (to save feature/topic discussion time) I meant to send this out last week but
> was sick. I have a lot of mail to dig thru so pardon duplicate comments.
>
> Under 9.1 Anchor:
> It is generically classified as Level 0 but some of the attributes are new to
> level 2 (ie TITLE, URN, METHODS). I think that labeling all of them as Level 0
> is misleading and that those new attributes should be labeled as such.
>
> Under 10.6.1 Definition List:
> There is a paragraph that talks about single occurences of <DT>'s and no
> <DD>'s but the converse is true as well. A similar paragraph should be
> inserted to cover this.
> The text about half way down says "The opening list tag must be <DL> and must
> immediately followed by the first term (<DT>)." This is wrong since you can
> have a Definition List with NO <DT>'s and all <DD>'s. Ammend the last part to
> be "...by the first term (<DT>) or the first definition (<DD>)."
> The COMPACT attribute is only described for DL's. Shouldn't it also be
> applicable to all other lists (UL & OL; DIR/MENU maybe??)
>
> Under 10.6 List Elements:
> There is a explicit description of all tags related to lists except LI. Its
> implicitly described under OL, UL, DIR, and MENU. Should it get its own
> section since it is a separate tag?
>
> Under 11 Form-based Input Elements:
> "Each variable field is defined by an Input, Textarea, or Option element"
> should be "..., Textarea, or SELECT element".
> In the paragraph describing the different conventions for TAB and Shift keys
> on different platforms, the description says "using Enter key to submit the
> form." This isnt true if the cursor is in a TEXTAREA field (on any browser I
> tried). A nit probably but semi-misleading.
> In the same paragraph, "The SUBMIT button is used to e-mail or send its
> contents to the server as specified by the ACTION attribute," should be changed
> to include the METHOD attribute too. Something like, "The SUBMIT button is
> used to e-mail or send its contents to the server as specified by the ACTION
> and METHOD attributes,"
>
> Under 11.1 Form:
> Describe the allowable attributes explicitly, not by example. This is done
> for _every_ other tag except FORM.
> In the next to last paragraph there is "The names are _usually_equal_ to the
> NAME attributes of the various _interactive_ elements in the form". What other
> way is there to name inputs?? Also, what about non-interactive elements (ie:
> HIDDEN fields)? Remove "interactive" and that should ok.
>
> Under 11.2 Input:
> For NAME, "The NAME attribute is required for _most_ input types...". When
> can an input field not have a name and still be an input?? Just how would a
> non-named input be returned, by value only? With > 1 non-named input, that
> could be very very bad!
> For SRC, "A URL or URN specifying..." is not uniform. I think it should be
> split out into SRC and URN (ala Anchors!) to be consistant.
> For CHECKBOX, how does the default value of "on" map up with any explicit
> values that are provided? For example, if a checkbox's value is "on" by
> default and the author specifies explicit values for the it (ie "yes"), just
> what should a browser send back if the user does not touch the checkbox on the
> form, "on" or "yes"?
> For PASSWORD, what about rephrasing "except that the text is not displayed as
> it is entered" to something like "except that the text is obfuscated or changed
> as it is entered so that it is not plainly visible to the user". The original
> text semi-implies that PASSWORD fields can be either obfuscated or not
> displayed at all. A nit really...
>
> Under 11.4 Select:
> How is it possible to select nothing from a list when "If no option is
> initially marked as selected, then the first item list is selected."?? This
> means an author is required to create a "No choice" option and make it the
> first option. I think this last part should be removed from the draft or
> inverted.
> As brought out at IEFT, SIZE has a different meaning for Select than any
> other FORM input. If it were renamed to something like LINES or ITEMS then it
> would be less ambiguous.
>
> Under 11.5 Text Area:
> The title should be one word, Textarea.
> A for FORM, list the allowable attributes explicitly, not be example!
>
> My proxy server is down this AM so I cant see if these changes need to be in
> any more recent draft than 3/31 so disregard any that have already been covered.
>
> Bruce
> ===============================================================================
> Bruce Kahn INet: Bruce_Kahn@iris.com
> Iris Associates Phone: 508.392.5335
> Standard disclaimers apply, even where prohibited by law..
>
--
Chris Lilley
+----------------------------------------------------------------------+
|Technical Author, Manchester and North HPC Training & Education Centre|
+----------------------------------------------------------------------+
| Computer Graphics Unit,             |  Email: Chris.Lilley@mcc.ac.uk |
| Manchester Computing Centre,        |  Voice: +44 61 275 6045        |
| Oxford Road, Manchester, UK.M13 9PL |    Fax: +44 61 275 6040        |
+-------------------------------------+ BioMOO: ChrisL                 |
|       URI: http://info.mcc.ac.uk/CGU/staff/lilley/lilley.html        | 
+----------------------------------------------------------------------+
|       "The first W in WWW will not wait."   François Yergeau         |
+----------------------------------------------------------------------+