On Sep 7, 2006, at 3:43 PM, Seth Willits wrote:

On Sep 6, 2006, at 10:14 AM, Terry Ford wrote:

I'm also one of those users that is very interested in any way to improve the "Official" documentation in an "In House" manner. As much as RS has been improving its OLR, there is still a lot to be desired. The new format lends itself well to rapid and continuing changes as opposed to the old format.

How's that? RS still has to update their master documentation and then stick it in HTML to ship with the next version. The only difference is it's in HTML rather than a custom binary format with a (horrible) custom viewer.

The first versions were. The latest has changed things around to some confusion and introduced new syntax errors. The old (and PDF) way was confusing enough. Now it's ridiculous.

Here's a comparison of the Canvas.AcceptTags Property in the OLR version for 2006r2, PDF version for r3 and OLR version for r3 is as follows:

----------
2006r2 OLR
----------
Canvas.AcceptTabs Property

Syntax
AcceptTabs as Boolean

If True and AcceptFocus is True, then pressing Tab triggers the KeyDown event for processing. If False, pressing the Tab key does not trigger the KeyDown event; pressing Tab triggers the LostFocus Event and selects the next object in the window that can accept the focus.

----------------------------------------
PDF version for r3 (In 3 columns) under Properties
----------------------------------------

(Name)
AcceptTabs

(Type)
Boolean

(Description)
If True and AcceptFocus is True, then pressing Tab
triggers the KeyDown event for processing. If False,
pressing the Tab key does not trigger the KeyDown
event; pressing Tab triggers the LostFocus Event and
selects the next object in the window that can accept the
focus.

---------------
OLR version for r3
---------------
Canvas.AcceptTabs

If True and AcceptFocus is True, then pressing Tab triggers the KeyDown event for processing. If False, pressing the Tab key does not trigger the KeyDown event; pressing Tab triggers the LostFocus Event and selects the next object in the window that can accept the focus.

Syntax
AcceptTabs( Boolean ) as <---- Huh?

Parameters
Boolean
-------------

To me, the correct syntax should be:

Canvas.AcceptTabs = True // or False or (Boolean Value)

Not:

AcceptTabs( Boolean ) as

There is a multitude of these in r3'S OLR.


3) There have been several attempts at providing a user based Wikki or example reference but they have usually failed through both lack of official support from RS or the users themselves.

Which could be corrected but that'd take some cooperation from RS. There is an ideal solution for all of this that's up in my skull, but there's no point in sharing it unless RS wants to do anything in the first place.

Thats what I mean. Do the substandard docs really have to persist?

Terry

_______________________________________________
Unsubscribe or switch delivery mode:
<http://www.realsoftware.com/support/listmanager/>

Search the archives of this list here:
<http://support.realsoftware.com/listarchives/lists.html>

Reply via email to