--- name: "arena" section: "1" platform: "linux" package: "arena" version: "1:0.3.62-1" release: "Debian 2.2 (Potato)" platforms: ["linux"] url: "https://new.carta.tech/arena" --- # arena(1) X11 based WWW Browser ## 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 \ 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: **\**.\ \ 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: **\**. Please send all control messages such as "subscribe" to the list manager. ## AUTHORS - *Dave Ragget* \\ \ - *Hakon W Lie* \\ \ - *Henrik Frystyk Nielsen* \\ \ - *Yves Lafon* \\ \ - *Coordinator* Yggdrasil *Arena* project coordinator is *QingLong*\ \. ## 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**.