Re: comments (Re: Really Quick Guide to Good HTML)

Walter Ian Kaye (boo@best.com)
Wed, 21 Feb 1996 11:17:03 -0800


Message-Id: <v02120d00ad5113fb80c1@[205.149.180.135]>
Date: Wed, 21 Feb 1996 11:17:03 -0800
To: www-html@w3.org
From: boo@best.com (Walter Ian Kaye)
Subject: Re: comments (Re: Really Quick Guide to Good HTML)

At 6:50a 02/21/96, Gregory J. Woodhouse wrote:

>I frequently add comments to my web pages using the syntax
>
><!-- This is a comment -->
>
>My first few lines are fairly standard giving such information as my name
>and a version number. I'm quite a bit more sparse with my comments in
>HTML than I am in, say, C++. I guess I'm still trying to settle on a good
>commenting style.

Heh, you could always just use your C++ commenting style in a bracket. If I
did so, mine might possibly look like this:

 <!--

 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *\
 *          Title: Xxxxxxxxxxxxx                                           *
 *       Full URL: Xxxxxxxxxxxxx                                           *
 *    Description: Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx           *
 *        Remarks: Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx         *
 *          Notes: Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx         *
 *  ---------------------------------------------------------------------  *
 *         Author: Walter Ian Kaye                                         *
 *       Internet: boodlums@genie.com                                      *
 *  Version 1.0.0: 00/00/96 - 00/00/96                                     *
 *  Last Modified: 00/00/96                                                *
 \* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

 -->

Hmmm... :)

__________________________________________________________________________
    Walter Ian Kaye <boo@best.com>     Programmer - Excel, AppleScript,
          Mountain View, CA                         ProTERM, FoxPro, HTML
 http://www.natural-innovations.com/     Musician - Guitarist, Songwriter