[ Home Page ] [ Eiffel Archive ] [ Eiffel Applications ]

Arc de Triomphe clipart (2486 bytes)

Magic Browser


Conception and Design: Peter Ward
Design and Implementation: Roger Browne
Production: The Digital Window Ltd

gnu_magic.zip (2,148,320 bytes) — source code and binary
http://www.elj.com/elj/v1/n2/pw/ (Article in the Eiffel Liberty Journal)
http://www.digitalwindow.com/content/docs/downmb.htm (Magic Browser home page)
http://www.digitalwindow.com/content/docs/dwnws1.htm (Magic Browser announcement)
http://www.digitalwindow.com/ (The Digital Window Ltd home page)


What's Special about Magic Browser?

The Magic Browser application...

Using Magic Browser

Unzip "gnu_magic.zip" into any directory THAT HAS NO SPACES IN ITS PATHNAME, being sure to select the "Use Folder Names" option.

To run Magic Browser, double-click on magic.exe. Magic Browser starts by displaying the document index.htm or index.html from the current directory, so you can use it to view this documentation (click on the right-arrow button to turn the pages).

Magic Browser runs under Windows 95 and Windows NT 4.

Documentation

See the Documentation for:

The documentation is from the commercial version of Magic Browser, and refers to a few special features (such as embedding) which are not present in this Gnu-licensed release.

Compiling Magic Browser

From Visual Eiffel version 2.5, choose the menu option "Project | Open" and browse to project.esd in the dev subdirectory, then choose "Project | Rebuild All".

If you wish to change the resources compiled into the executable (such as the icon, cursor or button shapes) you will need to recompile the resource file. To do this, modify the file rescomp.bat in the resource directory to use your own resource compiler, then run this batch file.

Unless you wish to modify Magic Browser, you do not need to compile it yourself. A compiled executable is present in the top-level directory as magic.exe. This executable has been compressed using Shrinker 3.20, which reduces the size of the finalized executable from 547kB to 204kB.

If you test Magic Browser from within the Visual Eiffel development environment, you wil need to select "Debug | Options" and set the starting path to a directory containing a file called index.htm or index.html. Alternatively, from the same dialog box you can set the program arguments to the pathname of your HTML file.

The only aspect of Magic Browser which is incompatible with the Visual Eiffel debugger is its non-CGI executables feature, which causes lock-up unless run from outside Visual Eiffel.

Modifying Magic Browser

The code in Magic Browser is fast and reliable but - like the face of an adventurous person - it shows its life experience. A few parts will soon be getting close to "bursting their architectural seams", but luckily software is indeed soft and can be restructured.

The code in Magic Browser:

But don't let any of that put you off! These issues only affect a tiny proportion of the code. Most of the code is clean, robust, and very malleable. But do switch on assertion-monitoring if you modify Magic Browser - the source code is peppered with assertions which will often protect you from making inappropriate modifications.

Problems?

If you encounter a problem with Magic Browser, please first check the Eiffel Forum Archive Site (http://www.eiffel-forum.org/archive/) to see whether a later version is available, as your problem may have been resolved.

If you are already using the latest version, please report your problem to Roger Browne (roger@eiffel.tm), who will be happy to help if the problem is reproducible.

Copyright

Copyright (C) 1998 The Digital Window Ltd

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program in the file copying.txt; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

For Further Information

The Digital Window Ltd
Old Linen Court
83-85 Shambles Street
Barnsley, S. Yorks
S70 2SB
+44-1423-359120 voice
+44-1423-359120 fax
digitalwindow@dial.pipex.com
www.digitalwindow.com

The Digital Window Ltd can supply enhanced commercial versions of Magic Browser.


[ Home Page ] [ Eiffel Archive ] [ Eiffel Applications ]