





                                C L F

                          Clipper Formatter

                    Verzia 2000.02 (Februar 2000)







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


                         Uvatesk manul











                  Pre priateov FREEWARE pripravil


                        Ing. Branislav tofko

                           Trebiovsk 21

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




            Copyright 1996 - 2000 by B. tofko Bratislava
                         All Rights reserved


1.    v o d
-------------

     Ak   pracujete  s   modernmi  metdami   pri  programovan,   je
samozrejm, e  V program sa  sklad z viacerch  modulov. Pokia s
moduly  dostatone   mal  nie  je  obvykle   potrebn  robi  krov
referencie, o rob formtovacie programy zloit.

     V  mojom  primrnom  programovacom  jazyku  som  si  zvykol psa
programy ledabolo, bez  ohadu na IF THEN ELSE a  dokonca mal a vek
psmen.  Toto  zrchuje  prcu,  lovek  sa  nezdruje pravou textu
a venuje sa plne programovaniu. Na  pravu textu programu potom raz za
as  odtartujem   formtovac  program  ,ktor   to  sprav  za   ma
automaticky a  ja sa medzitm,  ako program pracuje  pozriem von oknom
ak je tam poasie.

     V programovacom jazyku CLIPPER  situciu komplikuje tzv. maarsk
spsob zpisu premennch. Numerick premenn s potom nPocet, nSpolu a
znakov  premenn s  cMeno a  cMesto at.  Je to  praktick a  ke to
prevzali v Amerike, asi to m  nejak vznam. Mj doteraj program tu
nevyhovuje, lebo  sa sna zmeni  aj men premennch.  Potreboval som
rchlo nieo na formtovanie a tak som modifikoval mj program QBF.

     Pretoe  som u  bol v   minulosti obvinen,  e ni  neviem, len
opisujem od  inch, vyhlasujem, e  toto som opsal  z mjho vlastnho
programu  QBF.  Dfam,  e  t  o  ma  obviuj  z opisovania bud u
spokojn.

     Pouvam program CLF  u viac ako tri mesiace a  tak dfam, e aj
Vm bude  spoahlivo fungova. Napriek  tomu sa niekedy  program tohto
typu  ako  presadzuje  u  programtorov,  ktorm  je proti srsti, e
nejak program  a to dokonca tak,  ktor oni neurobili im  bude robi
poriadky  v ich  zdrojovch textoch.   Ale pozera  sa, ako  sa snaia
editorom zachovva odstupy pri kadom IF je zfal.

     Ja sa drm zsady, e

        PROGRAM NEMUS FUNGOVA, PROGRAM MUS PEKNE VYZERA.

     Toto privdza  niektorch do zfalstva,  lebo si myslia,  e moje
programy aj  tak funguj. Ale dosiahnu,  aby pekne vyzerajci program
fungoval  je ovea  jednoduchie ako  opane. A  ako potom  vyzeraj a
funguj moje programy, to vidte na programe CLF.

2.   tart programu
--------------------

     Program CLF sa ohlsi oznamom :

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 !!!
 
                                                         CLF 1 z 5

     Ak chcete  preformtova program PREHLAD.PRG,  napte jednoducho
CLF PREHLAD.PRG . tandardne je  nastaven odstup riadkov  za prkazom
IF na dva znaky. To sa mne jav ako optimlne, nakoko riadok sa potom
nerozahuje prli doprava.

     Prepna /S spsob, e v programe sa dopln vhodn komentr pred
a za PROCEDURE a FUNCTION. Majme nasledovn text.


procedure prva

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

     function druha(dlzka)

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

Tento text  je myselne napsan o  "najlampckejie" ako som vedel,
aby  ste mohli  vidie vsledok  innosti programu  CLF. Tento text je
v sbore  CLF_TST.OLD. Prekoprujte,  /nie premenujte/  tento sbor na
CLF_TST.PRG a na om si vyskajte o s tm sprav CLF.EXE !

Po formtovan sa zmen text programu nasledovne :


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

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

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

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

S prepnaom /G sa vytvor nov sbor s prponou .LST, kde s graficky
znazornen prkazy IF THEN ELSE, DO  CASE a podobne. Pouvam to vtedy
ak si u neviem rady s neposlunm programom.
 
                                                         CLF 2 z 5

Raz som pracoval vo firme, kde sice skoro nikto v programovacom jazyku
C nepracoval ale bolo vecou  profesionlnej cti pouva komentre tak
ako v  jazyku C . Aby  som nemusel meni svoj  zvyk, pouvanie komen-
trov zanajcich takto :

*--- to je komentar

vloil  som do  programu CLF  automatick konverziu.  A po  rokoch ma
upozornil jeden  uvate, e tmto  vlastne znehodnocujem inak  dobr
program. Ak by ste chceli ma okomentovan procedry takto :

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

pouijte prepna /C , ktor naviac prepe komentre *--- na //

A ete na zver. Nikto Vs nenti pouva prepnae manulne, spravte
si v takom prpade .BAT sbor  umiestnen tak ako program CLF do adre-
sra prstupnho cez PATH.

Tu je sbor CLIFO.BAT

     @echo off
     clf %1 /C

Potom miesto CLF program.prg sta napsa CLIFO program.prg

Pretoe  CLF bez  prepnaa /G  prepe pvodn  sbor, pouvajte CLF
uvene. A to je vetko, vea spechov praje autor.

3.   Kompletn sada
--------------------

     Ako prevencia proti vrusom a  neiadcim zsahom je v dokument-
cii na  tejto strnke uveden  sprvna vekos sborov  a dtum a  as
vytvorenia. Skontrolujte si vo vlastnom zujme neporuenos dodvky !

             Kompletn sada sa sklad z tchto sborov :


CLF    .EXE     4523   program

CLF    .602    10694   dokumentcia v tvare pre T602

CLF    .TXT    10657   dokumentcia v kde Kamenicky

CLF_TST.OLD      648   myselne zl prava sboru

CLF_ENG.TXT     6731   dokumentcia v anglitine

CLF_DUT.TXT     7371   dokumentcia v holandtine

     Dtum  a   as  vetkch  kritikch   sborov  je  nastaven   na
08.10.2000  a 09:00:00  .  V prpade  ak nemte  kompletn sadu, alebo
bola poruen, registrujte sa u autora, kde mete vdy zska neporu-
en sbory.
 
                                                         CLF 3 z 5

4.   Registrcia programu
--------------------------

     FREEWARE je  software, za ktor sa  neplat registran poplatok,
podobne ako u  PUBLIC DOMAIN, ale z ktorho  nie je vybran copyright.
To  znamen, e  si autor  stanovil podmienku,  e sce mete program
koprova a  pouva poda vlastnho uvenia,  program vak nesmiete
modifikova, napr. tak, e binrnym editorom prepete meno autora.

     Poplatok, ktor  platte nejakej firme za  dodvku tohto programu
typu  FREEWARE ,  pokrva vhradne  nklady na  rozmnoovanie, diskety
prpadne  CD ROM a  distribciu.  Tento  poplatok zostva  tejto firme
a mne  ako autorovi  z neho  nepripadne ani  halier. Toto  teda nie je
registran poplatok.

     Po vyskan  tohto programu sa  mete ale nemuste  registrova
u autora poslanm  pohadnice. V takom  prpade mi polite  pohadnicu
z mesta kde sa mj program pouva. Uvete prosm aj Vau adresu, moju
njdete v tejto  dokumentcii. Moja E-mail adresa je :

BranoStofko@RocketMail.com

alebo

bstofko@yahoo.com

            Poslanie E-mailu nepovaujem za registrciu !

     Po  registrcii  mete  zska  alie  vhody. Vaa registrcia
podpor  moje zmery  vytvori lepiu  verziu programu  ako aj  alie
programy typu FREEWARE a SHAREWARE.

     Tento  program  dvam  k  dispozcii  tak  ako je. Program mete
pouva v amatrskej ale aj zrobkovej  innosti, bez toho, e by ste
museli mne ako autorovi plati nejak alie poplatky.

     Prpadn pripomienky z praxe kde sa mj program pouva vtam. Ak
iadate psomn odpove, prilote do listu dostaton poet potovnch
znmok.  Od  priateov  z  eskej  republiky  akceptujem  esk znmky
v rovnakej  hodnote ako  zaplatte za  list Vy.  Ak mte E-mail adresu
znmky neposielajte.

     Registrovanm  uvateom odpovedm  prednostne na  ich dotazy za
horeuvedench  podmienok.  Pre  registrovanch  uvateov som ochotn
urobi len  tak modifikcie, o  ktorch sa domnievam,  e by prospeli
irokej  verejnosti. In  jazykov mutciu  programu, nie dokumentcie
som ochotn vytvori len na zklade dohody a za platu.

     Minule  sa na  ma telefonicky  obrtil jeden  z uvateov mjho
SHAREWARE programu BROWSER a chcel odo ma hne zdrojov text, lebo on
chce BROWSER  zlepi. BROWSER je moje  diea. Tak ako matka  ver, e
jej syn je nevinn aj ke ide  syn na popravisko, ja si myslm, e som
do BROWSER-a dal  vetko o viem a to  v mojom vonom ase. To  e Vm
dvam nejak  program prakticky zadarmo  ete neznamen, e  nemm ni
in na  prci ako riei  prpadn Vae problmy.  Samozrejme volajci
uvate si nedal ani t nmahu  aby sa u ma registroval. Vekorysos
mete oakva len ak budete sami vekorys.
 
                                                         CLF 4 z 5

Tento program bol vytvoren  pomocou databzovho kompiltora FORCE.Je
to  databzov  kompiltor  podobne  ako  CLIPPER  s rozdielom, e vie
vytvori  s krtkeho  zdrojovho textu  aj krtky  EXE sbor.

                         V y h l  s e n i e

     Nemm  iadne nmietky  proti tomu  aby ste  poskytli program  aj
svojim znmym, ale za podmienky,  e im dte kompletn zapakovan sadu
vrtane zdrojovho textu a tejto dokumentcie.

                                * * *
 
                                                         CLF 5 z 5