@DATABASE "IntuiCookie.guide" @$VER: IntuiCookie.guide 1.0 (20.01.96) @NODE Main "Contents" @{b}IntuiCookie for BGUI 1.0@{ub} Click @{"here" LINK IntuiCookie3.GIF/main} for a preview of the BGUI version. Click @{"here" LINK IntuiCookie2.GIF/main} for a preview of the Reqtools version (not included). Click @{"here" LINK IntuiCookie.GIF/main} for a preview of the MUI version (not included). I. Introduction 1.1 @{"Preface" LINK Preface} 1.2 @{"Why should I use IntuiCookie?" LINK Features} II. Legal crap 2.1 @{"Copyright" LINK Copyright} III. Before you use IntuiCookie... 3.1 @{"Requirements" LINK Requirements} 3.2 @{"Installation" LINK Installation} IV. How to use IntuiCookie 4.1 @{"Usage" LINK Usage} 4.2 @{"Menus" LINK Menus} V. How to configure IntuiCookie 5.1 @{"Tooltypes" LINK Tooltypes} 5.2 @{"File format" LINK CookieFileFormat} 5.3 @{"CookHash" LINK CookHash} VI. Glossary 6.1 @{"What is a fortune cookie?" LINK FortuneCookie} 6.2 @{"What is a cookie file?" LINK Cookiefile} 6.3 @{"What is a hash file" LINK HashFile} VII. Misc texts 7.1 @{"Contact address" LINK Address} 7.2 @{"About the author" LINK AboutMe} 7.3 @{"Thanks to..." LINK Thanks} VIII. Past, Present and Future 8.1 @{"Past" LINK Past} 8.2 @{"Present" LINK Present} 8.3 @{"Future" LINK Future} Up-to-date informations about IntuiCookie are available on the WWW: @{b}http://www.club.innet.be/~year0183/Texts/IntuiCookie.html@{ub} @ENDNODE @NODE Preface "1.1 Preface" @{u}@{b}1.1 Preface@{uu}@{ub} IntuiCookie is a program that will display fortune cookies. Some people might say that a BGUI fortune cookie program is overkill. I don't think so. Just @{"install" LINK Installation} IntuiCookie and draw your own conclusions. If you don't like BGUI, there is also a Reqtools version available. If you don't like Reqtools, check out the MUI version. If you don't like that one either then I can't help you ;-) __________ @{i}Pohls' Law: Nothing is so good that somebody, somewhere, will not hate it.@{ui} @ENDNODE @NODE Features "1.2 Why should I use IntuiCookie?" @{u}@{b}1.2 Why should I use IntuiCookie?@{uu}@{ub} · Uses hash files for amazingly fast access, even with a large cookie file. · Different fonts for cookie and origin. · Preparse possibilities: Display all cookies or origins left-aligned, centered or right-aligned. · Includes CookHash, a hashfile generator with AppIcon. · Formatting characters (bold, underlined, italic...) are supported. @ENDNODE @NODE Copyright "2.1 Copyright" @{u}@{b}2.1 Copyright@{uu}@{ub} IntuiCookie and all accompagnying files are (C)1995, 1996 Christian Kemp, except the guide and Install icons, which are (C) Tom Ekström. All Rights Reserved. BGUI is (C) Jaba Development, Jav van den Baard. @{b}This software is subject to the "Standard Amiga-FD-Software Copyright Note". It is Mailware as defined in paragraph 4b. For more information please read @{"AFD-COPYRIGHT" LINK AFD-Copyright/Main} (Version 1 or higher).@{ub} @ENDNODE @NODE Requirements "3.1 Requirements" @{u}@{b}3.1 Requirements@{uu}@{ub} · Kickstart and Workbench V37 or later. · BGUI V37 or later. · Memory usage depends on your configuration, for example whether you want IntuiCookie to have a background pattern, but should not exceed 300k. · ±300 kilobytes on your HD. (Only ±25 kilobytes have to reside on your boot partition.) @ENDNODE @NODE Installation "3.2 Installation" @{u}@{b}3.2 Installation@{uu}@{ub} Installation is accomplished through an Installer¹ script. Simply double-click on the Install icon and follow the on-screen instructions. Please do not install IntuiCookie by hand, it only causes unnecessary trouble. __________ ¹ Installer is not included in this archive. @ENDNODE @NODE Usage "4.1 Usage" @{u}@{b}4.1 Usage@{uu}@{ub} Simply start it by clicking on its icon. A window will be opened, click on "Continue" to close it, or take a look at the @{"menus" LINK Menus}. IntuiCookie can be customised via @{"tooltypes" LINK Tooltypes} and the MUI prefs program. @ENDNODE @NODE Menus "4.2 Menus" @{b}@{u}4.2 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}Quit@{uu} · Will have the same effect as clicking on the close or Continue gadgets: Close the window and quit. @ENDNODE @NODE Tooltypes "5.1 Tooltypes" @{b}@{u}5.1 Tooltypes@{uu}@{ub} Using tooltypes is described in-depth in your Workbench manual. Boolean tooltypes (which accept a TRUE or FALSE as answer) can also be shortened by just writing the name of the tooltype, which is the same as if you had written =TRUE. If you don't specify the tooltype at all, IntuiCookie reacts as if you had written =FALSE. @{u}· The COOKIEFILE tooltype@{uu} Used to specify the location and name of the @{"cookie file" LINK CookieFile}. Example: @{u}· The HASHFILE tooltype@{uu} Used to specify the location and name of the @{"hash file" LINK HashFile} Example: @{u}· The COOKIE_PREPARSE tooltype@{uu} Used to specify the look of the cookie text. Possible options are CENTER, LEFT, RIGHT, default is LEFT. Example: @{u}· The COOKIEFONT tooltype@{uu} Used to specify the font in which the cookie text will be written. Example: @{u}· The COOKIEFONTSIZE tooltype@{uu} Used to specify the size of the COOKIEFONT. Example: <15> @{u}· The ORIGINFONT tooltype@{uu} Used to specify the font in which the origin text will be written. Example: @{u}· The ORIGINFONTSIZE tooltype@{uu} Used to specify the size of the ORIGINFONT. Example: <11> @{u}· The ORIGIN_PREPARSE tooltype@{uu} Used to specify the look of the origin text. Possible options are CENTER, LEFT, RIGHT, default is LEFT. Example: =LEFT> @{u}· The ORIGIN tooltype@{uu} Used to determine whether the origin of the quote (the person that invented it) is displayed or not. Note that a lot of quotes are unacknowledged. Example: . Set this to FALSE if you don't want to see any origin. @ENDNODE @NODE CookieFileFormat "5.2 Format of the cookie files" @{b}@{u}5.2 Format of the cookie files@{uu}@{ub} The cookie file is a plain ASCII text file which can be read and modified by any text editor. Individual cookies can occupy up to 2048 bytes (±25 lines) and are separated by a line containing nothing but two percent signs. Example: ---BEGIN OF FILE--- About the cookie file % First cookie. % Second cookie! % This is the third cookie ---END OF FILE--- Note that there's no % before the first and after the last cookie! @{u}Formatting characters@{uu} "@b" - Print the following characters in bold. "@i" - Print the following characters in italics. "@u" - Underline the following characters. "@c" - Center the following lines. "@l" - Align the following lines to the left. "@r" - Align the following lines to the right. "@n" - Switch back to normal text. Note that all text before the first '%' is considered as Info Text, which can be displayed using the "Cookiefile Info" @{"menu" LINK Menus} of the MUI version. When adding cookies that come with an origin, please use the following format for the origin: - The name has to be on his own line. - It must be preceeded by two hyphens and one space ("-- "). - It must not be longer than 255 characters. If you don't follow these conventions, IntuiCookie may have problems recognising origins. @ENDNODE @NODE CookHash "5.3 CookHash" @{b}@{u}5.3 CookHash@{ub}@{uu} CookHash is used to create @{"hash files" LINK Hashfile}. The hash program that is included in this archive differs from the one included in the MUI version, as this version does not feature windows or requesters, but instead offers a simple AppIcon. Simply drag a cookie file over the AppIcon and a hash file will be created. @ENDNODE @NODE FortuneCookie "6.1 What is a fortune cookie?" @{b}@{u}6.1 What is a fortune cookie?@{uu}@{ub} A fortune cookie is a random quote, item of trivia, joke or maxim printed to the users terminal at login time. -- Quoted from Jargon 3.0.0 @ENDNODE @NODE CookieFile "6.2 What is a cookie file?" @{b}@{u}6.2 What is a cookie file?@{uu}@{ub} A cookie file is a collection of @{"fortune cookies" LINK FortuneCookie} in a format that facilitates retrieval by a fortune program. There are several different cookie files in public distribution, and site administrators often assemble their own from various sources. -- Quoted from Jargon 3.0.0 @ENDNODE @NODE HashFile "6.3 What is a hash file?" @{b}@{u}6.3 What is a hash file?@{uu}@{ub} A hash file is a file containing nothing but hexadecimal numbers (the "coordinates" where a new cookie begins) used for amazingly fast access of @{"fortune cookies" LINK FortuneCookie}, even in large files. @ENDNODE @NODE Address "7.1 Contact Address" @{b}@{u}7.1 Contact address@{uu}@{ub} It is very important to motivate me with long letters, E-Mails, bug-reports, suggestions and gifts. Send them 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. @ENDNODE @NODE AboutMe "7.2 About the author" @{b}@{u}7.2 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 DKB 1240 accelerator, Microvitec monitor, 250 MB hard disk and a Tandem1200 CD-ROM. @ENDNODE @NODE Thanks "7.3 Thanks" @{b}@{u}7.3 Thanks@{uu}@{ub} Thanks go to: All the faithful IntuiCookie users who sent me suggestions and remarks: Stephan Grossien, Aristotelis Grammatikakis, Olav Mueller, Eric Gerard, Kenneth Fribert, Michael-W. Hohmann, Steve Wong and Jason Murray. Thanks to Dietmar Knoll for the AFD licence and to Tom Ekström for his great Iconographics collection. @ENDNODE @NODE Past "8.1 Past" @{b}@{u}8.1 Past@{uu}@{ub} This the first BGUI version, although there are already a lot of MUI and Reqtools versions. @ENDNODE @NODE Present "8.2 Present" @{b}@{u}8.2 Present@{uu}@{ub} The following bugs ("features") and inconveniences exist in this version of IntuiCookie: - COOKIEFILE and HASHFILE must be preceeded by "PROGDIR:" when the files are in local directory. @ENDNODE @NODE Future "8.3 Future" @{b}@{u}8.3 Future@{uu}@{ub} @{u}Planned features for the next version@{uu} · Prefs program instead of setting tooltypes. · Support for multiple cookie files. · Copy a cookie to the clipboard or to a file. · "Browse" through a cookie file. · And, of course, your suggestions @{u}LATEST versions@{uu} Latest informations and versions are available via my homepage @{b}http://www.club.innet.be/~year0183/Texts/IntuiCookie.html@{ub} @ENDNODE