home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / MADTRB15.ZIP / CALNDR.DOC < prev    next >
Encoding:
Text File  |  1985-07-01  |  6.3 KB  |  161 lines
  1.  
  2.  
  3. 01-JUL-85                     CALNDR.PAS           
  4.  
  5.  
  6. Address any questions to Dave Carey,  [70120,112]
  7.  
  8.  
  9. 1: Description
  10.       
  11.       CALNDR.COM will produce a calendar for any year in the Gregorian
  12.       Calendar. The program will send the output to the screen, a
  13.       printer, or an MSDOS file at the user's option.  The output
  14.       format is selectable by the user from five pre-defined formats.
  15.       
  16.       Note that this program will create a calendar for ANY year, even
  17.       though the Gregorian calendar was not adopted until 1582 by the
  18.       Roman Catholic Church, and even later by other authorities.  The
  19.       Gregorian Calendar was adopted in the United States (along with
  20.       all the other British colonies) in 1752. Calendars produced for
  21.       years before these times are not, of course, valid for historical
  22.       purposes.
  23.       
  24.       
  25.  
  26. 2: Operation
  27.       
  28.       CALNDR.COM operates from parameters supplied on the DOS command
  29.       line.  Each parameter is processed, in sequence from left to
  30.       right, as supplied on the command line.  This sequence can be
  31.       critical to the production of desired output.  The next sections
  32.       describe each parameter in more detail.
  33.       
  34.       Parameters must be delimited by spaces, and the parameter
  35.       variables must not contain spaces.  The parameter key letters may
  36.       be upper or lower case. Undefined parameters or invalid arguments
  37.       will be rejected with an error message.
  38.       
  39.  
  40. 2.1:  Parameters
  41.  
  42. 2.1.1:      F Param
  43.                
  44.                The Fx option sets the format of the calendar output.
  45.                The option can be 0 thru 4.
  46.                
  47.                F1 generates a calendar that is one month wide by 12
  48.                months long. (33 characters by 120 lines.)
  49.                
  50.                F2 generates a calendar that is two months wide by 6
  51.                months long. (66 charactesr by 60 lines.)
  52.                
  53.                F3 3 x 4.  (99 characters by 40 lines.)
  54.                
  55.                F4 4 x 3.  (132 characters by 30 lines.)
  56.                
  57.                F0 generates a calendar using block characters.  One
  58.                month is printed per page.  The page must be at least
  59.                127 characters wide by 64 lines long.
  60.                With F0 a single month can be selected using the M
  61.                param, or an entire year can be selected using M0.  (See
  62.                also, the M Param, next section.
  63.                
  64.                
  65.  
  66. 2.1.2:      M Param
  67.                
  68.                The M param selects the month to be processed by format
  69.                0.  It has no effect on the other formats. M1 thru M12
  70.                select January thru December, M0 selects the entire year
  71.                for output.
  72.                
  73.                
  74.  
  75. 2.1.3:      P Param
  76.                
  77.                The P param sends data to the output device or file.
  78.                The typical use of the P param would be to send the
  79.                characters to select condensed print or some other
  80.                special effect to a printer.
  81.                
  82.                The variable portion of the P param is the data text to
  83.                be sent to the output device or file.  Standard letters,
  84.                numbers, and other characters can be specified directly,
  85.                control characters are selected by preceding the desired
  86.                keyboard character with the circumflex '^' character.
  87.                The program will subtract 64 (hex 40) from the binary
  88.                value of the next keyboard character before the
  89.                character is output.  The Escape character is specified
  90.                as ^[.  Note that the Case (Upper or Lower) of
  91.                alphabetic characters is relevant here.  ^A is Hex 01
  92.                (41-40=01), while ^a is Hex 21 (61-40=21).
  93.                
  94.                Note that the Print control information will be sent to
  95.                the last defined Output device/file.
  96.  
  97. 2.1.4:      O Param
  98.                
  99.                The O param defines the output device or file.  The
  100.                variable portion of the O param can be any valid MS-DOS
  101.                file or TURBO device name.
  102.  
  103.                Note that the Output file or device must be specified
  104.                prior to output of Print control data using the P param.
  105.                
  106.                If the O param is omitted, the default device is the
  107.                TURBO "OUT:" device (the screen).
  108.  
  109. 2.1.5:      Y param
  110.                
  111.                The Y param defines the year desired, and causes the
  112.                program to immediatly output the selected calendar.  A Y
  113.                param with no variable part causes the output of a
  114.                calendar for the previously specified Y or 1985 if no
  115.                prior Y param is present.
  116.                
  117.                
  118.  
  119. 2.2:  Examples
  120.          
  121.          Generate a calendar for January, 1950, in block characters to
  122.          the printer.
  123.          (Note that the printer must be capable of printing at least
  124.          128 characters per line.)
  125.          
  126.                           calndr f0 m1 olst: y1950
  127.          
  128.          Same as above but set condensed print (On the RS LP-V
  129.          Condensed print is set by Escape Cntrl-N) Refer to your
  130.          printer manual for the proper control information for your
  131.          printer.
  132.          
  133.                           calndr f0 m1 olst: p^[^N y1950
  134.  
  135.  
  136.          Same as above, but send the output to a disk file called
  137.          MYFILE on the default disk and directory.
  138.          
  139.                           calndr f0 m1 omyfile y1950
  140.          
  141.          Same as above, but do both January and February.
  142.          
  143.                           calndr f0 omyfile m1 y1950 m2 y
  144.          
  145.          Generate a calendar for the complete year 1985, printed on a
  146.          single page (66 characters by 60 lines).
  147.          
  148.                           calndr f2 olst: y1985
  149.          
  150.          Same format as before, except create two calendars 1984 and
  151.          1985.
  152.          
  153.                           calndr f2 olst: y1984 y1985
  154.          
  155.          
  156.  
  157.  
  158.  
  159.  
  160.  
  161.