







                                C L F

                          Clipper Formatter

                   Version 2000.02 (Februar 2000)







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


                       Gebruikers Handleiding











             Voor vrienden van FREEWARE ontwikkeld door


                        Ing. Branislav Stofko

                           Trebisovska 21

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

                              SLOVAKIA


             Copyright 1996-2000 by B. Stofko Bratislava
                      Alle Rechten Voorbehouden

1.   Inleiding

     Indien  u  werkzaam  bent  met  moderne  programmeertalen, is het
logisch  dat je  programma bestaat  uit meerdere  modules. Indien deze
modules  klein zijn  is er  geen enkele  behoefte aan  cross-reference
variabelen en kan het programma gemakkelijk geschreven worden.

     In mijn  primaire programmeertaal FORCE maak  ik geen onderscheid
tussen IF THEN ELSE  en If Then Else or iF tHen  ELse. Deze manier van
schrijven kan mijn  werk en leven heel gemakkelijk  maken. Ik kan meer
aan programmeren denken en minder aan de SHIFT toets.

     Alhoewel,  na enige  tijd ziet  mijn programma  er verward uit en
niet gemakkelijk aan te passen. Dit is het moment dat het noodzakelijk
is om een programmeertool te hebben dat de broncode herformateerd. Dit
programma kan alles op een zeer leesbare manier reproduceren en heb ik
even tijd om door het venster te gluren wat weer het is vandaag.

     In de  CLIPPER programmeertaal is  de situatie nog  ingewikkelder
bij  het gebruik  van de  Hongaarse stijl  voor character  variabelen.
Numerische variabelen moeten gedefinieerd worden als nCount, nTotal en
character variabelen cName en cCity.

     Dit is  niet slecht, maar mijn  oud programma kan dit  niet doen.
( al mijn  variabelen beginnen met een  hoofdletter ) en ik  moest een
nieuw programma schrijven. Mijn nieuw  programma CLF is gemakkelijk en
kort want character variabelen worden niet gewijzigd !

     Ik weet uit mijn eigen ervaring  dat het niet makkelijk is om een
programmeur te  overtuigen iemand anders zijn  programma te gebruiken.
Alhoewel, door  te proberen en  het te tonen  aan anderen, die  steeds
source  code  editeren  naar  goed  gestructureerde  lay-outs,  is het
hopeloos.

  Mijn leuze is

      EEN PROGRAMMA MAG DAN WEL NIET WERKEN,
      MAAR DE SOURCE CODE MOET GOED GESTRUCTUREERD ZIJN.

     Het is gemakkelijker om een goed gestructureerd lay-out programma
te hebben dat werkt dan een dat niet werkt.

2.   Starten van het programma

     Het programma CLF start met de mededeling :

 CLIPPER source file reformatter        FREEWARE B.Stofko/H.Kasinski

 Syntax: CLF <filename> [options]

 Options: /S    DBASE comment lines
 Options: /C    C style comment lines
 Options: /G    generate graphic output to file filename.lst

 Output:        the same filename !!!

Indien je  het programma MAIN.PRG  wil herformateren, simpel  weg tijp
onderstaand comando in :

 
                                                          CLF 1 of 3

     De standaard  ingave achter het  commando IF is  2 characters. Ik
denk dat dit de beste oplossing  is want opeenvolgende lijnen zijn dan
niet te lang voor een 80 character breed scherm.

     Optie  /S forceert  de generatie  van commentaar  lijnen voor  en
achter keywords PROCEDURE en FUNCTION.

     Voorbeeld van een slecht gestructureerde 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) + "!"

     Deze  tekst is  opzettelijk slecht  geschreven. U  kan deze tekst
terug vinden in de file CLF_TST.OLD. Maak a.u.b. een copie ( zonder de
naam te  wijzigen ) van  deze file file  naar file CLF_TST.PRG  . Deze
file kan dan geherformateerd worden met CLF.

     Na  de herformatatie,  De source  code zal  gemodifieerd zijn als
onderstaande tekst:

*-------------
PROCEDURE prva
*-------------

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

*--------------------
FUNCTION druha(dlzka)
*--------------------

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

                            O P G E L E T

           CLF overschrijft de originele source code file.
           U moet CLF gebruiken met de hoogste voorzichtigheid.

     Indien U een groot programma schrijft met veel IF THEN ELSE en DO
ENDDO  commando's,  de  volgende  mogelijkheid  - grafisch gemarkeerde
commando's - kunnen  waardevol zijn. Ik ben zeer  dikwijls verloren in
deze situatie,  maar CLF heeft  mij hierbij geholpen.
 
                                                          CLF 2 of 3

     Probeer CLF uit met uw source files met de optie /G .

     In  de nieuwe  Clipper versie  is het  mogelijk om  de C style te
gebruiken. Gebruik de optie /C indien u deze verkiest

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

     Met deze optie zal alle  *--- commentaar veranderd worden in /---
too.  Aan de  andere kant  is het  niet noodzakelijk  om deze  optiesz
manueel  te gebruiken.  Plaats kleine  .BAT bestanden  in de directory
gedefinieerd in het PATH en plaats CLF.EXE hier ook in

     Dit is de inhoud van CLIFO.BAT

     @echo off clf %1 /C

Roep CLF aan als volgt

CLIFO program.prg

en de optie /C bestaat voor immer en altijd !

3.   Bestanden lijst

CLF    .EXE     CLIPPER source code reformatting programma

CLF    .602     handleiding in de Slovaakse taal, speciaal formaat

CLF    .TXT     handleiding in de Slovaakse taal, ASCII file

CLF_TST.OLD     slecht gestructureerde source code

CLF_ENG.TXT     handleiding in het Engels, ASCII file

CLF_DUT.TXT     handleiding in het Nederlands, ASCII file


4.   Programma registratie

     Dit  programma is  FREEWARE .  U hoeft  geen registratiekosten te
betalen. Indien  U mij een  postkaart toestuurt ben  ik zeer tevreden.
Dit type van software wordt CARDWARE genaamd.

     Indien U enige vragen of opmerkingen heeft kan U mij bereiken via
mijn Email adres :

        <BranoStofko@RocketMail.com> or <bstofko@yahoo.com>

     Indien  u deze  tekst kan  vertalen in  uw eigen  taal, zend  mij
a.u.b. een copie als Email attachment.

     Dit programma  werd gecreerd met de  database compiler FORCE. Dit
programma is  gelijkgesteld aan CLIPPER  maar produceert kleinere  EXE
files.

                                * * *
 
                                                          CLF 3 of 3