





                                Q B F

                        Quick Basic Formatter

                     Version 97.04 (April 1997)







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


                             User manual











                 For friends of FREEWARE prepared by


                        Ing. Branislav Stofko

                           Trebisovska 21

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

                              SLOVAKIA



              Copyright 1996-97 by B. Stofko Bratislava
                         All Rights reserved



1.  Introduction
    -------------

  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 QUICK   BASIC is  the proper  style of
writing important too.  But today I am not agree  to do this manually.
I know 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 PROGRAM 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 QBF will be started with message :

Quick BASIC source file reformatter       FREEWARE B.Stofko

Syntax: QBF <filename> [options]

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

Options: /S   generate comment lines before and after SUB or FUNCTION

Output:       the same filename !!!

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

                            QBF MAIN.BAS

  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 want,
you can type QBF MAIN.BAS/I:8 and this is all.

  Switch  /S force  generation of  comments before  and after keywords
PROCEDURE  and FUNCTION.  Don't forget  to store  source code in ASCII
format for this reason.


                            W A R N I N G
                           ===============

           QBF write  over the original  source code file.
           You should therefore using QBF carefully.

3.  File summary
    ------------

QBF    .PRG     source code of QBF program

QBF    .EXE     source code reformatting program

QBF    .602     manual in Slovak language, special format

QBF    .TXT     manual in Slovak language, ASCII file

QBF_EN .TXT     manual in English language

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 POSTCARDWARE.

  And if you really like this  program, why not contact the editors of
your  favourite  computer  magazine  or  newspaper,  or web sites that
review software and tell them about it ! That's a great way to make my
work better known.

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

  <branostofko@rocketmail.com> or <stofi@pobox.sk>

  You have not only QBF.EXE but source code too. Maybe you are able to
modify  this source  code for  other compiler  as PASCAL,  C or  maybe
VISUAL  BASIC. 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.

  The  author of  this program  accepts no  responsibility for damages
resulting from its use and makes no warranty or representation, either
express or implied, including but not limited to, any implied warranty
of merchantability  or fitness for a  particular purpose. This program
is provided  "AS IS", and you,  its user, assume all  risks when using
it.

  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 !
                                * * *