
                             Appoint V1.10                        

                   by Thies Schrader Web Programming

                        http://www.webprog.com

                        ----------------------

          Appoint V1.10 is Copyright (C) 1998 by Thies Schrader


-Registered? -----------------------------------------------------------------

 Thank you for registering Appoint, I hope you will like the new features that
come with Appoint V1.10. To install this version of Appoint, simply execute
the SETUP.EXE file.

- Not Registered? ------------------------------------------------------------

 If you are using the trial version of Appoint, please try it out for a trial
period of 60 days. Registering will remove the 'Trial-version' dialog from
Appoint Admin, and it will also allow you to change the footers of all views.

 Please see http://www.WebProg.com/appoint/register.html for more information.

------------------------------------------------------------------------------

 See license.txt for license agreement.

================
1. Contents:
================

    1. Contents
    2. Requirements
    3. Setup/Installation
    4. Appoint Administrator 
    5. More information on Header and Footer files.
    6. Using Appoint
    7. Support
    8. Credits


================
2. Requirements:
================

 Appoint V1.10 works on most Windows NT and Windows 95 WWW servers. Servers
that have been tested are:

  EMWACS
  WebSite
  Netscape Commerce
  Netscape FastTrack

 it is also known to work on many others. (It does not work with Win-Httpd)

 In order to get Appoint working, you will need to have read/write access
to the servers CGI directory and the Windows system directory.


================
3. Setup/Installation
================

 To setup Appoint, execute the SETUP.EXE file included with the Appoint V1.10
package. If you are not using O'Reilly WebSite or a Netscape server, you will
need to know where you server CGI directory is. You will also need to know
where you would like Appoint to install its support files (header, footer and
datafiles)

 If you have previously installed Appoint V1.10 or above onto your computer,
please uninstall that version first. Use the "Add/Remove Programs" icon from
the "Control Panel".

================
4. Appoint Administrator
================

 With the Appoint administrator you can edit, delete and add new configurations.

 From the "Programs" menu under "Start" then "Appoint V1.10" select the
"Appoint Admin" icon. This will start the Appoint Admin program.

 Main Appoint Administrator dialog:

     New...   - Creates a new configuration based on you "Default" configuration.
     Edit...  - Edits the selected configuration.
     Delete   - Deletes the selected configuration.
     OK       - Saves changes and exits Appoint Admin.

 New Configuration dialog:

     Enter the name of the new configuration, and press the "OK" button to create
     it, the "Cancel" button takes you back to the Main dialog.

     The name you use here is the name of the configuration. This is used in the
     Appoint URL to view the calendar. Use the following URL syntax:

     http://your-server/cgi-bin/appoint.exe?CFG=<NAME>

     Where <NAME> is the short-name of the configuration given in the 'New' dialog
     box.

 Appoint Administrator configuration dialog:

     This dialog box is used to edit a selected or new configuration. In the basic
     view, you can change features for the "Month" and "Edit" views.

     By pressing a "..." button, a dialog box will appear, that may aid you in
     finding a specific file or directory.

     Basic features are:

       Month:
    
         Header - the file that should be used as the month's view header. This
             typically contains site logos, button bars to other site locations.
             See the Example.hdr file for an example header file.

         Footer - the file that should be used as the month's view footer. This
             typically contains a line explaining who the maintainer of the site
             is, in case of an error. See the Example.ftr file for and example
             footer file.
    
         Name - The long name of the calendar. The %N macro in header and footer
             files will be replaced with this name.

         Note - A note you would like to have under the calendar table, e.g.
             the HTML text to display in the bottom row of the calendar. Banners
             are often places here.

       Edit:
 
         Header - see Month, Header.
   
         Footer - see Month, Footer.
 
         Password - The password that is needed to enter or edit the calendars
             Appointments.

         Data path - The full path to where the calendars data files should
             be stored, the default value is the recommended choice.

     By pressing the "Advanced>>" button, the advanced features are shown.

     Advanced features are:

       Special month view formatting:

         Before - Any HTML code or text that should be used before the day's
             appointments are places in a calendar cell. Typically any
             font formatting codes.

         After - Any HTML code or text that should be used after the day's
             appointments are places in a calendar cell. Typically the
             HTML 'end' tags for any HTML code placed in Before.

       Week view:

         By checking the checkbox, the viewer of the calendar will be able
             to view the week mode. This mode displays a table of the
             appointments in a single week. See Month for information on
             the Header and Footer files.

       Day view:

         By checking the checkbox, the viewer of the calendar will be able
             to view the day mode. This mode displays information for a single
             day in HTML code. It is recommended to use the Edit view for this
             purpose since the Day view is often confusing for the user.
             See Month for information on the Header and Footer files.
          
     Pressing the OK button saves any changes, where as Cancel will abort any
     changes made.           

================
5. More information on Header and Footer files.
================

 A Header files is a files that at minimum contains

     <html><head><title>...</title></head><body>

 In addition you may add any other HTML text or any of the
 following macros:
  
     %C - will be replaced by the current calendar's name
     %N - will be replaced by the current calendar's long (Name in AppAdmin)
     %Y - will be replaced by the current year, e.g. 1996
     %M - will be replaced by the current month's name, e.g. October
     %S - will be replaced by the current month's short name, e.g. Oct
     %W - will be replaced by the current week's number (1-5)
     %D - will be replaced by the current day's number (1-31)

   By current, I mean the year/month/week/day being viewed if it exists.
   See the example files included (Example.hdr and Example.ftr located
   in the Appoint directory. To find the directory, look under Start
   Programs then Appoint V1.10, there will be an icon that takes you
   to the Appoint Directory).

================
6. Using Appoint:
================

1. Start Appoint.exe with your browser.

    http://your.server/cgi/appoint.exe?cal=[NAME]

    Where your.server is your servers address, and cgi is the path to
    you servers CGI directory, and used by SETUP. [NAME] is needed only
    if you would not like to use the default configuration. Use
    the configuration name as used in AppAdmin. Examples are:

    http://www.WebProg.com/cgi-bin/appoint.exe?cal=Meetings
    http://hjs.geol.uib.no/cgi-win/appoint.exe?cal=Thies

2. Pick a date, write your appointment and password (for this calendar),
   and press the 'Accept' button.

3. Play around with the program, if it is not working correctly, please
   see the Trouble Shooting section below.


   It should be easy to see how the program works, good luck!


================
7. Support
================

 If you have problems installing or using Appoint, please send me an email
to support@WebProg.com. I will try to help you as quick as I can. To help
the process, also send information on the current Server, Browser you are
using, and a copy of the TCGI.INI file located under the Windows system
directory.

 If you need changes done to Appoint, I do provide my time at the following
cost:

 15$ per hour - If the change/update can be used in future version of Appoint
      or simular products.

 30$ per hour - If the change/update cannot be used in future version.

 I also always take comments on how to make Appoint better. Just send me a 
mail explaining what you would like to see. Email is thies@WebProg.com, or
visit my web pages at http://www.WebProg.com.

================
8. Credits
================

 Thanks go to :

  - Andrew Brault (ajb@wpi.edu) for a lot of the code needed to set
    up the correct date, and view, the copyright for his code follows
    below.

  - Hans Schrader, for testing and coming up with new ideas.

  - The people at the CompChat - FastPitch site, for testing and comments.

  - All those who have come up with good ideas for additions. I have
    tried to add some of them, others are to overwhelming for a project
    like this one.

  - All those that send feedback on my programs, I get bored quickly
    making programs without getting feedback.

  - The copyright for Andrew Brault (ajb@wpi.edu) program.

/        This program (calendar) is Copyright (C) 1996 by
|        Andrew Brault (ajb@wpi.edu).
|
|        Permission to use, copy, modify, and distribute this software and
|        its documentation for any purpose and without fee is hereby
|        granted, provided that the above copyright notice appear in all
|        copies and that both that copyright notice and this permission
|        notice appear in supporting documentation.  This software is
\        provided "as is" without express or implied warranty.


================
Thies Schrader
Skyaasvegen 4
7015 Trondheim

E-mail : thies@WebProg.com
URL    : http://www.WebProg.com
