Mercurial > pidgin
view doc/gaim-remote.1.in @ 9584:fe35f55ee984
[gaim-migrate @ 10427]
" When joining a jabber conference many jabber servers
send a recap of the last 20 or so messages. If you
have sounds enabled, this will result in either 20
sounds in row, or worse if mixing is available, a
horrible mix of 20 overlapping sounds. These recap
messages can be identifed be the presence of the
"jabber:x:delay". This patch identifies delayed
messages, passes that information through flags from
the prpl to the core, and then on to the gui. Detailed
changes:
Add GAIM_MESSAGE_DELAYED to GaimMessageFlags to
indicate a delayed message.
Change gtkconv.c to not play sounds when either
GAIM_MESSAGE_DELAYED or GAIM_MESSAGE_SYSTEM are set.
Add GaimConvChatFlags, parallel to GaimConvImFlags, to
pass flags from protocols to core. Currently contains
two flags:
GAIM_CONV_CHAT_WHISPER
GAIM_CONV_CHAT_DELAYED
Change fourth arg of serv_got_chat_in() from "int
whisper" to "GaimConvChatFlags chatflags".
Change jabber prpl to set delayed flag when the
"jabber:x:delay" element is present. Change toc
protocol since it uses the whisper flag." --Nathan Fredrickson
Date: 2004-07-24 00:49
Sender: marv_sfAccepting Donations
Logged In: YES
user_id=790708
I'm not sure I like naming the flags "DELAYED". I mean
that's okay inside jabber since that's what the jabber
protocol refers to it as, but for the the GAIM_*_DELAYED
flags, I think they should be named something else.
I thought about NOSOUND, but I decided that was wrong,
because the flag should say what kind of message it is, not
what to do with it, that's up to the UI to decide.
What's up with not playing sounds on GAIM_MESSAGE_SYSTEM?
This sounds unrelated to this. Are there times when we want
to play sounds on system messages?
Date: 2004-07-24 09:13
Sender: noif
Logged In: YES
user_id=365548
I purposely did not use a name that implied what the UI
should do with the flag. The only characteristic that makes
these messages unique is that they've been stored in the
server for some period of time and are not current. I'm
open to a better flag name than "DELAYED"... I thought about
"RECAP", but that seemed less generalized than "DELAYED".
As for not playing sounds on GAIM_MESSAGE_SYSTEM, that can
be removed if it's controversial. I think I slipped that
in since the setting of the topic was still playing a sound
every time you joined a jabber conference.
I think we can change the flag name ourselves if something else is better.
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Sat, 24 Jul 2004 15:18:32 +0000 |
parents | a47f038ecf9a |
children |
line wrap: on
line source
.TH gaim-remote 1 .SH "NAME" gaim-remote v@VERSION@ \- Gaim command-line remote control .SH "SYNOPSIS" .TP 5 \fBgaim-remote \fI[command]\fR \fI[parameters]\fR .TP 5 \fBgaim-remote -h \fI[command]\fR .SH "DESCRIPTION" .PP \fbgaim-remote\fR is a command-line interface for controlling an already-running instance of the Gaim Instant Messaging client. It currently has only rudimentary support for launching AIM-style URIs, and closing the running instance, although further functionality is planned. .SH "OPTIONS" The following options are provided by \fBgaim-remote\fR: .TP .B \-h [\fIcommand\fB] Display help for \fBgaim-remote\fR or a specific command (see below). .SH "COMMANDS" The following commands are implemented by \fBgaim-remote\fR: .TP .B quit Closes the currently-running instance of \fBGaim\fR. .TP .B uri [URI] Sends the given AIM-style URI to the currently running instance of \fBGaim\fR (see below). .SH "URIs" The following URIs are currently valid. These default to acting on the first AIM account you have in your list: .TP .B aim:goim?screenname=[SCREENNAME] Begins a new conversation with the given screenname. .TP .B aim:goim?screenname=[SCREENNAME]&message=[MESSAGE] Sends the given message to the screenname. Spaces in the message must be replaced with +. .TP .B aim:gochat?roomname=[CHATROOM] Opens a chat window in the given room. .TP .B aim:addbuddy?screenname=[SCREENNAME] Opens a dialog to add the specified buddy to your buddy list. .SH "FILES" .TP .I /tmp/gaim_[USERNAME].[INSTANCE] The UNIX domain socket used to contact the running instance of \fBGaim\fR. .SH "SEE ALSO" .BR gaim (1), .BR \fIhttp://gaim.sourceforge.net/\fR, .BR \fIhttp://www.sourceforge.net/projects/gaim/\fR .SH "AUTHOR" .PP This manpage was written by Robert McQueen <\fIrobot101@debian.org\fR> for the Debian GNU/Linux system (but may be used by others).