Notepad 48 v1.2b Front End for TED Library 1212 By Eric Rechlin rechlin@btigate.com rechlin@sendit.nodak.edu ================================================================================ INTRODUCTION Notepad 48 is a front end for the TED editor which has a graphical menu to select files to open, delete, transfer to another calculator or computer, and more. For convenience, all files created in Notepad 48 are saved in one file--data.npx--which is stored in port 0. ================================================================================ INSTALLING THE LIBRARY You must first have a working copy of TED installed. This also requires the Universal Font Library (UFL). TED can be obtained from: http://www.hut.fi/~mheiskan/ and UFL can be obtained from: http://www.engr.uvic.ca/~aschoorl/ufl/ Or, go to my HP48 Archive site at http://hp48.ml.org to download these or many more programs. Now you may install the Notepad 48 library as you would any other library: 1. Send NP48.LIB to your calculator in binary mode. 2. Press the softkey corresponding to the variable in which NP48 is stored (NP48.LIB). 3. Enter the port number you want NP48 installed to. This is usually 0. 4. Turn your HP off and then back on again. 5. NP48 is now installed and in your library menu, attached to the HOME directory. ================================================================================ USING THE LIBRARY Notepad 48 1.2 creates a file named DATA.NPX in port 0. This file stores everything that is typed and saved in Notepad 48 1.2. This way, Notepad 48 1.2 can be run from any directory and will still get its data. Notepad 48 1.0, aka Notepad 48 Light, creates a variable named DATA.NPX in the current directory. Because this variable stores everything that is typed and saved in Notepad 48, it is recommended that you always run Notepad 48 1.0 from the same directory. To do this, I created a variable with the contents: << NP48 >> in the folder that I always run Notepad 48 (NP48) from. When you run NP48, an opening screen comes up with a menu of the most used options. They are NEW, OPEN, DEL, REN, and EXIT, to create a new file, open and edit an existing file, delete an existing file, rename an existing file, and to exit NP48, respectively. You may also exit Notepad 48 by pressing Backspace or ON/CANCEL/ATTN. Pressing NXT will display a second menu with I/O options. They are IR TX, IR RX, BCKUP, REST, and EXIT, to transfer a file over infrared, to receive a file over infrared, to backup the entire data file via a wire to a computer running the Kermit protocol, to append a backup file to your current data file over a wire from a computer running the Kermit protocol, and to exit NP48, respectively. When you choose NEW, you will be presented with a screen to choose a name of the file. The name may have spaces, and about anything else since it is stored as a string. After entering the name, TED will load with an empty document. You may now enter text. When you are done, turn off Alpha mode and press Enter. This will quit TED, save the file, and return you to the main menu. Choosing OPEN will bring up a menu to select which file to edit. After selecting a file and pressing ENTER, TED will load with that data file. TED operates exactly the same as explained above. Choosing DEL will bring up a menu to select which file to delete. After selecting a file and pressing ENTER, the file will be deleted. Note that there is no confirmation when deleting! Choosing REN will bring up a menu to select which file to rename. After selecting a file and pressing ENTER, a screen like what is shown when creating a new file is displayed. It allows you to change the old name to whatever you want. Press ENTER when you are done to save the new name. On the second menu, choosing IR TX will allow you to choose a file to send, and then it will send it via infrared to another HP48 running NP48. The file will be appended to the other HP's data file. Choosing IR RX will receive a file from another HP48 running NP48, as explained above. Choosing BCKUP will send the entire data file over the wire to a computer set to receive a file with the Kermit protocol. It will be saved as DATAFILE.NPX, but you may rename it whatever you want. This can be used for backing up your NP48 text files to your computer. Choosing REST will receive a file over the wire from a computer using the Kermit protocol. It will append the data to the end of the current data file. This can either be used to receive an NP48 backup file (see above) or to transfer a standard text file from your PC to NP48. To transfer text files from your PC to NP48, add the following five lines to the top of the text document so they will view properly: %%HP: T(3); { C$ 8 Document C$ $ Change the word "Document" to whatever you want the title to be in NP48, and change the number 8 to the number of characters in the title. You may want to set the word wrap in the text to 33 characters first, so you don't have to do any horizontal scrolling in TED/NP48. Choosing EXIT on either menu will, well, you know what it does. ================================================================================ REMOVING THE LIBRARY To remove NP48 (although I don't see why you would want to, except to install a new version if I ever upgrade this), enter a tagged object with the port number you stored it in and the library number of NP48 (1212), like this, for example: :0:1212 Press ENTER again to duplicate it, then type DETACH and then PURGE. NP48 should now be deleted (but then I can shoot you for removing my great program!). ================================================================================ KNOWN BUGS There is one known bug in Notepad 48, but it's not completely NP48's fault. When running NP48 with HPSauce 2.2 or Java 3.0 (not sure about older versions, but it works fine with HPSauce 1.0), after quitting NP48, the softkeys on the bottom of the screen will not reappear. To make them show up, press any key. I have found one work-around for this bug. Just create a variable with the contents: << NP48 #386A1h SYSEVAL >> If you run NP48 by calling this variable instead of directly running NP48, the screen will be redrawn after you quit and everything should be okay. Please note that I have only tested this SYSEVAL on a Revision R calculator. If you enter the number incorrectly, or if you have a different ROM revision, you stand a chance at clearing your memory. So double-check the SYSEVAL and back up your memory before running it! ================================================================================ VERSION HISTORY 1.2b Updated documentation to explain how to work around the only known bug. 1.2a Updated documentation to explain how to transfer text files from the PC to the HP. Repackaged source code in ASCII format rather than binary for easy editing on a PC. 1.2 Fixed most bugs (the only known one is listed above). Now stores DATA.NPX in Port 0. First major release. 1.1 Never released to the public. Added I/O functions, but had a couple nasty bugs. 1.0 Initial release. Only released to the public as a part of the 1.2 package. Tested by several friends. ================================================================================ OTHER INFORMATION I also am including NP48.DIR with this distribution. It is the UserRPL source code, ready to be converted to a library, so you can edit it to replace every occurence of TED to Edit or whatever stringwriter you prefer to use. It isn't commented, but all you need to do is look for the text TED in the variables EDIT.NPX and NEW.NPX (if I remember right). It is included in ASCII format, so you can easily edit it on your PC. Also included is NP48 1.0, aka NP48 Light, in both library and directory formats, which doesn't include I/O functionality or support for the CANCEL key to quit. I included it because it is 1.65k smaller (3.15k instead of 4.80k) for people who are low on memory. Its file names are NP48LGT.DIR and NP48LGT.LIB. ================================================================================ 'PRICING' INFORMATION This program is 'emailware'. If you like it, simply email me to tell me. This will encourage me to continue to write more software, and maybe to convert this to SysRPL, if I ever learn it. ================================================================================ DISCLAIMER / LEGAL STUFF THIS PROGRAM IS PROVIDED "AS IS" AND IS SUBJECT TO CHANGE WITHOUT NOTICE. NO WARRANTY OF ANY KIND IS MADE WITH REGARD TO THE SOFTWARE OR DOCUMENTATION. THE AUTHOR SHALL NOT BE LIABLE FOR ANY INCIDENTAL ERROR OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE SOFTWARE AND/OR THE DOCUMENTATION. PERMISSION TO FREELY DISTRIBUTE THIS SOFTWARE IS GRANTED PROVIDED THIS MANUAL IS DISTRIBUTED WITH IT WITHOUT ANY MODIFICATION. THIS PROGRAM CAN'T BE USED FOR ANY COMMERCIAL PURPOSE WITHOUT WRITTEN PERMISSION FROM THE AUTHOR. THIS IMPLIES THE USER SHOULD NOT BE CHARGED FOR THE USE OF THIS PROGRAM IN ANY WAY. This program has been tested on an HP48GX revision M, P, and R and hasn't caused any problems. However, as with any other program, you are strongly encouraged to BACK UP YOUR MEMORY before installing this, just in case you have a problem. This program will not run on an HP48SX due to its use of the CHOOSE command. ================================================================================ Eric Rechlin February 10th, 1998 http://rechlin.ml.org rechlin@btigate.com rechlin@sendit.nodak.edu (at least one of those addresses should work for a few more years)