Git commit ef1d316f5933be71a13a6d8a8743f6b92ce6adb1 by Yuri Chornoivan. Committed on 30/10/2014 at 17:58. Pushed by yurchor into branch 'master'.
Fix some issues, use entities, improve formatting M +17 -21 doc/index.docbook http://commits.kde.org/kopete/ef1d316f5933be71a13a6d8a8743f6b92ce6adb1 diff --git a/doc/index.docbook b/doc/index.docbook index 3d67815..3f2c11b 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -32,7 +32,7 @@ Getting Started (1st draft, Will) Add an account Go online Start chatting -Using Kopete (1st draft, Will) +Using &kopete; (1st draft, Will) Contact List window Layout Menu @@ -58,7 +58,7 @@ Using Kopete (1st draft, Will) Starting group chats Shortcuts File transfers -Configuring Kopete (1st draft, Will) +Configuring &kopete; (1st draft, Will) Global Shortcuts Configure Dialog Adding/Editing Accounts ( @@ -715,7 +715,7 @@ Shortcuts...</guimenuitem></menuchoice>.</para></tip> </sect2> <sect2 id="protocols-msn"> <title>MSN</title> - <para>File transfer and multi user chats work. To transfer a file, drag the file from &konqueror; or the desktop into the chat window. To invite someone else into a chat, drag them from the Contact List into the chat window. The <menuchoice><guimenu>File</guimenu></menuchoice> menu also contains these commands. In addition, MSN supports custom emoticons.</para> + <para>File transfer and multi user chats work. To transfer a file, drag the file from &dolphin; or the desktop into the chat window. To invite someone else into a chat, drag them from the Contact List into the chat window. The <menuchoice><guimenu>File</guimenu></menuchoice> menu also contains these commands. In addition, MSN supports custom emoticons.</para> <para>To use file transfer, make sure port 6891 is forwarded to your computer.</para> </sect2> <sect2 id="protocols-yahoo"> @@ -1094,58 +1094,54 @@ sets that you can simply extract there.</para> </answer> </qandaentry> <qandaentry> -<question><para>I don't see any "plugins" listed in the "Configure Plugins" dialog. What's up?</para> + <question><para>I don't see any plugins listed in the <quote>Configure Plugins</quote> dialog. What's up?</para> </question> -<answer><para>There are two solutions to this problem. If you used binary packages, then make sure that you used binary packages designed for your distribution, and the specific version of your distribution. Crossing distributions and versions around will not work with Kopete. If there are no binary packages for your system, you must compile Kopete using the source packages or source rpms. If you compiled your KDE, then Kopete must go in the same prefix as KDE did. If, however, you compiled the source packages, then make sure that your Kopete is installed in the same location as your KDE, if it is not, you can force it to do so by specifying a --prefix command to cmake. e.g. cmake -DCMAKE_PREFIX=/opt/kde4 (where /opt/kde4 is your prefix). To determine where your KDE prefix is, type "which konqueror" in a konsole. It should display something like "/opt/kde4/bin/konqueror", then /opt/kde4 would be your prefix, or if it says "/usr/bin/konqueror", then your prefix would be /usr. Also make sure you performed a 'make install', and check that there is no stale Kopete installation from previous versions in different locations. You might also need to run 'kbuildsycoca4' manually after installing Kopete. kbuildsycoca updates the plugin database. It runs when new software using plugins is installed, but it is possible that 'make install; kopete' will run Kopete before the update has completed.</para> +<answer><para>There are two solutions to this problem. If you used binary packages, then make sure that you used binary packages designed for your distribution, and the specific version of your distribution. Crossing distributions and versions around will not work with &kopete;. If there are no binary packages for your system, you must compile &kopete; using the source packages. If you compiled your &kde;, then &kopete; must go in the same prefix as &kde; did. If, however, you compiled the source packages, then make sure that your &kopete; is installed in the same location as your &kde;, if it is not, you can force it to do so by specifying a prefix command to <application>cmake</application>. Example: <userinput><command>cmake</command> <parameter>-DCMAKE_PREFIX=/opt/kde4</parameter></userinput> (where <userinput>/opt/kde4</userinput> is your prefix). To determine where your &kde; prefix is, type <userinput><command>which</command> <parameter>dolphin</parameter></userinput> in a &konsole; window. It should display something like <computeroutput>/opt/kde4/bin/dolphin</computeroutput>, then <filename class="directory">/opt/kde4</filename> would be your prefix, or if it says <computeroutput>/usr/bin/dolphin</computeroutput>, then your prefix would be <filename class="directory">/usr</filename>. Also make sure you performed a <command>make install</command>, and check that there is no stale &kopete; installation from previous versions in different locations. You might also need to run <application>kbuildsycoca4</application> manually after installing &kopete;. <application>kbuildsycoca4</application> updates the plugin database. It runs when new software using plugins is installed, but it is possible that <command>kopete</command> will run &kopete; before the update has completed.</para> </answer> </qandaentry> <qandaentry> -<question><para>I have many <desktops / monitors / computers> and / or I talk to many people at the same time, and as a result I wish Kopete could play a <sound / pop up a m -essage / change my wallpaper / reboot my computer > whenever I <receive a new message / someone goes online / someone goes offline > When will this be added?</para> +<question><para>I have many <desktops / monitors / computers> and / or I talk to many people at the same time, and as a result I wish &kopete; could play a <sound / pop up a message / change my wallpaper / reboot my computer > whenever I <receive a new message / someone goes online / someone goes offline > When will this be added?</para> </question> <answer><para>It is already there - (surprise!). Kopete is a KDE application and thus makes use of KNotify for all notifications. For those who don't know, KNotify is a very powerful architecture that lets you do pretty much - anything you want when an event occurs in a KDE application. You can play a sound, pop up a passive dialog, flash the taskbar, log a message, or even run your own custom commands, such as -a shell script, to do anything your heart desires. To access this treasure trove, go into the Configure Notifications dialog, and click "More Options". This will present you with -all the different actions you can take on the events listed just above. As a tip, check out some of your other KDE applications to see what events they let you catch. I for one find a passi -ve popup on new emails in KMail to be very handy.</para> + (surprise!). &kopete; is a &kde; application and thus makes use of KNotify for all notifications. For those who don't know, KNotify is a very powerful architecture that lets you do pretty much + anything you want when an event occurs in a &kde; application. You can play a sound, pop up a passive dialog, log a message, or even run your own custom commands, such as + a shell script, to do anything your heart desires. To access this treasure trove, go into the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Notifications</guimenuitem></menuchoice> dialog. This will present you with all the different actions you can take on the events listed just above. As a tip, check out some of your other &kde; applications to see what events they let you catch. I for one find a passive popup on new emails in &kmail; to be very handy.</para> </answer> </qandaentry> <qandaentry> <question><para>How come file transfers don't work?</para> </question> -<answer><para>There are many reasons for this. WLM was the the first protocol in which we've implemented support for file transfers. Support for file transfers in Jabber and IRC was added in Kopete 0.9.0 (included in KDE 3.3), and ICQ and AIM in Kopete 0.50.0 (included in KDE 4.0.0). Also, file transfers may not work if you're behind a firewall - see WLM section in the protocol chapter.</para> +<answer><para>There are many reasons for this. WLM was the the first protocol in which we've implemented support for file transfers. Support for file transfers in Jabber and IRC was added in &kopete; 0.9.0 (included in &kde; 3.3), and ICQ and AIM in &kopete; 0.50.0 (included in &kde; 4.0.0). Also, file transfers may not work if you're behind a firewall - see WLM section in the protocol chapter.</para> </answer> </qandaentry> <qandaentry> <question><para>Why all of this silly single-click behavior? It's very annoying!</para> </question> -<answer><para>Kopete is a KDE application. We are not some lame 3rd party application that decides to "look" like the rest of KDE. We also have the "feel" and "integration" aspect of KDE, which means that Kopete follows KDE's standard "Single-click" behavior. If you would like to change this it requires you to change it in all of KDE. You can change to a double-click style by going to K->Settings->Peripherals->Mouse or start &systemsettings; and go to Peripherals->Mouse and change to the option "Double-click to open files and folders".</para> +<answer><para>Kopete is a &kde; application. We are not some lame 3rd party application that decides to "look" like the rest of KDE. We also have the "feel" and "integration" aspect of KDE, which means that &kopete; follows KDE's standard "Single-click" behavior. If you would like to change this it requires you to change it in all of KDE. You can change to a double-click style by starting &systemsettings; and go to <menuchoice><guimenu>Input Devices</guimenu> <guimenuitem>Mouse</guimenuitem></menuchoice> and change to the option <guilabel>Double-click to open files and folders (select icons on first click)</guilabel>.</para> </answer> </qandaentry> <qandaentry> <question><para>Will you make the user-interface skinnable?</para> </question> -<answer><para>The only answer for this is no. Kopete was invented to be a KDE Instant-Messenger and this also includes having a KDE Look-n-Feel. By adding skins we would break this rule and having both skin-support and skinless-support at once is impractical as well. Just select a different style in KDEs controlcenter and be happy to have transparent menus and other neat eye-candy today's KDE offers. You can, however, run kopete using a different style. Just run "kopete --style=marble" as an example. Any valid KDE or Qt style will work.</para> +<answer><para>The only answer for this is no. &kopete; was invented to be a &kde; Instant-Messenger and this also includes having a &kde; Look-n-Feel. By adding skins we would break this rule and having both skin-support and skinless-support at once is impractical as well. Just select a different style in &kde;'s &systemsettings; and be happy to have transparent menus and other neat eye-candy today's &kde; offers. You can, however, run kopete using a different style. Just run <userinput>kopete --style=marble</userinput> as an example. Any valid &kde; or &Qt; style will work.</para> </answer> </qandaentry> <qandaentry> <question><para>I would like a feature in the next version of Kopete.</para> </question> -<answer><para>Please go to http://bugs.kde.org and file a wishlist item under the application 'kopete'. Please be very detailed and proof-read what you have written to us. This is NOT a guarantee that we will add this feature in any version, but allows us to consider it.</para> +<answer><para>Please go to <ulink url="http://bugs.kde.org";>&kde; Bugzilla</ulink> and file a wishlist item under the application 'kopete'. Please be very detailed and proof-read what you have written to us. This is NOT a guarantee that we will add this feature in any version, but allows us to consider it.</para> </answer> </qandaentry> <qandaentry> -<question><para>My Kopete crashed or has/had unexpected behavior (unexpected behavior does NOT fall in the category of "Kopete doesn't act like Pidgin", etc).</para> +<question><para>My &kopete; crashed or has/had unexpected behavior (unexpected behavior does NOT fall in the category of "Kopete doesn't act like Pidgin", &etc;).</para> </question> -<answer><para>Please rep -ort this bug to us by going to http://bugs.KDE.org and file a bug report under the application 'kopete'. Bugs will only be accepted if they are in English, they are detailed, and if a crash was involved they contain a backtrace (the text in the tab marked "Backtrace" once Kopete has crashed). If you're using Kopete git, however, please mail us at kopete-devel at kde.org instead of filing a bug report.</para> +<answer><para>Please report this bug to us by going to <ulink url="http://bugs.kde.org";>&kde; Bugzilla</ulink> and file a bug report under the application 'kopete'. Bugs will only be accepted if they are in English, they are detailed, and if a crash was involved they contain a backtrace (the text in the tab marked <guilabel>Backtrace</guilabel> once &kopete; has crashed). If you are using &kopete; git, however, please mail us at <ulink url="mailto:kopete-devel at kde.org">&kopete; developers mailing list</ulink> instead of filing a bug report.</para> </answer> </qandaentry> <qandaentry> <question><para>Jabber SSL support stopped working, I get the message that the QCA TLS plugin is probably missing. What am I supposed to do?</para> </question> -<answer><para>As the error message indicates, you are missing the QCA TLS plugin, which handles the Jabber plugin's TLS/SSL encryption. Install the package qca-tls (and eventually qca-ossl) or retrieve the plugin from http://delta.affinix.com/qca. Please note that you only need to install the qca-tls plugin, _not_ the QCA library itself. A recompilation of Kopete is not necessary, in fact not even a restart. In case you have installed the plugin and it still won't work, Qt can probably not find it. Since qca-tls installs itself as a Qt plugin, you will have to make sure that it gets installed to the plugin directory of the Qt version you are using to run Kopete.</para> +<answer><para>As the error message indicates, you are missing the QCA TLS plugin, which handles the Jabber plugin's TLS/SSL encryption. Install the package <application>qca-tls</application> (and eventually <application>qca-ossl</application>) or retrieve the plugin from <ulink url="http://delta.affinix.com/qca";>its homepage</ulink>. Please note that you only need to install the <application>qca-tls</application> plugin, <emphasis>not</emphasis> the QCA library itself. A recompilation of &kopete; is not necessary, in fact not even a restart. In case you have installed the plugin and it still won't work, Qt can probably not find it. Since qca-tls installs itself as a &Qt; plugin, you will have to make sure that it gets installed to the plugin directory of the &Qt; version you are using to run &kopete;.</para> </answer> </qandaentry> <qandaentry> @@ -1158,7 +1154,7 @@ ort this bug to us by going to http://bugs.KDE.org and file a bug report under t <question><para>I use Jabber and ICQ together. Whenever I go online with Jabber, I am disconnected from ICQ with an error message about being connected from another client. What's up?</para> </question> -<answer><para>Remember when you played with ICQ transports on that other Jabber client? You set up an "ICQ Transport" which allows you to talk to ICQ people from Jabber. ICQ doesn't allow multiple connections to the same account, and disconnects you. Look in your Jabber contacts for a contact of the form "123456 at icq.jabber.org" and delete it.</para> +<answer><para>Remember when you played with ICQ transports on that other Jabber client? You set up an <quote>ICQ Transport</quote> which allows you to talk to ICQ people from Jabber. ICQ doesn't allow multiple connections to the same account, and disconnects you. Look in your Jabber contacts for a contact of the form <guilabel>123456 at icq.jabber.org</guilabel> and delete it.</para> </answer> </qandaentry> </qandaset>
