OFFLINE BROWSER CONSTRUCTION KIT Binary Executable Version SI Software - http://www.sisoftware.com/browskit/browskit.htm info@sisoftware.com 1. OBJECTIVE 2. INSTALLATION AND OPERATION 3. TECHNICAL NOTES 4. ORDER INFORMATION 5. NOTES AND SAMPLE DOCUMENTATION FROM THE REGISTERED SOURCE CODE VERSION 6. LICENSE AGREEMENT 7. CONTACT AND ORDER INFORMATION *************************************************************************** 1. OBJECTIVE OFFLINE BROWSER CONSTRUCTION KIT unregistered binary executable version downloads files from WWW (World Wide Web) sites using an "agent" or "agenda" of URL's. (The registered version includes source code and documentation for http and ftp downloads as a tool to help programmers learn how to build their own personal or commercial offline browser. Other desirable features are layed out on the main screen but are not supported) *************************************************************************** 2. INSTALLATION AND OPERATING INSTRUCTIONS OFFLINE BROWSER CONSTRUCTION KIT EXECUTABLE BINARY VERSION 1. Unzip the file BROWSKIT.ZIP to a single directory 2. Create Program Group And Icons As You Desire 3. Use Text Editor or the program itself to create "agents" or "agendas" which are lists of URL's to visit, one on each line: EXAMPLE: http://www.techweb.com http://www.iworld.com http://www.boardwatch.com Save your "agent" as a text file with a ".NSF" file extension EXAMPLE: Save File As: zines.nsf 4. Click on nsurf.exe to run the program (or click on a .nsf agenda file you have created) (Please note that the screen is designed to support many features that are not offered in this program. The only feature that your unregistered version supports is download of selected WWW files. It's simple, but it works!) 5. Select File, Open to run one of the .NSF files you created OR: Click ADD button to create list of URL's to download 6. Click BEGIN DOWNLOAD button to begin the download process. The application will download the selected htm, gif or jpg files to the same directory and will create a clickable, browsable index page of the downloaded files named 2.HTM 7. Use any browser to view the index page named 2.HTM This page indexes and links to the locally downloaded files and indicates any files that failed to download. You can use your browser to directly view any of the saved files also. ********************************************************************** OPERATION This build can only download files from WWW sites, using HTTP (Hyper-Text Transfer Protocol). Using either a text editor or OFFLINE BROWSER CONSTRUCTION KIT itself, enter one or more WWW files for download. The format of the filenames is the same as you would enter the file into a browser, for example, http://www.netscape.com/index.html. You may enter any valid URL in the "agenda or agent", a text file with a .nsf extension, including .gif and .jpg files. Individual agent files cannot exceed 32K in size. A warning is displayed if a .nsf file exceeds this length. Click the "Begin Download" button to begin the download process. The application will download the pages and display "Agenda Completed" in the status bar when it is finished. OFFLINE BROWSER CONSTRUCTION KIT downloads the files to the current directory, creating an index at the same time. The index is named 2.htm. Open this file with any browser to access the list of links to the downloaded pages. Pages that failed to download are included in the list with an error message, and they are not linked to any downloaded file. Graphics within the web files are not automatically downloaded, although the individual URLs of these files may be entered in the agenda. The first time the program is run, it will register itself with Windows so that anytime a .nsf file is run, the application will automatically be called. By creating separate file folders with a .nsf agenda in each folder, you can keep your agendas separate from one another. ************************************************************************** 3. TECHNICAL NOTES The OFFLINE BROWSER CONSTRUCTION KIT 16 Bit application uses Windows Sockets (WINSOCK.DLL) for communicating with the Internet. A connection to the Internet is required before this program is executed. WINSOCK DLLs can vary from each vendor, although the program had no problems with any particular implementations of Windows Sockets so far. ************************************************************************** 4. ORDER REGISTERED SOURCE CODE VERSION TODAY BY PHONE, FAX, E-MAIL, MAIL USING ANY MAJOR CREDIT CARD: Item #:14788 - OFFLINE BROWSER CONSTRUCTION KIT - $30 Public Software Library - PsL P.O. Box 35705 Houston, TX 77235-5705 800-242-4775 713-524-6394 FAX - 713-524-6398 Compuserve E-Mail: 71355.470@compuserve.com "THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY. THE PUBLISHER OF THIS PROGRAM CANNOT BE REACHED FOR SALES AND TECHNICAL INFORMATION AT THESE NUMBERS" "Any questions about product or order status? Contact: info@sisoftware.com" **************************************************************************** 5. NOTES AND SAMPLE DOCUMENTATION FROM THE REGISTERED SOURCE CODE VERSION (YOU HAVE THE UNREGISTERED VERSION, BELOW ARE BRIEF NOTES AND A PREVIEW OF DOCUMENTATION ACCOMPANYING THE REGISTERED SOURCE CODE VERSION ) OFFLINE BROWSER CONSTRUCTION KIT is a 16-bit application written in Visual C++ version 1.52c. It uses Microsoft Foundation Classes, and makes use of two royalty-free, distributable .vbx files (Visual Basic controls) to implement the tabbed-dialog control in the lower portion of the application's main window. Here is a brief description of the project's files: Implementation of the "Add Agenda" dialog Implementation of the "Terms of License" dialog The CMainFrame class, derived from CFrameWnd The CNsurfApp application class, derived from CWinApp The CNsurfDoc document class, derived from CDocument The CNsurfView form class, derived from CFormView, and the CTabDlg dialog class, derived from CDialog The CSockWnd window class, derived from CWnd Standard MFC file for generating precompiled headers The CInternet class, derived from CSocket The Windows resource file License message that appears in "Terms of License" Windows module definition file Application icon Application toolbar images Windows 16-bit executable FarPoint "Imprint" VBX FarPoint "Tab" VBX The NSurf16 project makes use of MFC's Document/View architecture to facilitate reading and writing of the .nsf agenda files. The contents of the .nsf file is held in the CNsurfDoc member variable m_strAgenda. CNsurfView is the SDI dialog, associated with resource IDD_NSURF_FORM. This class is responsible for parsing the agenda file (using CNsurfDoc), managing internet connections (using CSockWnd), and saving the downloaded files. CNsurfView downloads as many as four files at a time by creating a CSockWnd for each file. CSockWnd uses the CInternet class to asynchronously download a file. When a file is successfully downloaded or fails download, CSockWnd notifies the CNsurfView window of the status, and the CSockWnd is destroyed. When a CSockWnd is finished downloading a file, the entire contents of the file remain in a buffer, which is transferred to a newly-created file. The file is named according to the original filename at the end of the URL. If the filename cannot be derived from the URL, a filename with a unique number is generated. In either case, the filename is added to the master contents file "2.htm". The asynchronous operation of OBKC is implemented using the OnIdle method... THE REGISTERED VERSION ALSO INCLUDES FTP EXECUTABLE AND SOURCE (which follows MFC) (Sample Of Documentation - Please Order Registered Version For Complete Source Code And Documentation - ORDER INSTRUCTIONS ARE FOUND ON FOLLOWING PAGES) ********************************************************************************** 6. LICENSE AGREEMENT - Before you can use this product, you must accept the following license agreement by reading it and then choosing Agree. If you do not accept the terms of this agreement, choose DECLINE and exit program. BEFORE YOU CLICK ON THE "ACCEPT" BUTTON AT THE END OF THIS DOCUMENT, CAREFULLY READ THE TERMS AND CONDITIONS OF THIS AGREEMENT. BY CLICKING ON THE "ACCEPT" BUTTON, YOU ARE CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, CLICK THE "DECLINE" BUTTON AND DO NOT USE THE SOFTWARE. 1. SI Software grants to you a non-exclusive, non-transferable, non-sublicensable, license to use this unregistered binary executable version of the SI Software OFFLINE BROWSER CONSTRUCTION KIT (the "Software"), in binary executable form, according to the terms and conditions set forth below. You are not entitled to hard-copy documentation, support or telephone assistance. You may copy and distribute the Software free of charge to anyone via the Internet or any online service, or internally within your company or organization, but only in the form and configuration originally downloaded to you from SI Software without modification of any kind (including this document), and not for payment or compensation of any kind. Except as specifically described in this License, you may not transfer, rent, lease, lend, copy, modify, translate, sublicense, time-share, electronically transmit or receive the Software. If you find the Software useful and find that you are using the Software and continue to use it after a reasonable trial period, you must make a registration payment of $30 to SI Software. The $30 registration fee will entitle you to (1) licensed source code version of the Software for use on any one computer at any one time. 2. SI Software MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THIS SOFTWARE OR ABOUT ANY CONTENT OR INFORMATION MADE ACCESSIBLE BY THE SOFTWARE, FOR ANY PURPOSE. THE SOFTWARE IS PROVIDED 'AS IS' WITHOUT EXPRESS OR IMPLIED WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. THIS SOFTWARE IS PROVIDED GRATUITOUSLY AND, ACCORDINGLY, SI Software SHALL NOT BE LIABLE UNDER ANY THEORY FOR ANY DAMAGES SUFFERED BY YOU OR ANY USER OF THE SOFTWARE. SI Software WILL NOT SUPPORT THIS SOFTWARE AND WILL ISSUE UPDATES TO THIS SOFTWARE IN ITS SOLE AND ABSOLUTE DISCRETION. YOU ASSUME ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU AND NOT SI Software ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING OR REPAIR. SI Software does not warrant that the operation of the Software will be uninterrupted or error free or that the Software will meet your specific requirements. Good data processing procedure dictates that any program bethoroughly tested with non-critical data before relying on it. The user must assume the entire risk of using the program. SOME STATES OR OTHER JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSIONS MAY NOT APPLY TO YOU. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY FROM STATE TO STATE AND JURISDICTION TO JURISDICTION. 3. All content accessed through the Software is the property of the applicable content owner and may be protected by applicable copyright law. This License gives you no rights to such content. 4. While SI Software intends to distribute a source-code version of the Software, SI Software reserves the right at any time not to release a source-code version of the Software or, if released, to alter prices, features, specifications, capabilities, functions, licensing terms, release dates, general availability or other characteristics of the source-code version. 5. This license is not a sale. Title, ownership rights, and intellectual property rights in and to the Software and any copy made by you shall remain in SI Software and/or its suppliers. You agree to abide by the copyright law and all other applicable laws of the United States including, but not limited to, export control laws. You acknowledge that the Software in source code form remains a confidential trade secret of SI Software and/or its suppliers until you register and purchase the source code version and agree to it's License Agreement Terms. Therefore you agree not to modify the Software or attempt to decipher, decompile, disassemble or reverse engineer the Software, except to the extent applicable laws specifically prohibit such restriction. Failure to comply with the above restrictions will result in automatic termination of this license and will make available to SI Software other legal remedies. 6. SI Software may terminate this License at any time by delivering notice to you and you may terminate this License at any time by destroying or erasing your copy of the Software. In the event of termination, the following sections of this License will survive: 2,3, 4, 5, 6, 7, 8. This License is personal to you and you agree not to assign your rights herein. This License shall be governed by and construed in accordance with the laws of the State of Illinois without reference to conflicts of laws or the 1980 U.N. Convention on Contracts for the International Sale of Goods and, as to matters affecting copyrights, trademarks and patents, by U.S. federal law. This License sets forth the entire agreement between you and SI Software. 7. SI Software OR ITS SUPPLIERS SHALL NOT BE LIABLE FOR (a) INCIDENTAL, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INDIRECT DAMAGES OF ANY SORT, WHETHER ARISING IN TORT, CONTRACT OR OTHERWISE, EVEN IF SI Software HAS BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES, OR (b) FOR ANY CLAIM BY ANY OTHER PARTY. THIS LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY TO THE EXTENT APPLICABLE LAW PROHIBITS SUCH LIMITATION. FURTHERMORE, SOME STATES OR OTHER JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS LIMITATION AND EXCLUSION MAY NOT APPLY TO YOU. 8. The parties hereto confirm that it is their wish that this License, as well as other documents relating hereto, have been and shall be written in the English language only. Les parties aux présentes confirment leur volonté que cette convention de même que tous les documents y compris tout avis qui s'y rattache, soient rédigés en langue anglaise. This License is the entire agreement between us and supersedes any other communications or advertising with respect to the Software. If any provision of this License is held invalid or unenforceable, such provision shall be revised to the extent necessary to cure the invalidity or unenforceability, and the remainder of this License shall continue in full force and effect. In the event of any conflict between any provision of this License and any applicable law, the provision or provisions of this License affected shall be modified to remove such conflict and permit compliance with such law and as so modified this License shall continue in full force and effect. All SI Software product names are trademarks or registered trademarks of SI Software Development Inc. If you have any questions, please contact SI Software at the following e-mail address: info@sisoftware.com. ### ACCEPTANCE OR NONACCEPTANCE OF THIS AGREEMENT: INDICATE YOUR ACCEPTANCE OR NONACCEPTANCE BY CLICKING THE APPROPRIATE BOX. ************************************************************************************** 7. SI SOFTWARE http://www.sisoftware.com/browskit/browskit.htm info@sisoftware.com OFFLINE BROWSER CONSTRUCTION KIT - EXECUTABLE BINARY VERSION ORDER INFORMATION FOR REGISTERED SOURCE CODE VERSION THANK YOU FOR TRYING OFFLINE BROWSER CONSTRUCTION KIT This is an unregistered, fully functional, executable-only version of the OFFLINE BROWSER CONSTRUCTION KIT and does not contain the documentation and source code included in the registration version. The functionality is the same as the registration version - it enables you to download files from WWW sites using HTTP and view them using a browser. This application is shareware. If you like the executable binary version of Offline Browser Construction Kit, PLEASE REGISTER TODAY TO ORDER THE DOCUMENTED SOURCE CODE VERSION. This version includes $10,000 worth of source code and documentation (on file downloads from WWW and FTP) for the shareware price of $30! Order today and learn how to construct your own offline browser program using straightforward Microsoft Foundation Class architecture. ORDER REGISTERED SOURCE CODE VERSION TODAY BY PHONE, FAX, E-MAIL, MAIL USING ANY MAJOR CREDIT CARD: Item #:14788 - OFFLINE BROWSER CONSTRUCTION KIT - $30 Public Software Library - PsL P.O. Box 35705 Houston, TX 77235-5705 800-242-4775 713-524-6394 FAX - 713-524-6398 Compuserve E-Mail: 71355.470@compuserve.com "THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY. THE PUBLISHER OF THIS PROGRAM CANNOT BE REACHED FOR SALES AND TECHNICAL INFORMATION AT THESE NUMBERS" "Any questions about product or order status? Contact: info@sisoftware.com" "PsL will notify us the day of your order and we will contact you via e-mail or phone for prompt download or delivery information" OFFLINE BROWSER CONSTRUCTION KIT software and documentation are copyright 1996 by SI Software info@sisoftare.com http://www.sisoftware.com/browskit/browskit.htm ************************************************************************************