nHTTPd 1.1aRelease Date July 21, 1998Copyright 1998 Matthew Vaughn and Copyright 1995-1996 Ray RischpaterWhat is it?nHTTPd is a small web server based on a technical writeup Ray did for develop magazine in March 1997. In the form it was released in, nHTTPd was fairly non-functional, but after some tweaking of the publicly available source code, it is now capable of working with my Notepad Server CGP (included) to serve notes from your Newton OS Notepad. The original nHTTPd is released under Gnu Public License (see GPL.html) as will the source to this build when it is finalized but until then I will keep development of nHTTPd private. The terms and conditions for use of this software include all terms noted in GPL.html as well as the following:Disclaimer and License:1) Neither Matthew Vaughn nor Lightyear Media shall be held responsible for any corruption of data or damage to hardware caused by use of this free software.2) This software is provided free of charge for all educational, personal, and non-commercial uses. Any commercial use of this product should be approved by the author.3) You will not attempt to disassemble or reverse engineer this product. All development shall be executed solely by the author.4) As this is free software, you may not charge for it except to recoup cost of transmission or reproduction.5) This product may be included at will in any compilation of software, provided that the compilation is distributed according to item 2 and that the author, Matthew Vaughn, is notified of and assents to your intentions.6) As this is free software, technical support wil be provided at the author's discretion and may be denied without further explanation or obligation.7) By reading this document, you accept the terms of this license and all points of disclaimer. If you do not wish to do so, please refrain from installing this software on your Newton Device.Instructions:1) Install nHTTPd using your favorite package installer. Then, install any content generation plugins you have (ie Notepad Server or Agenda Server).2) Set up the content to be served as per instructions bundled with the content generation plugins.3) Establish a TCP/IP connection with nHHTPd by opening the application and tapping the 'Start' button.4) The current IP of your machine will be displayed beneath the Start/Stop buttons. This is the machine name for the URL you will enter in the WWW Client that will access your server.5) As pages are served, their names will appear in the monitor window, which is useful for debugging.6) Do not use any other TCP/IP applications (Eudora, Nethopper, etc) while running this server, as they will corrupt its connection, likely leading to you needing to reset your Newton device. For one exception, see Troubleshooting item 1.7) When you ar ready to quit, Tap the 'Stop' button and wait for the connection to terminate. DO NOT, I REPEAT, DO NOT tap the Close Box before stopping the connection or you will have to Reset your Newton device. This will be fixed in a subsequent release of nHTTPd. Troubleshooting:1) [Q] I have one internet connection. How can I serve pages to myself to test this out? [A] Good question. This is serious geek stuff here, so you may mot find it worthwhile. You have to realize that when you are running nHTTPd, it locks up the IP address that's assigned to it and guards it jealously. The way I did it was to run a virtual browser on another IP address. How? Start nHTTPd. Start PT100 (If you own it). Telnet to a UNIX machine where you have an account and can run the Lynx. (Along the way, you will get 3 errors from nHTTPd but just dismiss them and continue.) Under lynx, go to your server's URL and be amazed as your served data goes out to lynx (running on another IP address), then comes back down the pipe into your terminal emulator. and onto your screen. This is EXACTLY how I debugged the changes I made to the comms code of nHTTPd and Notepad Server in the final stages of their first development cycle.2) [Q] Can I hide nHTTPd? [A] Not yet. I tried to make it take up as little real estate as possible. The ability to hide will come in a subsequent release.Contact Information:Matthew VaughnLightyear Media, Ltd.1201 E Florida Avenue Suite 34AUrbana, IL 61801email: matvon@mad.scientist.comFax: (217) 337-4862