International Support

IMCom now handles international characters from what I've been told. Simply open your ~/.imcom/imcomrc file and add encoding tags to your profile. Example: <encoding>iso-8859-1</encoding>. Set it to the appropriate encoding for your locale and it should, in theory, be all happy.

What do you mean group support?

Each user can belong to zero or more groups. To show the groups a particular person belongs to use the membership command.
Example:

      IMCom> /membership airog

This would return the list of groups the user airog belongs to.

To see which users belong to a particular group use the show command.
Example:

       IMCom> /show lurker

This would return a list which looks very similar to the roster list except that it only shows users which are members of the group lurker.

To see a list of the groups that you have just use the show command with no arguments.
Example:

      IMCom> /show

This would return the list of groups currently in existance.

Note that you never actually have to create a group. Simply adding a user to a non-existing group will create that group.

There are currently two special groups: lurker and ignore.

The lurker group is used for people who you want to have Nick<->JID matching on, but don't want to see status updates for or even on your roster at all. For instance, I use the lurker group for people who I have on my list twice, once with their icq user and once with their jabber user. I add their icq user to my lurker group so I never see it unless I really want to. I also use it for people who I very rarely talk to. People who are a member of the lurker group will only ever show up if you use the show command to show the members of group lurker. If a user (bob) belongs to both lurker group and school group, and you use the show command to list the members of the school group bob will not appear in that list because he is a lurker. The only list a lurker will show up in is the lurker list.

The ignore group is used for people who you never want to see anything from.

Summary:

To add a user to a group use the addgroup command. It will create the group if necessary.
To remove a user from a group use the delgroup command. It will remove the group if no users exist in the group anymore.
To set a user belonging to just one group use the setgroup command. It will create the group if necessary.

$0 through $9

The person who most recently evented you is stored in $0 through $9. Events include messages, auth requests, file requests, basically everything EXCEPT status changes.

This is an advanced feature and not yet well tested at of version 0.62. It is useful when random3409783408@jabber.org messages you because you can then just

IMCom> /info $0

To get info on random3409783408@jabber.org.

Aliases

This is another advanced feature that was requested. Basically aliases are textual-substitution commands. That is, you can shorten one command line to a single command. For instance, say you are running on a unix system and want to bind the command /cls to clear the screen. You could

IMCom> /alias /clear ! clear

Which would create the alias /clear, which would literally run ! clear

Let say I message user bob often. I could

      IMCom> /alias /bob /msg bob

which would allow me to

      IMCom> /bob hi!

Sending the message "hi!" to bob.

Summary:

To get a list of aliases use just /alias
To remove an alias use /unalias [alias-name]
eg: /unalias /bob
To save aliases to your preferences issue a saveprefs command, which defaults to /saveprefs

Modules

This is another advanced feature that was requested. Modules are a generic way of adding new user interface features to IMCom. A module can register for events and add commands to IMCom. In the modules directory there are a few example modules. If you are interested in extended the user interface of imcom to do new things, take a look at the examplemodule. I'm willing to help those who want to write modules figure it out, just IM me or email me.

Advanced Stuff	Navigation: Home IMCom News What is IMCom Download Commands Advanced ChangeLog Example Config
International Support IMCom now handles international characters from what I've been told. Simply open your ~/.imcom/imcomrc file and add encoding tags to your profile. Example: <encoding>iso-8859-1</encoding>. Set it to the appropriate encoding for your locale and it should, in theory, be all happy.
What do you mean group support? Each user can belong to zero or more groups. To show the groups a particular person belongs to use the membership command. Example: IMCom> /membership airog This would return the list of groups the user airog belongs to. To see which users belong to a particular group use the show command. Example: IMCom> /show lurker This would return a list which looks very similar to the roster list except that it only shows users which are members of the group lurker. To see a list of the groups that you have just use the show command with no arguments. Example: IMCom> /show This would return the list of groups currently in existance. Note that you never actually have to create a group. Simply adding a user to a non-existing group will create that group. There are currently two special groups: lurker and ignore. The lurker group is used for people who you want to have Nick<->JID matching on, but don't want to see status updates for or even on your roster at all. For instance, I use the lurker group for people who I have on my list twice, once with their icq user and once with their jabber user. I add their icq user to my lurker group so I never see it unless I really want to. I also use it for people who I very rarely talk to. People who are a member of the lurker group will only ever show up if you use the show command to show the members of group lurker. If a user (bob) belongs to both lurker group and school group, and you use the show command to list the members of the school group bob will not appear in that list because he is a lurker. The only list a lurker will show up in is the lurker list. The ignore group is used for people who you never want to see anything from. Summary: To add a user to a group use the addgroup command. It will create the group if necessary. To remove a user from a group use the delgroup command. It will remove the group if no users exist in the group anymore. To set a user belonging to just one group use the setgroup command. It will create the group if necessary.
$0 through $9 The person who most recently evented you is stored in $0 through $9. Events include messages, auth requests, file requests, basically everything EXCEPT status changes. This is an advanced feature and not yet well tested at of version 0.62. It is useful when random3409783408@jabber.org messages you because you can then just IMCom> /info $0 To get info on random3409783408@jabber.org.
Aliases This is another advanced feature that was requested. Basically aliases are textual-substitution commands. That is, you can shorten one command line to a single command. For instance, say you are running on a unix system and want to bind the command /cls to clear the screen. You could IMCom> /alias /clear ! clear Which would create the alias /clear, which would literally run ! clear Let say I message user bob often. I could IMCom> /alias /bob /msg bob which would allow me to IMCom> /bob hi! Sending the message "hi!" to bob. Summary: To get a list of aliases use just /alias To remove an alias use /unalias [alias-name] eg: /unalias /bob To save aliases to your preferences issue a saveprefs command, which defaults to /saveprefs
Modules This is another advanced feature that was requested. Modules are a generic way of adding new user interface features to IMCom. A module can register for events and add commands to IMCom. In the modules directory there are a few example modules. If you are interested in extended the user interface of imcom to do new things, take a look at the examplemodule. I'm willing to help those who want to write modules figure it out, just IM me or email me.
Tips and Tricks There are a few random little tricks in IMCom that don't seem to have a home in the documentation. This is the spot for them. When you have readline support hitting [Tab] on a empty line will prefill with "/msg last-person-you-messaged ". This is similar to the // command. Similarly if you hit [Space] then [Tab] IMCom will prefill with "/msg last-person-who-messaged-you ". This is similar to the /r command, but safer. There are two special groups: lurker and ignore. The ignore group does what you think it does. The lurker group is for people whom you never want to see in your roster list, but want a jid<-> mapping. See the groups section for more details You can customize commands by editing your ~/.imcom/imcomrc file. First thing to do is issue a /saveprefs from within imcom. This will output a complete config file. Then open up the ~/.imcom/imcomrc file with a text editor capable of reading and writing with UTF8 encoding. You'll see two giant command blocks. The block outside the profile tag applies to all profiles. The block inside your profile applies to only your profile overrides the block outside. Just find the command you want to modify by searching for it. Change it to whatever you want. Remember that XML encodings apply to the following special characters: < > " ' &.

Advanced Stuff

International Support

What do you mean group support?

$0 through $9

Aliases

Modules

Tips and Tricks