Short: Key-Bindings for Origami Author: hadig@pool.informatik.rwth-aachen.de Uploader: ruebe pool informatik rwth-aachen de Type: util/edit Architecture: m68k-amigaos This file is for first time origami users ! Welcome to the amiga version of origami ! This file will tell you how to install the origami-editor. After installing, please read the file `readme.amiga` and the files in the `AmigaDocs`-directory. Contents -------- 1. What is origami ? 2. What do you need to run origami ? 3. What is included in the package ? 4. How do I install origami ? 5. Which docs shoud I read ? 6. Copyright, Disclaimer, Acknowlegdements, Mail address 1. What is origami ? -------------------- Origami is a folding editor. Folds are used to hide text, so you will find your point of interest faster and have a clearer structure. The fold information will be written in the textfile, but you can compile all textfiles without deleting the fold information. Origami has all important features needed by users. This includes : * freely configurable keyboard tables * powerfull macro language (OCL) * AREXX port (beta version) * powerfull standard macros like fill-paragraph, regular-expression-search, towers-of-hanoi and many others For more information read the file doc/intro. 2. What do you need to run origami ? ------------------------------------ First you need the executable called origami. Origami needs to read two files : .origamimsg : This file contains all the messages origami will print. .origamirc : This file contains all the macro definitions and the keyboard definition. It also contains the arexx definition and the help pages. Origami needs both files to run. If they are not found, origami will exit. The namebase (standard .origami) can be changed by using the -k option. The files are search in the S: directory and all directories specified in the ORIPATH environment variable. You can also use the -R option to specify a different directory. Please read the man/origami.1 file for more information. 3. What is included in the package ? ------------------------------------ The whole origami package contains several directories : The first list of directories is defined in the Origami_.lha distribution. AmigaDocs : this directory contains all amiga specific documents and the bug.fixes file. bin : this directory contains the amiga executables. man : doc : These directories contain the information about the origami and the additional programs. rexx : this directory contains some useful arexx scripts. At this time only some test scripts are included, but if you have some interesting scripts, I will surely include them there. The second archive (Origami_Bind_.lha) contains the binding files. bindings : here you can find the files, describing the keysequences origami will listen for... (read the manual for more infos) The third archive (Origami_Docs_.lha contains the sources of the origami folding editor : doc : man : These directories contain nroff and awk sources of the ascii documents distributed in the other archive. scripts : This directory contains some scripts useful on unix/linux operating systems. src : Contains the complete source and the directory with the amiga port sources (see below). The source directory has several subdirectories : Amiga : here you can find the special files and Smakefiles used in the amiga port. autoalias, dirfold, h, keybind, origami, lib, viewrc : These directories contain the complete unix source. You will need the Origami_.lha archive only, if you just want to run origami without changing anything. You will need the Origami_Bind_.lha archive, too, if you want to change the existing bindings or use some of the macros in your own binding. The third archive (Origami_Srcs_.lha) contains all the things, you need to compile origami on the amiga or any other os. So you will not need it in most cases. 4. How do i install origami ? ----------------------------- To install origami use the commodore installer with the install_origami script in the main directory. 5. Which docs should I read ? ----------------------------- There are several documtentation files in this distribution. You will not have to read every bit of information, so i will give you a short description of the files : doc/intro : This file contains more information about folding editors and origamis concept of storing file information. man/.man : These files contain a short description of the commands and a detailed option list. AmigaDocs/README.AMIGA : This file contains all additional feature provided by the amiga version. AmigaDocs/README.AREXX : This file gives a short introduction in origamis way to use the Arexx port. AmigaDocs/bug.fixes : This file contains all (fixed and not-fixed) bugs of the current version and additional or changed features. bindings/[*fun/]*.r : These files contain the reference card descriptions of the functions defined in the responding marco file (the file without the .r). Some of the macro packages do not have any descriptions (this will be changed sometime.). You should read the bug.fixes file everytime you get a new version. You should read the origami.man and maybe view the keybind.man files, if you use origami for the first time. You should read the AMIGA.README, if you use the Amiga version of origami the first time. You should read the manual and the keybind.man and viewrc.man files and the bindings/fun/*.r files, if you want to change the standard keybinds or if you want to develope a completly new binding. 6. Copyright, Disclaimer, Acknowlegdements, Mail address -------------------------------------------------------- Please read the AmigaDocs/README.AMIGA file for the information mentioned above (and some more info). I hope you`ll enjoy origami Thomas Hadig