summaryrefslogtreecommitdiffstats
path: root/ubuntu/maverick/applications/konversation/debian/man
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-07-10 16:17:43 -0500
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-07-10 16:17:43 -0500
commit9b2075d9b89fc628c447fbb98f43ef72e4a9c81d (patch)
tree2de9e866f064b1c7d36df24de1df305474f949fe /ubuntu/maverick/applications/konversation/debian/man
downloadtde-packaging-9b2075d9b89fc628c447fbb98f43ef72e4a9c81d.tar.gz
tde-packaging-9b2075d9b89fc628c447fbb98f43ef72e4a9c81d.zip
Initial import from old SVN repository
Note that only the Debian and Ubuntu folders were preserved
Diffstat (limited to 'ubuntu/maverick/applications/konversation/debian/man')
-rw-r--r--ubuntu/maverick/applications/konversation/debian/man/konversation.1.docbook214
-rw-r--r--ubuntu/maverick/applications/konversation/debian/man/konversationircprotocolhandler.1.docbook95
2 files changed, 309 insertions, 0 deletions
diff --git a/ubuntu/maverick/applications/konversation/debian/man/konversation.1.docbook b/ubuntu/maverick/applications/konversation/debian/man/konversation.1.docbook
new file mode 100644
index 000000000..f48e27b95
--- /dev/null
+++ b/ubuntu/maverick/applications/konversation/debian/man/konversation.1.docbook
@@ -0,0 +1,214 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+]>
+<refentry>
+ <refentryinfo>
+ <author>
+ <firstname>Nathaniel</firstname>
+ <othername role="mi">W</othername>
+ <surname>Turner</surname>
+ <email>nate@houseofnate.net</email>
+ </author>
+ <copyright>
+ <year>2004</year>
+ <holder>Nathaniel W. Turner</holder>
+ </copyright>
+ <!-- XXX IMPORTANT XXX -->
+ <!-- Keep this date up to date: -->
+ <date>2005-05-31</date>
+ <!-- ^^^^^^^^^^ -->
+ </refentryinfo>
+ <refmeta>
+ <refentrytitle>KONVERSATION</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+ <refnamediv>
+ <refname>konversation</refname>
+ <refpurpose>user friendly IRC client for KDE</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>konversation</command>
+ <arg choice="opt">
+ <option><replaceable>Qt-options</replaceable></option>
+ </arg>
+ <arg choice="opt">
+ <option><replaceable>KDE-options</replaceable></option>
+ </arg>
+ <arg choice="opt">
+ <option><replaceable>options</replaceable></option>
+ </arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+ <para>
+ Konversation is client for the Internet Relay Chat (IRC) protocol.
+ </para>
+ <para>
+ IRC is a great way to meet friends on the net, make new acquaintances and
+ lose yourself in talk about your favorite subject.
+ </para>
+ <para>
+ Konversation is under active development and is currently in beta.
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+ <para>
+ All <productname>KDE</productname> and <productname>Qt</productname>
+ programs accept a some common command-line options.
+ </para>
+ <para>
+ <variablelist>
+ <title>Generic options:</title>
+ <varlistentry>
+ <term> <option>--help</option> </term>
+ <listitem> <para>Show help about options</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>--help-qt</option> </term>
+ <listitem> <para>Show Qt specific options</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>--help-kde</option> </term>
+ <listitem> <para>Show KDE specific options</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>--help-all</option> </term>
+ <listitem> <para>Show all options</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>--author</option> </term>
+ <listitem> <para>Show author information</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>-v</option>, <option>--version</option> </term>
+ <listitem> <para>Show version information</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>--license</option> </term>
+ <listitem> <para>Show license information</para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term> <option>--</option> </term>
+ <listitem> <para>Indicates end of options</para> </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ <variablelist>
+ <title>Options</title>
+ <varlistentry>
+ <term><option>--server</option>
+ <arg choice="req"><replaceable>server</replaceable></arg></term>
+ <listitem><para>Server to connect</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--port</option>
+ <arg choice="req"><replaceable>port</replaceable></arg></term>
+ <listitem><para>Port to use (default: 6667)</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--channel</option>
+ <arg choice="req"><replaceable>channel</replaceable></arg></term>
+ <listitem><para>Channel to join after connection</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--nick</option>
+ <arg choice="req"><replaceable>nickname</replaceable></arg></term>
+ <listitem><para>Nickname to use</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--password</option>
+ <arg choice="req"><replaceable>password</replaceable></arg></term>
+ <listitem><para>Password for connection</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--ssl</option></term>
+ <listitem><para>Use SSL for connection (default:
+ false)</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <!-- TODO * add all the rest of the options, but maybe find an automated
+ way to keep it up to date -->
+ </refsect1>
+ <refsect1>
+ <title>SCRIPTING</title>
+ <para>Konversation looks for scripts in <filename
+ class="directory">/usr/share/apps/konversation/scripts</filename> and
+ in <filename
+ class="directory">~/.kde/share/apps/konversation/scripts</filename>.
+ To execute a script, use the <command>exec</command> command:</para>
+ <cmdsynopsis>
+ <command>/exec</command>
+ <arg choice="req"><replaceable>scriptname</replaceable></arg>
+ <arg choice="opt"><replaceable>arguments</replaceable></arg>
+ </cmdsynopsis>
+ <para>
+ For example:
+ </para>
+ <para><userinput>/exec gauge 75</userinput></para>
+ </refsect1>
+ <refsect1>
+ <title>FILES</title>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><filename>~/.kde/share/config/konversationrc</filename></term>
+ <listitem><para>Main configuration</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <filename>~/.kde/share/config/konversation.eventsrc</filename>
+ </term>
+ <listitem><para>Notification settings</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <filename
+ class="directory">~/.kde/share/apps/konversation/logs</filename>
+ </term>
+ <listitem><para>Directory containing channel log
+ files</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+ <para>
+ The Konversation Handbook is an excellent resource for further reading.
+ It can be found under the <guimenu>Help</guimenu> menu in Konversation.
+ </para>
+ <para>
+ The following manual pages may also be of interest:
+ <citerefentry>
+ <refentrytitle>konversationircprotocolhandler</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>dcop</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>COPYRIGHT</title>
+ <para>
+ This manual page was written by Nathaniel W. Turner
+ <email>nate@houseofnate.net</email> for the
+ <productname>Debian</productname> system (but may be used by others).
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the <acronym>GNU</acronym> General Public License,
+ Version 2 or any later version published by the Free Software Foundation.
+ </para>
+ <para>
+ On Debian systems, the complete text of the GNU General Public
+ License can be found in
+ <filename>/usr/share/common-licenses/GPL</filename>.
+ </para>
+ </refsect1>
+</refentry>
diff --git a/ubuntu/maverick/applications/konversation/debian/man/konversationircprotocolhandler.1.docbook b/ubuntu/maverick/applications/konversation/debian/man/konversationircprotocolhandler.1.docbook
new file mode 100644
index 000000000..1752d7b2c
--- /dev/null
+++ b/ubuntu/maverick/applications/konversation/debian/man/konversationircprotocolhandler.1.docbook
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+]>
+<refentry>
+ <refentryinfo>
+ <author>
+ <firstname>Nathaniel</firstname>
+ <othername role="mi">W</othername>
+ <surname>Turner</surname>
+ <email>nate@houseofnate.net</email>
+ </author>
+ <copyright>
+ <year>2004</year>
+ <holder>Nathaniel W. Turner</holder>
+ </copyright>
+ <!-- XXX IMPORTANT XXX -->
+ <!-- Keep this date up to date: -->
+ <date>2004-07-06</date>
+ <!-- ^^^^^^^^^^ -->
+ </refentryinfo>
+ <refmeta>
+ <refentrytitle>KONVERSATIONIRCPROTOCOLHANDLER</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+ <refnamediv>
+ <refname>konversationircprotocolhandler</refname>
+ <refpurpose>handler for irc:// URI scheme</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>konversationircprotocolhandler</command>
+ <arg choice="req">
+ <option>URI</option>
+ </arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+ <para>
+ This program takes a URI of the form
+ irc://<replaceable>server</replaceable>:<replaceable>port</replaceable>/
+ (or simply irc://<replaceable>server</replaceable>/) and opens a
+ connection to the specified IRC server in a running Konversation client.
+ </para>
+ <para>
+ This program is registered with KDE as a handler for the irc URI scheme,
+ and KDE applications will use this program to handle such URI.
+ (For example, it will be called if a user clicks on an irc:// link on a
+ web page in Konqueror.)
+ </para>
+ <para>
+ This program can also be used directly, but since it is somewhat internal
+ to Konversation, it's interface might change in an incompatible way, and
+ relying on it is not advised. It is better to use Konversation's dcop
+ interface directly.
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>BUGS</title>
+ <para>
+ This program will only work if there is a currently running konversation
+ process.
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+ <para>
+ <citerefentry>
+ <refentrytitle>konversation</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>dcop</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>COPYRIGHT</title>
+ <para>
+ This manual page was written by Nathaniel W. Turner
+ <email>nate@houseofnate.net</email> for the
+ <productname>Debian</productname> system (but may be used by others).
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the <acronym>GNU</acronym> General Public License,
+ Version 2 or any later version published by the Free Software Foundation.
+ </para>
+ <para>
+ On Debian systems, the complete text of the GNU General Public
+ License can be found in
+ <filename>/usr/share/common-licenses/GPL</filename>.
+ </para>
+ </refsect1>
+</refentry>