Yrolo(1)

NAME
yrolo - a Rolodex(TM) like program in Motif

SYNOPSIS
yrolo
yrolo [options ...] or
yrolo [options ...] filename
Where options include:
  -fg foreground_color       sets the foreground color
  -bg background_color       sets the background color
  -i                         starts in iconic form
  -iconic                    starts in iconic form
  -d display_name             X server to contact
  -display display_name       X server to contact
  -xrm resourcestring        specifies a resource string
  -h                         shows short help
  -V                         shows Version
  -nopixmaps                 do not use pixmaps for cards
  filename is the name of a valid Yrolo database file.

DESCRIPTION
Yrolo is a X/Motif program for maintaining, manipulating and displaying databases of people's name, address etc. If the Yrolo program is started without any argument, it will try to open a file called .yrolo.yr at your home directory. You may start adding card to the database right away. This is the default card file Yrolo will open every time it is invoked without any argument. But you can change the default card file by setting the environment variable YROLODEX. As for Example, if your shell is csh or it's variant, at the shell prompt, type:
    setenv YROLODEX path_of_your_database If your shell is sh or it's variant, at the shell prompt, type:
    YROLODEX=path_of_your_database
    export YROLODEX

Any valid Yrolo database also can be opened from command line as, yrolo file.yr. After staring the program, any valid database file also can be opened from the File menu.

If you add cards to the databe, they will be saved automatically to this file. However if any unusual condition arises and Yrolo can not save your cards, it will try to detect it and prompt for a filename when you select Quit from the File menu. Yrolo accepts all standard X toolkit command line options. In addition it takes a filename. As for Example:
   yrolo -bg lightblue rolodex.yr The class of Yrolo is YRolo. Appropriate fallback resources are hardcoded, however if you insist to change resources, please look the file X RESOURCES section. To get Contextual Help, select the Contextual Help item from the Help menu. When the pointer turns into a question, click on any visible item on the window to get help about that item. If no help is available, the pointer will change back to normal..nothing will happen.

MENU ITEMS
File
         Open rolodex
         Print the displayed Card ...
         Print the entire Database ...
         Save As ...
         Quit
Options
         Search Preferences ...
         Card Info ...
Help
         About ...
         Hints ...
         Contextual Help

Open rolodex
When this item is selected, a File selection dialog box will pop-up. Enter the name of a valid Yrolo file at the Text widget labeled Input File. After entering the filename, press on the OK button. The dialog can be traversed using the Tab key.

Print the displayed Card
This menu item can be selected after a card is being displayed by clicking on the name item at the list widget. If no card is being displayed and this item is selected, it will write a message at the status area telling that no card is currently being viewed. When a card is being displayed and this item is selected, a window will pop-up with various choices. The printing destination can be set by clicking on the appropriate toggle button, e,g. Printer or File. Currently Yrolo supports only text mode. PostScript support will be added at the next release.The default print command is lpr. However, you can set o your favorite print command by setting the environment variable PRINT_COMMAND. If your shell is csh or it's variant, at the shell prompt, type:
    setenv PRINT_COMMAND "lpr -Ptxt"
The print command can be a pipe as well. As for example I use the ASCII to PostScript converter pform to print the card/s to a PostScript printer. I set my PRINT_COMMAND like this:
    export PRINT_COMMAND="pform -q -s 8 -f Times-Roman -l 6 -Pps"
I use bash as my shell. By default, the fields Name, Company, and Address are selected for printing. Toggle the Print Fields buttons to any combinations you like. When satisfied, click on the Print button for printing or click on the Cancel button if you changed your mind. If the menu item Print the displayed Card ... is selected from the File menu, the title of the print dialog will be Print Displayed Card otherwise the title will be Print All Cards.

Print the entire Database ...
This item can be selected if there is atleast one card is loaded. Otherwise, when this item is selected, a message will be written to the status area telling that there is nothing to print. If the item is successfully selected, the same pop-up print dialog will appear as mentioned earlier.

Save As
When this item is selected, a prompt dialog will request a filename for saving the loaded database. Enter the filename and click on OK. No space is allowed at the filename. '~' will be expanded if it is the first character of the filename. As for example, if the file name is ~/file, it will be expanded as your_home_directory/file. If the filename is ~someone/file, it will be expanded to the user "someone's" home directory. ~file will be saved as it is.

Quit
Exit the application.

Search Preferences
When this item is selected, a dialog will pop-up with many toggle options. By default, Yrolo searches the whole database during search operation. However, the search can be restricted by toggling the options in this dialog. Click on OK button when you are done. Search can be performed keeping this dialog up as well.

Card Info
When this item is selected, a dialog will pop-up with information about the loaded Yrolo database. If this dialog is up, the information will be updated with any changes in the database or with loading a new database.

About
When this help item is selected. A pop-up dialog will display the version number, author's email, URL etc.

Hints
When this help item is selected, a pop-up window will display concise hints about Yrolo and getting started.

Contextual Help
When this item is selected, the pointer will turn in to question, click on any visible item on the window to get help about that item. If no help is available, the pointer change back to normal..nothing will happen.

SEARCHING THE DATABASE
The loaded database can be searched by entering a string or a bunch of strings at the text widget located at the bottom left corner of the main window. After entering the string, hit the Return key. If there is a match, a dialog will pop-up with the card name/s that matched the search. Click on the item at the list to display the card at the main viewing area. By default, the whole database is searched. However, the search can be restricted to one or many fields by selecting the Search Preferences sub menu item from the File menu.

ADDING CARD
To add card to the database, click on the Add Card push button at the bottom of the window. When this button is licked, a window will pop-up. When the mouse is moved on that window, the very top text widget labeled Name will get the focus (provided you have the keyboard focus policy set to pointer for your window manger). Start entering data..you can go to the next item by hitting Return key or by clicking the left mouse button. You can fill up all or any item. When you are done, click on the Accept push button. A prompt dialog will request for the confirmation. The Accept button also can be activated from the Remarks text window by pressing the CTRL-D (Control+D) key combination.

EDITING CARD
The Edit Card push button gets sensitive after a card is being displayed by clicking on the name at the list widget. When this button is clicked, the pop-up window mentioned above will appear. All the steps are same as mentioned in the section ADDING CARD.

DELETE CARD
The Delete Card push button becomes sensitive after a rolodex card is being displayed by clicking on the name at the list widget. If this button is clicked, a warning dialog will ask for the confirmation.

WARNING: There is NO UNDELETE option at the time. DELETION WILL BE PERMANENT.

SENDING MAIL
The Send Mail push button becomes sensitive after a rolodex card is being displayed clicking on a name at the name list widget. When this button is clicked, a dialog will pop-up. The To: field get the focus by default. If the displayed card has a email address, the address will appear at the To: text widget. The address can be edited or many comma separated addressees can be added. Hit Return key to go to the next item.

The body of the mail is typed at the top scrolled window. Any text or binary file can be included by clicking on Include File push button. When the Include File push button is pressed, a file selection dialog box will request for the filename.

If the file is binary, it will be detected and automatically uuencoded before including.

If you have a .signature file at your home directory, you can sign the letter by clicking the Sign push button.

To send mail, click on the Send Mail push button or CTRL-D key combination while at the message editing window. A information message will be displayed at the bottom scrolled window after the mail is sent.

X RESOURCES
The appearance of Yrolo can be changed using the X Resource file. The default look and feel is chosen carefully using appropriate fallback resources. However if you insist to change the resources, please make sure that you do it right. The class of Yrolo is YRolo. So, the X Resources can be defined in a file called YRolo. The usual place to keep this file is /usr/lib/X11/app-defaults. If this file is kept there, resources will be loaded at the invocation. The resource file also can be kept at your home directory. It also can be added at the end of your .Xdefaults file. Again the environment variable XAPPLRESDIR can be set to define the location of the YRolo file. Note that X resources file takes precedence over hard coded resources, but the command line resource specification has the highest priority. Please look at the file YRolo.ad for available resources.

ENVIRONEMNT VARIABLES
    YROLODEX - name of the default database file.
    PRINT_COMMAND - name of the default print command.

BUGS
No known bugs. Please report bugs to muquit@semcor.com.

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.

AUTHORS
Muhammad A Muquit
SEMCOR, Inc.
Warminster Engineering Center
65 West Street Road, Suite C-100
Warminster, PA 18974
Voice: (215) 674-0200
Fax:   (215) 443-0474
E-mail: muquit@semcor.com