Yrolo $Revision: 1.1 $ $Date: 1995/04/15 19:23:42 $ ****************************************************************************** This software is not shareware..it's a freeware. You can do anything with it except making money. I wrote in in my own time, mostly after work and weekends. My employer SEMCOR, Inc. has nothing to do with this software. Look at the Copyright notice for more details. ****************************************************************************** REQUIREMENTS 1) Unix 2) A C compiler 3) X and Motif (1.1 or 1.2) libraries Yrolo is a program for maintaining database for people's name, address, phone number, email etc. The data structure is based on another Motif rolodex program written by gregg hanna (mrolo13) with many enhancements and modifications. I borrowed several routines from gregg's program for handling the database. Yrolo can be used to send mail to the people at your database. If the database contains the e-mail address field, this address will be used to send mail. However, Yrolo can mail to anyone with a valid e-mail address. While including file in the message, if the file is binary, it will be automatically "uuencoded". I personally compiled and tested the software at the following platforms. If you port it to a different platform, please send me patches. o Sparc 10 (SunOS 4.1.4, X11R5, Motif 1.2) - stock cc and gcc 2.6.3 o Sparc LX (Solaris 2.3, OpenWindows 3.2, Motif 1.2) - gcc 2.5.6 o Interactive UNIX 3.2 (i486 33, Motif 1.1) - gcc 2.5.8 FEATURES: o Add Card o Edit Card o Delete Card o Print a selected card (can be restricted to specific field/s) o Print all cards (can be restricted to specific field/s) o Send E-mail o Include text or binary file in the mail message o Search database o Restricted search o Save/Load database o Context Sensitive help o Supports X toolkit command line options and some more o X Resources To COMPILE: (If you need to change anything, edit the "Yrolo.tmpl", do not edit the "Imakefile". Edit "Yrolo.tmpl" if compilation fails.) at your shell prompt, type: xmkmf make if you want to install, make install make install.man If compiled successfully, to run, type: yrolo Click on Help menu for on-line help for getting started. X RESOURCES Appropriate fallback resources are used at compile time. That means, the program will have a nice look without the app-defaults file. However if you insist to change the resources, please look the file YRolo.ad. If you change the X resources, make sure that you do it right, otherwise Yrolo will not work right. Even a empty resources file screw things up. ACKNOWLEDGEMENT o Thanks to Jack P. Starrantino (jps@semcor.com) for allowing to put the code in the public domain. o Thanks to Wil Roesler (wil@semcor.com) for suggesting many things. o Thanks to gregg hanna for mrolo. If I didn't see his program I probably won't write this one. The file format of mrolo and yrolo is similar. The differences are: (1) yrolo has more fields (2) yrolo format has a identification tag. COPYRIGHT ------------------------------------------------------------------------------- Copyright 1995 by Muhammad A Muquit. Permission to use, copy, modify, distribute this software is hereby granted, provided this copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and the name of my employer SEMCOR, Inc. and Company not be used in in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The software is provided "as is" without express or implied warranty. I disclaim all warranties with regard to this software, including all implied warranties of merchantability and fitness, in no event shell me or my employer SEMCOR, Inc. be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software. ------------------------------------------------------------------------------- If you have any suggestion or bug report, please send me mail at: muquit@semcor.com URL: http://www.semcor.com/~muquit/ If you like the software, please drop me a line. I like to hear from you. Enjoy!