@DATABASE "Adagis v3 English Guide File" @NODE "Main" "Adagis v3.1" @TOC "MAIN" @{b} Adagis v3.1 @{ub} @{" New " LINK "New"} © 1996 Esteve Boix @{" What is Adagis " LINK "What is Adagis"} @{" Installation " LINK "Install"} @{" How does it work ? " LINK "How it works"} @{" History " LINK "History"} @{" To do " LINK "To do"} @{" Distribution / Disclaimer" LINK "Distribution"} @{" MUI " LINK "MUI"} @{" Thanks... " LINK "Thanks"} @{" About the author " LINK "About"} @ENDNODE @NODE "New" "New in Adagis v3.1" @TOC "MAIN" Major/Minor changes: -New tooltype AUTHOR (see Tooltypes). -New 'Jump to...' window, which enables you to jump to an specific byte in the cookie-file. -Adagis.data statistics are more accurate now -Minor sthetic changes. -Installation is done with the CBM Installer. @ENDNODE @NODE "What is Adagis" "What is Adagis" @TOC "MAIN" @{b}What is Adagis ?@{ub} Well, Adagis can be described as a Fortune-Cookie program. Its main purpose is to display a cookie (an adage) in a window of your workbench. The cookies are stored in the file Adagis.data. Adagis chooses one randomly (or not) and displays it. @ENDNODE @NODE "Install" "Installation" @TOC "MAIN" @{b}Installation@{ub} Very simple: Just run the script English.ins to install the program in you WBStartup and the english Adagis.data in your S: drawer. @ENDNODE @NODE "How it works" "How it works" @TOC "MAIN" @{b}How does it work@{ub} To use Adagis you need: -AmigaDOS v2.0+ (2.1+ required to use locale.library) -MUI v3.2+ @{"How to use the program" LINK "Usage"} @{"The 'Adagis.data' file" LINK "Adagis.data"} @{"Configuring Adagis" LINK "Config"} @{"Tech" LINK "Tech"} @ENDNODE @NODE "Tech" "Some tech stuff" @TOC "MAIN" @{b}Tech@{ub} -Unlike previous Adagis versions, v3 doesn't hold the whole Adagis.data in the RAM. The obvious advantage is that with large cookie-files the RAM usage remains the same as when working with little files. But the method Adagis uses has the disadvantage (?) that it can't know both the current cookie and the total number of cookies. -When Adagis random-selects an adage, it has instant access to it, and it displays its offset (in bytes) in the file. -If you want you can get an adage selecting its number, but then the access could be *slow*, as Adagis has no information about the positions of adages, and has to search in the file line by line. -Adagis v3.1 sets its priority to -1. -You may notice that if you specify an offset, probably Adagis will not jump exactly to that offset. It jumps to the first cookie it finds after this offset. @ENDNODE @NODE "Usage" "Using Adagis" @TOC "MAIN" @{b}How to use the program@{ub} Adagis v3 has two main MUI-pages. The first one is 'Adagis' and its (nearly) identical to the GUI of Adagis v2.x. Adagis selects an adage and displays it in the list. It then waits a time proportional to the number of lines of the adage and quits. You can make Adagis wait forever by pressing 'Wait'. Pressing again 'Wait' 'defreezes' Adagis (???). If you press 'More', Adagis will choose and display a new adage. 'Quit' is obvious, no ? The second page, 'Miscelaneous' is new. It contains (currently) 4 buttons: 'MUI-Config' : Calls MUI-Prefs for Adagis v3. 'Get Adage #': You can specify an adage by its number. Remember that with large cookie-files, access can be very slow. 'Jump to...' : You can specify an adage by its position within the file. If you specify an offset that belongs to the last adage, Adagis will choose another one randomly. 'About Adagis.data': Analyzes the cookie-file and displays some interesting (?) information about it. Again, with large cookie-files, this function can take time. 'About Adagis v3': Displays some (interesting) information about the prog. @ENDNODE @NODE "Adagis.data" "Adagis.data file" @TOC "MAIN" @{b}The Adagis.data file@{ub} The Adagis.data file contains the adages. It's a plain ASCII file, so you can edit it with your favourite text editor. Its structure is very simple: >>>Adagis<<< # Adage 1 # Adage 2 # Adage 3 # . . . # Adage N Each adage is preceeded by a '#'. I try to not exceed 48 characters per line. Of course Adagis can handle longer lines, but it does not features formatting, keep this in mind. Please, don't play with the file, because you can easily hang Adagis. @ENDNODE @NODE "Config" "Configuration" @TOC "MAIN" @{b}Configuring Adagis@{ub} Adagis is a MUI program, so you can configure everything... I recommend you to use large fonts in lists, 14 or 15 points, as they make adages more easy to read. You can set-up some settings through tooltypes: DELAY=# Sets the delay per line in miliseconds (1000=1sec) PROB=# If you set this to 100, Adagis will start every time you execute it. If you set it to 50, it will start with a probability of 50 % CENT If this tooltype is present, the lines of the adages will appear centered in the list. AUTOFREEZE Again, if present, AutoFreeze will make Adagis start as if you had pressed 'Wait' USEBIGFONT If present, Adagis will use the Big Font set in MUI-Prefs for the adages. AUTHOR If you set this tooltype, Adagis will look every line of an adage for if it begins with '--'. If so, this line will be right justified and "bolded". Normally, an author of an adage is preceeded by '--'. @ENDNODE @NODE "History" "History" @TOC "MAIN" @{b}History@{ub} v0.1...0.9: Never really saw light. ßetaversions. v1.0...1.8: Only few people saw them. Used the gadtools.library. v2.1: First working MUI-version of Adagis. Uploaded to Aminet. Configurable via tooltypes. v2.2: Internal changes. Never saw the light. Not uploaded to Aminet due to v3. v3.0: Requires MUI 3.2+. Adagis.data not hold in RAM. Sample english cookie-file. Uploaded to Aminet. v3.1 Present version :-) New AUTHOR tooltype New 'Jump to...' window Internal changes @ENDNODE @NODE "Distribution" "Distribution" @TOC "MAIN" @{b}Distribution@{ub} Adagis v3 is public domain, you can (and I'd like you doing so) freely copy it to anyone, as long as you follow the following rules: -Adagis v3 must be distributed without a single modification in the original distribution package. -You can distribute Adagis via InterNet, BBSs, soft libraries and similar electronic channels. -If you want to include it in a magazine-disk or similar, please contact the author first ! This software is subject to the "Standard Amiga FD-Software Copyright Note". It is CardWare as defined in paragraph 4c. [...] For more information please read "AFD-COPYRIGHT" (Version 1 or higher). See About the author. If you create you own Adagis.data, please contact me, because I'd like to distribute Adagis with a lot of cookies... ------------------------------------------------------------------------ $VER: "AFD-COPYRIGHT"(TM) English Version 1.2 (27.02.96) __ __ *====================================* __ __ / // / * Standard Amiga FD-Software * / // / / // / * Copyright Note (TM) * / // / / // / *====================================* / // / __ __ / // / * * __ __ / // / \ \\ \/ // / * Version 1.2 - English * \ \\ \/ // / \ \\/ // / * 27-Feb-1996 * \ \\/ // / \ / // / * * \ / // / """ "" *====================================* """ "" 0. INTRODUCTION =============== If you are a user I hope you like this Standard Copyright Note for Free Dis- tributable Amiga® Software you only have to read once instead of individual notes. There are translated versions of this document available on Aminet® named: /pub/aminet/docs/misc/AFD-Files1-xx.lha (xx = number of languages). If you are a software developer and want to include this document in your own FD package then please read it carefully first, especially chapter 5 "DEVELOPERS INFORMATION". Thank you for your support. 1. COPYRIGHT ============ a. This software is copyrighted by its developer(s). That means that you are NOT ALLOWED to modify the program(s) and documentation in any way. Especially you MUST NOT REMOVE the documentation or this text file. b. You are NOT allowed to use this software or any part of it for any other purpose than that one mentioned in its documentation, this also includes any fonts, images or samples. If the developer(s) did NOT include the source code of the program(s) in this package you are NOT allowed to de- compile any part of it. 2. DISTRIBUTION =============== This package is freely distributable. That means you are allowed to re- distribute this package as long as you follow these points: a. Any re-distribution has to include all files in this archive, including this "AFD-COPYRIGHT" file, without any modifications. You are NOT allowed to add any files to the archive. b. This package may be freely distributed via BBSs, InterNet/UseNet, software libraries such as Fred Fish's and Aminet® CD-ROM, and other similar electronic channels. c. Disk magazines and services that charge extra for file transfers may NOT distribute it without written permission by the developer(s)! 3. DISCLAIMER ============= By using this product, you accept the FULL responsibility for any damage or loss that might occur through its use or the inability to use it. The developer(s) of the software and the author and the translators of this "Copyright Note" can NOT be held responsible. IMPORTANT: The author and the translators of this "Copyright Note" do NOT give any guarantee for the quality and usefulness of ANY products that are subject to this note!!! Some names used in this text are trademarks or registered trademarks. The use of these names does not imply that they are free. 4. RETURN SERVICE ================= "Free distributable" only says that you do not have to pay for copying or re- distributing the software. You are allowed to test this product for 30 days. If you like it and decide to use the product regularly, most of the develo- pers want something in return for their efforts. The documentation of this software contains one classification out of these: a. Freeware - You are allowed to use this software FREE. b. Mailware - You have to send the developer(s) a MESSAGE (by email or snailmail). c. Cardware - You have to send the developer(s) a POSTCARD. d. Donationware - You have to make a DONATION to an organization as stated in the documentation to this product. g. Giftware - You are requested to send the developer(s) a GIFT, for example: - some candy or - a package of disks or - a copy of a self-made program or - some money or - an Amiga 5000 PowerTower ;-) s. Shareware - You have to send the developer(s) the amount of MONEY demanded in the documentation. 5. DEVELOPERS INFORMATION ========================= The concept of a "Standard-Licence" like this one has several advantages: - You as a developer don't have to think about copyright stuff yourself. - The users of your product have to read it only if they haven't done so before. - This document is available in several languages via Aminet®. So you can be sure that the users have read it at least once and did understand it. If you want to include "AFD-COPYRIGHT"(TM) in your own Amiga® FD-Software package you have to follow these rules: a. Read this whole document carefully and make sure that you agree with the whole text WITHOUT ANY EXCEPTIONS. (If you do not agree with it, do not use it! You are allowed to copy parts of it, but IF you do so, you MUST NOT use the names "AFD-COPYRIGHT"(TM) and "Standard Amiga FD-Software Copyright Note"(TM).) b. Make sure that you use the following Default-Tools in the .info-files you are going to release: - for ASCII texts: More - for AmigaGuide® documents: AmigaGuide - for AmigaOS scripts: IconX - for ARexx scripts: RX - for configuration files: Ed - for Installer scripts: Installer - for IFF-ILBM pictures: Display (The idea of this rule was inspired by Osma "Tau" Ahvenlampi, Finland. It was included to set a standard. If someone does not use these tools (s)he has to make not more than one link per file type!) c. Include a paragraph like the following in the manual to your product: ------8<------------------------------------------------------------------- This software is subject to the "Standard Amiga FD-Software Copyright Note". It is as defined in paragraph 4. [...] For more information please read "AFD-COPYRIGHT" (Version 1 or higher). ------8<------------------------------------------------------------------- Example: This software is subject to the "Standard Amiga FD-Software Copyright Note". It is SHAREWARE as defined in paragraph 4s. If you like it and use it regularly please send $15 to ... For more information please read "AFD-COPYRIGHT" (Version 1 or higher). d. You have to include this file called "AFD-COPYRIGHT"(TM) (English). IF you include an AmigaGuide® hypertext documentation you can link it to this file or include the whole text in the AmigaGuide® file just as you like. Please do not add more than two translations of this file to your package. So your package doesn't get too big. 6. AUTHORS ========== "AFD-COPYRIGHT"(TM) was written by Dietmar Knoll. It is itself subject to the above copyright note (© 10.12.1994, 27.02.1996). If you have any comments, hints or questions or some suggestions for the next version, please write to the following addresses: Dietmar Knoll InterNet-Email: To: dknoll@gwdg.de Iltisweg 6 Subject: AFD D-37081 Göttingen My WWW-Homepage: GERMANY/EUROPE ftp://ftp.gwdg.de/pub/physik1/WWW/GAUHPIL/Welcome.html The translators of this document and their addresses are stated in the corresponding files. The translations are © by the translators. @ENDNODE @NODE "Thanks" "Thanks" @TOC "MAIN" @{b}Thanks@{ub} Well... My special thanks go to : -Anna: For most of catalan adages supplied with Adagis v3. -Christian Kemp: For his help. -Michael Misfud: For (great part of) the english Adagis.data file and the nice postcard ! -Josep Rubiralta: ...uhm... For his ideas and suggestions. -Wouter van Oortmerssen: Amiga_E !!! Thanks also to all Adagis users that have send me nice postcards and cookies !!! @ENDNODE @NODE "About" "About" @TOC "MAIN" @{b}About the author@{ub} Please, send me suggestions, criticisms, ideas, gifts, CyberStorms and postcards (mainly postacards) to: Esteve Boix Sánchez C/Alcalde Armengou n11 7-1 08240 Manresa (Barcelona) Spain You can contact me through to following e-mail address: axe@arrakis.es Adagis v3 has been completely developed using AmigaE v3.2e, from Wouter van Oortmerssen, in an Amiga 3000 w/ 68030+882 25Mhz, 18Mb RAM, 540Mb SCSI HD and a CyberVision64. @ENDNODE @NODE "To do" "To do" @TOC "MAIN" @{b}To do in Adagis@{ub} List of features that *may* be added to Adagis: -Non-MUI versions: Not likely, but depends on users... -Add more MUI 3.2 features: Buf... Help bubbles ? For Adagis ??? -Make Adagis "talk" the cookies: This feature was already added, but finally I decided not to include it, as (be honest) the Amiga talks very bad... As usual, waiting for suggestions. @ENDNODE @NODE "MUI" "Sobre MUI" @TOC "MAIN" @{b}MUI@{ub} This application uses MUI: This application uses MUI - MagicUserInterface (c) Copyright 1993/94 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