home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 35 / hot35.iso / ficheros / 9INET / LTW200A.ZIP / README.TXT < prev    next >
Text File  |  1998-06-04  |  13KB  |  351 lines
  1. LOGTIME 2.0a for Windows 95 and 3.1
  2. Copyright (c) 1998 by Christopher S L Heng. All rights reserved.
  3. ----------------------------------------------------------------
  4.  
  5. $Id: readme.txt 2.11 1998/06/03 16:31:45 chris Exp $
  6.  
  7.  
  8. **UPGRADERS**
  9. Please read one of the following sections of this file before
  10. installing (depending on which version you currently use):
  11. - UPGRADING LOGTIME FROM VERSION 2.0
  12. - UPGRADING LOGTIME FROM VERSION 1.21 OR BELOW.
  13.  
  14.  
  15.  
  16. CONTENTS
  17.  
  18. 1.  WHAT IS LOGTIME?
  19. 2.  WHAT'S NEW IN VERSION 2.0a?
  20. 3.  SYSTEM REQUIREMENTS
  21. 4.  PACKING LIST
  22. 5.  INSTALLING LOGTIME FOR THE FIRST TIME
  23. 6.  UPGRADING LOGTIME FROM VERSION 2.0
  24. 7.  UPGRADING LOGTIME FROM VERSION 1.21 OR BELOW
  25. 8.  UNINSTALLING LOGTIME
  26. 9.  GETTING MORE INFORMATION ABOUT LOGTIME
  27. 10. LICENSING AND COPYRIGHT
  28. 11. CONTACTING THE AUTHOR
  29. 12. BUG REPORT CHECKLIST
  30.  
  31.  
  32.  
  33. 1.  WHAT IS LOGTIME?
  34.  
  35. LOGTIME is a utility that assists users in tracking the amount of
  36. time they spend and cost they incur while connected to their
  37. Internet Service Providers ("ISP"). It is useful for people who
  38. use ISPs that charge according to the amount of time you spend
  39. connected to them.
  40.  
  41. LOGTIME supports a plethora of charging schemes used by ISPs and
  42. phone companies all over the world. It has support for ISPs that
  43. charge different rates depending on the period of the day you
  44. connect. It has support for ISPs that give you a certain amount
  45. of "free" connection time each month or day. It has support for
  46. users who connect to more than one ISP.
  47.  
  48. For users who connect to their ISPs using multiple operating
  49. systems on their PCs, the same log and configuration files that
  50. are used by LOGTIME for Linux can be used by LOGTIME for Windows
  51. 95, and LOGTIME for Windows 3.1. Now you can connect in any
  52. system you happen to be working in, and not have to worry that
  53. you have forgotten to keep track of your connection time.
  54.  
  55.  
  56.  
  57. 2.  WHAT'S NEW IN VERSION 2.0a?
  58.  
  59. Please see the file whatsnew.txt for more information on this.
  60. A copy of this file was installed into the same directory as
  61. the LOGTIME program when you ran SETUP.EXE.
  62.  
  63.  
  64.  
  65. 3.  SYSTEM REQUIREMENTS
  66.  
  67. LOGTIME for Windows 95 has the following minimum system
  68. requirements:
  69.  
  70.     Windows 95 and above
  71.     A dialer like the Dial-Up Networking that comes with Windows 95
  72.  
  73. LOGTIME for Windows 3.1 has the following minimum system
  74. requirements:
  75.  
  76.     Windows 3.1, 3.11, Windows for Workgroups 3.11
  77.     A Winsock package and dialer
  78.  
  79. If you do not have the above, you probably will not need Logtime
  80. anyway!
  81.  
  82.  
  83.  
  84. 4.  PACKING LIST
  85.  
  86. For a list of items in this package, please see filelist.txt.
  87. A copy of this file was installed into the same directory as
  88. the LOGTIME program when you ran SETUP.EXE.
  89.  
  90.  
  91.  
  92. 5.  INSTALLING LOGTIME FOR THE FIRST TIME
  93.  
  94. If you are upgrading from a previous version of LOGTIME, please
  95. see the appropriate section on upgrading in this file. This
  96. section is applicable only to new users of LOGTIME.
  97.  
  98. a. Run SETUP.EXE and follow the instructions given to install
  99. LOGTIME on your computer.
  100.  
  101. b. Configuring LOGTIME. Start up LOGTIME and hit the Help button.
  102. Read through the Getting Started and Configuring Logtime sections
  103. of the online manual (just press the "Getting Started" button on
  104. the button bar at the top of the window). Then configure Logtime
  105. for your system and ISP as indicated in the manual.
  106.  
  107. e. Testing LOGTIME. You should not test until you have read the
  108. online help. If you did not properly configure the program, do
  109. not expect the program to yield any meaningful results. You also
  110. need to know how to get LOGTIME to log your calls. So read the
  111. online help! Then test run your setup of LOGTIME by making a call
  112. into your ISP, running LOGTIME accordingly, and then checking the
  113. results by clicking the "Current" button on the main dialog
  114. window.
  115.  
  116. NOTE: If you want to install both the Windows 95 *and* the
  117. Windows 3.1 versions, repeat the SETUP procedure for both
  118. versions in their respective operating system/environment.
  119. That is, install the Windows 95 version from Windows 95,
  120. and the Windows 3.1 version from Windows 3.1. You may
  121. install both versions into the same directory. The version
  122. numbers of LOGTIME for both platforms should be identical.
  123.  
  124.  
  125.  
  126. 6.  UPGRADING LOGTIME FROM VERSION 2.0
  127.  
  128. If you are upgrading LOGTIME from version 2.0 (or one of the
  129. version 2.0 BETAs), please uninstall the older version first.
  130.  
  131. Uninstalling LOGTIME will not remove the log and configuration
  132. files you originally installed, so if you install this new
  133. version into that same directory, the new version of LOGTIME will
  134. continue to use those log and configuration files.
  135.  
  136. To uninstall, see the instructions on UNINSTALLING LOGTIME
  137. below.
  138.  
  139. Then proceed to install LOGTIME by running the SETUP program.
  140.  
  141. NOTE: If you installed both the Windows 95 *and* the
  142. Windows 3.1 versions, please uninstall *both* versions before
  143. continuing. You should run the uninstaller from the
  144. respective operating system/environment for each version.
  145.  
  146. If you want to install both the Windows 95 *and* the
  147. Windows 3.1 versions, repeat the SETUP procedure for both
  148. versions in their respective operating system/environment.
  149. That is, install the Windows 95 version from Windows 95,
  150. and the Windows 3.1 version from Windows 3.1. You may
  151. install both versions into the same directory. The version
  152. numbers of LOGTIME for both platforms should be identical.
  153.  
  154.  
  155.  
  156. 7.  UPGRADING LOGTIME FROM VERSION 1.21 OR BELOW
  157.  
  158. This section applies only to users who are upgrading from
  159. LOGTIME 1.21 or earlier. If you are a new user, you need to
  160. read the section on INSTALLING LOGTIME FOR THE FIRST TIME
  161. instead.
  162.  
  163. a. Before upgrading, make sure that no version of LOGTIME is
  164. currently running. If a LOGTIME window is open, close it before
  165. upgrading. This is important because the version of SETUP.EXE
  166. used to install LOGTIME at this time is not able to correctly
  167. update a program that is currently running.
  168.  
  169. b. Run SETUP.EXE and follow the instructions to install LOGTIME
  170. on your computer. You may, if you choose, install the new version
  171. of LOGTIME over your existing version. The instructions that
  172. follow assume that you have installed over your existing version.
  173. Your configuration and data files will not be overwritten, and
  174. can be converted for use by the new version of LOGTIME.
  175.  
  176. c. LOGTIME 2.0 and above does not use the same log (or data) file
  177. as version 1.21 and below. Likewise, although the same
  178. configuration file (logtime.ini) is used, the various options in
  179. that file have been re-organised and renamed. This is to support
  180. the host of new features introduced in version 2.0.
  181.  
  182. To ease the pain of upgrading, LOGTIME comes with an upgrade
  183. utility called LTCONV.EXE for the Windows 95 version of LOGTIME
  184. and LTCONVD.EXE for the Windows 3.1 version of LOGTIME.
  185. LTCONV.EXE (or LTCONVD.EXE) will convert the old
  186. log files and the old configuration files to the new format.
  187.  
  188. In the paragraphs that follow, substitute ltconvd (LTCONVD.EXE)
  189. for ltconv (LTCONV.EXE) if you are using Windows 3.1. Reference
  190. to ltconv only applies to the Windows 95 version of LOGTIME.
  191.  
  192. To upgrade your old configuration files, open a MS-DOS Prompt
  193. window (Start Menu | Programs | MS-DOS Prompt). Change to the
  194. directory where LOGTIME was installed, where your old data and
  195. configuration files are kept as well. Then run the ltconv
  196. utility to upgrade the files.
  197.  
  198. For example, if you installed LOGTIME to C:\LOGTIME over your old
  199. LOGTIME files, you might do the following:
  200.  
  201.     c:
  202.     cd \logtime
  203.     ltconv
  204.  
  205. The upgrading utility will create two new files: logtime.log and
  206. logtime.ini. The old log (data) file, logtime.dat, will not be
  207. removed. The old configuration file will be saved as logtime.bki.
  208. Both logtime.dat and logtime.bki may be removed if you do not
  209. envisage going back to version 1.21 of LOGTIME. They are not used
  210. by version 2.0 and upwards.
  211.  
  212. If you did not previously set the time zone in your logtime.ini
  213. file, you should use the -t option on the ltconv command line to
  214. add the TZ option.If you are unsure whether your old logtime.ini
  215. file had a TZ option, assume it does not, and follow the
  216. instructions below. Setting the time zone will ensure that the
  217. log and ini files have the same time zone in their entries.
  218. Otherwise your results will be inaccurate.
  219.  
  220. Find out what your time zone is, then use the following command
  221. lines instead of the above:
  222.  
  223.     c:
  224.     cd \logtime
  225.     ltconv -t <time_zone_string>
  226.  
  227. where <time_zone_string> should be replaced by your time zone.
  228. For example, if your time zone is SST-8, your ltconv command line
  229. would be
  230.  
  231.     ltconv -t SST-8
  232.  
  233. The log file entries would then be configured according to a time
  234. zone of SST-8 and your new logtime.ini will have an entry
  235. TZ=SST-8 as well. The two must be in sync, or your results will
  236. be inaccurate.
  237.  
  238. If you have no idea what a time zone is, and you never have to
  239. adjust your clock for different seasons of the year, and you do
  240. not have a time zone setting in your old logtime.ini, you might
  241. be able to get away with the following command line:
  242.  
  243.     ltconv -t GMT0
  244.  
  245. The above command line makes LOGTIME think that your local time
  246. zone is identical with the Greenwich Mean Time.
  247.  
  248. d. Read the online help and try out the new LOGTIME. You might
  249. want to take advantage of some of the new features available with
  250. LOGTIME. It is now able to automatically detect modem
  251. connections. It can track your telephone charges as well as the
  252. usual tracking of ISP charges. It supports more ISP methods of
  253. calculating cost. And so on.
  254.  
  255. NOTE: If you want to install both the Windows 95 *and* the
  256. Windows 3.1 versions, run SETUP for both versions in their
  257. respective operating system/environment. That is, install
  258. the Windows 95 version from Windows 95, and the Windows 3.1
  259. version from Windows 3.1. You may install both versions into
  260. the same directory. The version numbers of LOGTIME for both
  261. platforms should be identical.
  262.  
  263.  
  264.  
  265. 8.  UNINSTALLING LOGTIME
  266.  
  267. a. If you configured LOGTIME to automatically start up everytime
  268. Windows 95 or 3.1 runs, simply go to the Monitor options and
  269. uncheck the box that says "Automatically run LOGTIME everytime
  270. Windows starts up".
  271.  
  272. b. Next, run the Uninstall program which can be found in the
  273. Logtime group. In Windows 95, if you followed the default
  274. installation procedure, the Uninstall option is in Start |
  275. Programs | Logtime | Uninstall. Or you can go to the Control
  276. Panel's Add/Remove Programs and select the Logtime entry to
  277. uninstall. In Windows 3.1, the Uninstall icon can be found
  278. in the Logtime program group.
  279.  
  280. c. The Uninstall program will not delete the logtime.log and the
  281. logtime.ini files. To completely uninstall LOGTIME, remove those
  282. files and the directory in which they reside. Remember not to
  283. delete the log and configuration files if you are still using
  284. LOGTIME on other platforms.
  285.  
  286.  
  287.  
  288. 9.  GETTING MORE INFORMATION ABOUT LOGTIME
  289.  
  290. For information on how to configure and use LOGTIME, install the
  291. package, run LOGTIME, and click the Help button.
  292.  
  293.  
  294.  
  295. 10. LICENSING AND COPYRIGHT
  296.  
  297. Please see the file licence.txt for more information on this.
  298. A copy of this file was installed into the same directory as
  299. the LOGTIME program when you ran SETUP.EXE.
  300.  
  301.  
  302. 11. CONTACTING THE AUTHOR
  303.  
  304. If you wish to contact me about LOGTIME, you may email me on the
  305. Internet via one of the addresses given below (please use only
  306. one and not all or I'll wind up with three copies of your email).
  307.  
  308. Internet email addresses:
  309.     cyfheng@singnet.com.sg
  310.     chrisheng@bigfoot.com
  311.  
  312. Home page:
  313.     http://www.singnet.com.sg/~cyfheng/
  314.     http://www.bigfoot.com/~chrisheng/
  315.  
  316. DISCLAIMER: Please note that while I generally would like to hear
  317. from you if you are using the program, and I certainly would like
  318. to know if you discover any bugs in the program, I am under no
  319. obligation to fix any bugs. In fact, I make no promises about
  320. even replying.
  321.  
  322. NOTE: There are a couple of LOGTIME mailing lists which you
  323. may like to join. Check out my web page above for more information
  324. about this.
  325.  
  326.  
  327.  
  328. 12. BUG REPORT CHECKLIST
  329.  
  330. Please furnish me the following information when emailing me
  331. about bugs. In fact, it would be good if you provide the
  332. information even if you are simply requesting new features. This
  333. will enable me to answer your questions/problems/requests more
  334. relevantly.
  335.  
  336. 1.    The version of LOGTIME you are using, eg Version 2.0.
  337. 2.    A copy of your logtime.ini file, and if relevant a copy
  338.     of your logtime.log.
  339. 3.    The platform (or platforms) on which you are running
  340.     LOGTIME: ie whether Windows 95, Windows 98, Windows 3.1
  341.     or Linux or all of the above.
  342. 4.    The dialer (Windows 95) or winsock package (Windows 3.1)
  343.     or type of protocol (PPP or SLIP, etc) (Linux) that you
  344.     are using, and the version number (if available).
  345. 5.    A description of the problem. Please do not email me a
  346.     screen dump without stating what the problem is.
  347. 6.    Any other information that might be relevant.
  348.  
  349. Or you can simply complete the bug report form at my home
  350. page listed in the section above (CONTACTING THE AUTHOR).
  351.