Greg Ercolano wrote: > Duncan Gibson wrote: >> I'm also not keen on left markers in multiline comments: >> >> /** >> * \brief The one-liner >> * >> * The detailed description here, >> * on more than one line. >> * \param x >> * \return y >> */ >> >> because it's too much faffing about when you need to reformat, >> and I reformat to keep it readable in the editor and avoid lots >> of raggedy short and overly-long text lines. >> I would prefer that we all agree to omit the left markers:
[...] > For the docs I'm writing for Fl_Browser, I'm following the format > that's already there, without the stars. > > Seems kinda important to achieve consensus on this if possible. We did already discuss this, and we decided to use the format as it is in FLTK 1.3: without left markers/stars. In this regard the coding standard is either not up to date, or it reflects what is in FLTK 2.0. Thus we either need to clarify that there are two _different_ standards, or we declare the FLTK 1.3 way to be _the_ standard. Albrecht _______________________________________________ fltk-dev mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-dev
