5. Customizable variables

A lot of emacs-w3m variables are customizable via the Custom mechanism, a graphical Emacs interface to define user options. Custom offers several methods to define your customizations, you can use for example M-x customize-option for a single option (i.e. an Emacs Lisp variable) or M-x customize-group to see all available options (including variables and faces) for a “group” and change them; in which case the group to use is w3m.

Alternatively (if you don’t want to use Custom), you can put arbitrary Emacs Lisp expressions in your emacs-w3m initialization file, which is ‘~/.emacs-w3m’ by default. This example:

(setq w3m-home-page "http://emacs-w3m.namazu.org/")

would set the default homepage to http://emacs-w3m.namazu.org/. The syntax to use is the same as in your ‘~/.emacs’ file. See (emacs)Init File section ‘Init File’ in The Emacs Manual.

Please note that some variables from external modules could be undefined at the time the ‘~/.emacs-w3m’ file is loaded, thus making them impossible to modify (of course if you don’t care about the default value, you can override them completely in your ‘~/.emacs-w3m’) file. The w3m-search-engine-alist variable is a typical example (see section Variables related to searching the web).

w3m-init-file

When emacs-w3m starts, it will read the w3m-init-file file. The default value is ‘~/.emacs-w3m’. You probably don’t need to change this. This is a normal Emacs Lisp file and can be used to avoid cluttering your ‘~/.emacs’ and ‘site-init’ files with emacs-w3m stuff. Emacs-w3m will also check for files with the same names as this, but with ‘.elc’ and ‘.el’ extensions (in other words, ‘~/.emacs-w3m.elc’, ‘~/.emacs-w3m.el’ and ‘~/.emacs-w3m’, in this order).

This document was generated by TSUCHIYA Masatoshi on January 30, 2019 using texi2html 1.82.