Not all classes located in runtime/android/core and reflection_gen_dir/wrapper
are supposed to be part of the embedding API, some of them are just for
internal usage like Crosswalk Cordova plugin but not for external developers.
So although I totally agree with you that this is not clear to everyone and
indeed there's already some cases that we've forgot to list new class in the
gyp file, scanning the whole directory is not appropriate. I suggest we still
keep the original way here, or maybe we can define some tags for marking
specific class to let the generation tools distinguish it.
From: Kubo Da Costa, Raphael
Sent: Tuesday, September 20, 2016 23:02
Cc: Sun, Lin <lin....@intel.com>
Subject: Expanding coverage in xwalk_core_library_documentation?
At the moment, the xwalk_core_library_documentation target invokes javadoc and
manually lists all files it wants to document. This is bad, as it requires
keeping the list up-to-date, and it's not at all clear to anyone that this
needs to be done.
Instead, I'd like to call javadoc on all classes in runtime/android/core/src as
well as all reflection wrapper classes.
If I ran javadoc correctly, this means the following new classes would start
being part of the API documentation:
Crosswalk-dev mailing list