Re: [ft-devel] Markdown Documentation in header files

[Werner LEMBERG]

>> [...] if you are going to convert all comments, please convert to
>> the `light' format, using address@hidden' instead of `<foo>' for tags (the
>> latter can be dropped completely then):
>
> Should we also replace those and allow something like this:
>
>   /************************************************************************
>    *
>    * @Section:
>    *    gzip
>    *
>    * @Title:
>    *    GZIP Streams
>    *
>    * @Abstract:
>    *    Using gzip-compressed font files.
>    *
>    * @Description:
>    *    This section contains the declaration of Gzip-specific functions.
>    *
>    */

Yes.  All `rectangle block' comments should be converted to this
format.


    Werner