MSN(2)								  msn User Manual							    MSN(2)

NAME

       msn - An opensource Python implementation for the MSN messenger protocol version 8

SYNOPSIS

       msn [profilename]

DESCRIPTION

       This manual page documents briefly the msn command.

       This manual page was written for the Debian distribution because the original program does not have a manual page.

       msn is a program intended to be used as a proof of concept for the msnlib functions. It shows some of the capabilities of the library.

       When a profilename is passed as parameter, msn will use that profile account information (previously configured and stored by msnsetup) to
       connect.

COMMANDS

       The program has a builtin command "help" which shows the latest list of commands available for the program. Below is the complete list of
       commands available.

       In most cases, when you are asked for a nick, you can alternatively enter the email. This makes it easier to handle people with weird or
       long nicks.

       status [mode]
	   Shows the current status, or changes it to "mode", which can be one of: online, away, busy, brb, phone, lunch, invisible, idle

       q
	   Quits the program.

       w
	   Prints your entire contact list. Contacts connected are highlighted in bold.

       ww
	   Prints your entire contact list, including email addresses.

       wn
	   Prints your entire contact list, including real nicknames.

       wr
	   Prints your reverse contact list (this is simply the list of all the people who have you on their contact list).

       wd
	   Prints the differences between your forward and reverse lists.

       e
	   Prints your online contacts.

       ee
	   Prints your online contacts, including email addresses.

       eg
	   Prints your online contacts with the groups.

       en
	   Prints your online contacts, including real nicknames.

       h
	   Shows your incoming message history. This is a list of the last N messages that you received. The amount is configurable with the
	   directive "input history size" in the msnrc file, which defaults to 10.

       add email [nick][groupname]
	   Adds the user "email" with the nickname "nick" to the group "groupname".

       del nick
	   Deletes the user with nick "nick".

       ren nick newnick
	   Renames the user with nick "nick" to appear as "newnick".

       info [nick]
	   Without parameters shows your personal info. If a nick is passed as parameter, shows the user information and pending messages (if
	   any). It also includes some advanced information (like the server socket or tid).

       lignore [nick]
	   Locally ignores the user, or displays the locally ignored users list. This makes the messages coming from the user not to be displayed,
	   but they are still logged so you can see them later.

       lunignore nick
	   Removes a user from the locally ignored users list.

       block nick
	   Blocks a user.

       unblock nick
	   Unblocks a blocked user.

       g
	   Shows the groups list.

       gadd gname
	   Adds the group "gname".

       gdel gname
	   Deletes the group "gname". Note that all the users in the group will be deleted too.

       gren old new
	   Renames the group "old" with the name "new".

       color [theme]
	   Shows the available color themes, or sets the color theme to "theme".

       close nick
	   Closes the switchboard connection with "nick". There is no need to use this command and is included just for advanced users and
	   debugging.

       config
	   Shows the configuration, in the internal representation, along with other special automatic variables. This means that many commands
	   and values won't have the same format; for instance, instead of 'yes' you will often see a "1". This command is mostly exclusively
	   included for bug reporting.

       info [nick]
	   Shows the user information and pending messages (if any), or your personal info.

       nick [newnick]
	   Changes your nick to "newnick", or shows your current nick.

       privacy p a
	   Sets whether to accept messages from people who is not on your list (p) and require authorization (a).

       m nick text
	   Sends a message to "nick" with the "text". The standard and most practical way of sending a message. Tab completion expands to this.

       a text
	   Sends a message with "text" to the last person you sent a message to.

       r text
	   Sends a message with "text" to the last person that sent you a message.

       invite nick1 to nick2
	   Invites nick1 into the chat with nick2.

FILES

       ${HOME}/.msn/msnrc
	   The default configuration file for the account information, stored by msnsetup.

       ${HOME}/.msn/msnrc-{profilename}
	   The configuration file for a specific profile name that stores that account information, chosen by the user and stored by msnsetup.

DIAGNOSTICS

       The following diagnostics may be issued on stderr:

       Bad configuration file. Exiting.
	   The configuration file seems to contain a broken configuration line. Use the --verbose option, to get more info.

       msn provides some return codes, that can be used in scripts:

       Code   Diagnostic
       0      Program exited successfully.
       1      The configuration file seems to be broken.

BUGS

       Comments and patches are always welcome; please send them to albertito@blitiri.com.ar

       Further information on how to report a bug can be found inside the documentation directory, in the file 'reporting_bugs'.

SEE ALSO

       msnsetup(2)

AUTHOR

       Julia Palandri <julia.palandri@gmail.com>
	   Wrote this manpage for the Debian system.

COPYRIGHT

       Copyright (C) 2011 Julia Palandri

       This manual page was written for the Debian system (and may be used by others).

       Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at
       your option) any later version published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

msn								    12/18/2011								    MSN(2)