home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / utility / countd / count.ref < prev    next >
Text File  |  1996-02-13  |  4KB  |  109 lines
  1.  
  2.                       Countdown for Windows/DOS
  3.                              version 1.0
  4.                        (C) 1995 Jeremy Lilley
  5.  
  6.                           Reference File
  7.  
  8.  
  9.      Thank you for getting Countdown for Windows and DOS.
  10.  
  11.      This file is a reference to the codes that can be used
  12. in Countdown files. The README.1st is an overview of Countdown
  13. and this file lists the commands. While you can easily use the 
  14. Windows editor, CNTEDIT.EXE, to manipulate Countdown data files, 
  15. this will give you a better idea of what the commands mean.
  16.  
  17. --------
  18. Basic commands
  19.  
  20.      Basically, a command is anything between two percentage
  21. signs (%) and two percentage signs in a row will produce a single
  22. percentage sign on the screen. Comments start with REM and 
  23. centering and justification are field commands like anything else.
  24. Fields cannot be imbedded.
  25.  
  26. Here is a sample file:
  27.  
  28.      % REM This is a sample file %
  29.      There are %days as dhms since 6/1 1:00PM% days, %hours%:%minutes%:%seconds%
  30.  
  31. Which displays in Count.EXE at a certain time:   
  32.  
  33.      There are 100 days, 12:53:32
  34.  
  35.  
  36.      Normal text will be displayed unprocessed, but the fields in
  37. percentage signs are treated different. Empty/blank lines will not 
  38. be shown, but you can easily add a space to the beginning for a 
  39. blank line to show up.
  40.  
  41.      Countdown does its best to fill in blank data (like the year)
  42. and words like "as" are not needed but make the file clearer. Midnight
  43. is assumed in case no time is specified, and unless there is a PM at
  44. the end, 24-hour time (0:00 is midnight) is assumed. 12:00 is always
  45. noon unless there is an AM.
  46.  
  47.      The first word above shows what specific value is used. Words
  48. like "hours," "weeks," "months," "seconds," etc. all work. 
  49.  
  50.      The dhms above specifies what will be extracted from that date 
  51. (d is "day," h for "hour," etc.). That way, you don't get (24*100)+12 
  52. total hours but the hours filtered after the date.
  53.  
  54.      After you have specified one date and an expression like "dhms,"
  55. you can also filter out hours, minutes, seconds, etc. without typing
  56. in the date again. Just putting "hours" alone in parenthesis above
  57. will work because "dhms" was in the "days" expression.
  58.  
  59.  
  60. --------
  61. Using Calculations
  62.  
  63.      Another useful feature is to calculate a value from the text.
  64. As an example, if you knew that on average, that you sold a product
  65. every 90 seconds, the following would work:
  66.  
  67.      % seconds since 1/1 as s / 90 % products sold this year.
  68.  
  69.      Symbols like +, -, *, and / all work. It is usually best to
  70. go to the number of seconds and to multiply a smaller value because
  71. it will be updated more often that way.
  72.  
  73.  
  74. --------
  75. Other Commands
  76.  
  77.      Here are some other useful commands:
  78.  
  79.  
  80. Formatting:
  81.  
  82.      Center    - centers text
  83.      Left      - left-justifies (default)
  84.      Right     - right-justifies
  85.  
  86. Date/time:
  87.  
  88.      Now       - Tells Countdown to use the current date and time,
  89.                  necessary if you do other date calculations and  
  90.                  then want today's day.
  91.      Date      - displays the formatted date
  92.      WDay      - displays the day of the week
  93.      Time      - display the formatted time
  94.      AMPM      - displays AM or PM for the formatted time
  95.      TimeS     - displays the formatted time with seconds
  96.      TimeM     - displays the military (24-hour) time 
  97.      TimeMS    - displays military time with seconds
  98.      Day       - finds the day of the month
  99.      Month     - displays the month as text
  100.      MonthN    - displays the number of the month
  101.      Year      - displays the year
  102.      Title     - text in quotation marks becomes the header
  103.  
  104. DOS oriented:
  105.      DOSF      - this allows the file when displayed in DOS to
  106.                  look nicer (does not affect windows)
  107.      BK_BLUE, BK_RED, etc., makes a different colored background
  108.      FG_WHITE, FG_YELLOW, etc., makes the foreground different
  109.