W3C home > Mailing lists > Public > www-html@w3.org > July 2011

Re: Markup for variable definitions

From: Jim Jewett <jimjjewett@gmail.com>
Date: Mon, 18 Jul 2011 20:19:15 -0400
Message-ID: <CA+OGgf7v-yCrO0HMO8JMiZ8iFbvwaWTbHFV1vfwJT5EH+cBetA@mail.gmail.com>
To: Křištof Želechovski <giecrilj@stegny.2a.pl>
Cc: www-html@w3.org
On Mon, Jul 18, 2011 at 7:49 AM, Křištof Želechovski
<giecrilj@stegny.2a.pl> wrote:

> <DT >char *blah <DD >This variable contains lorem ipsum.

> I wonder whether this markup is correct, as the variable type is not part
> of the variable blah, it is a property thereof.  So the DT should contain
> "blah" only.

Jukka K. Korpela already gave the main reason this is OK -- that the
semantics aren't really as strict as you believed.

But for this particular case, the type may well be part of the
variable name -- the only part that distinguishes it from another
object with the same name but a different type.  (This is particularly
common for methods distinguished by parameter types.)

Received on Tuesday, 19 July 2011 00:20:04 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:06:24 UTC