SIGREADER Version 1.0 Files Included: SIGREADR.CH -- SIGREADER include file. SIGREADR.OBJ -- SIGREADER obj for linking.. SIGRDRGR.OBJ -- SIGREADER obj for linking utilizing Grumpfish functions. README.TXT -- you're reading it. ORDER.TXT -- Order file for registering. SIGREADER is written by Stan Grossman Copyright 1994 SIG Software 9074 Andromeda Drive Burke, VA 22015-3510 CIS# 72624,3050 SOFTWARE LICENSE SIGREADER is not and has never been public domain software, nor is it free software. Non-licensed users are granted a limited license to use SIGREADER on a 30-day trial basis for the purpose of determining whether SIGREADER is suitable for their needs. The use of SIGREADER, except for the initial 30-day trial, requires registration. The use of unlicensed copies of SIGREADER by any person, business, corporation, government agency or any other entity is strictly prohibited. A single user license permits a user to use SIGREADER only on a single computer. Licensed users may use the program on different computers, but may not use the program on more than one computer at the same time. Licensed users may distribute this library only in the form of compiled code included in their applications. No one may modify or patch the SIGREADER executable files in any way, including but not limited to decompiling, disassembling, or otherwise reverse engineering the program. A limited license is granted to copy and distribute SIGREADER only for the trial use of others, subject to the above limitations, and also the following: 1) SIGREADER must be copied in unmodified form, complete with the file containing this license information and only the following SIGREADER files: SIGREADR.CH, SIGREADR.OBJ, SIGRDRGR.OBJ, ORDER.TXT and README.TXT. You may NOT distribute the SIGREADER registration ID. 2) The full machine-readable SIGREADER documentation must be included with each copy. 3) No fee, charge, or other compensation may be requested or accepted, except as authorized below: A) Operators of electronic bulletin board systems (sysops) may make SIGREADER available for downloading only as long as the above conditions are met. An overall or time-dependent charge for the use of the bulletin board system is permitted as long as there is not a specific charge for the download of SIGREADER. B) Vendors of user-supported or shareware software may distribute SIGREADER, subject to the above conditions, without specific permission. Vendors may charge a disk duplication and handling fee, which, when pro-rated to the SIGREADER product, may not exceed five dollars. C) Non-profit user groups may distribute SIGREADER, subject to the above conditions, without specific permission. Non-profit user groups may charge a disk duplication fee, which, when pro- rated to the SIGREADER product, may not exceed five dollars. LIMITED WARRANTY EXCEPT AS PROVIDED ABOVE, SIG SOFTWARE DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT. SHOULD THE PROGRAM PROVE DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES. IN NO EVENT WILL SIG SOFTWARE BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE INABILITY TO USE THIS PRODUCT EVEN IF SIG SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Use of this product for any period of time constitutes your acceptance of this agreement and subjects you to its contents. U.S. GOVERNMENT RESTRICTED RIGHTS Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227- 7013. Contractor/manufacturer is SIG Software. USERS GUIDE ___________ SIGREADER has ben written in native Clipper code. It may be overlayed. Simply add an: #include "sigreadr.ch" statement in .PRG using SIGREADER constructs and add either SIGREADR.OBJ or SIGRDRGR.OBJ to your FILE list. SIGREADR.OBJ contains standard Clipper code and memo functions and may be used in any Clipper application. SIGRDRGR.OBJ contains a modified version of Grumpfish's POPNOTE function. It is called GETNOTE and uses memo or character fields/variables instead of a text file. In order to use SIGRDRGR.OBJ, you must already own a copy of the Grumpfish Library because the GETNOTE function calls several Grump functions; it will only work if the Grumpfish Library is also linked in. These constructs may be used just like any native SAY/GET statement if the SIGREADER has been linked in. @ , SIGGET RIGHT [PICTURE ] [VALID ] [WHEN ] [MESSAGE ] [COLOR ] This command right justifies data as it is entered. This is helpful for entering ID numbers to get " 12" instead of "12 " which keeps indexes straight. The must be of character type, all other clauses are standard Clipper. @ , SIGGET LOGICAL [WHEN ] [VALID ] [COLOR ] This command causes a logical to be displayed as "Yes" or "No". It takes standard input (either Y/N or T/F) but displays "Yes" or "No". must be a logical type. Obviously, the validation is inherent in the field type, but I have included a VALID clause so that you can branch to a function and do somethiong when this field loses focus. @ , SIGSAY MEMO , [COLOR ] @ , SIGGET MEMO , [COLOR ] [WHEN ] [NOSTAMP] These two commands display or display/get a memo/char variable. The memo is displayed for of length. A SIGSAY...MEMO will append an ellipse (...) at the end of the last line if the memo continues for more lines than shown. The SIGGET...MEMO will automatically time stamp each entry; if this is not desired include the NOSTAMP clause. The memo field will be displayed and encountered just like any other get however to exit the SIGGET...MEMO you must type a ^W or ESC key (or the equivalent). This wil only exit the get not close the screen (it eats the key stroke). This command makes handling memos as easy as any other field -- no more special keys and function keys.