home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / educatio / sdc102.zip / STARDATE.DOC < prev    next >
Text File  |  1993-06-10  |  5KB  |  132 lines
  1. StarDateCalc 1.02
  2.  
  3. Freeware by Afonso Infante, 1993
  4.  
  5. USER'S MANUAL
  6. =============
  7.  
  8.   The purpose of this program is to convert normal "Earth Dates" to Star 
  9. Trek: The Next Generation's "StarDates" and vice-versa.
  10.  
  11.   The formulas used to make the conversion can be considered "canon", 
  12. since they've worked perfectly every time both Earth Dates and 
  13. correspondent StarDate were given during the series. I worked the formula 
  14. out through those situations, and, after all, is a very logic process. 
  15. Other persons (like Wilford Nusser, from RIME's StarTrek conference) have 
  16. reached formulas that give exactly the same results.
  17.  
  18.   The program has two modes of operation: the standard mode (which only 
  19. displays the current StarDate) and the interactive mode, which, besides 
  20. showing the current StarDate, shows a menu, which gives you the 
  21. opportunity to convert *any* Earth Date (between 2147483648 BC and 
  22. 2147483647 AD) into a StarDate and to convert any *positive* StarDate 
  23. (between 2.9E-39 and 1.7E38) into its correspondent Earth Date. 
  24.  
  25.   In the conversion, the year, month, day of the month, hour, minute, 
  26. second and even 100th of second are taken in account. 
  27.  
  28.   An important detail: every time the program outputs an Earth Date, the 
  29. format of the output is
  30.  
  31.   dd/mm/yyyy hh:mm:ss.ss
  32.  
  33.   This is the English (and Portuguese) date format, so users from other 
  34. countries (especially USA, where the format is mm/dd, not dd/mm) have to 
  35. be cautious. The hour is in military format (00:00:00.00 to 23:59:59.99), 
  36. no AM or PM. One hour PM is 13 hours, and so forth, until 23 hours (11 
  37. PM). 00 hours is 12 AM.
  38.  
  39.   The outputted years are always AD unless specified.
  40.  
  41.  
  42.   STANDARD MODE
  43.   -------------
  44.  
  45.   To run the program, just type STARDATE in the DOS command line. The 
  46. program will present the current Earth Date and its equivalent StarDate. 
  47.  
  48.   If you want to save the StarDate into a text file (for using it in an 
  49. off-line mail reader, for example), just use the DOS pipes. For example, 
  50. if you want to place the StarDate into the file STAR.TXT, just type:
  51.  
  52.   STARDATE >STAR.TXT
  53.  
  54.   The program will still present the Earth Date on the screen, but the 
  55. StarDate (and only that) will be outputted to the text file.
  56.  
  57.  
  58.   INTERACTIVE MODE
  59.   ----------------
  60.  
  61.   Using the interactive mode it's possible to take advantage of all the 
  62. power of the program.
  63.  
  64.   You can enter the interactive mode by typing 
  65.  
  66.     STARDATE *
  67.  
  68.   in the command line. Then, besides the standard information, a menu will 
  69. appear, giving you three choices: convert an Earth Date into a StarDate, 
  70. do the opposite or just quit the program. To choose the option, just type 
  71. its corresponding number. Any characters other than number 1 or 2 will 
  72. just quit the program.
  73.  
  74.  
  75.    Convert an Earth Date into a StarDate
  76.    -------------------------------------
  77.  
  78.     After choosing this option, you'll have to type in all the data 
  79. concerning the Earth Date. BC years are accepted, and to type one in, just 
  80. put a minus sign before (e.g.: 2000 BC is -2000). Any year between 
  81. 30445 BC and 35090 AD is accepted. If you type any year off this limits, 
  82. a fraction, or any non-numeric string, the program will output an error 
  83. message.
  84.  
  85.     In the month and day of month prompts, anything off the range (1 to 12 
  86. in the first case and 1 to 28, 29, 30 or 31, depending on the month, in 
  87. the second) and any non-numeric characters will be rejected.  
  88.  
  89.     In the hour, minute, second and 100th of second prompts, anything off 
  90. the limit or any non-numeric string will be considered 0.
  91.  
  92.  
  93.   Convert a StarDate into an Earth Date
  94.   -------------------------------------
  95.  
  96.    This is very straightforward. Just type in any *positive* StarDate 
  97. (negative ones are rejected, due to limitations in program language - 
  98. maybe in a future release I can work out some way to work around this - in 
  99. spite of not being any big limitation, since normally you'll want to 
  100. convert positive StarDates).
  101.  
  102.   Non-numeric strings are considered StarDate 0.
  103.  
  104.   
  105.   After any conversion, the program simply exits to DOS. 
  106.  
  107.   This version was tested under DESQview and Windows 3.1, and worked 
  108. perfectly in any of them. 
  109.  
  110.  
  111.   I hope all your Trekkies out there like the program. This program is 
  112. freeware, but any contributions will be welcomed and support the 
  113. development of the program. If I have enough support, I will certainly 
  114. make a Windows 3.1 version of StarDateCalc, which will work much like the 
  115. standard Windows' Clock accessory.
  116.  
  117.   You can send your contributions (in cash - US dollars or Portuguese 
  118. Escudos - or internacional postal money order) to:
  119.  
  120.   Afonso Infante
  121.   Travessa da Belavista, 8 - 3ºFrente
  122.   2735 CACEM
  123.   PORTUGAL
  124.  
  125.   I also accept any suggestion or critic. You can also reach me through 
  126. RIME's StarTrek conference (AFONSO INFANTE on node SKYSHIP) or Internet 
  127. (afonso.infante@f2.n362.z2.fidonet.org).
  128.  
  129.   Thank you for reading the DOC!
  130.  
  131.   Afonso Infante.
  132.