[Development] qdoc for C++ and QML

Shawn Rutledge Shawn.Rutledge at qt.io
Tue Apr 25 15:57:24 CEST 2017


> On 25 Apr 2017, at 14:09, Alberto Mardegan <mardy at users.sourceforge.net> wrote:
> 
> On 25/04/2017 09:29, Martin Smith wrote:
>>> What would be incorrect as those APIs are only internal for C++, but
>>> public for QML or v.v.
>> 
>> Then we need \cpponly and \qmlonly, or something like that.
> 
> This is calling for future headaches, when you start adding python or
> other languages.
> 
> It's better to just support using \cpp, \qml, \python tags; and if no
> tags appear, then it's assumed that the documentation applies to all
> languages.
> Also \nocpp, \noqml and \nopython could be useful.

Or something with a parameter like \lang(cpp) \lang(qml) etc. might be more extensible?  (not sure of what sort of syntax like that you can support inside a backslash doc tag… should follow the convention if there is one)



More information about the Development mailing list