Re: [platform-swt-dev] Platform differences and documentation.

[Grant Gayed <Grant_Gayed@xxxxxxxxxx>]

Hi Eric,

In the original bug report (for those
interested, https://bugs.eclipse.org/bugs/show_bug.cgi?id=147120 ) I misspoke
when I said "platform differences like this" because this was
an example of a hint (SWT.FLAT) not being honoured.  Platforms/themes
are free to honour or ignore hints like these in order to provide a consistent
visual presentation of its choice, and to list all platform/theme decisions
like this would be huge and the javadoc would fall out of date as new OS
versions/themes became available.

However there is merit to the idea of
javadoc'ing some more functional (if that's the right word) differences
on a case-by-case basis, such as MenuItems not supporting images on motif.
 These will be added to the javadoc rather than the original proposal
of having them live in a separate document.

Grant

Eric Zimmerman <eric@xxxxxxxxxxx>
Sent by: platform-swt-dev-bounces@xxxxxxxxxxx

06/15/2006 02:26 PM

Please respond to
"Eclipse Platform SWT component developers list." <platform-swt-dev@xxxxxxxxxxx>

To	"platform-swt-dev@xxxxxxxxxxx" <platform-swt-dev@xxxxxxxxxxx>
cc
Subject	[platform-swt-dev] Platform differences and documentation.

I noticed a bug today that had this quote in it from
Grant Gayed:

"There is not currently a place where platform differences like this
are 
listed, but these are being accumulated for a future document/article,
so this has been noted."

Why are platform differences not listed directly in the Javadoc?  This
is where developers go for this type of information. 

I agree that a general article that summarizes these differences would
be great for new developers or people evaluating the platform.  However,
static articles don't reflect changes in real time and in contexts that
developers can use while coding.

A wiki with the current information would be a good start, with a long
term goal of javadoc integration.

Eric


_______________________________________________
platform-swt-dev mailing list
platform-swt-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/platform-swt-dev