FWD » Core Development

Please cleanup/improve the compatibility_options.odt chapter in the p2j_docs/runtime_installation_configuration_and_administration_guide/ project. The chapter has good content but it needs work. See my GES: note in this chapter for details. You should also change or add anything else that you find would be useful.

Please note that the table itself probably needs some major modifications. For example, the "Progress 4GL Feature" column has many weird entries like "com.goldencode.p2j.util.NumberType". This doesn't make sense. Instead, the individual 4GL feature should be tracked down and used in that column instead.

Often this is a command line option to Progress (e.g. the numberDecimalSep option can be set via the -numdec <number> command line option). These can be found in the "Startup Command and Parameter Reference".

But the feature may also be something that can be read or read/written at runtime using 4GL code. In that case, you would find this in the 4GL Reference (or the ABL Reference in later versions). For example, the numberDecimalSep option is the same thing as SESSION:NUMERIC-DECIMAL-POINT attribute (although this is read-only). It is common for many of these settings to be accessible via the SESSION system handle. But it is also possible that the feature may be a built-in function. For example, the currentLanguage option is the CURRENT-LANGUAGE function (for reading) and the CURRENT-LANGUAGE statement (for writing).

Often it is useful to look at where the option is read from the directory in the P2J code. There should be some comments or JavaDoc there that explains the 4GL feature that matches.

Since you haven't started this yet, I just added some more notes to the chapter. Please make sure to check out the latest version before starting.

I made some more changes and checked in another version.