← Back to branch summary

~ubuntu-branches/ubuntu/karmic/rxvt-unicode/karmic

« back to all changes in this revision

Viewing changes to README.FAQ

  • Committer: Bazaar Package Importer
  • Author(s): Decklin Foster
  • Date: 2007-08-03 12:44:44 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20070803124444-uwmus5csvd7rm4fp
Tags: 8.3-1
http://bugs.debian.org/433004
http://bugs.debian.org/422540
http://bugs.debian.org/428659
http://bugs.debian.org/411074
http://bugs.debian.org/415848
http://bugs.debian.org/415846
http://bugs.debian.org/381967
* New upstream release (Closes: #433004)
  - Rolled with autoconf 2.61 (Closes: #422540)
* Match https URLs in selection-popup (Closes: #428659)
* Fix typos in urxvtperl(3) (Closes: #411074, #415848)
* Use sensible-browser instead of x-www-browser directly (Closes: #415846)
* Added urxvtcd as alternative (Closes: #381967)

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.FAQ
44
44
    Try "urxvtd -f -o", which tells urxvtd to open the display, create the
45
45
    listening socket and then fork.
46
46
 
47
 
   How can I start urxvtd automatically when I run URXVT_NAME@@c?
 
47
   How can I start urxvtd automatically when I run urxvtc?
48
48
    If you want to start urxvtd automatically whenever you run urxvtc and
49
49
    the daemon isn't running yet, use this script:
50
50
 
92
92
 
93
93
   How do I compile the manual pages on my own?
94
94
    You need to have a recent version of perl installed as /usr/bin/perl,
95
 
    one that comes with pod2man, pod2text and pod2html. Then go to the doc
96
 
    subdirectory and enter "make alldoc".
 
95
    one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml).
 
96
    Then go to the doc subdirectory and enter "make alldoc".
97
97
 
98
98
   Isn't rxvt-unicode supposed to be small? Don't all those features bloat?
99
99
    I often get asked about this, and I think, no, they didn't cause extra
503
503
    two standard values that can be used for Backspace: "^H" and "^?".
504
504
 
505
505
    Historically, either value is correct, but rxvt-unicode adopts the
506
 
    debian policy of using "^?" when unsure, because it's the one only only
 
506
    debian policy of using "^?" when unsure, because it's the one and only
507
507
    correct choice :).
508
508
 
509
509
    Rxvt-unicode tries to inherit the current stty settings and uses the
882
882
    is subtly garbled, then you should check your locale settings.
883
883
 
884
884
    Rxvt-unicode must be started with the same "LC_CTYPE" setting as the
885
 
    programs. Often rxvt-unicode is started in the "C" locale, while the
886
 
    login script running within the rxvt-unicode window changes the locale
887
 
    to something else, e.g. "en_GB.UTF-8". Needless to say, this is not
888
 
    going to work.
 
885
    programs running in it. Often rxvt-unicode is started in the "C" locale,
 
886
    while the login script running within the rxvt-unicode window changes
 
887
    the locale to something else, e.g. "en_GB.UTF-8". Needless to say, this
 
888
    is not going to work, and is the most common cause for problems.
889
889
 
890
890
    The best thing is to fix your startup environment, as you will likely
891
891
    run into other problems. If nothing works you can try this in your
892
892
    .profile.
893
893
 
894
 
      printf '\33]701;%s\007' "$LC_CTYPE"
 
894
      printf '\33]701;%s\007' "$LC_CTYPE"   # $LANG or $LC_ALL are worth a try, too
895
895
 
896
896
    If this doesn't work, then maybe you use a "LC_CTYPE" specification not
897
897
    supported on your systems. Some systems have a "locale" command which
1061
1061
    main(), or things like the dynamic loader of your system, which should
1062
1062
    result in very little risk.
1063
1063
 
1064
 
   On Solaris 9, many line-drawing characters are too wide.
1065
 
    Seems to be a known bug, read
1066
 
    <http://nixdoc.net/files/forum/about34198.html>. Some people use the
1067
 
    following ugly workaround to get non-double-wide-characters working:
1068
 
 
1069
 
       #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
1070
 
 
1071
1064
   I am on FreeBSD and rxvt-unicode does not seem to work at all.
1072
1065
    Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in
1073
1066
    your compile environment, or an implementation that implements it,
1099
1092
    system libraries once and for all, instead of forcing every app to carry
1100
1093
    complete replacements for them :)
1101
1094
 
1102
 
   I use Solaris 9 and it doesn't compile/work/etc.
1103
 
    Try the diff in doc/solaris9.patch as a base. It fixes the worst
1104
 
    problems with "wcwidth" and a compile problem.
1105
 
 
1106
1095
   How can I use rxvt-unicode under cygwin?
1107
1096
    rxvt-unicode should compile and run out of the box on cygwin, using the
1108
1097
    X11 libraries that come with cygwin. libW11 emulation is no longer
1115
1104
    multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
1116
1105
    likely limited to 8-bit encodings.
1117
1106
 
 
1107
   Character widths are not correct.
 
1108
    urxvt uses the system wcwidth function to know the information about the
 
1109
    width of characters, so on systems with incorrect locale data you will
 
1110
    likely get bad results. Two notorious examples are Solaris 9, where
 
1111
    single-width characters like U+2514 are reported as double-width, and
 
1112
    Darwin 8, where combining chars are reported having width 1.
 
1113
 
 
1114
    The solution is to upgrade your system or switch to a better one. A
 
1115
    possibly working workaround is to use a wcwidth implementation like
 
1116
 
 
1117
    http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
 
1118