(w3.info)Basic Setup


Next: Firewalls Prev: Compiling W3 Up: Setting Up

Basic Setup
===========

   There are a few variables that almost all people will need to change.

`w3-bad-port-list'
     List of ports to warn the user about connecting to.  Defaults to
     just the mail and NNTP ports so you cannot be tricked into sending
     fake mail or forging messages by a malicious HTML document.

`w3-be-asynchronous'
     Controls whether document retrievals over HTTP should be done in
     the background.  This allows you to keep working in other windows
     while large downloads occur.

`w3-confirmation-func'
     What function to use for asking yes or no functions.  Possible
     values are 'yes-or-no-p or 'y-or-n-p, or any function that takes a
     single argument (the prompt), and returns t only if a positive
     answer is gotten.

`w3-default-action'
     A lisp symbol specifying what action to take for files with
     extensions that are not in the w3-mime-extensions assoc list.
     This is useful in case you ever run across files with weird
     extensions (.foo, .README, .READMEFIRST, etc).  This should not be
     required anymore.

     Possible values: any lisp symbol.  Should be a function that takes
     no arguments.  The return value does not matter, it is ignored.
     Some examples are

          Action			Value
          ----------------------------------------------
          Parse as HTML		'w3-prepare-buffer
          View as text		'indented-text-mode

`w3-default-homepage'
     The url to open at startup.  It can be any valid URL.  This will
     default to the environment variable WWW_HOME if you do not set it
     in your .emacs file. If WWW_HOME is undefined, then it will
     default to the hypertext documentation for W3 at Indiana
     University.

`w3-delay-image-loads'
     Whether to delay loading inlined images.  If non-`nil', images are
     not loaded.  If you are on a slow network link, I would recommend
     setting this to `t'.

`w3-delimit-emphasis'
     Whether to use characters at the start and end of each bold/italic
     region.  Types of characters are specified in
     `w3-style-chars-assoc'.

`w3-delimit-links'
     Put brackets around links?  If this variable is eq to 'linkname,
     then it will put the link # in brackets after the link text.  If
     it is nil, then it will not put anything.  If it is non-nil and
     not eq to 'linkname, then it will put [[ & ]] around the entire
     text of the link.  Is initially set to be t iff in normal emacs.
     Nil if in epoch or lucid emacs, since links should be in different
     colors/fonts.

`w3-global-history-file'
     The global history file used by both Mosaic/X and W3.  This file
     contains a list of all the URLs you have visited.  This file is
     parsed at startup and used to provide URL completion.

`w3-hotlist-file'
     Hotlist filename.  This should be the name of a file that is
     stored in NCSA's Mosaic/X format (ncsa-mosaic-hotlist-format-1).
     It is used to keep a listing of commonly accessed URL's without
     having to go through 20 levels of menus to get to them.

`w3-personal-annotation-directory'
     Directory where w3 looks for personal annotations.  This is a
     directory that should hold the personal annotations stored in a
     Mosaic-compatible format.
     (ncsa-mosaic-personal-annotation-log-format-1)

`w3-personal-mail-address'
     Your full email address.  This is what is sent to HTTP/1.0 servers
     as the FROM field.  If not set when w3-do-setup is run, it
     defaults to `(user-real-login-name)'@`(system-name)', which can
     often be wrong.

`w3-right-border'
     Amount of space to leave on right margin of WWW buffers.  This
     amount is subtracted from `(window-width)' for each new WWW buffer
     and used as the new fill-column.

`w3-track-mouse'
     Whether to track the mouse and message the url under the mouse.
     This also changes the mouse cursor to be the cursor specified by
     w3-link-cursor.

`w3-use-forms-index'
     Non-nil means translate <ISINDEX> tags into a hypertext form.  A
     single text entry box will be drawn where the ISINDEX tag appears.
     If t, the isindex handling will be the same as Mosaic for X.

`w3-use-hypertext-gopher'
     Controls how gopher documents are retrieved.  If non-`nil', the
     gopher pages will be converted into HTML and parsed just like any
     other page.  If nil, the requests will be passed off to the
     `gopher.el' package by Scott Snyder.  Using the `gopher.el'
     package will lose the gopher+ support, and inlined searching.

`w3-wais-gateway-port'
     The port # of the WAIS gateway to pass all wais:// requests to.
     Note: Native WAIS Support

`w3-wais-gateway-server'
     The machine name where the WAIS gateway lives.  Note: Native WAIS
     Support

`w3-xterm-command'
     Command used to start an xterm window


automatically generated by info2www