arena

Section: User Commands (1)
Arena Index
Return to Main Contents (man2html)

NAME

Arena - X11 based WWW Browser

SYNOPSIS

arena [ [-badflags #] [--maximum-badflags #] [-[no]cache path] [--[no]persistent-cache [path]] [-color] [-color8] [--color (true|dither|mono|grey)] [-[no]cm] [--[no]color-map] [-ct N] [-debug] [--debug [trace-value]] [-display X11_Display] [--display X11_Display] [-editor editor_cmd] [--edit cmd] [-email address] [--e-mail-address address] [--fontsize (large|giant)] [-gamma correction] [--gamma correction] [-geometry +X+Y] [--geometry +X+Y] [-giant] [-grey] [-help|--help] [-icon file.gif] [--application-icon file.gif] [-large] [-lt W3C-Flags] [--libwww-trace [W3C-Flags]] [-lens factor] [--magstep factor] [--magnification factor] [-nomailcap] [--no-mailcap] [-mono] [-printer print_cmd] [--print-command cmd] [--scrollbar-thickness pixels] [-nostyle] [--no-style-sheets] [-noterminal] [--no-terminal] [-url URL] [--url URL] [--usage] [--version] [URL] ]

DESCRIPTION

Arena is an X11 graphical web browser comprised entirely of free software. Its origins predate proprietary packages such as Netscape Navigator, and Mosaic.

COMMANDLINE OPTIONS

-badflags max_bad_flags, --maximum-badflags #: Sets the maximum number of HTML bad flags to be reported when editing a document. Bad flags appear as comments in the HTML source. The default is 5, the absolute maximum is 50.
-nocache, --no-persistent-cache: Turns client side file caching off.
-cache dir, --persistent-cache dir: Set the cache directory path. The default is ~/.Arena/cache/ File caching is not yet "actually" persistent.
-cm, --color-map: Use a separate colormap. This avoids Arena going into grayscale mode when other applications are hogging the colours.
-color: Use true colour mode.
-color8: Use 232 dither mode.
--color (true|dither|mono|grey): Specifies the type of color setup you wish Arena to run with.
-ct debug_level, --debug debug_level: Set the value of the debug level. Arena allows the selection of which modules will output debugging messages.
-debug, --debug: Turns on verbose debugging modes. All modules will report and some modules will give very detailed messages.
-display X11_display, --display X11_display: Open Arena on a display different from DISPLAY environment variable.
-editor editor_command, --edit cmd: Sets the editor command to be used, .e.g. "xterm -e vi". The value of the EDITOR environment variable is used by default. When you have finished editing the temporary file that is created, save the file and exit the editor. Arena will then display your edited document. Your changes will NOT affect the original document unless you specifically use the editor to "save as" and overwrite the original document.
-email return_address, --e-mail-address address: Specifies your email address. Arena will build an email address for you by using USER@FQDN. If you cannot receive mail at that address, you must specify it yourself.
-gamma gamma_correction, --gamma correction: Set the gamma correction factor.
-geometry +X+Y, --geometry +X+Y: Allows the specification of X11 geometry for Arena at startup.
-giant: Use giant font sizes.
--fontsize (large|giant): Specify the basic font size to be used.
-grey: Grayscale mode.
-help, --help: Displays a slightly more detailed list of Arena options than --usage.
-icon filespec.gif, --application-icon filespec.gif: Replace default icon in upper right corner of the Arena window. A file or URL pointing to a gif immage can be specified.
-lt W3C-Flags, --libwww-trace W3C-Flags: Specifies the W3C library tracing specification.
-large: Use large font sizes.
-lens XFactor, --magstep XFactor, --magnification XFactor: Sets the magnification factor which is used to calculate the correct font size.
-nomailcap, --no-mailcap: Do NOT load any mailcap files.
-mono: Use monochrome display.
-printer print_command, --print-command cmd: Set the printer command, e.g. "lpr -Plp1". At the moment Arena can only print the HTML source.
--scrollbar-thickness pixels: Specify the thickness of the scrollbars in pixels.
-nostyle, --no-style: Do NOT take the <STYLE> tag into account when rendering pages.
-noterminal, --no-terminal: Undocumented option.
--usage: Displays basic command line usage with available options.
-v, --version: Basic output of current running version of Arena.
[-url URL], [--url URL], [URL]: The initial URL to open. Arena will use the WWW_HOME environment varialbe unless specified on the command line.

TOOLBAR ICONS

All toolbar button text labels seem to be quite self explanatory. HINT: Your mouse has 3 buttons.

Quit: Exit Arena... closing all URL connections and cleaning up temporary files and caching directories.
Home: Go to the home web page or default URL.
Open: Allows you to enter a URL specification to be opened.
Back / Reload / Forward: This single button allows you to move through the history list. The left mouse button will go back to the previous document. The middle button will reload the current document. The right button will move to the next document in the history.
SaveAs...: Save the current document to disk. You must then specify the file specification to be used.
View: Toggle viewing HTML source/formatted.
Edit: Causes the external editor specified via the --edit-command command line switch to be used on the current document. Upon return, Arena will redisplay your edited document. Your original document is not altered, unless you used the editor to overwrite it.
Print: Print the current document. At this time, this means just raw text output. You must specify a --print-command.
Zoom In / Out: The left mouse button will redisplay the current document with enlarged fonts. The right button will redisplay with reduced fonts. You may zoom in/out more than once.
BookMarks Folder / Index / Add: The left mouse button will open the default bookmark folder. The middle button will display the bookmark folders index. When you select one of the folders, it will then become the current default folder. The right button will mark the current document URL in the current default bookmark folder.
Help: Will open a default Arena Help Page currently located at Yggdrasil.com
Abort: Abort the current requested URL.

URL MOUSE BUTTONS

Left button follows the anchor specified. Middle button show the URL of the targetted anchor. Right button pops up the History List.

HISTORY LIST

Arena keeps a current history list. By pressing the third (right) mouse button, you may select the URL from the popup menu.

INITIALIZATION

Arena gets its initial options from /usr/share/Arena/arenarc (this location is system and/or administrator dependent), then ~/.Arena/arenarc, then .XDefaults, and lastly your command line options. The same option may be specified in each location. The closer to the user, the more influence the option setting has.

At the moment, any GNU style option may be specified within each of the arenarc files. However, .XDefaults are only available for a very limited set.

BUGS

There are many...
Please report them to the Arena developers mailing list: <arena-developers@yggdrasil.com>.

Information on subscribing to either list is available by sending an email message with "help" in the body of the message to the mailing list processor: <petidomo@yggdrasil.com>. Please send all control messages such as "subscribe" to the list manager.

AUTHORS

Dave Ragget: <dsr@w3.org>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Raggett>
Hakon W Lie: <howcome@w3.org>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Lie>
Henrik Frystyk Nielsen: <frystyk@w3.org>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Frystyk Nielsen>
Yves Lafon: <lafon@w3.org>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Lafon>
Coordinator: Yggdrasil Arena project coordinator is QingLong
<qinglong@yggdrasil.com>.

HISTORY

Arena has been originally created and been developed by the W3 Corporation as a testbed browser for (currently) obsolete HTML3.0 standard. Original Arena source code has been covered by a standard W3C copyright. In late 1996 it has been given to Yggdrasil Computing Inc. and all further changes made by Yggdrasil are covered by GNU GPL.

This document was created by man2html, using the manual pages.
Time: 23:52:51 GMT, September 18, 1997