gaim/www

this is a little better.

2005-12-23, Luke Schierer
9c8a28fbf047
Parents 8263e55695fe
Children 60beebe9d6f7
this is a little better.
  • +97 -146
    htdocs/faq2.txt
  • --- a/htdocs/faq2.txt Wed Dec 21 17:38:01 2005 -0500
    +++ b/htdocs/faq2.txt Fri Dec 23 11:05:44 2005 -0500
    @@ -169,8 +169,6 @@
    related to encryption.
    </li>
    <li>If you use 0.75 or higher on win32, try deleting <code>tcl.dll</code>.</li>
    - <li>If you have ever installed 0.65, edit your <code>~/.gaimrc</code>, changing your auto away
    - preference from -1 to 0.</li>
    </ul>
    !ANCHOR cvs
    @@ -256,27 +254,28 @@
    Q: How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol?
    A: Use the Account Editor (Accounts-&gt;Add/Edit) to add the account of
    -the appropriate messaging service. Use the checkbox in the
    -account editor to enable the account.
    +the appropriate messaging service. Use the checkbox in the account editor to
    +enable the account.
    Q: How do I use Google Talk?
    A: Create a Jabber account as per <a
    href="http://www.google.com/support/talk/bin/answer.py?answer=24073">Google's
    FAQ</a>. The Audio component is not currently supported and will not be
    -until 1)the protocol is published and 2)<a href="http://gaim-vv.sf.net">Gaim-vv</a> is ready for
    -mainstream use.
    +until 1)the protocol is published and
    +2)<a href="http://gaim-vv.sf.net">Gaim-vv</a> is ready for mainstream use.
    Q: How do I change the font Gaim uses? The empty left padding? The
    background color?
    A: The font preference in Gaim is used only for the formatting of outgoing
    messages. The display fonts used by the rest of Gaim are those specified
    -by GTK+. To change this font you need to edit your <code>~/.gtkrc-2.0</code> file.
    -If you need help you can see our example <a href="./gtkrc-2.0"><code>.gtkrc-2.0</code></a>
    -file. On Windows, this file is located at <code>C:\Documents and
    -Settings\username\.themes\Default\gtk-2.0\gtkrc</code>. If the file does
    -not exist, create it.
    +by GTK+. To change this font you need to edit your <code>~/.gtkrc-2.0</code>
    +file. If you need help you can see our example
    +<a href="./gtkrc-2.0"><code>.gtkrc-2.0</code></a> file. On Windows, this file
    +is located at <code>C:\Documents and
    +Settings\username\.themes\Default\gtk-2.0\gtkrc</code>. If the file does not
    +exist, create it.
    <p>
    You can also just switch to a different GTK+ theme. You can find GTK+ themes
    (and information on using them) by visiting
    @@ -302,8 +301,8 @@
    people to use Ctrl-Enter to send but to also allow people to use anything else
    they felt like and to reduce the clutter in the User Interface. The gtk
    interface is, unfortunately, not as immediately obvious as a simple checkbox,
    -however it is still simple. The example gtkrc file seen <a href="./gtkrc-2.0">here</a>
    -shows you how to do it (among other things).
    +however it is still simple. The example gtkrc file seen
    +<a href="./gtkrc-2.0">here</a> shows you how to do it (among other things).
    Q: When I click the status selector, I see blank space and have to
    scroll. What can I do about this?
    @@ -321,7 +320,10 @@
    Q: How do I make gaim use emacs-like keybindings, or assign a custom
    hotkey?
    -A: You need to edit your <code>~/.gtkrc-2.0</code> to contain the appropriate line from <a href="./gtkrc-2.0">this example file</a>. If you are using <code>gtk-can-change-accels = 1</code>, then you hover over the menu item then press your desired key stroke.
    +A: You need to edit your <code>~/.gtkrc-2.0</code> to contain the appropriate
    +lines from <a href="./gtkrc-2.0">this example file</a>. If you are using
    +<code>gtk-can-change-accels = 1</code>, then you hover over the menu item then
    +press your desired key stroke.
    Q: How do I use smiley themes?
    @@ -359,9 +361,9 @@
    is in the lower-right, always. When an AOL buddy is not away, the fact that
    [s]he's an AOL user is the most important information shown in the icon. The
    consistency is that the user can always look in the same place on the icon to
    -find out what he needs to know. Also, importantly, the lower-right corner emblem
    -is the only emblem that shows up when "Small list" is on, as only one emblem
    -would fit.
    +find out what he needs to know. Also, importantly, the lower-right corner
    +emblem is the only emblem that shows up when "Small list" is on, as only one
    +emblem would fit.
    Q: How do I get sound to work correctly?
    @@ -380,8 +382,8 @@
    To compile Gaim with support for libao you need libao-devel and
    audiofile-devel. To use libao you need libao and audiofile. If you do
    not wish to install these packages you can also just change your sound
    - playing method in preferences to <code>Command</code> and use <code>esdplay %s</code>
    - or <code>artsplay %s</code>.
    + playing method in preferences to <code>Command</code> and use
    + <code>esdplay %s</code> or <code>artsplay %s</code>.
    </p>
    Q: How do I make Gaim use ALSA or OSS for playing sounds? What does the
    @@ -392,7 +394,8 @@
    method, while choosing "Automatic" lets it decide for itself.
    <p>
    If you choose "Automatic", you can create a file, either
    - <code>/etc/libao.conf</code> or <code>~/.libao</code>, and put <b>one</b> of the following lines
    + <code>/etc/libao.conf</code> or <code>~/.libao</code>, and put <b>one</b> of
    + the following lines
    in it:
    </p>
    <pre><code>default_driver=alsa
    @@ -403,23 +406,25 @@
    See also <code>man 5 libao.conf</code>.
    </p>
    -Q: Why does Gaim use the same <code>WM_CLASS</code> for every window? It makes it
    -impossible to control window size and placement for the buddy list separately
    -from the conversations.
    +Q: Why does Gaim use the same <code>WM_CLASS</code> for every window? It makes
    +it impossible to control window size and placement for the buddy list
    +separately from the conversations.
    -A: Both strings in the <code>WM_CLASS</code> property are supposed to be the same for
    -all windows in the same instance of an application. ICCCM states that one
    -is meant to be the same for all instances of the application, the other
    -is meant to be unique to that instance of the application. ICCCM also
    -states "If a client has multiple windows with identical <code>WM_CLASS</code> and
    -<code>WM_NAME</code> properties, then it should provide a <code>WM_WINDOW_ROLE</code> property."
    +A: Both strings in the <code>WM_CLASS</code> property are supposed to be the
    +same for all windows in the same instance of an application. ICCCM states that
    +one is meant to be the same for all instances of the application, the other is
    +meant to be unique to that instance of the application. ICCCM also states "If
    +a client has multiple windows with identical <code>WM_CLASS</code> and
    +<code>WM_NAME</code> properties, then it should provide a
    +<code>WM_WINDOW_ROLE</code> property."
    <p>
    - Gtk+ sets these <code>WM_CLASS</code> values for us so that they are unique for Gaim
    - instances, and the documentation for the <code>gtk_window_set_wmclass</code> function
    - says explicitly not to use it for anything else. Gaim uses the
    - <code>WM_WINDOW_ROLE</code> hint to differentiate windows. If your window manager
    - is having problems differentiating between Gaim windows, please ensure
    - that it uses the <code>WM_WINDOW_ROLE</code> hint per the ICCCM.
    + Gtk+ sets these <code>WM_CLASS</code> values for us so that they are unique
    + for Gaim instances, and the documentation for the
    + <code>gtk_window_set_wmclass</code> function says explicitly not to use it
    + for anything else. Gaim uses the <code>WM_WINDOW_ROLE</code> hint to
    + differentiate windows. If your window manager is having problems
    + differentiating between Gaim windows, please ensure that it uses the
    + <code>WM_WINDOW_ROLE</code> hint per the ICCCM.
    </p>
    Q: I blocked someone accidentally, how can I unblock them?
    @@ -447,12 +452,6 @@
    either case, new logs (new as of 0.73) are in subdirectories that correspond to
    protocol/yourscreenname/theirscreenname.
    -Q: How can I see my own status with Gaim?
    -
    -A: Currently the only supported method to see your own status is to add
    -yourself to your buddy list. This works with Aim, ICQ, Y!M, IRC, and some
    -of the others, and is mimicked by gaim for MSN and Jabber.
    -
    Q: Can I use Gaim for e-mail, blogging, an RSS feed, or something else
    that isn't IM-related?
    @@ -471,14 +470,14 @@
    A: Somewhat, yeah. As of 1.2.1 The following is supported:
    <ul>
    -<li>Sending and receiving files on AIM (although it might be a bit
    +<li>Sending and receiving files on AIM/ICQ (although it might be a bit
    buggy)</li>
    <li>Sending and receiving files on IRC</li>
    <li>Sending and receiving files on Jabber</li>
    <li>Sending and receiving files on MSN</li>
    <li>Sending and receiving files on SILC</li>
    -<li>Sending and receiving files on Yahoo when not using an HTTP proxy (sending is
    -limited to an unknown file size)</li>
    +<li>Sending and receiving files on Yahoo when not using an HTTP proxy (sending
    +is limited to an unknown file size)</li>
    </ul>
    <p>
    Most of the protocols themselves support file transfer, but Gaim
    @@ -625,8 +624,7 @@
    A: AOL has set a limit for the maximum number of people you can have in
    your buddy list. This number is currently 500 for AIM, if you don't think
    -you are
    -anywhere near that limit, it is possible that your server-stored buddy
    +you are anywhere near that limit, it is possible that your server-stored buddy
    list is corrupt.
    <p>
    If you think this might be the case, you can try signing on with an
    @@ -645,7 +643,7 @@
    supported. The ones that <i>are</i> supported are goim, addbuddy, and
    gochat.
    <p>
    - You'll need the &quot;Remote Control&quot; plugin loaded for this to work.
    + You'll need a version of gaim compiled with dbus support for this to work.
    </p>
    <p>
    If you use wingaim, this will not work as gaim-remote has not yet been ported
    @@ -654,11 +652,9 @@
    Q: Does Gaim support file transfer?
    -A: AIM and ICQ file transfer is partially implemented. Notably, it will
    -fail when the <b>sender</b> is behind a NAT device, and sometimes when the
    -sender is behind a firewall even if not behind a NAT.
    -<a href="http://gaim.sourceforge.net/summerofcode/jonathan/blog">Jonathan
    -Clark</a> is working on this as a Summer of Code project.
    +A: AIM and ICQ file transfer is mostly implemented at this time.
    +However, just as with the official clients, you may need to look at the
    +network tab in preferences.
    Q: Does Gaim support DirectIM and IM Image?
    @@ -714,18 +710,13 @@
    use when conversing with ICQ users. Use the account editor to set this
    encoding.
    -Q: Can I set myself invisible?
    -
    -A: Yes. Go to Tools-&gt;Away-&gt;<i>account</i>-&gt;Invisible.
    -
    -
    !SECTION IRC Protocol
    Q: How do I join a channel with the IRC plugin?
    A: First create the account, then sign on. After you have signed on, you
    -can use File-&gt;Join A Chat on the buddy list to join a channel. In any
    +can use Buddies-&gt;Join A Chat on the buddy list to join a channel. In any
    window, either a conversation or a chat, in which your IRC user is the
    sender, you can also use <code>/join</code> to connect to a new channel.
    @@ -743,14 +734,13 @@
    Q: Is it possible to change the user name that appears in
    username@hostname?
    -A: Yes. Go to Tools-&gt;Accounts. Select your IRC account and click
    -Modify. Expand the Show more options section. Enter a name in the
    -Username field.
    +A: Yes. Go to the Accounts menu. Select your IRC account and click
    +to edit. Click the Advanced tab. Enter a name in the Username field.
    Q: How can I set/change my real name?
    -A: Go to Tools-&gt;Accounts. Select your IRC account and click modify.
    -Expand the Show more options section. Enter a name in the Real name field.
    +A: Go to the Accounts menu. Select your IRC account and click to edit.
    +Click the Advanced tab. Enter a name in the Real name field.
    !SECTION Jabber Protocol
    @@ -785,48 +775,12 @@
    don't type in what you thought you did, you're hosed.
    </p>
    -Q: How do I use invisibility?
    -
    -A: Jabber invisibility support is available in Gaim version 0.60 and later.
    -<p>
    - There are two ways to use Jabber invisibility: on a per-buddy and on a
    - per-server basis.
    -</p>
    -<p>
    - To use per-buddy invisibility: right-click on the buddy on the Online
    - buddy list and select "Temporarily Hide From." You will appear to that
    - buddy to be off-line. To make yourself seen by that buddy again:
    - right-click on the buddy and select "Un-hide From." Note that the menu
    - changes based on whether you're currently invisible to that buddy or
    - not.
    -</p>
    -<blockquote>
    - The "Temporarily" part is a dead give-away. Your invisibility to
    - that buddy will last only until the next time you log on or until
    - you set server invisibility (discussed next) on and off.
    -</blockquote>
    -<p>
    - To use per-server invisibility: click "Tools -&gt; Away," select the
    - Jabber server login for the server upon which you wish to become invisible
    - (if necessary) and select "Invisible." To become visible again: select
    - anything else from that same menu (such as "Online"), or set your away
    - status or log off the server and back on again.
    -</p>
    -<p>
    - You can set yourself invisible per-server and subsequently make yourself
    - visible to selected buddies only.
    -</p>
    -<p>
    - Gaim currently does not retain invisibility settings between logins,
    - just as it doesn't currently retain "away" status.
    -</p>
    -
    Q: I've a buddy that I keep removing from my buddy list but the entry
    keeps coming back every time I log in again! How can I stop this?
    -A: With Gaim 0.60 or later, it might be continuing to
    - import the old buddy lists. Remove <code>~/.gaim/*.blist</code> - these
    - are no longer used, the buddy list is now stored in <code>~/.gaim/blist.xml</code>
    +A: With Gaim 0.60 or later, it might be continuing to import the old buddy
    +lists. Remove <code>~/.gaim/*.blist</code> - these are no longer used, the
    +buddy list is now stored in <code>~/.gaim/blist.xml</code>
    Q: Can I remove a buddy from my Jabber roster entirely?
    @@ -968,26 +922,20 @@
    permit list and your deny list. There are two ways to fix this: the correct
    way and the quick way. The correct way is to go to Tools-&gt;Privacy, and
    manually scan the list and remove the duplicate entries. The quick way is to
    -remove the blist.xml file from the <code>~/.gaim</code> directory. Be aware that this
    -contains your buddy list for <i>all</i> accounts, and also stores the
    +remove the blist.xml file from the <code>~/.gaim</code> directory. Be aware
    +that this contains your buddy list for <i>all</i> accounts, and also stores the
    &quot;Contact&quot; grouping of Buddies.
    Q: Is there a way to invite more than one person to an MSN chat?
    A: Yes. Right click a buddy on your list and choose "Initiate Chat". In the
    -conversation window that appears, choose "Invite" from the "Conversation" menu to
    -invite another user. When the conversation framework gets another rewrite,
    +conversation window that appears, choose "Invite" from the "Conversation" menu
    +to invite another user. When the conversation framework gets another rewrite,
    it is possible that this will be simplified.
    -Q: Is MSNP9 (MSN6) going to be supported?
    -
    -A: MSNP9 support has existed in Gaim since 0.69. However, at this point,
    -features such as custom smileys aren't yet implemented.
    +Q: Is MSNP11 (MSN7) going to be supported?
    -Q: Will I be able to use Gaim for MSN after October 15th 2003? (The day they're preventing third party clients from connecting)
    -
    -A: Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is
    -supported after October 15th 2003.
    +A: It is being worked on.
    Q: I just upgraded Gaim and the MSN plugin will not load. Why?
    @@ -999,13 +947,15 @@
    Q: The MSN plugin won't load, but I have Mozilla NSS!
    -A: Some distributions, including Slackware, install Mozilla NSS to a non-standard directory. The fix is
    -simple. Edit <code>/etc/ld.so.conf</code> and add <code>/usr/lib/mozilla-1.4</code> (or whatever
    -version you're using, but it's usually 1.4) to the file, and run ldconfig as root. Then re-run
    -configure and recompile Gaim. You may also need to specify where the
    -include file are for NSS and NSPR, see <code>./configure --help</code> for the options.
    +A: Some distributions, including Slackware, install Mozilla NSS to a
    +non-standard directory. The fix is simple. Edit <code>/etc/ld.so.conf</code>
    +and add <code>/usr/lib/mozilla-1.4</code> (or whatever version you're using,
    +but it's usually 1.4) to the file, and run ldconfig as root. Then re-run
    +configure and recompile Gaim. You may also need to specify where the include
    +file are for NSS and NSPR, see <code>./configure --help</code> for the options.
    <p>
    - Mozilla 1.5 has a broken .pc file and does not install the necessary .h files, and so will not be detected.
    + Mozilla 1.5 has a broken .pc file and does not install the necessary .h files,
    + and so will not be detected.
    </p>
    <p>
    See <a href="./faq-ssl.php">these notes</a> on getting SSL to work with Gaim.
    @@ -1029,8 +979,8 @@
    Q: How do I set my MSN Friendly Name (the name other users see)?
    -A: In the Buddy List window, go to Tools-&gt;Account
    -Actions-&gt;<i>account</i>-&gt;Set Friendly Name.
    +A: In the Buddy List window, go to Accounts-&gt;<i>account</i>-&gt;Set
    +Friendly Name.
    Q: What does &quot;Error reading from switchboard server&quot; mean?
    @@ -1062,16 +1012,19 @@
    Q: What is Zephyr?
    A: Zephyr is an IM protocol developed at MIT for use with Project Athena. Its
    -features include Kerberos IV authentication, multi-level chats (aka "subscriptions").
    -You're probably using this because your college/employer/organization uses it as a
    -local IM/chat system. If not, you probably don't have a server to connect to.
    +features include Kerberos IV authentication, multi-level chats (aka
    +"subscriptions"). You're probably using this because your
    +college/employer/organization uses it as a local IM/chat system. If not,
    +you probably don't have a server to connect to.
    -Q: Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't initialize zephyr".
    +Q: Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't
    +initialize zephyr".
    A: Your site might require the use of Kerberos 4 for authentication, though
    -few prepackaged Gaim binaries use Kerberos. One solution is to compile Gaim with
    -the --with-krb4 flag to point to the location of your Kerberos 4 devel files,
    -usually one of <code>/usr</code>, <code>/usr/local</code>, or <code>/usr/athena</code>, e.g.
    +few prepackaged Gaim binaries use Kerberos. One solution is to compile Gaim
    +with the --with-krb4 flag to point to the location of your Kerberos 4 devel
    +files, usually one of <code>/usr</code>, <code>/usr/local</code>, or
    +<code>/usr/athena</code>, e.g.
    <code>./configure --with-krb4=/path/to/kerberosIV</code>
    @@ -1081,24 +1034,26 @@
    installed, and running, and pointed at your Zephyr servers. e.g.
    <pre><code>zhm z1.example.com z2.example.com z3.example.com</code></pre>
    <p>
    -Alternatively, there might be a firewall or a NAT between you and the
    -Zephyr servers. Zephyr generally doesn't work in an environment where incoming
    -connections cannot be made to arbitrary UDP ports.
    + Alternatively, there might be a firewall or a NAT between you and the
    + Zephyr servers. Zephyr generally doesn't work in an environment where incoming
    + connections cannot be made to arbitrary UDP ports.
    </p>
    Q: How do I use Zephyr from behind my firewall, or without recompiling with kerberos support if needed?
    -A: You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a machine
    -that is behind a firewall or NAT. First, make sure that tzc is installed and working on the
    -remote machine. The best version of tzc to use can be found <a href="http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/tzc-cclub_001-3.tar.gz">here</a>. Second, make sure that you can make a passwordless ssh
    -connection to the remote machine and get kerberos 4 tickets.
    +A: You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a
    +machine that is behind a firewall or NAT. First, make sure that tzc is
    +installed and working on the remote machine. The best version of tzc to use
    +can be found
    +<a href="http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/tzc-cclub_001-3.tar.gz">here</a>.
    +Second, make sure that you can make a passwordless ssh connection to the remote
    +machine and get kerberos 4 tickets.
    Then, click on "Show more options", enable "Use tzc", and set the tzc command to
    <pre><code>/path/to/ssh username@hostname /path/to/tzc -e "%s"</code></pre>
    -Alternately, if you have tzc working on your machine, you can enable "Use tzc", and set the tzc
    -command to
    -<pre><code>/path/to/tzc -e "%s"</code></pre>
    +Alternately, if you have tzc working on your machine, you can enable "Use tzc",
    +and set the tzc command to <pre><code>/path/to/tzc -e "%s"</code></pre>
    !SECTION SILC Protocol
    @@ -1231,13 +1186,9 @@
    Q: Will you support features such as voice chat, internet phones, or
    video chat?
    -A: In the short term we have no plans to work on or attempt to integrate
    -patches in these areas. However, one of our developers has created <a
    -href="http://gaim-vv.sf.net">Gaim-vv</a>, a "fork" of Gaim, which will be
    -merged into gaim when a decent subset of voice and video functionality is
    -implemented and stable. Having a separate sourceforge project allows
    -people interested in such features greater access to development while not
    -clogging the main thrust of gaim towards text instant messages.
    +A: Merging the gaim-vv code will take time, and we are not sure when it
    +will be ready. Even then, there will remain work to be done before voice
    +chat, video sharing, or internet phones will work on all protocols.
    Q: Where should I report bugs?