readme.txt

关于PBCOMMENT这个软件

About PBCOMMENT Version 6.1
================================================================
Copyright (C) RC Sizer 1999.03 - 2000.02, All rights reserved.
Copyright (C) SCST Co.,Ltd. 2003, All rights reserved.
Copyright (C) TRUEWAY(TM) 2002.03 - 2004.11, All rights reserved.
TRUEWAY(TM) is the trademark of programs by Trueway Lee
   Written By RC Sizer, Welkin Zhou, Trueway Lee
   RC Sizer's    E-Mail: [e-mail] 
   Welkin Zhou's E-Mail: [e-mail]
   Trueway Lee's E-Mail: [e-mail]

   She can help you to create comments for PB script automatically,
and indent some PB script at sixes and sevens into dainty format.
   And she can also help you automaticly create script code.
   She is really wonderful!!!
   Support PowerBuilder 6.0/6.5/7.0/8.0/9.0 in one program!!! 
   You can also read <<readme_cn.txt>> written in simple chinese.
    
Function Specification
================================================================
   The lastest PBCOMMENT include some useful functions, such as:
     Build complete function comment
     Build modify/delete/add code comment
     Build step code specification comment
     Convert the script text to UpperCase/LowerCase
     Indent your PB script code, a powerful function to turn your
        PB script code into dainty format!!!
     Automatically fill prefix or postfix into a block of script code
     Automatically fill script code between datawindow and structure 
        variable, or datawindow and datawindow, and so on.
     DataWindow script code automatic create tool

What's New
================================================================
   PBCOMMENT Version 1.0     Only support PB 6.0/6.5
   PBCOMMENT Version 2.0     Added Support PB 7.0
   PBCOMMENT Version 3.0     Added Support PB 8.0
   PBCOMMENT Version 3.5     Added Support PB 9.0
   PBCOMMENT Version 5.0     Added indent script code
   PBCOMMENT Version 5.1     Rewrite the object of PB indent tool
                             Fixed the bug found
   PBCOMMENT Version 5.2     Fixed the bug when process "&"
                             Added Support SQL statement 
                             Fixed the bug when "~~" or "~""
                             Added process *.sr* file in one time
                             Automatically integrate PBCOMMENT to PB IDE
                                Now support PB 6.0/6.5, PB 9.0 only
                             Fixed bug when define a DOUBLE type variable 
   PBCOMMENT Version 5.3     Automatically fill prefix or postfix into 
                                a block of script code
   PBCOMMENT Version 5.31    Automatically fill script code between 
                                datawindow and structure variable, 
                                or datawindow and datawindow
                             Add support for muti-language form
                             Automatically integrate PBCOMMENT to PB IDE
                                Now support PB 6.0/6.5/7.0/8.0/9.0 
                             Add trim code from the beginnig or end the flag
   PBCOMMENT Version 5.5     Add suppprt for dataWindow script code
                                automatic create tool named "PBDataWindow.exe"
                             Add support for distinguishing comment between
                                function or event code under PB 6.0/6.5
   PBCOMMENT Version 5.5 Plus  Add user function for comment interested format
                             Add support for distinguishing comment between
                                function or event code under PB 7.0-9.0             
                                
   PBCOMMENT Version 6.0     Fixed some bug about indent script 
                             Add support for PB 10.0
                             Add support for automatically detect 
                                current PB IDE version
   PBCOMMENT Version 6.1     Fixed some bug about integrate to PB IDE
                             Add multi-language support for function comment
                             Fixed some bug about indent *.sr* file
      

Reason and History
================================================================
   If you often access internet, you will find a lot of homothetic 
programs they can help you to build code comments automatically. But, 
it is obvious to easily find a fly in the ointment, they can't support 
all PB version Integrated Development Entironment. The lastest PBCOMMENT 
provide with all support.
   Thanks a lot for the program written by RC Sizer who created the frame 
work of PBCOMMENT.
   I am Trueway. I usually appreciate an email describing how you used 
the code and what modifications (if any) where made to the code. 
All feedback will be published in a Frequently Asked Questions (FAQ) page,
with the appropriate references. I'm looking forward to meeting your E-Mail.
   The function to indent script code is written by Welkin Zhou, a excellent 
programmer, come from Hangzhou, a beautiful city of China. He often create
some utility tools they help you to code freely and joyfully. 
   Thanks a lot for the program written by  Welkin Zhou.
   For rapid coding, from PBCOMMENT 5.3, add support for automaticly complete 
script code, such as: build datawindow script code from datawindow column list,
assign structure variable to datawindow, assign value between one datawindow 
and another, and so on. By this way, you can spend less time on coding. 


PBCOMMENT Usage
================================================================
   The file named "pbcomment.exe" compiled under PB 6.0. Please copy the
PB 6.0 virtual machine files to your windows system directory before use it.
And you can compile PBCOMMENT.pbl under PB 6.5 or later version. 
   NOT FORGET to copy the virtual machine files of all version PB to your
windows system directory.
   Under PBCOMMENT 5.2 or later, you can click "Integrate to PB IDE" menu 
item, PBCOMMENT will automatically integrate itself to the current active
or inactive but installed in your system, You can use them looked as 
some powerful tools of great use provided by SYBASE. 

1) Run "pbcomment.exe" directly

2) Use it in PB Integrated Development Entironment

   You can config your PB Menu Toolbars ("File|Toolbars", or "Windows|Toolbars", 
or "Tools|Toolbars"), Add new item and open "Customize" window, set "Command Line" 
item (e.g., "d:\pbcomment\pbcomment.exe all"). By this way, you will use it 
looked as some powerful tools of great use provided by SYBASE. :))
 
   Arguments Specification:
     pbcomment ALL      Build complete function comment

     pbcomment ADD      Build modify/delete/add code comment
                        No press any key to Build modify code comment 
                        Press [CTRL]     to Build add code comment
                        Press [SHIFT]    to Build delete code comment       
              
     pbcomment STEP     Build step code specification comment
                        Press [CTRL]     to Build step code comment with
                                            author and date information
     pbcomment UPPER    Convert the script text to UpperCase
     pbcomment LOWER    Convert the script text to LowerCase
     pbcomment INDENT   Indent your PB script code
     pbcomment PREFIX   Automatically complete code
                        Press [CTRL]     to Trim code


INI File Specification
================================================================
pbcomment.ini

[COMMENT_PARM]
REASON = Fix bug
AUTHOR = Trueway Lee
DATEFORMAT = yyyy.mm.dd
COPYRIGHT = Copyright (C) TRUEWAY(TM) 2003, All rights reserved.
COMMENT_LINE_LENGTH =68
INDENT = FFFFF