distribution-README.end 5.5 KB
Newer Older
1
2
3
4
5
6
2.2 After installing

    After installing you can set Emacs to load LysKOM automatically.

    1. Set up autoloading by adding the following line to your .emacs
       or any other file that Emacs loads at startup (such as
7
       ~/.emacs, site-start.el or default.el):
8
9
10
11
12
13
14
15

            (autoload 'lyskom "lyskom" "Start LysKOM" t)

    2. If you have your own LysKOM server you may want to modify the
       variable kom-server-aliases. The best place to change it is in
       your site init file (default.el or site-start.el). For example,
       if you are running a server on kom.domain.org, you might want
       to say something like this in your init file:
16

17
18
19
            (defvar kom-server-aliases 
                    '(("kom.domain.org     . "DomainKOM")
                      ("kom.lysator.liu.se . "LysKOM")))
20

21
22
23
24
25
26
27
28
29
30
31
32
       The first server listed in kom-server-aliases will be the
       default server for new users.

    3. Restart Emacs. You should be able to use the command lyskom
       (M-x l y s k o m RET) to start the client. Enjoy!


3.  Reporting bugs

    Before reporting a bug, please check that it is not one of the
    known issues below. Please report bugs by posting them to the
    bugzilla at http://bugzilla.lysator.liu.se/. You can also e-mail
33
34
    bug reports to bug-lyskom@lysator.liu.se if you are unable or
    unwilling to use bugzilla.
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

    To evaluate your bug report we need the following information:

    o   The LysKOM version you are using. This is shown when you start
        LysKOM and is also contained in the variable
        lyskom-clientversion.

    o   The symptoms of the bug. Please be as detailed as possible.
        Please do not try to make conclusions. Just give us the facts.

    o   How you triggered the bug. If you know how to reproduce it,
        please tell us. We're pretty good at fixing bugs we can
        reproduce.

    o   How you started Emacs, what variables you have changed and
        which packages you have loaded. If possible, try to reproduce
        the bug with Emacs started with the -q command line switch.

    The command kom-bug-report may come in handy. It gives us a lot of
    information that you might not think of (such as what the internal
    data structures look like). If you post a bug report to our
    bugzilla, please make the result of kom-bug-report an attachment
    to your bug report.


4. Known issues

62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
   Issue:  Cannot enter conference names containing international
           characters.

   Reason: You may be using a different character coding from the
           server, and conversion to the server's coding is not
           working. For example, many versions of Emacs are unable to
           convert from iso-8859-15 (latin-9) to iso-8859-1 (latin-1)
           even though most characters are the same.

           Switching to the character coding used by the server by
           using set-language-environment (probably to Latin-1) will
           fix this problem. If you are unwilling to do this, you can
           try loading the ucs-tables Emacs library (a version of this
           file is available from <URL:http://www.lysator.liu.se/
           lyskom/klienter/emacslisp/>).


   Issue:  Problems displaying many normal-looking texts.

   Reason: Recent versions of some Linux distributions encourage users
           to use the latin9 language environment, which results in
           texts coded using iso-8859-15. If you do not have fonts
           suitable for displaying this character coding you may
           experience some problems with such texts. To fix this
           problem, install fonts suitable for displaying iso-8859-15
           characters. You may also be able to fix it by loading
           either the ucs-tables or the latin-unity Emacs library
           (a version of ucs-tables is available from <URL:http://www.
           lysator.liu.se/lyskom/klienter/emacslisp/> and latin-unity
           is available from the XEmacs package system).


   Issue:  I see \201 before international characters in the string
           showing what some other user is doing (e.g. L\201äser).
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

   Reason: The user is probably using an old version of the client in
           a new version of Emacs. You can confirm this by using the
           command kom-list-clients (Lista klienter, List clients).


   Issue:  I get the message "Key sequence < m o u s e - 2 > uses
           invalid prefix characters" when I load lyskom.elc.

   Reason: You have a file named macedit.el or macedit.elc installed.
           Remove this file.


   Issue:  Columns containing Swedish characters or characters in
           numeric representation are not aligned correctly.

   Reason: This happens in certain versions of Emacs when running
           without multi-byte character support and is due to bugs in
           Emacs. The only workaround is to either upgrade Emacs or
           enable multi-byte character support.


   Issue:  Swedish characters show up as blanks, question marks or
           numbers.

   Reason: If Swedish characters show up as blanks your font probably
           does not support them. If they show up as question marks or
123
124
           numbers your language environment does not support them or
           you are lacking the fonts to display them.
125
126
127
128
129
130
131

           Make sure that your language environment is set correctly
           with set-language-environment. Just setting the environment
           variable LC_CTYPE to the proper value (iso_8859_1 is
           usually correct) should be enough.

           Do not use standard-display-european to fix this problem.