> Hi guys,
>
> I've an issue with the 2.1 release:
>
> After migration and cleanup ('distclean' job) I ran the 'source' job,
> which
> complained (warnings) about some "@type member" API-Docs (see below).
> But it doesn't say anything about WHERE it found them...this is not
> helpful
> at all :-/The code parsing the JSDoc comments has no information about where the comments come from. (It might even receive comments that are generated on the fly, so there wouldn't be a file to relate it to). I considered it too tedious to feed file information to the comments parser, especially when it is usually so easy to locate offending entries by just grepping for the strings from the console warnings. > Another thing is, that the generator python scripts [1] improve from > release to > release, but there is no hint or automatic update by the 'migration' job > that > tells you about this. A hint would be enough. Mh, which other improvements are you hinting at? - But anyway, all important improvements are listed in the release notes [2]. To let the migration job also warn about JSDoc comments might be doing too much. It is probably much more important to let the users know about changes affecting their *code* before worrying about comments, and even when focusing on the former I'm not sure everybody is reading the information. T. [2] http://qooxdoo.org/project/release_notes/2.1#tooling1 > > Regards, > Peter > > > [1] generate.py located at the applications folder; first > created/generated > via /tool/bin/create-application.py -name:... > > **************************************************************************** > * Command line output below > **************************************************************************** > d:\app\frontend>generate source > > ---------------------------------------------------------------------------- > Initializing: frontend > ---------------------------------------------------------------------------- >>>> Processing configuration > > ---------------------------------------------------------------------------- > Executing: source::source-script > ---------------------------------------------------------------------------- > - Populating the cache, this may take some time >>>> Scanning libraries > >>>> Collecting classes \ > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > \ > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > - Warning: Unable to parse '@type' JSDoc entry: @type member > > - Sorting 636 classes >>>> Generate application > - Processing 3 locales > - Generate packages > - Generate loader script >>>> Done (1m34.04) > > **************************************************************************** > * Command line output end > **************************************************************************** > > ------------------------------------------------------------------------------ > Monitor your physical, virtual and cloud infrastructure from a single > web console. Get in-depth insight into apps, servers, databases, vmware, > SAP, cloud infrastructure, etc. Download 30-day Free Trial. > Pricing starts from $795 for 25 servers or applications! > http://p.sf.net/sfu/zoho_dev2dev_nov > _______________________________________________ > qooxdoo-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel > > > ------------------------------------------------------------------------------ Monitor your physical, virtual and cloud infrastructure from a single web console. Get in-depth insight into apps, servers, databases, vmware, SAP, cloud infrastructure, etc. Download 30-day Free Trial. Pricing starts from $795 for 25 servers or applications! http://p.sf.net/sfu/zoho_dev2dev_nov _______________________________________________ qooxdoo-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel
