[Japi-cvs] SF.net SVN: japi: [51] trunk/src/doc/tasks.xhtml
Status: Beta
Brought to you by:
christianhujer
From: <chr...@us...> - 2006-04-12 21:20:06
|
Revision: 51 Author: christianhujer Date: 2006-04-12 14:19:55 -0700 (Wed, 12 Apr 2006) ViewCVS: http://svn.sourceforge.net/japi/?rev=51&view=rev Log Message: ----------- Added TODO comments so IntelliJ IDEA will show the TODOs in its TODO Browser. Modified Paths: -------------- trunk/src/doc/tasks.xhtml Modified: trunk/src/doc/tasks.xhtml =================================================================== --- trunk/src/doc/tasks.xhtml 2006-04-11 23:08:22 UTC (rev 50) +++ trunk/src/doc/tasks.xhtml 2006-04-12 21:19:55 UTC (rev 51) @@ -14,136 +14,136 @@ They are here for public discussion before they become BUG / RFE entries in the bug tracker. </p> <dl> - <dt>Integration Subversion with Ant</dt> + <dt><!-- TODO -->Integration Subversion with Ant</dt> <dd> The build.xml for Ant still uses the old cvs tasks. The subversion ant task provided by tigris should be used instead. </dd> - <dt>Add Changelog Facility</dt> + <dt><!-- TODO -->Add Changelog Facility</dt> <dd> There should be an automatic changelog facility in build.xml that displays all changes made since the last release. Because we use subversion now, this should be easy to do once subversion is integrated in Ant. </dd> - <dt>Create missing package descriptions</dt> + <dt><!-- TODO -->Create missing package descriptions</dt> <dd> Some packages lack package descriptions. </dd> - <dt>Review package descriptions</dt> + <dt><!-- TODO -->Review package descriptions</dt> <dd> Some package descriptions might be inaccurate or not good enough. </dd> - <dt>Improve java2html</dt> + <dt><!-- TODO -->Improve java2html</dt> <dd> java2html needs some improvement to create XHTML 1.1 with properly identifiable lines. E.g. <code><![CDATA[<span id="line10" class="even line">...</span>]]></code>. The stylesheet should allow for alternating background of odd and even lines. </dd> - <dt>Finnish JTreeTable</dt> + <dt><!-- TODO -->Finnish JTreeTable</dt> <dd> The class JTreeTable needs to be finnished. </dd> - <dt>Finnish preferences modules</dt> + <dt><!-- TODO -->Finnish preferences modules</dt> <dd> The preferences modules for keyboard, menu, toolbar, dialogs (bringing onetime dialogs back again) and proxy need to be finnished resp. created. </dd> - <dt>Increase JAPI</dt> + <dt><!-- TODO -->Increase JAPI</dt> <dd> Cher has some old JAPI versions from the time of JAPI before SF, which might contain some useful classes that should go into JAPI. </dd> - <dt>Add Cursor Handling to ActionFactory</dt> + <dt><!-- TODO -->Add Cursor Handling to ActionFactory</dt> <dd> ActionFactory should be able to automatically set the cursors for components it creates. </dd> - <dt>Improve ToolbarLayout</dt> + <dt><!-- TODO -->Improve ToolbarLayout</dt> <dd> ToolbarLayout needs an improvement to allow toolbars to be placed next to each other. </dd> - <dt>Create Checkstyle Configuration</dt> + <dt><!-- TODO -->Create Checkstyle Configuration</dt> <dd> JAPI needs a Checkstyle configuration. An Ant Target running Checkstyle should also be added. </dd> - <dt>Create font browser tool</dt> + <dt><!-- TODO -->Create font browser tool</dt> <dd> This goes in tools/font </dd> - <dt>Create a jar browser tool</dt> + <dt><!-- TODO -->Create a jar browser tool</dt> <dd> This goes in tools/jar </dd> - <dt>Rework guide on XInclude</dt> + <dt><!-- TODO -->Rework guide on XInclude</dt> <dd> Some source code in the guide is not yet included using java2html and XInclude. This should be changed to let all source code look consistently. </dd> - <dt>Website Layout improvement</dt> + <dt><!-- TODO -->Website Layout improvement</dt> <dd> JAPI needs a logo and a better website. </dd> - <dt>IDE project files</dt> + <dt><!-- TODO -->IDE project files</dt> <dd> Think about a concept of how to put IDE project files in the JAPI repository in a way that when users change them, they'll be working on their copies without creating new versions when they do commits. For a start, IntelliJ IDEA, NetBeans and Eclipse should be supported. Perhaps applying the UCM stream concept of ClearCase might also be a possible solution to this. Question: How to checkout a trunk directory from a branch instead. </dd> - <dt>Unit Tests</dt> + <dt><!-- TODO -->Unit Tests</dt> <dd> JAPI needs a unit test suite. </dd> - <dt>Set svn:ignore properties properly</dt> + <dt><!-- TODO -->Set svn:ignore properties properly</dt> <dd> Some directories like tools/fonts should have settings for svn:ignore. All sub project directories with their own build.xml should, for instance, set svn:ignore to exclude their <code>classes</code> directory. </dd> - <dt>NPE avoidance</dt> + <dt><!-- TODO -->NPE avoidance</dt> <dd> There's much code, especially in ActionFactory, which will throw little useful NullPointerExceptions. This code should be reworked by using <code>@Nullable</code> and <code>@NotNull</code> annotations. All possible NullPointerException warnings should be removed except in acceptable cases. This task also includes the definition of a list of acceptable cases of possible NullPointerExceptions. </dd> - <dt>Properties handling</dt> + <dt><!-- TODO -->Properties handling</dt> <dd> Make sure all property files are iso-8859-1 and not any other encoding. Also make sure that in xi:include elements, property files are included as iso-8859-1. </dd> - <dt>Add syntax highlighting for property files</dt> + <dt><!-- TODO -->Add syntax highlighting for property files</dt> <dd> Add a syntax highlighting for property files. </dd> - <dt>Remove old references to ITCQIS</dt> + <dt><!-- TODO -->Remove old references to ITCQIS</dt> <dd> Some source still contains references to ITCQIS other than Cher's mail address. These references should be removed. </dd> - <dt>Unify package documentation and XHTML sources</dt> + <dt><!-- TODO -->Unify package documentation and XHTML sources</dt> <dd> Some package documentation is XHTML Basic. Some documents are XHTML 1.1 and some are XHTML 1.1 + XInclude. This should be unified to always be XHTML 1.1. </dd> - <dt>Remove unused meta stuff from XHTML sources</dt> + <dt><!-- TODO -->Remove unused meta stuff from XHTML sources</dt> <dd> Some XHTML sources contain unused meta stuff. This should be removed. </dd> - <dt>Improve copyright handling</dt> + <dt><!-- TODO -->Improve copyright handling</dt> <dd> Files get automatic copyright notices. Currently, the year and name are fixed. This should be improved. </dd> - <dt>Unify Utility Classes</dt> + <dt><!-- TODO -->Unify Utility Classes</dt> <dd> Several Utility Classes do not yet have a private constructor. They all should get one. The documentation on all these private constructors should follow the same pattern. </dd> - <dt>Unify Whitespace</dt> + <dt><!-- TODO -->Unify Whitespace</dt> <dd> Some classes have two blank lines between copyright comment and package, some have only one. This should be unified. </dd> - <dt>Unify SuppressWarnings in case of working around bugs</dt> + <dt><!-- TODO -->Unify SuppressWarnings in case of working around bugs</dt> <dd> Several warning suppressions do not suppress valid warnings but bogus warnings that are bugs of IntelliJ IDEA. These warning suppressions should be tagged as such with a special comment to find and remove them once the bugs in IntelliJ IDEA are This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |