Click! 2.03 Source Code Reformatter

Features:

CLICK.DBF and CLICK.NSX
Reindenting your Source Code
ReSpacing your Source Code
Alignment of Source Code Elements
Function calling Function Cross Reference
Module to Function Reference
Table and Index Cross Reference
Applying Cross References to your Source Code


CLICK.DBF and CLICK.NSX

CLICK.DBF is the table which is generated the first time you run Click! It contains all of the functions available via libraries in your system. The CLICK.NSX file is an index of these functions. This file is used to create the function cross reference text file. CLICK.DBF will be created if it is missing, or you can use one of the following parameters when you run Click! CLICK /REBUILD <Enter> CLICK /UPDATE <Enter> CLICK CLICK.DBF <Enter> If you run Click! without using a .LNK file as the input system, then Click! will refer to every library it finds the function in. If you run Click! by specifying the name of a .LNK file, then Click! scans the .LNK file to see which libraries are being used, and isolates multiple libraries to the actual one which would be used if you compiled with the existing environment. There are three options for creating CLICK.DBF 1: You specify that you want to use the LIB= environment path. (this is the way it worked before.) 2: You specify a path or set of paths, just like the environment, except in CLICK.INI. 3: You specify that you want CLICK.EXE to search your hard drive for every library in every directory, even including multiple drives and network drives. This one might take longer, but creates the ultimate cross reference. From CLICK.INI // options are ENVIRONMENT, (specified path), DRIVES MAKE_CLICK_DBF_FROM=ENVIRONMENT //MAKE_CLICK_DBF_FROM=C:\CLIPPER5\LIB;E:\GRUMP52\LIB;F:\FUNCKY\LIB //MAKE_CLICK_DBF_FROM=DRIVES If you select DRIVES in the above step, you can limit how deep the recursion level will go with... RECURSION_LIMIT=N ... which means that it will only recurse the first N-1 levels and will skip all N level directories and below.

Reindenting your Source Code

Click will easily and quickly reindent your source code. While you cannot turn this feature off, you can change the amount of indenting for each type of control structure using the following commands in CLICK.INI. INDENT_IF=3 INDENT_FOR=3 INDENT_CASE=3 INDENT_FUNC=3 INDENT_BEGIN=3 INDENT_WHILE=3 INDENT_CLASS=3 INDENT_FUNCTIONS=NO INDENT_DO_CASE=NO

ReSpacing your Source Code

Click completely respaces your source code, opening up the elements on each line of source code so they are easy to identify. There is no part of CLICK.INI which controls this step. It is CA-Clipper syntax aware. However, you can compress some of the spaces back out on a case by case basis by using the deflate directives. // options are YES, NO // deflate mode removes spaces // following ({[ and preceding ]}) // following , // both sides of + DEFLATE_(=YES DEFLATE_{=YES DEFLATE_[=YES DEFLATE_,=YES DEFLATE_+=YES

Alignment of Source Code Elements

The Aligner is a post processor which will make your source code align elements in groups, so the code looks very professional. POSTPROCESS_WITH_THE_ALIGNER=YES @_SAY_GET_ALIGNMENT_METHOD=2 options are 0, no alignment 1, each element type in it's own aligned column 2, Columns aligned, but not by type 3, Each element in it's own row. If you use option 3, there is no reverse process. Review the output before you commit to method 3. ALIGN_DBCREATE_IN_THE_ALIGNER=YES

Function calling Function Cross Reference

The function calling function cross reference creates a file in the output directory which contians a complete cross reference for every function call in your source code. If Click! cannot resolve the function reference in your source code, it goes to your library files and finds the functions in your libraries! You can control the name of the file with the following CLICK.INI directive. SOURCE_XREF_FILE=SRC_CROS.TXT

Module to Function Reference

Click! creates a Module to Function cross reference file in the output directory, which contains a listing of every function in every module. You can control the name of the file with the following CLICK.INI directive. FUNCTION_XREF_FILE=FNC_CROS.TXT

Table and Index Cross Reference

Click! creates a Table and Index cross reference file in the output directory, which contains a listing of every Table or Index used in every module. You can control the name of the file with the following CLICK.INI directive. TABLE_XREF_FILE=TBL_CROS.TXT

Applying Cross References to your Source Code

If you choose, you can allow Click! to put the function to function and the module to fuction cross reference data into each of your source code modules. FUNCTION_REF_INTO_SOURCE=YES ( module to function ) FUNCTION_XREF_INTO_SOURCE=YES ( function to function ) TABLE_XREF_INTO_SOURCE=YES ( table in module ) INDEX_XREF_INTO_SOURCE=YES ( index in module )