H T M L v i e w

Version 1.0
Copyright (c) 1996, JMA Software Technologies

HTMLview is a program that lets you surf the net and view HTML pages.

HTMLview is a faster way of viewing HTML and URL:s than WebExplorer. It does most of the things that WebExplorer does and works both on- and off-line. It has many features that WebExplorer has not. If you are used to work with WebExplorer you will soon be used to work with HTMLview. Most menu-item and keyboard shortcut are similar to or the same as in WebExplorer.

Don't forget to read the Tips, tricks and limitations chapter in this manual since it contains information you might miss otherwise.

Table of content

Requirements
Installation
How to start HTMLview
The menu bar
The button bar
The edit bar
The status bar
About the settings notebook
Using the QuickList
The QuickList file
Tips, tricks and limitations
Files
How to contact us
Disclaimer, license information

Requirements

HTMLview requires IBM OS/2 Warp 3 or Warp 4.
HTMLview also requires IBM TCP/IP (via LAN or Dialup) with WebExplorer 1.03 or later.

Back to table of content

Installation

Installation instructions

-	Run the installation program (INSTALL.EXE).
-	or,
-	Copy the files (HTMLview.EXE, HTMLview.HTM) to a directory of your choice.
-	Create desktop icons with program references for HTMLview.EXE.
	DO NOT drag the icons representing the executables from the file system (Drives window).
-	You may create several program references with different URL:s as parameters.
	Many copies of HTMLview may run at the same time.

Registration

-	Get your registration key (see REGISTER.TXT).
-	Start HTMLview and and select the Options->Register menu item.
-	Enter your name and the register code.
-	Click on OK.

Please note that the registration is saved in the .INI file. If you lose the INI file you must re-enter your registration information. The registration is per copy and it is illegal to use the same registration on different machines.

Please note that support is only available to registered users.

If you are interested in site licenses or customized versions of HTMLview please contact us for further information.

Uninstalling

-	Delete both program reference icons and all files in the installation catalog.
	You may want to keep the QuickList file (QUIKLIST.TXT).

Note: HTMLview does not make any changes to system files CONFIG.SYS and OS2.INI.

Back to table of content

How to start HTMLview

Start the program HTMLview.EXE or start the WPS program reference. You may put this program (its program reference, or a shadow of the .EXE file) in the startup folder if you wish. The first time you start the program you should go to the Options -> Setting menu and set at least your homepage and email address.

Please note that the unregistered version runs only 15 minutes at a time.

You may enter a URL as parameter to the program. Please note that .HTML files need no be prefixed with file:/// but URL:s must be prefixed with http:// or ftp:// when specifying a parameter.

HTMLview will create the .INI file in the directory where it is placed. The file will be found even if start HTMLview from another directory. (The default name of the .INI file is HTMLview.INI).

Items added to the QuickList will be saved in a file called QUIKLIST.TXT, this one also in the .EXE directory. You may edit this file but you MUST comply to the general structure or HTMLview might not start.

NOTE: If you are unhappy with the name of the .EXE or the .INI file you may rename the .EXE to another name (for example HV.EXE). Upon starting this "new" .EXE file a new .INI file will be created with the same name as the .EXE file. If you are a registered user you must either rename your old .INI file or re-enter your registration key.

Back to table of content

The menu bar

*File menu*
Open file	Allows you to select a HTML file to open.	(Ctrl-O)
Reload document (URL)	Reloads current document.	(F5)
Save as	Allows you to save the current document as a HTML file.	(F2)
Save file	Generates a filename and saves current document (as HTML).	(F4)
Print document	Allows you to print the current document.
Halt loading document	Stop loading the current document.	(Esc)
Exit program	Leaves HTMLview	(F3)
*Navigate menu*
Backward	Go to previous viewed document.	(Ctrl-P)
Forward	Go to next viewed document.	(Ctrl-N)
Home page	Load homepage specified in Options -> Settings notebook.	(Ctrl-H)
Find in Document	Allows you to search the current document for a specified string.	(Ctrl-S)
Presentation mode	Hides all frame controls and toolbars and maximizes the window.	(Ctrl-P)
Send mail	Allow you to send mail using a mailto: form.
Set keyboard focus	Use this if you cannot use the keyboard to scroll.
	If you start HTMLview without focus (ex. START HTMLview) this menuitem must be used.
*Options menu*
Font	Lets you select the size of the viewing font.
	This does not update the File->Save settings selection.
Beep when loaded	Select if you want HTMLview beep when a document has been loaded.
Load Graphics	Select if you want HTMLview to load graphics.
Register	Registers your HTMLview license.
Set current page as homepage	Sets the current document as your homepage.
Settings	Gives you a notebook box with settings.
	Selections are saved into your .INI file and get reloaded each time you restart HTMLview. Please see "About the settings notebook" for more information on this.
Save window settings	Saves the current window position
	Save the main window and QuickList position, font and colors. Restores them the next time you start HTMLview.
*QuickList menu*
Show document	Loads the document accosiated with the selected QuickList item.
Add current document	Adds current document to QuickList.	(Ctrl-A)
Add manually	Allows you to add a QuickList item via a dialog.
Edit	Edit the selected QuickList item.
Delete	Delete the selected QuickList item.
Sort	Allows you to sort the QuickList.
Show QuickList	Shows (or hides) the QuickList.	(Ctrl-Q)
Import QuickList from WebExplorer	Imports QuickList items from WebExplorer.
Create Webmap (.HTM) file	Creates WEBMAP.HTM with all your QuickList items as links.
Save QuickList to disk	Updates QuickList file on disk.
	This is done automaticly when you exit HTMLview.
*Help menu*
Online help	Shows this document.	(F1)
Product Information	Gives product information.
	Shows version, copyright information, where to find us and version of WebExplorer DLL and .INI file.

Back to table of content

The button bar

The button bar contains 15 button that mimics menu items. They "gray out" when the function they represent is not available and gets highlighted when a function is "on". They are:

-	Navigate -> Backward
-	Navigate -> Forward
-	Navigate -> Home page
-	Navigate -> Find in document
-	File -> Reload document (URL)
-	File -> Halt loading document
-	QuickList -> Add current document
-	File -> Open file
-	File -> Save as
-	File -> Save to disk
-	File -> Print document
-	QuickList -> Show QuickList
-	Options -> Load graphics
-	Switches between the four font sizes (Small, Normal, Large, Extra large)
-	Navigate -> Send mail

Back to table of content

The edit bar

The edit bar is an edit field where you can enter the name of a URL. It is also updated each time you try to reach a link. Even if the link is not fully loaded the text of the link will still be there.

The edit bar is also a combination box where you find a list of all visited links (during this session). Press the down button on the right of the edit bar and then select the link you want to go to.

There is a maximum of 200 items in this list.

Back to table of content

The status bar

The status bar gives information when loading a URL with status information and the name of the link currently under the mouse pointer.

When loading an URL the status bar changes to reflect the current status. It shows the amount loaded (in percent) of the document text and the status of the graphics load threads.

During the download of a file the statusbar gives you information regarding the status of the download. If the server supports file size information you will see information regarding file size and percentage/time left. If your server does not support this you will only see bytes loaded and CPS rate.

When printing the status bar show a static text and the document windows is disabled. This is to prevent errors in printing.

In the rightmost part of the status bar you will see status indicators that shows the settings of Font size, Loading of graphics and Beep at load.

Back to table of content

About the settings notebook

The settings notebook allows you to change the permanent settings. Selecting OK writes these to the .INI file at ones. It also update the non-permanent settings for this session.

Note: Some settings requires you to restart the program for them to take effect (They are noted with the (*) sign).

*PAGE 1 - General/cache*
Show QuickList	Default setting to show or not show the QuickList window.
Beep when page is loaded	Default beep or not beep when page is loaded.
Number of threads	Number of threads used (helps speed but uses memory).
Use working dir	Reuses last directory in File -> Open file / Save as.
Load from	Default directory for File -> Open file.
Save to	Default directory for File -> Save as, Save to disk and downloads.
Enable caching	Allow program to cache pages/graphics.
Keep cached images in memory	Keep images in memory (or on disk).
Number of pages to cache	Documents to "remember".
Number of images to cache	Images to "remember".
Cache dir	Where place cached pages/images.
*PAGE 2 - Addresses*
Home page	Document to load at startup and with Navigate -> Home page.
Load homepage at startup	Load at startup or not.
Proxy gateway	Name of proxy gateway.
Use proxy	Use proxy gateway.
Socks server	Name of sockets server.
Use socks	Use sockets server.
email address	Your email address (used on mailto:s).
News server	Name of your news server.
*PAGE 3 - Color/fonts*
Text	Text color.
Links	Color of links.
Visited links	Color of links you have already visited.
Background	Background color of document (when no background bitmap).
	(Select color by first clicking on item to change and then click on the desired color.)
Change font	Select font to use in document.
Default font size	Set default font size.
*PAGE 4 - Display*
Use palette managment	Use OS/2 palette management or not.
Prefer internal viewer	Use internal viewer if one is available.
Underline links	Underline all links.
Load graphics	Default load graphics state (load or not).
Preview documents before images	Display all document text before graphics.
Ignore image errors	Do/do not display red X over not loaded images.
Display interlaced GIF:s	How to display them while loading.
*PAGE 5 - Viewers*
	Gives you a list of defined viewers. Here you can remove viewers by selection the viewer to remove and press the Remove button or add a new viewer by filling in the fields and pressing the Add button. You may browse for the .EXE file (the viewer) using the Browse button.

Back to table of content

Using the QuickList

The QuickList is a place where you place your most often visited links. Its shown as a "listbox-style" window at the right of your document.

Though its originally invisible it can easily be shown using the QuickList -> Show QuickList menu item or the corresponding button in the button bar. You may also select a default state using the Options -> Settings notebook, Show Quicklist (first page).

To see the URL click ones on the QuickList item and then look at the status bar. To load a link double-click on the QuickList item.

You add links to the QuickList either by selection the Add current document menu item (shortcut Ctrl-A) or the corresponding button on the button bar. You may also with a right-click on the QuickList window select the Add manually item (where you then type in the required information).

To change the amount of space the QuickList occupies place your mouse button on the splitbar (situated between the document-window and the QuickList) and press and hold your mouse button. Now drag the splitbar to the new preferred position and drop it there (release the mouse button). To save the new position select the Options -> Save window settings menu item.

Please note that if unregistered the QuickList may contain no more than five items.

To change the color and font of the QuickList window use the Color and Font palettes of the OS/2 System Setup folder. Just drag and drop the font / color you like (to change text color drag with Ctrl pressed) and then select the Options -> Save window settings menu item to save them.

The context menu (right-click on the QuickList window) contains the following items:

-	Show document, Same as doubleclicking on a item in the QuickList.
-	Add current document, Add current document to QuickList.
-	Add manually, allows you to manually add a QuickList item.
-	Edit, allows you to edit a QuickList item.
-	Delete, allows you to remove a QuickList item.
-	Sort QuickList, same as QuickList -> Sort QuickList
-	Save QuickList to disk now, same as QuickList -> Save QuickList to disk now
-	Hide QuickList, same as the QuickList -> Show QuickList menu item.
-	Create Webmap (.HTM) file, also under QuickList -> Create Webmap (.HTM) file. from QuickList.

Every time HTMLview starts it loads the QuickList into memory and every time you quit HTMLview its saves the content of the QuickList to the QuickList file. If you want to save it while running the program you can select the QuickList -> Save QuickList to disk now menu item. This menu item is also available in the context menu on the QuickList window.

Back to table of content

The QuickList file

You may edit the QuickList file (QUIKLIST.TXT) outside of HTMLview (its a pure text file) but you must follow these guidelines otherwise HTMLview might not load.
The first line in the file is a numeral that specifies the number of title / URL pairs in the file. This numeral must be correct. Following is title/URL pairs. The title may be up to 80 characters and the URL up to 128. They must be placed on one line each.

You may NOT have any blank lines in the QuickList file.

Back to table of content

Tips, tricks and limitations

Tips and tricks

To load a link while a page is loading just click on that link !
If a link cannot be reached the text is still in the edit bar for you to edit
To save the document as a URL object drag it to the desktop (or any folder) with the right mouse button pressed. If you wish to save the document as a HTML file then drag with the Ctrl key pressed.
Press the right mouse button on top of the QuickList window to get the context menu.
The button that switches between font sizes works even when you are loading a webpage.
Drag/drop fonts/color from the Color/Font palette in your System Setup folder and drop them on the QuickList window. Select Options -> Save window setting to save them. To change the text color drag a color with the Ctrl key pressed.
If you prefer loading speed to functionality/stability then install WebExplorer 1.03 instead of an later version.

Known problems

HTMLview uses the same set of programming API as WebExplorer does. However, some features used in WebExplorer are NOT documented by IBM and therefore we have not been able to use them. We are constantly trying to work around these problems and also try to make IBM understand that they should make these functions available to us and others.

The following cannot be done since IBM has not released the specifications on how to do it:

When moving backward/forward through visited pages you will always be placed at the top of a visited page even if you had previously scrolled down. This problem does not exist in WebExplorer.
To be able to use news we must be able to get/set the news settings. This API (wxViewQueryNewsOpts and wxViewSetNewsOpts) is not documented by IBM.
To use JAVA we must be able to get/set the news settings. The wxView*Java* API is not documented by IBM. There is no officially released version of WebExplorer with Java support.
Codepage support (wxViewCallLoadCP) is not documented.
The Warp 4 link top level menu item is not documented and does not work by itself. However the links popup menu works as they should in HTMLview.
In WebExplorer you may press Enter to activate the tag in a form (CGI) document. This does not work in HTMLview and is probably a undocumented feature.
Do not run HTMLview (or WebExplorer) with Neologic Network Suite. There is a incompatibility that makes one of them to use up all CPU. Do NOT run them at the same time!

There are also a few minor problem with HTLMview that might not have anything to do with the WebExp API:

When you change the graphics on/off settings notebook the document will not redraw to that setting. Press F5 and the document will use the setting.

Back to table of content

Files

The main file (HVMLview.EXE) creates a .INI file with its current settings in the same directory as the .EXE file.

This .INI file is NOT dependent of the drive/directory and can easily be transferred with the .EXE file to any drive/directory. The QuickList file (QUIKLIST.TXT) may be transferred in the same way.

Please note that the directory where the .EXE file resides in must not be write protected.

Back to table of content

How to contact us

Please do not hesitate to contact us at any of the following:

Our homepage

http://home1.swipnet.se/~w-13247/

Technical support, technical questions

Lennart Carlson (mail@jmast.se)

Please note that support is only available to registered users.

General questions

Martin Alfredsson (jma@jmast.se)

Our mail address

JMA Software Technologies
P.O Box 2345
SE-403 15 GOTHENBURG
SWEDEN

Our fax

46-(0)31-195260

Back to table of content

Disclaimer

Software
HTMLview is not free software. Unregistered versions of HTMLview may not be used for more than 30 days.

Unregistered versions of HTMLview may be distributed to remote FTP or networked sites without the explicit written permission of the JMA Software Technologies. Distributed versions of HTMLview must contain the entire unmodified distribution. JMA Software Technologies is not responsible for modifications made to the distribution without the explicit written permission of JMA Software Technologies.

Registered versions of HTMLview may not be distributed in any form for any reason.

Use
You, the site or licensed individual, may use one copy of the software product specified above ("Software") on a single computer. You may use the Software on a network provided you have licensed Software equal to the maximum number of copies in use at one time. The Software is "in use" on a computer when it is resident in memory (i.e., RAM) or installed (executable and other files) on the hard disk or other storage device. Software installed on a server for distribution purposes only is not considered "in use." The Software may not be used beyond the licensing period.

Restrictions
You may not alter, merge, modify or adapt this Software in any way including disassembling or decompiling. You may not loan, rent, lease, license, or distribute this Software or any copy. You may not transfer the Software, license, documentation, media, or copies.

Copyright
All intellectual property rights in this Software and user documentation are owned by JMA Software Technologies and are protected by copyright laws, other applicable copyright laws, and international treaty provisions. JMA Software Technologies retains all rights not expressly granted.

Limited Warranty
JMA Software Technologies makes no warranty or representation, promise or guarantee, either express or implied, statutory or otherwise, with respect to this Software or user documentation, including its quality, performance, merchantability, or fitness for a particular purpose.

The warranty and remedies set forth herein are exclusive and in lieu of all other, oral or written, express or implied. No Software dealer, distributor, agent or employee is authorized to make any modifications or additions to this warranty.

Limitation of Liability
Because software is inherently complex and may not be completely free of errors, you are advised to verify your work and to make backup copies of your work. In no event will JMA Software Technologies be liable for direct, indirect, special, incidental, economic, cover, or consequential damages arising out of the use of or inability to use the Software or user documentation, even if advised of the possibility of such damages. In no case shall JMA Software Technologies liabilities exceed the total sum of the Software and licensing agreement.

JMA Software Technologies is not liable for the usage of the Software. JMA Software Technologies is not liable or responsible for information, data, documents, or images retrieved, generated, stored, copied, or traversed that have copyright or are proprietary, pornographic, restricted and otherwise illegal. All ownership and rights to retrieved, generated, stored, copied, and traversed materials are retained by their original owners, unless otherwise explicitly stated.

Back to table of content

This document was written with HTMLedit by Martin Alfredsson and was last updated November 1, 1996.

H T M L v i e w

Version 1.0 Copyright (c) 1996, JMA Software Technologies

Table of content

Requirements

Installation

Installation instructions

Registration

Uninstalling

How to start HTMLview

The menu bar

File menu

Navigate menu

Options menu

QuickList menu

Help menu

The button bar

The edit bar

The status bar

About the settings notebook

PAGE 1 - General/cache

PAGE 2 - Addresses

PAGE 3 - Color/fonts

PAGE 4 - Display

PAGE 5 - Viewers

Using the QuickList

The QuickList file

Tips, tricks and limitations

Tips and tricks

Known problems

Files

How to contact us

Our homepage

Technical support, technical questions

General questions

Our mail address

Our fax

Disclaimer

Version 1.0
Copyright (c) 1996, JMA Software Technologies