Delphi Code Arrange Expert

This program is a Delphi Expert which help you to arrange the indentation of Delphi source code, make reserved words all to Upper/Lower case, unify the spelling of variable / const / function / procedure name via setting..., etc. no Src. Shareware, $10 US dollars to register.

Get your copy of Delphi Code Arrange Expert at the place listed below:

• Download the Delphi Code Arrange Expert (Ver. 1.02) now
• Download from DelphiChat Official FTP Site
• Download from An Chen Computer Co. Ltd.

More detail...

Installation & Getting Start

To install Delphi Code Arrange Expert into Delphi 2 / Delphi 3 IDE, please follow these steps listed below:

1. Decompress cca102.zip
2. Copy all the decompressed files into any directory, e.g. C:\ChienCA
3. Run the C:\ChienCA\SetupCA.exe
4. Select "Install into Delphi 3" Checkbox if you want to use this expert on Delphi 3, same action for "Install into Delphi 2".
5. Click "OK" button.

Once the installation have been done, next time you lanuch Delphi 2 / Delphi 3, there will be a new menuitem "Edit / Code Arrange" in the Delphi IDE menu.

To run the Delphi Code Arrange Expert:

1. Run Delphi 2 / Delphi 3
2. Open a old project or File / New Applicaitoin to create a new one
3. Click the Code Editor to let it get focus
4. Delphi IDE menu: Edit / Code Arrange... (or take Ctrl + A hotkey instead)
5. Click "Arrange" button.

To UnInstall Delphi Code Arrange Expert:

1. Run the C:\ChienCA\SetupCA.exe again
2. Clear "Install into Delphi 3" Checkbox if you want to uninstall from Delphi 3, same action for "Install into Delphi 2".
3. Click "OK" button.

User's Guide

The files you got in the cca102.zip are:

File name	Description
ca.html	The file you are reading now, Traditional Chinese transation file is ca_big5.html
SetupCA.exe	Install / Uninstall program for Delphi Code Arrange Expert.
ChienCA2.dll	DLL for Delphi 2
ChienCA3.dll	DLL for Delphi 3
keyword.cfg	reserved word list
a..z.cfg	standard spelling setting file for identifiers

To change the option settings of Delphi Code Arrange Expert:

1. Run Code Arrange Expert (Delphi IDE menu: Edit / Code Arrange...)
2. Click the "Options..." button
3. Change the settings in the Code Arrangement Options... dialog box.
4. Click the "OK" button.

What these options mean are descripted below:

Reserved words: Make reserved words all to upper / lower case

• Upper: Make all reserved words to upper case.
• Lower: Make all reserved words to lower case.
• First Letter Upper: Make the first character of each reserved word to upper case.

Begin/End style: Select the "begin" location style for your source code.

• Don't care: Tell the Delphi Code Arrange Expert don't make any change on "begin" location for you.
• Default: Leave "begin" on a single line alone and put it on the same column to it's releated keyword (if / for / while..., etc.). For example,

if expL then
begin
    Statment1;
    Statment2;
end;

• Reduced: "begin" is intended to share the same line with it's releated keyword. For example:

if expL then begin
    Statment1;
    Statment2;
end;

Indent Width: How many blank characters for each indentation, range from 1 to 8, default value is 2.

Unify symbols: Make Delphi Code Arrange Expert to automatically unify spelling of each identifiers. Default value is Checked.

Delphi Code Arrange Expert take the following criterion on checking out each identifier's spelling:

1. Check out the the standard spelling file (a.cfg, b.cfg..., z,cfg) to get this symbol's standard spelling.
2. If this symbol's standard spelling is not available, take the pattern it's first time appear in the current unit to be the standard spelling.

Aligned const / var: Let me say it by example, if there is a code snippet look like:

const
    _CRLF = 3;  // comment
    _PI  = 3.1416; // comment;

"Check Aligned const / var" will make them become like this:

const
    _CRLF = 3;          // comment
    _PI       = 3.1416; // comment;

Auto End-comment: Default value is unchecked. Select this checkbox will make Delphi Code Arrange Expert Auto-append a special comment behind each"end", which comment contain the block information at that time. For example:

if x < 3 then
begin
  Statement1;
end; {_ if x < 3 then _}

These auto-append comments could be removed by clearing the "Auto End-comment" checkbox then re-arrange your source again.

Since a special comment will be appended behind of each "end", you should avoid to use comment begin with "{_" and end with "_}" in your program, Sorry!

Advanced

Delphi Code Arrange Expert support blocking arrangement, that's say, you do not need to arrange whole of your source code. To direct my Expert arrange specific lines of source only, just select these lines you want before you run the Delpih Code Arrange Expert. This action is same as that you drag characters before you copy / cut them into clipboard. Blocking Arrangement is supported on Delphi 3 only.

---

a.cfg, b.cfg..., z.cfg are the standard spelling files, you could edit these files manually or via the "Symbol..." button in Code Arrangement Options... dialog box.

If you edit these files manually, please notify that each word is catalogued into "a" to "z" by it's first character, that's say, if you want to add "FieldByName" into these standard spelling files, you should add it into "f.cfg" since the first character of "FieldByName" is "F". Underline is catalogued into z.cfg.

Let Delphi Code Arrange Expert add indentifers for you is recommendated. The steps to direct Delphi Code Arrange Expert add identifiers for you are --

1. Run Delphi Code Arrange
2. Click the "Options..." button
3. Click the "Symbol..." button
4. Select a Delphi .pas unit in the open file dialog

After you select a .pas file, symbols in that unit will be parsed and add into a.cfg...z.cfg for you. Please notify that only the symbols ahead of implementation part will be add into.

a.cfg..z.cfg could be absent, that's say, you could delete them. But, keyword.cfg should not be removed, or you will get problem on Delphi Code Arrange Expert executed.

Registration

Delphi Code Arrange Expert is shareware, you could try it for evaluation before you buy it. If you consider this program is useful for you. I'm appreciated your support by sending $10 US dollars to me.

The online registeration is available for you now --

1. Fill out your name and E-mail address in the form on this page.
2. On you click the "Register" button, my CGI program will send an E-mail to you, which mail will tell you the license key of Delphi Code Arrange Expert.
3. After CGI on-line registeratioin, I'm looking forward you sending the register fee to the street address below: (registered mail is welcome)
   3FL, NO. 38, 5TH CHANG-I STREET, TAIPING, TAICHUNG HSIEN,
   TAIWAN, R.O.C.
4. Once I got the money / check from you, the source code of Delphi Code Arrange Expert will be send by E-mail to you as soon as possible.

To redistribute cca102.zip is encouraged and it is free available for evaluation trying.

Online registation form --

Wolfgang Chien <wolfgang@ms2.hinet.net>

3FL, NO. 38, 5TH CHANG-I STREET, TAIPING, TAICHUNG HSIEN,
TAIWAN, R.O.C.
TEL: 886-4-2926213