arena(1)

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: <[email protected]>.

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: <[email protected]>. Please send all control messages such as "subscribe" to the list manager.

AUTHORS

Dave Ragget

<[email protected]>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Raggett>

Hakon W Lie

<[email protected]>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Lie>

Henrik Frystyk Nielsen

<[email protected]>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Frystyk Nielsen>

Yves Lafon

<[email protected]>
<www.w3.org/pub/WWW/People/W3Cpeople.html#Lafon>

Coordinator

Yggdrasil Arena project coordinator is QingLong
<[email protected]>.

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.