docs/readme.mdwn
author Myhailo Danylenko <isbear@ukrpost.net>
Mon, 20 Aug 2012 22:49:24 +0300
changeset 56 f0e3c123d506
parent 11 README@18de00544c46
child 58 694833145b98
permissions -rw-r--r--
Rearrange docs
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
     1
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
     2
# Service Discovery
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     3
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     4
This is a module for mcabber to send service discovery requests.
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     5
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
     6
It provides mcabber command 'disco'. To use this module just load it -
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
     7
then command will be available.
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     8
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
     9
With this you can discover abilities of various jabber entities, like
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    10
servers, transports etc. Note, that it can only provide information,
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    11
what to do with this information (eg register to entity, that supports
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    12
it) is not this module's task. Note also, that if you want to get
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    13
abilities of some buddy, you should send disco request to specific
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    14
resource of that buddy (because of this this command supports extended
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    15
notation ./resource), if you'll send request to bare jid, you'll get
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    16
reply from server, that serves that jid.
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    17
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    18
# Installation
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    19
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    20
To install it, you need:
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    21
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    22
 * mcabber headers
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    23
 * glib
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    24
 * loudmouth
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    25
 * cmake
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    26
 * make
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    27
 * c compiler (gcc)
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    28
 * linker (binutils)
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    29
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    30
Then do:
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    31
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    32
    $ mkdir build
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    33
    $ cd build
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    34
    $ cmake ..
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    35
    $ make edit_cache
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    36
    $ make
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    37
    # make install
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    38
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    39
Debian users can instead of make install do:
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    40
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    41
    $ make package
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    42
    # dpkg -i libmcabber-disco_*.deb
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    43
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    44
Users of other distributions can select appropriate package generator,
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    45
using cache editor.
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    46
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    47
# License
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    48
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    49
This code underlies terms of GNU GPL v2 or later. You can find it in
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    50
file COPYING from this distribution or on a GNU web-site
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    51
<http://www.gnu.org/licenses/>.
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    52
56
f0e3c123d506 Rearrange docs
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
    53
# Contact
11
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    54
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    55
I will be happy to get feedback, patches, suggestions, etc.
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    56
You can send me email or contact via jabber <isbear@unixzone.org.ua>.
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    57
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    58
  -- Myhailo Danylenko <isbear@ukrpost.net>
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    59