home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Misc / Phonebill / Documentation / Phonebill.doc next >
Text File  |  1995-08-10  |  57KB  |  1,645 lines
  1.  
  2.  
  3. `Phonebill'
  4. ***********
  5.  
  6.    Welcome to the `phonebill' 3.3c documentation. Before going ahead
  7. with the program, please read the following sections first.
  8.  
  9. Legal issues
  10. ************
  11.  
  12. License
  13. =======
  14.  
  15.    This license applies to the product called `phonebill', a program
  16. for the Amiga computer, published by Raymond Penners under the concepts
  17. of ShareWare, and the accompanying documentation, example files and
  18. anything else that comes with the original distribution.  The terms
  19. `Program' and `phonebill' below, refer to this product.  The licensee
  20. is addressed as `you'.
  21.  
  22.    * You may copy and distribute verbatim copies of the program's
  23.      executable code and documentation as you receive it, in any
  24.      medium, provided that you conspicuously and appropriately publish
  25.      only the original, unmodified program, with all copyright notices
  26.      and disclaimers of warranty intact and including all the
  27.      accompanying documentation, example files and anything else that
  28.      came with the original.
  29.  
  30.    * You may not copy and/or distribute this program without the
  31.      accompanying documentation and other additional files that came
  32.      with the original.  You may not copy and/or distribute modified
  33.      versions of this program.
  34.  
  35.    * You may not copy, modify, sublicense, distribute or transfer the
  36.      program except as expressly provided under this license.  Any
  37.      attempt otherwise to copy, modify, sublicense, distribute or
  38.      transfer the program is void, and will automatically terminate
  39.      your rights to use the program under this license.  However,
  40.      parties who have received copies, or rights to use copies, from
  41.      you under this license will not have their licenses terminated so
  42.      long as such parties remain in full compliance.
  43.  
  44.    * By copying, distributing and/or using the program you indicate your
  45.      acceptance of this license to do so, and all its terms and
  46.      conditions.
  47.  
  48.    * Each time you redistribute the program, the recipient automatically
  49.      receives a license from the original licensor to copy, distribute
  50.      and/or use the program subject to these terms and conditions.  You
  51.      may not impose any further restrictions on the recipients'
  52.      exercise of the rights granted herein.
  53.  
  54.    * You may not disassemble, decompile, re-source or otherwise reverse
  55.      engineer the program.
  56.  
  57.    * You may use the programs for a period of up to 3 weeks for
  58.      evaluation.  After that, you have to register or quit using the
  59.      program.
  60.  
  61.    * If you wish to incorporate parts of the programs into other
  62.      programs, write to the author to ask for permission.
  63.  
  64.    * You agree to cease distributing the program and data involved if
  65.      requested to do so by the author.
  66.  
  67.    * You may charge a fee to recover distribution costs.  The fee for
  68.      diskette distribution may not be more than the cost to obtain a
  69.      public domain diskette from Fred Fish.
  70.  
  71. No warranty
  72. ===========
  73.  
  74.    THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED BY
  75. APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  76. HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS IS" WITHOUT
  77. WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  78. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  79. PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE
  80. OF THE PROGRAMS IS WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU
  81. ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  82.  
  83.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  84. WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  85. REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  86. DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
  87. DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAMS
  88. (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  89. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF
  90. THE PROGRAMS TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
  91. OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  92.  
  93. Disclaimer
  94. ==========
  95.  
  96.    No warranty, either express or implied, is made with respect to the
  97. fitness or merchantability of `phonebill'.
  98.  
  99.    Raymond Penners (referred to as `the author'), reserves the right to
  100. not develop any future versions of `phonebill'.
  101.  
  102.    The author will try to make a good faith attempt at correcting any
  103. problems if any are discovered, but is in no way required, nor bound to
  104. correct them.
  105.  
  106.    The author neither assumes nor accepts any responsibility for the
  107. use or misuse of these programs.  He will also not be held liable for
  108. damages or any compensation beyond the original registration fee due to
  109. loss of profit or any other damages arising out of the use, or
  110. inability to use this program.
  111.  
  112.    The author will not be liable for any damage arising from the
  113. failure of this program to perform as described, or any destruction of
  114. other programs or data residing on a system attempting to run the
  115. programs.  The user of this program uses it at his or her own risk.
  116.  
  117. Introduction
  118. ************
  119.  
  120.    `phonebill' is, simply said, a log file analyzer. What it basically
  121. does is scan log file(s) generated by a terminal program or a mailer,
  122. extract all information about calls you have made by using your modem,
  123. and store this in its own (short) format. After extracting the calls
  124. `phonebill' can generate various reports in which you can find
  125. information on duration and costs of the calls.
  126.  
  127.    Here is a small list of the main features:
  128.  
  129.    * Very flexible user-configurable rates, supporting exceptions for
  130.      certain days and dates.
  131.  
  132.    * User-configurable log scanners: `phonebill' by default supports
  133.      various log files, but for any log file that is not supported the
  134.      user is able to create a scanner. The following is a list of log
  135.      files that are already supported:
  136.         * AmiTel
  137.  
  138.         * AutoPilot
  139.  
  140.         * CyberPager
  141.  
  142.         * DreamTerm
  143.  
  144.         * GMS
  145.  
  146.         * GPFax
  147.  
  148.         * ISDN Master Telephone log
  149.  
  150.         * JamMail
  151.  
  152.         * JrComm
  153.  
  154.         * MagiCall
  155.  
  156.         * MicroDot
  157.  
  158.         * Multifax (both v2.0 and Multifax professional)
  159.  
  160.         * NComm
  161.  
  162.         * Off-line Amiga
  163.  
  164.         * Plink
  165.  
  166.         * PPP
  167.  
  168.         * Term action log and Term call log
  169.  
  170.         * Terminus
  171.  
  172.         * TheAnswer
  173.  
  174.         * TKR-BTX
  175.  
  176.         * Trapdoor
  177.  
  178.         * Trapfax
  179.  
  180.         * UUCP TimeLog
  181.  
  182.         * XenoLink
  183.  
  184.         * ZeeTerm
  185.  
  186.    * Log files can be automatically truncated if their size exceeds the
  187.      maximum size.
  188.  
  189.    * Generates miscellaneous reports: statistics, total costs, ....
  190.  
  191.    * Context-sensitive online help.
  192.  
  193.    * Supports new 3.0 features (new look menus, ...).
  194.  
  195.    * Nice `Amiga User Interface Style Guide' conformant user interface.
  196.  
  197.    * Supports `traplist.library'.
  198.  
  199. Installation
  200. ************
  201.  
  202.    There are two ways to install `phonebill': the hard way and the easy
  203. way. If you choose the latter, just double click the `Install
  204. phonebill' icon to execute the Commodore installer. This installer can
  205. be found on the `Install2.1' or `Install3.0' disk from Commodore. If
  206. you don't have it then you'll have to install the program manually,
  207. which really is not that hard. Just drag the `phonebill' drawer over
  208. the drawer where you like to copy it to. If you haven't used any
  209. previous version of `phonebill' then this is all you have to do. If you
  210. already have a version older than 3.0 installed then you'll have to
  211. follow these steps:
  212.  
  213.    * Convert the configuration files so that they can be used with this
  214.      release. This can be done by running the supplied program called
  215.      `ConvertConfig' from the shell:
  216.           1> ConvertConfig
  217.  
  218.    * After running the converter, the new configuration files can be
  219.      found in `T:'. You should copy these files to the
  220.      `Phonebill/Config' directory, e.g.:
  221.           1> copy T:#?.config Phonebill/Config
  222.  
  223.    * If you wish, delete the `phonebill' configuration files found in
  224.      `ENV:' and `ENVARC:'.
  225.           1> delete ENV:Phonebill all
  226.           1> delete ENVARC:Phonebill all
  227.  
  228. Workbench and Shell
  229. *******************
  230.  
  231.    The program can be started from both the shell and the workbench.
  232. When started from the shell, the program accepts commandline arguments.
  233. To view all known arguments, supply a "?" as the only argument to the
  234. program, for example:
  235.  
  236.         1.SPHINX-O-HD:Comm/Phonebill> Phonebill ?
  237.  
  238.    The following keywords/switches are supported:
  239. `PROC=PROCESS/S'
  240.      Supplying this switch will cause the program to process the log
  241.      files and return control to the shell when done.
  242.  
  243. `LIST=LISTCALLS/K,BILL/K,STATS=STATISTICS/K,BILL/K'
  244.      Generates the specified report and outputs it to a file.
  245.  
  246. `FROM/K,TO/K'
  247.      Use these to specify the scanrange. If you don't supply these
  248.      arguments the range specified in the configuration will be used.
  249.  
  250. `QUIET/S'
  251.      Supplying this argument disables output produced when processing
  252.      the logs.
  253.  
  254. `CONFIG/S'
  255.      Specify the location of the configuration directory.
  256.  
  257.    The following command will cause the program to quietly process the
  258. log files and then save two reports. The former will be displayed in
  259. the console, the latter will be saved to `t:bill.txt':
  260.      1> phonebill proc list=* bill=t:bill.txt quiet
  261.  
  262. Menus
  263. *****
  264.  
  265.    The following text is to describe the menu items available in the
  266. `phonebill' main panel.
  267.  
  268. Project
  269. =======
  270.  
  271. `Process logs'
  272.      Scans and/or truncates all listed log files, See Log files panel.
  273.      If new calls were found, they will be added to the binary log file.
  274.  
  275. `Rescan logs'
  276.      Same as `Process logs', except that this operation extracts all
  277.      calls from the log files if they were already found by a previous
  278.      scan operation. Please note that a rescan can cause calls
  279.      previously removed or modified using maintenance to reappear.
  280.  
  281. `Iconify'
  282.      Closes the window and drops an icon labeled `phonebill' on the
  283.      Workbench window. Double-clicking this icon will cause the program
  284.      to wake up and to return the state it was in before it was
  285.      iconified.
  286.  
  287. `About `phonebill'...'
  288.      Shows some additional information on the program.
  289.  
  290. `Quit'
  291.      Terminates the program. If the configuration has been changed, you
  292.      will be prompted to confirm your decision.
  293.  
  294. Settings
  295. ========
  296.  
  297. `Miscellaneous...'
  298.      See Miscellaneous settings panel.
  299.  
  300. `Host...'
  301.      See Hosts panel.
  302.  
  303. `Log...'
  304.      See Log files panel.
  305.  
  306. `Rates...'
  307.      See Rates panel.
  308.  
  309. `Group...'
  310.      See Group settings panel.
  311.  
  312. `Report presets...'
  313.      See Report presets panel.
  314.  
  315. `Save settings'
  316.      Saves all the configuration files to disk.
  317.  
  318. Groups
  319. ======
  320.  
  321.    Note: this menu is only available if groups have been defined. See
  322. Group settings panel.
  323.  
  324.    If the `Default' item is checked, all hosts will be taken into
  325. account when generating reports. However, if `Default' is not checked,
  326. only hosts that are member of the checked groups will appear in the
  327. reports.
  328.  
  329. Presets
  330. =======
  331.  
  332.    Note: this menu is only available if presets have been defined. See
  333. Report presets panel.
  334.  
  335.    Using this menu you can use the settings of the selected preset.
  336.  
  337. Control panels
  338. **************
  339.  
  340. Main panel
  341. ==========
  342.  
  343.    Here it all begins. This panel provides gadgets and Menus which give
  344. you control over the main functions of the program.
  345.  
  346. `Process logs'
  347.      Scans and/or truncates all listed log files, See Log files panel.
  348.      If new calls were found, they will be added to the binary log file.
  349.  
  350. `Settings'
  351.      See Miscellaneous settings panel.
  352.  
  353. `About'
  354.      Shows some additional information on the program.
  355.  
  356. `From, To'
  357.      The dates entered here specify the period over which a report is
  358.      to be made. Besides entering dates it is also possible to enter a
  359.      number that specifies a number of days in the future starting from
  360.      the current date. For example: the period from "-6" to "today"
  361.      specifies the last 7 days.
  362.  
  363. `Statistics, Bill, List calls'
  364.      Selecting one of these will cause a report to be generated. If the
  365.      program encounters calls to a host that is not known, you will be
  366.      prompted to either add the host, skip it, or cancel the report
  367.      generation. When the report was generated succesfully, it will be
  368.      shown to you using a text viewer.
  369.  
  370. `Maintenance'
  371.      See Maintenance panel.
  372.  
  373. Miscellaneous settings panel
  374. ============================
  375.  
  376.    In the miscellaneous panel you can configure general program options.
  377.  
  378. `Binary log file'
  379.      The file name of the binary log file used for storing calls.
  380.  
  381. `Nodelist path'
  382.      Set this to the directory where you keep your nodelist files. This
  383.      is only useful if `traplist' is installed, leave this blank
  384.      otherwise.
  385.  
  386. `Carrier detect time'
  387.      It always takes some time before your modem has detected a
  388.      carrier. The connect time in the log files generated by your
  389.      terminal program are therefore incorrect, because the modem has
  390.      been online trying to get a carrier for a couple of seconds. For
  391.      example, it takes my modem approximately 15 seconds to connect.
  392.  
  393. `Public screen'
  394.      The name of the public screen to be used.
  395.  
  396. `Save dates on exit'
  397.      If this option is checked, the <from> and <to> date will be saved
  398.      automatically when you exit the program.
  399.  
  400. `Close only hides'
  401.      Specifies the behaviour of the main window close gadget: if this
  402.      option is checked the program will be hidden when closed instead of
  403.      exited.
  404.  
  405. `Use icon when hidden'
  406.      Specifies whether or not to put an icon on the workbench when the
  407.      program is in hidden state.
  408.  
  409. `Process logs on startup'
  410.      Specifies whether or not to process the log files automatically
  411.      when the program is started.
  412.  
  413. `Text viewer'
  414.      The text viewer to be used for displaying reports.
  415.  
  416. `Report file'
  417.      The file name of the report to be generated.
  418.  
  419. `Bill sort method'
  420.      The order in which the hosts from the bill report are to be sorted.
  421.  
  422. `Delete report after viewing'
  423.      If this option is checked, the report will be deleted after it has
  424.      been viewed.
  425.  
  426. `Save'
  427.      Saves current settings, and closes the panel. The from- and to
  428.      dates from the main panel are also saved.
  429.  
  430. `Use'
  431.      Closes the panel, without saving the settings.
  432.  
  433. Log files panel
  434. ===============
  435.  
  436.    In the log files panel you can add, remove log files and edit their
  437. options for use with the program.
  438.  
  439. `Log files'
  440.      The list of log files to be processed by the program.
  441.  
  442. `Add'
  443.      Adds a new log file to the list.
  444.  
  445. `Edit'
  446.      Lets you edit the settings of the selected log file, See Log
  447.      settings panel.  Log files can also be editted by double clicking
  448.      the entry in the list.
  449.  
  450. `Remove'
  451.      Removes the selected log file.
  452.  
  453. `Save'
  454.      Saves current log files settings, and closes the panel.
  455.  
  456. `Use'
  457.      Closes the panel, without saving the log files settings.
  458.  
  459. Log settings panel
  460. ==================
  461.  
  462.    This is where you edit the options of a log file.
  463.  
  464. `File name'
  465.      The file name of the log file.
  466.  
  467. `Truncate log file'
  468.      If this option is enabled log files will be truncated. See `Max.
  469.      size'.
  470.  
  471. `Max. size, Truncate %'
  472.      The maximum size in kilo-bytes of the log file. If the files' size
  473.      exceeds this value, the file will be truncated to the percentage
  474.      specified in `Truncate %' of the original size. This only works if
  475.      the `truncate' option is activated.
  476.  
  477. `Preserve blocks'
  478.      If this option is enabled the log file will be truncated at the
  479.      position of an empty line seperator.
  480.  
  481. `Scan log file'
  482.      If this option is enabled, the log file will be scanned for calls
  483.      using the scanner selected in the list of `Scanners'.
  484.  
  485. `Check archivebit'
  486.      If enabled, the files' archivebit will be set after processing. If
  487.      a log file with the archivebit set is encountered, it will be
  488.      regarded as not changed since the last time it was scanned.
  489.      Selecting this option increases processing of the log files
  490.      significantly.
  491.  
  492. `Sign log file'
  493.      If enabled (recommended), the program adds a signature to the end
  494.      of the log file to keep track of what calls have already been
  495.      processed.  If this option is disabled all calls found in the log
  496.      file will be regarded as new, which might result in the
  497.      reappearance of calls previously deleted/modified using
  498.      maintenance.
  499.  
  500. `Scanners'
  501.      A list of several types of log files the program is able to scan.
  502.      Select the appropriate entry that belongs to the current log file
  503.      if you wish to scan the log for calls.
  504.  
  505. Hosts panel
  506. ===========
  507.  
  508.    In the hosts panel you see a list of all `known' hosts. You can add,
  509. remove and edit hosts.
  510.  
  511. `Hosts'
  512.      The list of hosts known to the program.
  513.  
  514. `Add'
  515.      Adds a new hosts to the list.
  516.  
  517. `Edit'
  518.      Lets you edit the settings of the selected host, See Host settings
  519.      panel.  Hosts can also be editted by double clicking the entry in
  520.      the list.
  521.  
  522. `Remove'
  523.      Removes the selected host.
  524.  
  525. `Save, Use'
  526.      Save and/or use the current settings.
  527.  
  528. Host settings panel
  529. ===================
  530.  
  531.    In the host panel you can specify information about the host, like
  532. carrier detect time, rates, and telephone number.
  533.  
  534. `Name, Telephone number'
  535.      The name and/or telephone number of the host. You must at least
  536.      fill in one of these. If a host has more than one node, you can
  537.      enter the telephone numbers seperated by a vertical bar `|'
  538.      character, e.g.: "12345|6789".
  539.  
  540. `Use default, Carrier detect time'
  541.      If the carrier detect time is not the same for each host, you can
  542.      choose here whether you want to use the default carrier detect
  543.      time as specified in the Miscellaneous settings panel or use the
  544.      `Carrier detect time' specified for this host.
  545.  
  546. `Rate'
  547.      The rate set for this host.
  548.  
  549. `Groups'
  550.      Check all groups you wish the host to be a member of. See Group
  551.      settings panel.
  552.  
  553. `Use,Cancel'
  554.      Use or drop the current host settings.
  555.  
  556. Rates panel
  557. ===========
  558.  
  559.    In the rates panel you can create new rates, or modify existing
  560. rates.
  561.  
  562. `Rates'
  563.      This list contains all installed rates.
  564.  
  565. `Add'
  566.      Adds a new rate to the list.
  567.  
  568. `Copy'
  569.      The selected rate will be duplicated.
  570.  
  571. `Edit'
  572.      Lets you edit the selected rate, See Rate settings panel.
  573.  
  574. `Remove'
  575.      Removes the selected rate.
  576.  
  577. `Save,Use'
  578.      Save and/or use the current settings.
  579.  
  580. Rate settings panel
  581. ===================
  582.  
  583.    The information to be specified in this control panel will be used
  584. to calculate the amount of money to be paid for a call.
  585.  
  586. `Name'
  587.      Specifies the name of the rate.
  588.  
  589. `Area codes pattern'
  590.      If an unlisted host is encountered `phonebill' will try to match
  591.      the hosts' phonenumber to the area codes pattern of all rates. If
  592.      a match is found the rate is accordingly set and you are not
  593.      prompted to do so manually. For arguments sake, let's say
  594.      phonenumbers starting with 12 and 23 belong to rate A, others
  595.      belong to rate B. If you set the area codes pattern of rate A and
  596.      B to "(12#?|23#?)" resp. "~(12#?|23#?)" you will never be prompted
  597.      to add hosts manually.
  598.  
  599. `Groups'
  600.      The group settings of a host that is added automatically using the
  601.      area codes pattern will be set to the group settings selected here.
  602.  
  603. `List of periods'
  604.      The phone companies have the bad tendency to increase the costs
  605.      you have to pay each couple of years. This will cause calls in a
  606.      certain time period to be accounted different than calls in
  607.      another time period. You can specify a different rate for each
  608.      period, for example: from 1-jan-90 to 1-jan-92 there is rate A,
  609.      but from 1-jan-92 up to now is rate B. You'll find all different
  610.      periods in the list of periods
  611.  
  612. `Add, Copy, Edit, Remove'
  613.      Use these to add, copy, edit and remove certain rate periods.
  614.  
  615. Rate period settings panel
  616. ==========================
  617.  
  618.    The information to be specified in this control panel will be used
  619. to calculate the amount of money to be paid for a call, specifically
  620. for a certain time period.
  621.  
  622. `From, To'
  623.      The period in which the rate settings specified in this panel are
  624.      active. If you don't want to set a date, then just enter nothing.
  625.  
  626. `Days and dates'
  627.      This list contains the standard settings and exceptions for certain
  628.      dates and days of the week. When calculating the costs for a call,
  629.      `phonebill' first checks if the date on which the call was made is
  630.      listed in one of the exceptions. If this is the case, then the
  631.      settings for that exception will be used. If this isn't the case,
  632.      the day of the call will be compared with the days listed in all
  633.      `day' exceptions. If no exception is found, the standard settings
  634.      will be used.
  635.  
  636. `Add date(s)'
  637.      Will invoke a control panel to create a new rate entry to be used
  638.      on specific date(s). Multiple dates should be seperated by by a
  639.      vertical bar `|' character, e.g.: "25-Dec|1-Jan".
  640.  
  641. `Add day(s)'
  642.      Will create a new rate entry referring to one or more days of the
  643.      week. Use the buttons of the control panel to select the days the
  644.      current settings will be valid for.
  645.  
  646. `Time'
  647.      For each entry in the `Days and dates' list there is at least one
  648.      associated starting time available which defines when the
  649.      associated rate settings are to be used. You will find the time
  650.      settings in the list titled `Time'. To add a new time use the `Add'
  651.      button, to edit an existing entry, use the `Edit' button. To
  652.      remove an entry, press the `Remove' button.
  653.  
  654. `Units'
  655.      For each entry in the `Time' list there is at least on associated
  656.      unit available which defines how much you have to pay per set
  657.      amount of seconds starting at that time. Normally, only one entry
  658.      will be listed. If the first unit should be accounted differently
  659.      than the second, you can enter two different units in the `Units'
  660.      list. This can be applied to as much units as you like.
  661.      Furthermore you can specify the costs you have to pay in
  662.      `Connection costs', and the minimal amount of costs in `Minimal
  663.      costs'.
  664.  
  665. Maintenance panel
  666. =================
  667.  
  668.    In the maintenance panel you can modify the binary log file. Only
  669. calls that fall within the specified scan range from the main panel
  670. will be shown in the list.
  671.  
  672. `Add'
  673.      Adds a new call to the list.
  674.  
  675. `Edit'
  676.      Lets you edit the selected call.  Calls can also be editted by
  677.      double clicking the entry in the list.
  678.  
  679. `Remove'
  680.      Removes the selected call from the list.
  681.  
  682. `Remove all'
  683.      Removes all calls from the list.
  684.  
  685. `Save'
  686.      Saves the binary log file.
  687.  
  688. `Cancel'
  689.      Closes the maintenance panel without saving any changes.
  690.  
  691. Group settings panel
  692. ====================
  693.  
  694.    Hosts can be divided into several groups, for example hosts where
  695. you `poll' your mail belong to the group "Mail". In the group panel you
  696. control the groups.
  697.  
  698. `Groups'
  699.      This list contains all installed groups.
  700.  
  701. `Add'
  702.      Add a new group to the list.
  703.  
  704. `Remove'
  705.      Removes the selected group from the list.
  706.  
  707. `Save,Use'
  708.      Save and/or use the current settings.
  709.  
  710. Report presets panel
  711. ====================
  712.  
  713.    You are most likely interested in more than one specific report
  714. period. Instead of having to change the from/to dates and other report
  715. settings manually over and over again it is possible to store these
  716. settings in a preset. After doing this you only need to select the
  717. preset from the `Presets' menu and all report settings will be set to
  718. the desired settings. The report presets panel is where you define the
  719. presets.
  720.  
  721. `Presets'
  722.      This list contains all installed presets.
  723.  
  724. `Add'
  725.      Add a new preset to the list.
  726.  
  727. `Edit'
  728.      Edit current preset.
  729.  
  730. `Remove'
  731.      Removes the selected preset from the list.
  732.  
  733. `Save,Use'
  734.      Save and/or use the current settings.
  735.  
  736. User interface notes
  737. ********************
  738.  
  739.    To operate a gadget, press the key corresponding to the letter
  740. highlighted in the gadget label. Suppose a slider is labeled `Minutes'
  741. with the letter `M' underlined; in order to increase the slider value
  742. one has to hit the key labeled `M', to decrease the value one is to
  743. hold down either `Shift' key while pressing the key `M'.
  744.  
  745.    Windows in which only a single scrolling list is present cursor keys
  746. may be used to scroll the contents.
  747.  
  748.    The `Return' and `Escape' keys are respected by most windows. A
  749. button surrounded by a recessed box represents the default choice in a
  750. requester, pressing the `Return' key will select it. The `Escape' key
  751. mostly selects the most negative response (e.g. `Cancel'), whereas the
  752. `Return' key selects the most positive respone (e.g.`Use'). Most
  753. windows to feature a close gadget in the upper left corner can be
  754. closed by pressing the `Escape' key.
  755.  
  756.    Numeric entry fields accept input several notations, namely
  757. hexadecimal (`$..' and `0x..'), octal (`&..') and binary (`%..').
  758.  
  759.    The user interface support library tries to make all control panel
  760. windows fit on the screen. If the first attempt fails a different font
  761. is used. If this did not help either a new screen will be opened for
  762. the window.
  763.  
  764. Configuration
  765. *************
  766.  
  767.    This section describes briefly how to configure `phonebill' manually
  768. by editting the configuration files. All configuration files are plain
  769. ASCII text files, which are parsed at startup of the program. For each
  770. configuration file there are several keywords which let you control the
  771. certain variables. The following list describes all keyword types:
  772.  
  773. `string'
  774.      A keyword of type `string' is of the following form:
  775.           (<NAME> <STRING>)
  776.      where `<STRING>' is a valid c-style string.
  777.  
  778. `stringlist'
  779.      Keywords of type `stringlist' are of the following form:
  780.           (<NAME>  <STRING1> <STRING2> ... <STRINGn>)
  781.  
  782. `integer'
  783.      Keywords of this type are used to assign a integer value to a
  784.      variable:
  785.           (<NAME> n)
  786.      where `n' is a valid integer number.
  787.  
  788. `boolean'
  789.      A keyword of type `boolean' can only have the value 1 (which
  790.      stands for `true') or 0 (which stands for `false').
  791.  
  792. `block'
  793.      Keywords of this type are used to enter a block in which a new set
  794.      of keywords is valid.
  795.           (<NAME>
  796.               ; Block keywords
  797.           )
  798.  
  799.    Most configuration files can be controlled by editting the settings
  800. using the the program. The description of these configuration files
  801. will therefore be ommited.
  802.  
  803. Scanner configuration (Scanner.config)
  804. ======================================
  805.  
  806.    The "Scanner.config" file is used for defining the log file scanners.
  807. Before listing the format of this configuration file you'll have to
  808. learn about the way `phonebill' scans a log file.
  809.  
  810.    Log files are scanned line by line. Each line is searched for certain
  811. information concerning calls. If enough information is found to make up
  812. the date, time, duration and destination of the call, the call is insert
  813. in the list of new calls. The information needed can be divided into
  814. different types, for example: day of the month in which the call took
  815. place, telephone number, etc. Each line of the log file is compared to
  816. a format string which contains so called `cookies' on certain places in
  817. which information is to be expected.
  818.  
  819.      Cookie  Description                         Type        Range
  820.      ------- ----------------------------------- ----------- -----
  821.      %n      host name                           STRING
  822.      %a      phone number                        STRING
  823.      %A      phone number (char restriction)     STRING
  824.      %f      Fido-style address                  INT:INT/INT(.INT)
  825.      
  826.      %h      hour (connection)                   INT         0..23
  827.      %m      minutes (connection)                INT         0..59
  828.      %s      seconds (connection)                INT         0..59
  829.      %y      year (connection)                   INT         1970..
  830.      %e      year, short (connection)            INT         0..99
  831.      %o      month (connection)                  INT         1..12
  832.      %t      month, string (connection)          STRING
  833.      %d      day of month (connection)           INT         1..31
  834.      %p      AM or PM (connection)               STRING      (AM|PM|A|P| )
  835.      %l      localized date (connection)
  836.      
  837.      %H      hour (end of connection)            INT         0..23
  838.      %M      minutes (end of connection)         INT         0..59
  839.      %S      seconds (end of connection)         INT         0..59
  840.      %Y      year (end of connection)            INT         1970..
  841.      %E      year, short (end of connection)     INT         0..99
  842.      %O      month (end of connection)           INT         1..12
  843.      %T      month, string (end of connection)   STRING
  844.      %D      day of month (end of connection)    INT         1..31
  845.      %P      AM or PM (end of connection)        STRING      (AM|PM|A|P| )
  846.      %L      localized date (end of connection)
  847.      
  848.      %U      hours (connection length)           INT
  849.      %I      minutes (connection length)         INT
  850.      %X      seconds (connection length)         INT
  851.      
  852.      %#      dummy number                        INT
  853.      %$      dummy string                        STRING      # >= 1
  854.      %c      dummy character                     CHAR
  855.  
  856.    Now, let's take a look at the following log file:
  857.  
  858.      01-Jul-94 18:04:04 Connected to "BBS" (911)
  859.      01-Jul-94 18:06:33 Disconnected
  860.  
  861.    The following are scanstrings used for comparing with lines of this
  862. log file:
  863.  
  864.      "%d-%t-%e %h:%m:%s Connected to \"%n\" (%a)"
  865.      "%D-%T-%E %H:%M:%S Disconnected"
  866.  
  867.    Such scanstrings are listed in keyword "scanstring.default" of type
  868. `stringlist'.  Now take a look at the following part of the log file:
  869.  
  870.      01-Jul-94 18:07:01 Calling 911
  871.      01-Jul-94 18:07:16 BUSY
  872.      ...
  873.      01-Jul-94 18:14:01 Connected to "BBS"
  874.      01-Jul-94 18:23:21 Disconnected
  875.  
  876.    The line that contains "BUSY" has to be taken special care of: all
  877. information found up to that line needs to be disposed. This can be
  878. done using the keyword "scanstring.reset" of type `stringlist':
  879.  
  880.      scanstring.reset = "%#-%3$-%# %#:%#:%# BUSY"
  881.  
  882.    If a string is encountered that matches the above string, all
  883. information found so far gets disposed. There are however cases in
  884. which not all information may be disposed. Take a look at this log file:
  885.  
  886.      -------- 10 Aug 94
  887.      13:33:30 Connected to "BBS"
  888.      13:41:22 Disconnected
  889.      13:42:10 Connected to "Other BBS"
  890.      13:52:56 Disconnected
  891.      
  892.      -------- 11 Aug 94
  893.      16:42:64 Start of session
  894.  
  895.    This time it's not that easy to create a log scanner because the
  896. date is only listed once. When the first `Disconnected' is encountered,
  897. the call will be inserted in the list of new calls, and every
  898. information gets disposed.  The second call won't have a date, which is
  899. required for the call to be recognized. To resolve this problem, use
  900. the following two scanstrings: "scanstring.sticky" and
  901. "scanstring.hardreset", both of type `stringlist'. Every information
  902. detected by a sticky scanstring will only be lost by a hardreset, not
  903. by a reset. This all results in the following log scanner for the above
  904. log:
  905.  
  906.      (scanner
  907.          (name                       "foobar")
  908.          (scanstring.reset           "%#:%#:%# BUSY")
  909.          (scanstring.hardreset       "")
  910.          (scanstring.sticky          "-------- %d-%o-%e")
  911.          (scanstring.default         "%h:%m:%s Connected to \"%n\""
  912.                                      "%H:%M:%S Disconnected")
  913.      )
  914.  
  915.    Now you have seen some examples, a more formal description is given.
  916. Valid keywords in "Scanner.config" are:
  917. `scanner (`block')'
  918.      Using this keyword a new scanner can be defined. The following
  919.      keywords are valid within a `scanner' block:
  920.     `name (`string')'
  921.           Defines the name of the scanner.
  922.  
  923.     `scanstring.reset, .hardreset, .sticky, .default (`stringlist')'
  924.           Explained above.
  925.  
  926.     `noyear (`boolean')'
  927.           Set this to true (e.g. "(noyear 1)") if the year in which the
  928.           calls are made is not logged.  The program will try to fill
  929.           in the year itself.
  930.  
  931.     `signature (`string')'
  932.           To keep track of what calls have already been processed, it
  933.           is possible to add a signature to the end of the log file.
  934.           All calls that appear before this signature are regarded as
  935.           `previously scanned'.
  936.  
  937.    As you can see, creating your own log file scanner is not that easy.
  938. If you have a log file that is currently not supported then please
  939. don't hesitate to mail it to me (uuencoded please) and I'll create the
  940. scanner for you. See Author Info for my address.
  941.  
  942. Supported log files
  943. *******************
  944.  
  945.    This section contains a couple of notes on some log files:
  946. ``GPFax' log'
  947.      The log produced by `GPFax' is a binary log file. As it is
  948.      currently not possible to define a scanner for binary log files,
  949.      the scanner for this file format is built-in. I didn't have any
  950.      information about the structure of this log, so the built-in
  951.      scanner is a bit of a hack.  Therefore it is currently not
  952.      possible to truncate this kind of log file.
  953.  
  954. ``term' action log'
  955.      The call information placed in the action log files was never
  956.      intended for postprocessing with call-log analyzers. There is no
  957.      fixed defined file structure and localization of `term' can
  958.      introduce a lot of trouble. Therefore it is recommended to use the
  959.      `term' call log instead.
  960.  
  961. ``term' call log'
  962.      The file format of this log file is compatible to that of `NComm'.
  963.  
  964. ``terminus' log'
  965.      `terminus' has an option to select the format of the logged date.
  966.      You can choose "dd-mm-yy", "dd/mm/yy" and "mm/dd/yy". It isn't
  967.      always possible to decide what format is being used, for example:
  968.      is "05/01/94" of type "dd/mm/yy" or "mm/dd/yy"? Therefore only the
  969.      first date format is supported, no calls will be found in a log
  970.      file using the other two date formats.
  971.  
  972. ``trapdoor' log'
  973.      If the `trapdoor' scanner doesn't work with your log file, you
  974.      probably have insufficient loglevel settings. You should put the
  975.      following settings in the `trapdoor' configuration file:
  976.           LOGLEVEL 0:2            ; debugger
  977.           LOGLEVEL 1:2            ; link
  978.           LOGLEVEL 2:2            ; transfer
  979.           LOGLEVEL 3:2            ; system
  980.           LOGLEVEL 4:2            ; modem
  981.           LOGLEVEL 5:2            ; session
  982.           LOGLEVEL 6:7            ; security
  983.           LOGLEVEL 7:2            ; outside
  984.           LOGLEVEL 8:7            ; information
  985.           LOGLEVEL 9:2            ; scheduler
  986.  
  987. Program updates
  988. ***************
  989.  
  990.    Whenever a new release of `phonebill' becomes available it will be
  991. uploaded to:
  992.      Grafix Attack (SysOp: Kees Huizer)
  993.      +31-(0)10-4745816   (28K8)
  994.      +31-(0)10-4741062   (19k2 ZyXEL)
  995.      +31-(0)10-4744682   (28K8)
  996.      
  997.      FidoNet:   2:286/407.0
  998.      AmigaNet: 39:153/201.0
  999.      NLA:      14:101/200.0
  1000.      
  1001.      
  1002.      Decades BBS (Sysop: Thomas Andersson)
  1003.      +46-54-831561 (USR 28.8 V.Everything)
  1004.      
  1005.      FidoNet:   2:203/625.0
  1006.      AmigaNet: 39:160/105.0
  1007.  
  1008.    For those of you who have access to the aminet, the latest version
  1009. can be found in directory comm/misc, filename pbill??.lha (where ??
  1010. stands for the version/revision number).
  1011.  
  1012. How to register
  1013. ***************
  1014.  
  1015.    As with the previous versions of the program, `phonebill' v2.0 and
  1016. higher are shareware. There is one difference: starting from version 2.0
  1017. `phonebill' has been crippled, not all features are available in the
  1018. unregistered version:
  1019.  
  1020.    * Binary log file maintenance and report presets are disabled.
  1021.  
  1022.    * `phonebill' only calculates the fees with up to two decimals (e.g.
  1023.      $0,15). In the registered version nine decimals are supported,
  1024.      which provides a better accuracy.
  1025.  
  1026.    Many people hate crippled software, including myself. But it just
  1027. seems that uncrippled software isn't `appreciated' anymore, because very
  1028. few people registered. That is why I decided to cripple the program.
  1029.  
  1030.    *Important information:* The registration fee for the uncrippled
  1031. version was $5 US, but I had to raise the price because starting from
  1032. version 2.0 I will have to send users that register a disk containing a
  1033. keyfile. Now, starting from 27 September 1993, the registration fee will
  1034. be $10 US. If I receive any registrations containing $5 US after this
  1035. date, they will be regarded as a registration for the `old' (pre 2.0)
  1036. version of the program. So, if you registered with $5 US after this date
  1037. you will not receive a keyfile: you'll have to send another $5 US. I
  1038. would to thank all people that have registered the uncrippled version
  1039. of the program before this date by sending them a keyfile without
  1040. having to pay extra.
  1041.  
  1042.    *Registration procedure:* Complete the details in one of the
  1043. supplied registration forms found in the "Documentation" directory, and
  1044. follow the instructions given there. If for some reason you don't have
  1045. the registration form, then do the following:
  1046.  
  1047.   1. Write a note with your complete name and mailing address, and
  1048.      state clearly that you want to register the Amiga version of
  1049.      `phonebill'. If you have access to e-mail (e.g. internet, fidonet,
  1050.      etc.) please specify your e-mail address too. If you want your key
  1051.      to arrive fast I can send it by e-mail, but for security measures
  1052.      you will have to send me your PGP (Pretty Good Privacy) public key
  1053.      first.
  1054.  
  1055.   2. The registration fee is $10 US, DM 15,-, FL 15,-, AUD $15, or the
  1056.      equivalent of $10 US in any other currency.
  1057.  
  1058.      Decide how to transfer the money, e.g.:
  1059.         * cash (at your own risk).
  1060.  
  1061.         * a postal money order.
  1062.  
  1063.         * a EuroCheque (only in FL!), foreign cheques are *NOT*
  1064.           accepted!
  1065.  
  1066.   3. Send this to:
  1067.             Raymond Penners
  1068.             Berkenlaan 4
  1069.             NL-6241 AZ Bunde (The Netherlands)
  1070.  
  1071.   4. Wait for your keyfile to arrive. You should receive your key
  1072.      within 10 days after the arrival of your registration fee. Please
  1073.      allow up to four weeks, due to unforseen circumstances.
  1074.  
  1075.   5. Copy the keyfile to the directory where you keep `phonebill' in or
  1076.      to the `L:' directory. Thanks for registering!
  1077.  
  1078. Acknowledgements
  1079. ****************
  1080.  
  1081.    I would like to thank the following people for support, suggestions,
  1082. help and assistance: Richard Schiffelers, Maurice Lahaye, Matthias
  1083. Scheler, Philippe Duchein, Eric Delord, Johan Billing, Henrik Gelius,
  1084. Jan van den Baard, Michael Holloway, Lars Hanke, Sven Kuenzler, Jos
  1085. Swolfs, Kenneth Fribert, Finn Kettner, Stephan Grochowina, Richard
  1086. Galezowski, Peter C. Lowish, Thomas Andersson, Andreas Baum, Francesco
  1087. Dipietromaria, Cedric Souchon ...
  1088.  
  1089.    Special thanks go to Olaf `Olsen' Barthel, for releasing the
  1090. sourcecode of `term' and creating `gtlayout.library'. Great work!
  1091.  
  1092.    Some quick greetings to: Erwin Penders, Mel Nijsten, Maurice
  1093. Penners, Walter Konrad, Frans Bouma (Not at ericson anymore? What's
  1094. your e-mail adr.?), Robert Udo, Bart Cremers, Arnaud Gouder de
  1095. Beauregard, Walter Dees, Rino Roufs, Rex (the ONE and ONLY
  1096. SPHINX-O-Dog), Marcel Meuldijk, Edwin Boesten, Ephrem Bollen, Marcel
  1097. Franquinet ...
  1098.  
  1099.    Furthermore I would like to say hello to all `dudes' on IRC : Ikke,
  1100. Bilbo1, Savage, Dense, Milano, Pjotr, ALFred, Mnemo, Xed, SteveVai,
  1101. Zop, Janne, Outland, Mjoelnir, Juggi, Goldrnr, Lundman, Shocker, Mag,
  1102. VAG, Herb, _ho_ and everyone I know but forgot to mention here!
  1103.  
  1104.    These are all listed in chaotic order! I am sorry if I forgot
  1105. someone (which I'm sure I have) ...
  1106.  
  1107. Revision history
  1108. ****************
  1109.  
  1110.    Please select the version of which you you want to see the changes:
  1111.  
  1112. Version 1.0
  1113. ===========
  1114.  
  1115.    Version 1.0 was released 6-Jun-1993:
  1116.  
  1117.    * First public release.
  1118.  
  1119. Version 1.07
  1120. ============
  1121.  
  1122.    Version 1.07 was released 14-Jul-1993:
  1123.  
  1124.    * Compiled on A4000 :-)
  1125.  
  1126.    * All configuration files now use the IFF format, and are stored in
  1127.      ENV: and ENVARC:.
  1128.  
  1129.    * The documentation is now in guide format.
  1130.  
  1131.    * Improved preferences: more options.
  1132.  
  1133.    * Added requester that warns you on exit if the configuration has
  1134.      been modified.
  1135.  
  1136.    * Keyboard shortcuts for most of the gadgets.
  1137.  
  1138.    * Requester warning if <from> date is 'above' <to> date.
  1139.  
  1140.    * At the beginning of the report you'll now see the time period.
  1141.  
  1142.    * If no calls were found during scanning the report will state an
  1143.      error message. (In V1.00 an empty textfile would be displayed)
  1144.  
  1145.    * Included built-in rates: German, French, Dutch, Swedish rates.
  1146.  
  1147.    * Added commandline arguments. Try "Phonebill ?".
  1148.  
  1149.    * Added menus to the main window.
  1150.  
  1151.    * Added support for MagiCall log file.
  1152.  
  1153.    * In the report produced by "List Calls" sometimes only the
  1154.      phonenumber would be displayed, although a name was provided in
  1155.      the hostmanager.
  1156.  
  1157.    * If Phonebill was running under a localized workbench, the default
  1158.      from-date ("Yesterday") and to-date ("Today") weren't accepted
  1159.      anymore.
  1160.  
  1161.    * Fixed some V39 problems: the busy pointer now appears in the same
  1162.      resolution as the normal mouse pointer, and some problem
  1163.      concerning V39 listviews is fixed too.
  1164.  
  1165.    * If you were using a bigger system font the rate exception editor
  1166.      would mess up. Also, if you de-zoomed the editor window you
  1167.      wouldn't see the exception anymore.
  1168.  
  1169. Version 1.08
  1170. ============
  1171.  
  1172.    Version 1.08 was released 1-Aug-1993:
  1173.  
  1174.    * Added Terminus support.
  1175.  
  1176.    * Severe bugs were found in Term, Magicall and NComm scanning (thanks
  1177.      to Benno Zuure, Henrik Gelius and Frank Petzold). I've rewritten
  1178.      all log scanning routines to avoid software failures when unknown
  1179.      log messages were encountered.
  1180.  
  1181.    * The saved configuration files had the wrong version/revision tag.
  1182.      Also, Phonebill would disregard this tag and load any
  1183.      configuration file. So if the configuration files need to be
  1184.      changed in the future, the old version of the program would load
  1185.      the new config files which would probably result in a software
  1186.      failure.
  1187.  
  1188.    * Under some circumstances phonebill refused to remove a rate,
  1189.      although it wasn't in use.
  1190.  
  1191. Version 1.1
  1192. ===========
  1193.  
  1194.    Version 1.1 was released 16-Aug-1993:
  1195.  
  1196.    * The host and log lists now show some additional information.
  1197.  
  1198.    * Added support for Amiga UUCP timelog.
  1199.  
  1200.    * The pre-defined rate "Sverige: Riks 1" was wrong. The exception
  1201.      "Monday-Friday 18:00-22:00 0.29 per 52 secs" was missing.
  1202.  
  1203. Version 2.0
  1204. ===========
  1205.  
  1206.    Version 2.0 was released 27-Sep-1993:
  1207.  
  1208.    * GUI facelift: windows backfilled, listview doubleclick, changes in
  1209.      the menus.
  1210.  
  1211.    * Brand new rate editor
  1212.  
  1213.    * Improved "Do you really want to quit?" requester.
  1214.  
  1215.    * <From> and <To> date are now saved as strings.
  1216.  
  1217.    * Iconification.
  1218.  
  1219.    * Crippled.
  1220.  
  1221.    * Added JrComm support.
  1222.  
  1223.    * Binary log file maintenance.
  1224.  
  1225.    * Context-sensitive online help, by pressing `help'.
  1226.  
  1227.    * New improved documentation, including ASCII and DVI formats.
  1228.  
  1229.    * Improved keyboard control: `Escape' will function as a cancel/use
  1230.      action, and `return' as an ok/save action.
  1231.  
  1232.    * `Skip' in the `Unlisted host found'-requester now really skips the
  1233.      host, and not just for once.
  1234.  
  1235.    * Now `phonebill' is able to scan a `Terminus 2.0b' log file
  1236.      correctly (it has some strange `LF' before its connection string).
  1237.  
  1238. Version 2.1
  1239. ===========
  1240.  
  1241.    Version 2.1 was released 19-Oct-1993:
  1242.  
  1243.    * Fixed bug in `trapdoor' scanner: you don't have to pay for
  1244.      incoming calls anymore.
  1245.  
  1246.    * Fixed bug in `AmigaUUCP' scanner: calls of length greater then 99
  1247.      minutes in the UUCP log are misaligned. This caused `phonebill' to
  1248.      skip such calls.
  1249.  
  1250.    * Now you can add and edit calls from within the binary log file
  1251.      editor.
  1252.  
  1253.    * Time units extended with upto 4 decimals (e.g. $1,2345 per 12,3456
  1254.      seconds).
  1255.  
  1256.    * Bugfix: If the textviewer name contained spaces `phonebill'
  1257.      couldn't find the viewer.
  1258.  
  1259. Version 2.2
  1260. ===========
  1261.  
  1262.    Version 2.2 was released 7-Dec-1993:
  1263.  
  1264.    * Under most circumstances the updating of the binary log file is
  1265.      much faster and efficient compared to previous versions.
  1266.  
  1267.    * Added MultiFax proffesional support.
  1268.  
  1269. Version 2.3
  1270. ===========
  1271.  
  1272.    Version 2.3 was released 6-Feb-1994:
  1273.  
  1274.    * New callrate feature: least costs.
  1275.  
  1276.    * The statistics have been improved and new statistics have been
  1277.      added (hourly activity).
  1278.  
  1279.    * Bugfix: the calls in the binary log file weren't always sorted
  1280.      chronologically.
  1281.  
  1282.    * Added MicroDot support.
  1283.  
  1284.    * Added TrapFax support.
  1285.  
  1286.    * Due to the use of the quotes when running the textviewer you
  1287.      couldn't specify any commandline arguments (e.g. "WatchIt -i").
  1288.      This has been fixed.
  1289.  
  1290. Version 2.4
  1291. ===========
  1292.  
  1293.    Version 2.4 was released 13-Mar-1994:
  1294.  
  1295.    * Added TKR-BTX support.
  1296.  
  1297.    * Added AutoPilot support.
  1298.  
  1299.    * Fixed a problem with the MicroDot log file: A call ending with
  1300.      "NETCALL abgebrochen" was not recognized as a valid call, and
  1301.      therefore skipped.
  1302.  
  1303.    * Any trailing spaces entered at the end of the from/to-date strings
  1304.      are ignored now.
  1305.  
  1306.    * The `LogScan' signature from the term log file did not have the
  1307.      appropriate dateformat. Therefore, it could happen that the
  1308.      signature wasn't recognized during some months, which might have
  1309.      resulted in `fake' (duplicate) new calls.
  1310.  
  1311.    * Generating report now is approx twice as fast due to the use of
  1312.      asynchronous I/O.
  1313.  
  1314.    * More commandline arguments are supported.
  1315.  
  1316.    * Added a "Save"-button in the "Settings not saved" requester.
  1317.  
  1318.    * Added `dupe'-detection: duplicate calls are automatically removed.
  1319.      So now there is no harm done when a log file is accidently scanned
  1320.      twice. I recommend that you re-save your binary log file by
  1321.      pressing `Save' in the maintenance panel, so that dupes from
  1322.      previous versions are removed (if there were any).
  1323.  
  1324. Version 2.5
  1325. ===========
  1326.  
  1327.    Version 2.5 was released 6-Apr-1994:
  1328.  
  1329.    * When adding calls using the maintenance panel the date is
  1330.      automatically set to the current date instead of 01-jan-78.
  1331.  
  1332.    * Added GPFax support.
  1333.  
  1334.    * Bugfix: dupe-detection failed sometimes.
  1335.  
  1336.    * AutoPilot problem fixed: only sessions ending with "End of
  1337.      Session" were recognized.
  1338.  
  1339. Version 3.0
  1340. ===========
  1341.  
  1342.    Version 3.0 was releaded 25-Aug-1994.
  1343.  
  1344.    * The program can now be localized by translating the supplied
  1345.      catalog description file.
  1346.  
  1347.    * The configuration files have changed from IFF to plain ASCII text
  1348.      files which are parsed on startup. Files in ENV:Phonebill are no
  1349.      longer needed, which saves memory.
  1350.  
  1351.    * Moved from built-in scanners to user-configurable scanners. The
  1352.      only built-in scanner left is `GPFax' (which is binary log file).
  1353.  
  1354.    * Improved the rates: extended the limit of 4 decimals for units and
  1355.      seconds to 9, support for different rates in different time
  1356.      periods, you can enter more than one date in a date exception by
  1357.      seperating them using a `|' character, first and second unit have
  1358.      made place for a listview in which you can configure as much units
  1359.      as you wish.
  1360.  
  1361.    * Replaced the ugly CON: window by a nice intuition window.
  1362.  
  1363.    * You can set a different carrier detect time for each host, or use
  1364.      the default carrier detect time as desired.
  1365.  
  1366.    * Support for hosts with more than one phone number by seperating
  1367.      the numbers using a `|' character.
  1368.  
  1369.    * Cleaned up the statistics report a bit. It's also possible to
  1370.      define the sort order in which the host listed in the bill report
  1371.      are sorted.
  1372.  
  1373.    * Added support for `CyberPager', `TheAnswer', `JamMail' and
  1374.      `Multifax 2.0'.
  1375.  
  1376.    * New user-interface featuring `gtlayout.library' by Olaf `Olsen'
  1377.      Barthel. I found this the best compromise between a plain and fast
  1378.      gui like the old `phonebill', and a slow but very configurable gui
  1379.      like `MUI'.
  1380.  
  1381.    * Re-arranged the menus. I noticed that the `Project' menu was called
  1382.      `Projects', which looks very ugly. Why didn't anyone report this?
  1383.      :)
  1384.  
  1385.    * Cleaned up the code: large parts have been re-written.
  1386.  
  1387.    * Installation is now done by using the Commodore Installer (or
  1388.      should that be Samsung Installer, or Philips Installer? :-)
  1389.  
  1390. Version 3.1
  1391. ===========
  1392.  
  1393.    Version 3.1 was releaded 4-Oct-1994.
  1394.  
  1395.    * Changed: the program now also looks for the keyfile in the
  1396.      directory specified by the KEYPATH variable, if it exists.
  1397.  
  1398.    * Changed: The cookie %a only accepted certain phonenumbers, which
  1399.      caused a lot of problems. Now %a accepts any string.  So now,
  1400.      "Calling %n (%a)" and "Calling BBS (123-AMI)" match.  "A BBS 123"
  1401.      and "%n %a" match too: name="A" nr="BBS 123", to resolve this "%n
  1402.      %A" should be used.
  1403.  
  1404.    * Bug fix: Updating the binary log files on MC68000-amigas could
  1405.      crash because of reading from an odd address.
  1406.  
  1407.    * Changed: when adding hosts the last selected rate will be used as
  1408.      default for a new unlisted host.
  1409.  
  1410.    * Added an option called `connection costs' to the rates.
  1411.  
  1412.    * Changed: if  "ENV:AmigaGuide/Path" is set-up correctly, you can
  1413.      put the "Phonebill.guide" whereever you want.
  1414.  
  1415.    * Added some average costs/calls/online per day to the stats.  Also,
  1416.      if the <to date> is set somewhere in the future, `phonebill' will
  1417.      estimate the total costs on that date (bill report).
  1418.  
  1419.    * Changed: hosts with multiple phonenumbers did not work the way it
  1420.      was supposed to be. For example, now you can group a host "Line A"
  1421.      (9111) and host "Line B" (9112) to "Lines" (9111|9112).
  1422.  
  1423.    * New: Hosts can be assigned to groups, over which reports can be
  1424.      generated seperately, for example: create a group called "Poll"
  1425.      and assign all hosts you poll for mail to this group.  Then you
  1426.      can view reports concerning these hosts only...
  1427.  
  1428.    * Bug fix: the `minimal costs' weren't saved.
  1429.  
  1430.    * By pressing `Cancel' in the host settings panel the changes to the
  1431.      host were dropped, but changes to the rates weren't.  Now, you can
  1432.      only pick a rate from within the host settings panel. Editting
  1433.      rates is done by using the rate editor.
  1434.  
  1435.    * The format of the configuration files has changed again.  For
  1436.      example: "scanner ... endscanner" is now "(scanner ...)" The new
  1437.      format is more compact, and the parser should be a bit faster
  1438.      compared to the old parser.
  1439.  
  1440.    * Added German and Swedish catalogs, updated Swedish rates.
  1441.  
  1442.    * And last but not least: my fido e-mail addresses have changed. :)
  1443.  
  1444. Version 3.1a
  1445. ============
  1446.  
  1447.    Version 3.1a was released 14-Oct-1994.
  1448.    * The unregistered version could crash when you were presented with
  1449.      the shareware requester, but only if the localized strings were
  1450.      larger than the original strings.
  1451.  
  1452.    * Fixed possible software failures in the routines responsible for
  1453.      adding hosts manually.
  1454.  
  1455.    * Removed a spelling mistake. :-)
  1456.  
  1457.    * An italian catalog has been added.
  1458.  
  1459. Version 3.2
  1460. ===========
  1461.  
  1462.    Version 3.2 was released 24-Dec-1994.
  1463.  
  1464.    * Added NewIcons and MagicWB icons to the distribution.
  1465.  
  1466.    * The program no longer requires both %I and %X or %U and %I to be
  1467.      present to determine the length of the call. An occurence of %X
  1468.      only suffices.
  1469.  
  1470.    * Re-added writing signatures to the GPFax log file. If you don't
  1471.      like this, turn it off in the log settings.
  1472.  
  1473.    * Added scanners for AmiTel, Off-line Amiga, DreamTerm,
  1474.      ISDN-Master-Telephone-Log.
  1475.  
  1476.    * Added a new cookie for fido-style addresses to the scanner.  If
  1477.      you have `traplist' installed the address found will be used to
  1478.      find the real name and phonenumber of the host.  You'll need to
  1479.      configure the "Nodelist path" (see miscellaneous settings).
  1480.  
  1481.    * Phonebill has become a commodity: a hotkey can be defined in the
  1482.      tooltypes (CX_POPKEY, defaults to "ctrl alt b") to (de)iconify the
  1483.      program.
  1484.  
  1485.    * Added: if you want to rescan the log files you won't have to go
  1486.      through the trouble of removing the signatures with a text editor,
  1487.      just use the new `Rescan logs' menu item.
  1488.  
  1489.    * New: option for disabling writing signatures to the log file
  1490.  
  1491.    * Changed: a signature will only be added if new calls were found.
  1492.  
  1493.    * Added new date format: an integer can be used to specify the
  1494.      number of days after today (e.g. scanning from "-6" up to "today"
  1495.      results in a report of the last seven days.
  1496.  
  1497.    * New: report presets (for the scan range and groups).
  1498.  
  1499.    * New hosts can be automatically added by supplying the rate(s) with
  1500.      a pattern to match certain area codes.
  1501.  
  1502.    * Fixed a problem in call appending.
  1503.  
  1504. Version 3.3
  1505. ===========
  1506.  
  1507.    * Added a new `cookie' for scanning a localized date (e.g. newer
  1508.      versions of autopilot started logging localized dates).  Help, I
  1509.      am running out of cookies! :-)
  1510.  
  1511.    * Accidently mapped the month string "maa" (dutch for March) to may.
  1512.      Also, "mär" was unknown.
  1513.  
  1514.    * Added support for Plink.
  1515.  
  1516.    * A linefeed at the end of the bill report was missing.
  1517.  
  1518.    * Added AutoPilot scanner for v1.75 or higher.
  1519.  
  1520.    * The program can be opened on a public screen.
  1521.  
  1522.    * Added option to process log files on startup.
  1523.  
  1524.    * Bug fix: somewhere in the log panel information from memory was
  1525.      read after it had been freed already, causing enforcer hits. Oops!
  1526.  
  1527.    * Added commandline switch "CONFIG/S" to specify the location of the
  1528.      configuration directory.
  1529.  
  1530.    * Fixed bugs in the terminus scanner.
  1531.  
  1532.    * Added a scanner for ZeeTerm.
  1533.  
  1534.    * When pressing `enter' in the from/to gadgets of the rate period
  1535.      settings panel the date(s) or day(s) settings panel could popup
  1536.      with no particular reason. This has been fixed.
  1537.  
  1538.    * Cosmetical changes: menu checkmarks and Amiga keys are now scaled
  1539.      according to the current screen display ratio, added a zoom gadget
  1540.      to all windows.
  1541.  
  1542.    * Added a new truncating option called "Preserve blocks". If this
  1543.      option is enabled the log file will be truncated at the position
  1544.      of an empty line seperator.
  1545.  
  1546.    * Monetary values are now displayed according to the current locale
  1547.      settings.
  1548.  
  1549.    * Removed my name and address from .cd file.
  1550.  
  1551. Version 3.3a
  1552. ============
  1553.  
  1554.    Version 3.3a was released 11-Apr-1995.
  1555.  
  1556.    * The executable from the previous release was mangled: AmigaDOS
  1557.      2.04 wasn't able to execute it, but for some reason AmigaDOS 3.0+
  1558.      didn't have any problems with it. Needless to say that it has been
  1559.      fixed...
  1560.  
  1561. Version 3.3b
  1562. ============
  1563.  
  1564.    Version 3.3b was released 17-Jun-1995.
  1565.  
  1566.    * A French translation is now available, thanks to Cedric Souchon.
  1567.  
  1568.    * Important note: Continental Drift (the Australian  registration
  1569.      site) is closing down, meaning that they no longer accept
  1570.      registrations. Ofcourse, it is always possible for Australian
  1571.      people to get registered by me directly.
  1572.  
  1573.    * A switch is now available to make sure that the reports contain
  1574.      ASCII characters only (Miscellaneous settings).
  1575.  
  1576.    * "Off-line Amiga" scanner modified to recognize sessions other than
  1577.      "girotel" (e.g. Rabobank).
  1578.  
  1579.    * Added GMS scanner.
  1580.  
  1581. Version 3.3c
  1582. ============
  1583.  
  1584.    Version 3.3c was released 10-Aug-1995.
  1585.  
  1586.    * Scanner.config: Added PPP scanner.
  1587.  
  1588.    * Scanner.config: term's action log scanner now reads localized
  1589.      dates as written by term. However, this is only of any use when you
  1590.      are using a non-localized term on a localized workbench since
  1591.      otherwise phonebill wouldn't understand term's localized log file
  1592.      anyway. Btw, the best thing would be to use the call log anyway.
  1593.  
  1594.    * Finally the install script has been localized as well.
  1595.  
  1596.    * Bug fix: The last line of a log file was ignored if and only if it
  1597.      didn't contain a line feed. As far as I know, the only log file
  1598.      format that doesn't end it's lines with an apropriate linefeed is
  1599.      TKR-BTX.
  1600.  
  1601.    * Added UK rates.
  1602.  
  1603.    * Bug fix, 2.04 only: if you didn't specify a date in the rate
  1604.      period settings panel it would be interpreted as "31-Dec-99".
  1605.      This wasn't really my fault :), kick 2.04 seems to accept "-" as a
  1606.      valid date (try running "date -" in a shell).
  1607.  
  1608.    * Scanner.config: modified trapdoor scanner to recognize calls were
  1609.      the modem could not be hung up.
  1610.  
  1611.    * Scanner.config: modified the trapdoor scanner to recognize calls
  1612.      that were breaked by the user ("[..]User break[..]").
  1613.  
  1614.    * Scanner.config: GMS scanner has been modified to process 5D
  1615.      addresses correctly.
  1616.  
  1617. Author Info
  1618. ***********
  1619.  
  1620.    Send bug reports, log files, suggestions, comments, postcards,
  1621. flames, contributions, etc. to:
  1622.  
  1623.    * Snail-Mail:
  1624.             Raymond Penners
  1625.             Berkenlaan 4
  1626.             NL-6241 AZ Bunde (the Netherlands)
  1627.  
  1628.    * Internet:    raymondp@stack.urc.tue.nl
  1629.  
  1630.    * You may also find me (nickname "Sphinx") on IRC in the #amiga
  1631.      channel.
  1632.  
  1633.    Below you will find my public key.
  1634.  
  1635.      -----BEGIN PGP PUBLIC KEY BLOCK-----
  1636.      Version: 2.3a
  1637.      
  1638.      mQCNAixCIEEAAAEEAMYJLUgyMWTJHOzMaiL1k50GXN86f2Ym2R7sHt6To3XluXhN
  1639.      UYtkL+G2FYlGI+FzVL4oRBUCnzkqkvvIQHYbanxuVEX3XJ/w0tHWMc6+nj0/XniQ
  1640.      4N9sUk4a0CiQWlo6CH6O6l+JvUoEamLpOmHeNKbOsjzh3Ekg2WxCH+ITWUepAAUR
  1641.      tCtSYXltb25kIFBlbm5lcnMgPHJheW1vbmRwQHN0YWNrLnVyYy50dWUubmw+
  1642.      =CMBu
  1643.      -----END PGP PUBLIC KEY BLOCK-----
  1644.  
  1645.