





                                C L F

                          Clipper Formatter

                       Verzia 97.07 (jl 1997)







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


                         Uvatesk manul











                  Pre priateov SHAREWARE pripravil


                        Ing. Branislav tofko

                           Trebiovsk 21

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




            Copyright 1996 - 1997 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

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 filename !!!
                                                           CLF 1 z 4

     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.

     Odstup  jednho tabultora  tj. osem  znakov povaujem  za prli
vek. Ale prosm, ak ho  chcete ma napte len CLF PREHLAD.PRG/I:8 a
je to !

     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) + "!"

Pretoe  CLF prepe  pvodn sbor,  pouvajte CLF  uvene. A to je
vetko, vea spechov praje autor.
                                                           CLF 2 z 4

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    .PRG     8132   zdrojov text programu

CLF    .EXE     7556   program

CLF    .602    10255   dokumentcia v tvare pre T602

CLF    .TXT    10042   dokumentcia v kde Kamenicky

CLF_TST.OLD      196   myselne zl prava sboru

CLF_ENG.TXT     6419   dokumentcia v anglitine

     Dtum   a  as   vetkch  sborov   je  nastaven   na  25.07.97
a 22:00:00  . V prpade ak nemte kompletn sadu, alebo bola poruen,
registrujte sa u autora, kde mete vdy zska neporuen sbory.

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

BranoStofko@Hotmail.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.
                                                           CLF 3 z 4


     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.

     Okrem CLF.EXE  dvam k dispozcii  aj zdrojov text.  Tmto by sa
mohol tento produkt zaradi aj do PUBLIC DOMAIN, keby bol programovac
jazyk FORCE  veobecne rozren. Nikto  Vm vak nebrni  prepracova
program  do PASCAL-u,  C ,   QBASICu alebo  dokonca do  CLIPPERa. Vea
spechov !!!
     Tento produkt bol vytvoren pomocou programovacieho jazyka FORCE.
Je to  databzov kompiltor podobne  ako CLIPPER s  rozdielom, e vie
vytvori  s krtkeho  zdrojovho textu  aj krtky  EXE sbor. FORCE je
produktom americkej firmy :

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

                         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 4 z 4