





                                L G E

                     Listing or report generator

                    Version 97.10 (October 1997)







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


                            Users manual











                For friends of SHAREWARE prepared by


                        Ing. Branislav Stofko

                           Trebisovska  21

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




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




WHY GENERATOR

     You  known  probably  some  people  that  are  working with a bad
hammer. Moreover, most  of them haven't time to  repair your hammer or
buy a  new one. The argument  for this situation is  simple "I have no
time to repair a hammer". Really  reason for this is, they are working
with low  efficiency because a hammer  is wrong. However, at  some day
you must say "enough" and repair or buy a hammer.


WHY PROGRAMMERS DON'T LIKE GENERATOR

     Some generators don't allow programmer to add a code to generated
results, or an addition is complicated. I am the programmer and I will
give the  commands for machine. Some  generators are in the  memory at
runtime and from time to time are generated error messages ERR 567 ?


STORY FROM HISTORY

     30  years ago  are all  reports first  handwritten on paper. From
this paper are  translated to punch cards. Every  correction of report
was time-consuming. Today we have  screen editors. All corrections are
now simple, but if the user say OK, content of your suggestion must be
translated from text editor to programming language.

I use CLIPPER,  FoxPro or FORCE.  However, the translation  goes still
manually.  LGE is  a program  for automatically  translation from your
suggestion on paper to your programming language.


SOME SAMPLES

                       Sample #1 TEST.LGE

 Bike_touring_club                          Page_: 99

    N_a_m_e             Street          Phone
-----------------------------------------------------
 Rabenseifer_Milos      Skuteckeho_15   456_71

 Total_at 12/12/1995 is 999

     This  a stupid  simple example   of using  LGE. Please  note than
between some word  are characters "_" ASCII 95  . This characters will
be replaced with  blanks, ASCII 32. Text "N_a_m_e"  will be treated as
"N  a m  e" .  If you  use only  "N a  m e",  every character  will be
recognized as one element and not N a m e as one element.

     In the current lines of report  is useful to have really data and
not only XXXXXXXX  as space holder for alphanumerical  values and 9999
for  numeric values.  Please use  from  every  type of  line only  one
sample, because LGE generates all this lines.

     In  the total  line, you  can see  999. This  approach is  useful
because after generating you change the generated line as follows:

  @ r,28 say "999"  ->    @ r,28 say Total_count picture "999"
                                                         page 2 of 5

     Characters "999" are now used as a mask for PICTURE clause.

                       Sample # 2 MONEY.LGE


 Salary_report                 AUGUST 1995                          Page_: 99

 Branch    Name                Birth_date      Amount            Signature

==============================================================================

 TV123     Hellowen_Frederike  12/12/1962         1200          ..................
                                            -----------
                                Branch_total     99999
------------------------------------------------------------------------------
                               Concern_total    999999

In this example aren't new things only a count of different lines is bigger.

                       Sample # 3 CARD.LGE


            EMPLOYEE___CARD Ŀ
                                                 
                   Full_name  Herring_John       
                                                 
                  Birth_date  12/12/1957         
                                                 
                    Phone_nr  999999999          
                                                 
          

     This is a second simple stupid example. Because LGE.EXE generates
source code  for printer, resulting  source code file  isn't optimally
for screen.

     You  can use  simple or  double lines.  Tab key  is allowed  too.
However, LGE expands all tabs to standard 8 spaces. If setting of your
editor is different, resulting picture will be destroyed.

     If  this card  should be  only displayed  on screen,  you can use
command

@ 4,4 to 10,19 DOUBLE

Normally  you haven't  all four  coordinates of  card. I  use a  small
trick:

1. for final generating should be card modified follows :


          *             EMPLOYEE___CARD

                    Full_name  Herring_John

                   Birth_date  12/12/1957

                     Phone_nr  999999999

                                                  *
                                                         page 3 of 5


2. After them LGE.EXE generate two lines

   @ 4,7 say "*"

   In addition, some lines later

   @ 11,47 say "*"

3. At this  moment I modify  first line to  @ 4,7 to  11,47 DOUBLE and
   delete second line


RELATIVE OR ABSOLUTE LINE NUMBERS?

     I use for screen always absolute line number. For example

@ 12,56 SAY "Comment"

     Relative line numbers are standard  for reports creating. You can
use variable LineNum. LGE.EXE can  work with both styles. However, the
name for line counter is not  checked. You can have strange outputs if
the variable for line counter is SAY. LGE generates in this example:

@ SAY,56 SAY  "SAY" .

This can be a syntax error?


THIRD WAY

     LGE.EXE can  generate output commands  with character "?".  Well,
this is no more useful, but I have this way added for one occasion. If
you  give as  name of  line  counter  variable a  character ZERO  "0",
LGE.EXE make output follows:

Instead

@ 12,30 SAY "BOSTON"

will be generated

? SPACE(30)+"BOSTON"


HOW TO ABOUT USED .LGE FILES

     It  is dangerous  to leave  old  used  .LGE files  in the  active
directory. If you  make one or two hours modifications  in the code of
created .PRG file and somebody starts  LGE.EXE a new, your work can be
superseded  with generated  .PRG file.  Moreover, after  you can start
from begin. This is a reason for which I always delete old .LGE files.

                                                         page 4 of 5


HOW TO REGISTER LGE

     LGE is FREEWARE  and it is not neccesary to  register as user. If
you  find LGE  usefull, please  send  at  my home  address a  colorful
postcard from place who you live. Please tell my from which source you
have my program.

     I am ready  to answer questions from registered  user by E-mail .
My E-mail address is

BranoStofko@RocketMail.com

or

BranoStofko@Hotmail.com

            Sending only E-mail is not a registration!


                                * * *
                                                         page 5 of 5