@DATABASE "Smartass.guide"

@$VER: Smartass.guide 2.0 (02.06.96)




@NODE Main "Contents"

          @{i}He who trains his tongue to quote the learned sages,
                     will be known far and wide as a@{ui}
                                @{b}Smartass@{ub}

                            -- Howard Kandel


@{u}Contents of this Guide@{uu}

    @{"Introduction" LINK Introduction}

    @{"Copyright" LINK Copyright}
    @{"About MUI" LINK MUI}

    @{"Requirements" LINK Requirements}
    @{"Installation" LINK Installation}

    @{"Usage" LINK Usage}
    @{"Menus" LINK Menus}
    @{"Tooltypes" LINK Tooltypes}

    @{"Contact address" LINK Address}
    @{"About the author" LINK AboutMe}
    @{"Thanks to..." LINK Thanks}

    @{"Past" LINK Past}
    @{"Present" LINK Present}
    @{"Future" LINK Future}
    
@ENDNODE


@NODE Introduction

@{u}What?@{uu}

    A fortune cookie program for your pleasure.  Smartass contains
more than 66200 different cookies.  Murphy's laws, Devil's Dictionary,
myths, jokes, computer mimics to stories, AI Hacker's Dictionary and
not to forget - quotes from famous people.


@{u}How?@{uu}

    Smartass puts text to the Shell or opens a highly configurable
MUI window.


@{u}Why Smartass?@{uu}

    - Smartass uses MUI - which makes its appearance very configurable
    - Also supports output to the Shell
    - Very large cookie file (2.8 Meg crunched)
    - [Next] button: Go to the next cookie without having to reload
      the program.
    - Preparse possibilities: Display all cookies or origins in bold,
      italic, centered...
    - Save individual cookies to a file.
    - Optionally, the window can be made borderless, ie. no
      title, border and sizegadget will be displayed.
    - Possibility to disable the "Browse" buttons, the "Origin"
      area and the "Exit" gadget.

Smartass only has one major disadvantage: The data file is not user-configurable.
      
@ENDNODE





@NODE Copyright "Copyright"

@{u}@{b}Copyright@{uu}@{ub}

Copyright 1995, 1996 Smartass Team.  All Rights reserved.

The Smartass Team consists of:
Sveinar Rasmussen (sveinarr@stud.cs.uit.no)
Antonia Colombo (azc10@amail.amdahl.com)
Christian Kemp (ckemp@innet.lu)
Jan David (jdavid@sr.net)

Amiga-port and all the nice MUI stuff (C) 1995, 1996 Christian Kemp.


Smartass requires and uses @{"MUI" LINK MUI} © Stefan Stuntz.


@{b}This software is subject to the "Standard Amiga-FD-Software Copyright Note".
It is Giftware as defined in paragraph 4g.
For more information please read @{"AFD-COPYRIGHT" LINK AFD-Copyright/Main} (Version 1 or higher).@{ub}
@ENDNODE





@NODE MUI "MUI"
                          This application uses


                        MUI - MagicUserInterface

                (c) Copyright 1992-96 by Stefan Stuntz


MUI is a system to generate and maintain graphical user interfaces. With
the  aid  of  a  preferences program, the user of an application has the
ability to customize the outfit according to his personal taste.

MUI is distributed as shareware. To obtain a complete package containing
lots of examples and more information about registration please look for
a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
your local bulletin boards or on public domain disks.

          If you want to register directly, feel free to send


                         DM 30.-  or  US$ 20.-

                                  to

                             Stefan Stuntz
                        Eduard-Spranger-Straße 7
                             80935 München
                                GERMANY
@ENDNODE





@NODE Requirements "Requirements"

@{u}@{b}Requirements@{uu}@{ub}

· Kickstart and Workbench 2.04 or later.
· MUI 3.1 or later.
· Memory usage depends on your configuration, for example whether you want
  Smartass to have a background pattern, but should not exceed 300k.
· Nearly 3.0 Megabytes.
  (Only ±40 kilobytes have to reside on your boot partition.)
  
· You @{b}need@{ub} the archive Smartass_dat.lha or Smartass will not be able
  to display any cookies!

@ENDNODE





@NODE Installation "Installation"

@{u}@{b}Installation@{uu}@{ub}

Installation is accomplished through an Installer¹ script.

Simply follow these steps:

- Unpack Smartass_dat.lha and Smartass_bin.lha to RAM: or
  any other directory.  (If you haven't already done this).
  Warning: Unpacking to RAM will require over 3 Megabytes of
  free memory!
- Doubleclick on the RAM icon, then on the Smartass drawer.
- Doubleclick on the Install icon
- Follow the on-screen instructions.
- If the Installation was successful, delete the Smartass drawer
  that still resides in the RAM disk.
  
Please do not install Smartass manually, it only causes unnecessary trouble.



__________
¹ Installer is not included in this archive.
@ENDNODE





@NODE Usage "Usage"

@{u}@{b}Usage@{uu}@{ub}

WORKBENCH

    Simply start Smartass by clicking on its icon.
    A window will be opened, click on "Exit" to close it, or take a look
    at the @{"menus" LINK Menus}.

    If the NEXT mode is turned on, you will see an additional button
    near the Exit button.  This button can be used to display a new
    cookie without having to reload the program.
            
    Smartass can be customised via @{"tooltypes" LINK Tooltypes} and the
    MUI prefs program. (refer to the @{"Menus" LINK Menus} section).

SHELL

    Simply enter its name in a Shell window.
    
    The following command line options are supported:
    
    GUI - Smartass will behave just as if started from Workbench.
    Cookiefile - Specify the cookiefile (normally "Smartass.dat")
    
    Cookiefile is obligatory if GUI is not specified.
    

@ENDNODE





@NODE Menus "Menus"

@{b}@{u}Menus@{ub}@{un}


@{b}@{u}Project menu@{uu}@{ub}

@{u}About@{uu}
· A requester with the version number, a giftware notice and my contact
  address will appear.  Click on Continue to close the requester.

@{u}About MUI@{uu}
· Displays informations about the version of MUI installed on your Amiga.

@{u}Quit@{uu}
· Will have the same effect as clicking on the close or Exit gadgets:
  Close the window and quit.


@{b}@{u}Edit menu@{uu}@{ub}

@{u}Save cookie as...@{uu}

· This function allows you to save an individual cookie to a file.


@{u}@{b}Settings menu@{ub}@{uu}

@{u}MUI...@{uu}

· Show the MUI settings window, where you can modify the graphical
  appearance of Smartass.

@ENDNODE





@NODE Tooltypes "Tooltypes"

@{b}@{u}Tooltypes@{uu}@{ub}

Using tooltypes is described in-depth in your Workbench manual.

@{u}· The SMARTASSFILE tooltype@{uu}
Used to specify the location and name of the Smartass cookie file.

@{u}· The COOKIE_PREPARSE tooltype@{uu}
Used to specify the look of the cookie text.
Possible options are BOLD, CENTER, HIGHLIGHT, ITALIC, LEFT, RIGHT, UNDERLINE,
they can also be combined.
Example: <COOKIE_PREPARSE>=BOLD|CENTER>

@{u}· The COOKIEFONT tooltype@{uu}
Used to specify the font in which the cookie text will be written.
Example: <helvetica.font>

@{u}· The COOKIEFONTSIZE tooltype@{uu}
Used to specify the size of the COOKIEFONT.
Example: <15>

@{u}· The EXIT tooltype@{uu}
Used to specify if the Exit button should be displayed.
Example: <BUTTON=FALSE>

@{u}· The NEXT tooltype@{uu}
Used to specify if the "Next" button should be displayed.

@{u}· The INNERBORDER tooltype@{uu}
When this tooltype is specified, Smartass will include a 9-pixel
border around the area where the cookie is displayed.

@{u}· The NOBORDER tooltype@{uu}
When this tooltype is specified, the Smartass window won't have a border,
a sizing gadget, a close gadget and a title anymore.

@{u}· The GOODREFRESH tooltype@{uu}
When this tooltype is specified, Smartass will use a different method
for updating the window when it jumps from one cookie to a new one.
This causes a visible updating of the window, but the window will then
have the same height, as the cookie requires.

@ENDNODE






@NODE Address "Contact Address"

@{b}@{u}Contact address@{uu}@{ub}

Please send long letters, e-mails, bug-reports, suggestions, postcards,
gifts, money and used A4000/060's to:

@{"Kemp Christian" LINK AboutMe}
52, BD Patton
L-2316 Luxembourg
- Europe -

E-Mail : ckemp@innet.lu
WWW    : http://www.club.innet.be/~year0183/

You can write in German, English, or French.

Make sure to visit the Smartass homepage:
http://www.club.innet.be/~year0183/Texts/Smartass.html

@ENDNODE





@NODE AboutMe "About the author"

@{b}@{u}About the author@{uu}@{ub}

I'm 18 years old and I'm currently going to secondary school (high-school).

I've been using Amigas for over five years and my current setup includes an
A1200 with 68030, 8 Meg of Fast RAM, Microvitec monitor, 250 MB hard disk,
PCMCIA DoubleSpeed CD-ROM and TriStar 28k8 modem.

@ENDNODE





@NODE Thanks "Thanks"

@{b}@{u}7.3 Thanks@{uu}@{ub}

Thanks go to all the people who sent me suggestions and/or bug-reports
for Smartass and/or IntuiCookie:

- Stephan Grossien
- Aristotelis Grammatikakis
- Olav Mueller
- Kenneth Fribert
- Michael-W. Hohmann
- Eric Gerard (have you got a new email address?)
- Dietmar Knoll
- Brian Martz
- Jason Murray
- Steve Wong
- Esteve Boix (for suggestions, bug reports and motivation)
- Sveinar Rasmussen (for letting me port Smartass to the Amiga)
- Paul Barnes (are you sure your email address is correct?
  I replied to your mails, but apparently you didn't get them ;(

@ENDNODE





@NODE Past "Past"

@{b}@{u}Past@{uu}@{ub}

This is the first version of Smartass from me, and therefore there
is no history yet.

@ENDNODE





@NODE Present "Present"

@{b}@{u}Present@{uu}@{ub}

Known bugs:

- Apparently Smartass still produces some Enforcer hits.
  I'm working on it (which is hard, as I don't have an MMU)...

@ENDNODE





@NODE Future "Future"

@{b}@{u}Future@{uu}@{ub}

@{u}Planned features for the next version@{uu}

· Prefs program instead of setting tooltypes.
· Get rid of those Enforcer hits :(

· And, of course, your suggestions

@ENDNODE