







                                C L F

                          Clipper Formatter

                     Version 96.04 (April 1996)







       -------------------------------------------------------
       -------------------------------------------------------
       ------------------------------------------
       -----------------------------------------------
       -------------------------------------------------
       ----------------------------------------------
       -------------------------------------------------
       -----------------------------------------------
       -----------------------------------------
       -------------------------------------------------------
       -------------------------------------------------------


                             User manual











                For friends of SHAREWARE prepared by


                        Ing. Branislav Stofko

                           Trebisovska 21

                     821 01 B R A T I S L A V A

                              SLOVAKIA


               Copyright 1996 by B. Stofko Bratislava
                         All Rights reserved


1.   Introduction

  If  you  are  working  with  modern  methods  at  programming, it is
normally  that your  program consist   from more  than one  module. If
modules  are  small  it  is  no  need  for  cross-reference listing of
variables and my program can be written easy.

  In  my  primary  programming  language   FORCE  I  make  usually  no
difference between IF THEN ELSE and If Then Else or iF tHen ELse. This
type  of writing  can make  a work   and life  much easy,  i can  more
thinking about programming and not about SHIFT key at keyboard.

  However, after some times show my  program strange and of course not
useful for next  modifications. This is a time  in, which is necessary
to have  a program for source  code reformatting. This program  can do
all things for  me and I am able  make a break to show  through window
how weather we have today.

  In  the programming  language CLIPPER  is the  situation complicated
with Hungarian style for variables name. Numerical variables should be
written as nCount, nTotal and character variables cName and cCity.

  Well it  is not bad, but  my old program can  not do this all  ( all
variables become beginning with capital letter ) and I must make a new
one. My  new program CLF is  easy and short because  name of variables
are not changed !

  I now from my practice that is  not easy to convince a programmer to
use  a program  there was  not made  by its  own. However,  to show at
people there are every time editing source code to well looked form is
hopeless.

  My principle is

      A PROGRAMM MUST BE NOT WORKING,
      BUT THE SOURCE CODE MUST BE WELL LOOKING.

  It is more to possible to make well looking program to working as to
make opposite action.

2.   Start of program

     Program CLF will be started with message :

 CLIPPER source file reformatter           FREEWARE B.Stofko

Syntax: CLF <filename> [options]

Options: /I:n use increment of n blanks for indent, default = 2

Options: /S   generate comment lines before and after PROCEDURE
              and FUNCTION

 Output:        the same file name !!!

  If you want to reformat program  MAIN.PRG, it is enough to type :

                            CLF MAIN.PRG
                                                          CLF 1 of 3


  Default indent after  command IF is two characters.  I think this is
optimally  because  following  lines  will  be  not  to  long  for  80
characters wide display.

  Indent to 8 characters ( 1 Tabulator  ) is too big. But if you will,
you can type CLF MAIN.PRG/I:8 and this is all.

  Switch  /S force  generation of  comments before  and after keywords
PROCEDURE and FUNCTION.

  Example of bad structured CLIPPER source code :


procedure prva

  if x = 1
  y = 1
 else
  y =2
     endif

     function druha(dlzka)

  for i := 1 TO  10
    ? i
        next
                         return space(dlzka) + "!"

  This text is deliberate bad written.  You can find this text in file
CLF_TST.OLD. Please make a copy ( not  rename ) from this file to file
CLF_TST.PRG . This file can be after reformatted with CLF.

  After reformatting, will be source code modified following :

// -----------
PROCEDURE prva
// -----------

IF x = 1
  y = 1
ELSE
  y =2
ENDIF

// ------------------
FUNCTION druha(dlzka)
// ------------------

FOR i := 1 TO  10
  ? i
NEXT
return space(dlzka) + "!"

                            W A R N I N G

CLF write over the original source code file. You should using CLF
carefully.
                                                          CLF 2 of 3


3.   File summary


CLF    .PRG     source code of CLF program

CLF    .EXE     CLIPPER source code reformatting program

CLF    .602     manual in Slovak language, special format

CLF    .TXT     manual in Slovak language, ASCII file

CLF_TST.OLD     bad formatted source code

CLF_ENG.TXT     summary in English, ASCII text file


4.   Program registration

  This program  is FREEWARE . You  must not pay any  registration fee.
However, if you send my postcard I  am happy. This type of software is
called as CARDWARE.

  If you have any question, you can reach me at Email address :

  <BranoStofko@RocketMail.com> or <BranoStofko@Hotmail.com>

  You have not only CLF.EXE but source code too. Maybe you are able to
modify  this source  code for  other compiler  as PASCAL,  C or  maybe
CLIPPER. Good luck and please send  me your modifications by Email. If
you are able translate this text  to your own language, please send my
a copy by Email.

  This program was made with  database compiler FORCE. This product is
similar  to CLIPPER  but he  can  make  a smaller  EXE file.  FORCE is
a product of :

                 Sophco, Inc.
                 P.O. Box 7430
                 Boulder, Colorado 80306-7430
                 (303) 444-1542

  This adress has changed, see README.TXT !

                                * * *
                                                          CLF 3 of 3