[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Subject: RE: [relax-ng] Re: [relax-ng-comment] ## comments in compact syntax
Javadoc doesn't fret over /**********************/. It just happily rolls along. -Mike > -----Original Message----- > From: James Clark [mailto:jjc@jclark.com] > Sent: Wednesday, September 25, 2002 8:07 PM > To: David Rosenborg; relax-ng-comment@lists.oasis-open.org > Cc: relax-ng@lists.oasis-open.org > Subject: [relax-ng] Re: [relax-ng-comment] ## comments in compact syntax > > > Interesting point. Does anybody know what javadoc does with > > /**********************/ > > or C# with > > //////////////////////// > > ? > > --On 25 September 2002 21:14 +0200 David Rosenborg > <david.rosenborg@pantor.com> wrote: > > > > > I think one common pattern when you comment code is to use comment > > charaters as dividers of major sections like: > > > ># Some major section follows > >######################################################### > > > > The problem here is that the divider line is treated specially since > > it starts with ##. It is a bit supricing but you can get around > it easily > > by adding an extra space: > > > > > ># Some major section follows > ># ####################################################### > > > > I think one solution would be to only recognize ## as a documentation > > comment if it is followed by a non-# character. The disadvantage with > > this is that you will possibly need an extra character of lookahead in > > the parser. > > > > Cheers, > > David > > > > > > ---------------------------------------------------------------- > To subscribe or unsubscribe from this elist use the subscription > manager: <http://lists.oasis-open.org/ob/adm.pl> >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC