doc/faq.txt

   1 Frequently Asked Questions
   2 --------------------------
   3 :Description:   FAQ for the ELinks project
   4
   5 This is an attempt to capture some of the questions that appear once in a
   6 while on the mailing list or on IRC.
   7
   8
   9 [[instances]]
  10 I rebuilt/upgraded/reconfigured ELinks and restarted it, but it looks like nothing has changed!
  11 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12
  13 ELinks instances connect together so that they share the cache, bookmarks,
  14 cookies, configuration, etc.  Only the "master" ELinks instance does any real
  15 work and any other ELinkses you run will only connect to this instance.  So when
  16 you want to restart ELinks, make sure you have no other ELinks instances
  17 running.
  18
  19 Alternatively, you can use the `-no-connect` parameter to make ELinks always run
  20 standalone, or create a parallel group of ELinks instances with the
  21 `-session-ring N` parameter (where `N` is a number larger than zero).  Be aware
  22 of that in those cases ELinks won't touch any configuration, bookmark, cookies,
  23 etc. files.  You can force that with the `-touch-files` parameter, but beware
  24 that this can result in data loss!  (For example, when two master ELinks
  25 instances try to save the bookmarks, and you add a bookmark to each of those,
  26 only one of the bookmarks survives.)
  27
  28
  29 [[cutnpaste]]
  30 How does cutting and pasting work?
  31 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32
  33 The reason why normal cut and paste does not work is that ELinks requests all
  34 mouse event info even if it is compiled without GPM.  Therefore it is necessary
  35 to hold down the Shift key when cutting or pasting text.  If you do not need to
  36 use the mouse for navigation you can disable mouse support by passing
  37 `\--disable-mouse` to configure.
  38
  39
  40 [[move]]
  41 How does the "Move" button on the bookmark manager work?
  42 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43
  44 First you need to mark all the bookmarks (or folders) you want to move.  This
  45 can be done with the Insert key if you're using the default key-bindings.  An
  46 asterisk will appear near all marked bookmarks.  Now move to where you want to
  47 have the stuff moved to, and press the "Move" button.
  48
  49
  50 [[navigation]]
  51 What's up with the navigation in the various managers?
  52 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  53
  54 The managers use list boxes.  To navigate (assuming you're using a default
  55 key-binding configuration) use Space to open and close the folders.
  56
  57
  58 [[flavors]]
  59 Why are there so many Links flavors?
  60 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61
  62 Please refer to the link:http://elinks.cz/history.html[history page] to read
  63 about the various flavors and the differences between them.
  64
  65
  66 [[which-one]]
  67 Which one to use?
  68 ~~~~~~~~~~~~~~~~~
  69
  70 If you want a fast, stable, and feature-thin text browser, use
  71 link:http://artax.karlin.mff.cuni.cz/~mikulas/links[Links-0.99].  Main drawbacks
  72 include: No HTTP-auth support and no persistent cookies (i.e. they die when all
  73 instances of Links are closed).
  74
  75 If you want additional features, including HTTP-auth, persistent cookies, and
  76 on-the-fly compression, try ELinks.  (Note: links-0.9x and ELinks versions >
  77 0.3 do not share executable name or configuration files so you can safely run
  78 these on the same machine.)
  79
  80 If you want the option of graphics mode, use
  81 link:http://links.twibright.com[Links2] or
  82 link:http://xray.sai.msu.ru/~karpov/links-hacked/[Hacked Links].  Be aware that
  83 some people have reported the latter as hard to configure/compile.  You cannot
  84 run either of these with Links-0.9x on the same system without hacking the
  85 compile-time configuration.
  86
  87
  88 [[kibi-and-mebi]]
  89 What are the Ki (kibi) and Mi (mebi) units?
  90 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  91
  92 They are binary units defined by
  93 link:http://physics.nist.gov/cuu/Units/binary.html[the International System of Units].
  94 Examples:
  95
  96 `---------------`--------------------------------------------------------------
  97 Unit            Definition
  98 -------------------------------------------------------------------------------
  99 One kibibit     1 Kibit = 2^10 bit = 1024 bit
 100 One mebibyte    1 MiB = 2^20 B = 1 048 576 B
 101 -------------------------------------------------------------------------------
 102
 103
 104 [[get-256-colours]]
 105 How can I get 256 colors?
 106 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 107
 108 First, you must enable it in the `feature.conf` file before compiling.
 109
 110 Second, you must run ELinks on a terminal that supports 256 colours:
 111
 112  - link:http://dickey.his.com/xterm/xterm.html[Thomas Dickey's XTerm],
 113    revision 111. XTerm must be compiled with `\--enable-256-color`.
 114
 115  - Recent versions of
 116    link:http://www.chiark.greenend.org.uk/~sgtatham/putty/[PuTTY].
 117
 118 Third, you must set the `TERM` environmental variable to `xterm-256color`
 119 before running ELinks.
 120
 121 [NOTE]
 122 .Only 16 colors on The Linux console
 123 ===============================================================================
 124 Although the Linux frame-buffer supports 256 (or more) colors, the Linux console
 125 driver does not; therefore, console applications are still limited to 16
 126 colors on the Linux console, frame-buffer or not.
 127 ===============================================================================
 128
 129
 130 [[useragent]]
 131 What User-Agent header does ELinks send?
 132 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 133
 134 The older ELinks versions (up to 0.4.3) send:
 135
 136         ELinks ($version; $osinfo; $textmode_dimensions)
 137
 138 The new ELinks versions (from 0.9.0 on) send:
 139
 140         ELinks/$version (textmode; $osinfo; $textmode_dimensions)
 141
 142 You should therefore check against something like /^ELinks[\/ ]/, since more
 143 fields can be added inside the parenthesis in subsequent versions.  Note that
 144 users can change their User-Agent through the options system.
 145
 146
 147 [[droppings]]
 148 ELinks doesn't erase characters from the screen when it should!
 149 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 150
 151 When you scroll a web page, you may see ELinks leave some characters
 152 on the screen even though it should have erased them.  Pressing Ctrl+L
 153 usually removes these droppings until you scroll again.  There are
 154 a few possible reasons:
 155
 156 - ELinks 0.11.* in a UTF-8 locale.  By default, ELinks guesses the
 157   charset of the terminal from the environment variables LANG,
 158   LC_CTYPE, and LC_ALL.  ELinks 0.11 versions do not support UTF-8
 159   as this charset.  To use ELinks 0.11 on a UTF-8 terminal, you
 160   should instead enable UTF-8 I/O via the Setup -> Terminal options
 161   dialog box, and choose a charset from Setup -> Character set.
 162   This limitation has been removed in ELinks 0.12pre1.
 163
 164 - Web pages may use nonspacing combining characters or Unicode control
 165   characters that ELinks does not recognize as such.  This happens
 166   especially on http://en.wikipedia.org/wiki/Special:RecentChanges[],
 167   where the server generates U+200E LEFT-TO-RIGHT MARK characters.
 168   ELinks 0.13.GIT now has some support for these characters; see
 169   http://bugzilla.elinks.cz/show_bug.cgi?id=824[ELinks bug 824].
 170
 171 - Some versions of the Terminal application in Mac OS X appear to
 172   have a setting that makes line-drawing characters take up the
 173   space of two ASCII letters.  ELinks does not expect this.
 174   To avoid the incompatibility, either disable the setting in the
 175   Terminal application or select "No frames" in the Terminal options
 176   dialog box of ELinks.