[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [ft-devel] Markdown Documentation in header files
From: |
Werner LEMBERG |
Subject: |
Re: [ft-devel] Markdown Documentation in header files |
Date: |
Sat, 05 May 2018 00:24:42 +0200 (CEST) |
>> [...] 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