***JRNet Documentation***
*Overview*

JRNet is a chat client to LummoxJR's chat system. It is designed to offer more features than the standard client such as sound, /seen, per-user message windows . . .

Comments on or suggestions for improvements to JRNet should be directed to TheGreenReaper (Laurence Parry) - greenreaper@hotmail.com

All commands should be avilable via menus, but I know at least one user prefers a CLI (me ;-).

*Hints*

Left-click on someone's name in the user list to send a /MSG to them. Right-click to bring up a menu of fun things to do to them. Right-click per-user message windows to get rid of them.

ESC will autocomplete a name. Press again to get the next match - cycles at the end.

Up+down arrow keys in the send box will access send history (the last 100 things you said).

Link multiple commands with &&& (so "one &&& two &&& three"). Works with aliases, like: /alias /stuck /time 1ms /kick %1 &&& /setinfo %2 name %1

If you do not see what you require . . . ask! Feature requests are welcome! <g>

*Function keys*
F1 - opens this file
F2 - connects
F3 - opens the log for the last person to enter who was logged (useful for checking up on them)
F4 - unsticks the last stuck person
F5 - /vote y {user on vote button}
F6 - removes current vote
F8 - /vote n {user on vote button}

*Command prefixes (put in front of other commands)*

/NOEVENT - Prevent lower lifeforms from hearing of your nefarious deeds

/NOIGNORE - Prevent a statement from being ignored

/PWD password|newname - Supply a password to a command (or a new name for waitlist voting)

/TIME time - Specify a time for a command. Sample: /TIME 1w2d3h4m55s66ms

/UN[command] - Do the reverse of the command. May have reduced paramaters (usually just a name/IP).

*Summary of commands*

/AWAY [awaymsg] - Sets away. If you are /msg'd the sender will recieve notification of your status

/BACK - Returns from an away

/QUIETAWAY, /QUIETBACK, /QA, /QB - As /away and /back, only quieter - ops may prefer you use these . . . <g>

/BANINFO ip - Displays information on the specified banned IP

/BANLIST - Displays a list of banned IPs

/CLEAR - Clears the screen

/CLOSE [username] - Close a private message pane (the current one if not specified)

/COLOURS - Change interface colours (and font - by popular demand ;-). Also allows you to set a background image (probably only works on Win2k/XP).

/EXIT - Disconnects and quits JRNet

/GAGINFO user - Displays details of a specified gag

/GAGLIST - Displays a list of gagged users

/HELP [command] - Displays help on a specific command, or just shows this file

/ISGAGGED username - See if a user is gagged

/ISIGNORING username - See if a user is ignoring you

/IGNORE | /PLONK username - Ignore the specified user

/IGNOREBYWORD - Ignores *everything* with the specified word in. Be warned, this is severe; if you ignore "a", every sentance with the letter "a" in will be ignored. Works with usernames.

/IGNORELIST - Displays a list of users you are currently ignoring

/JOIN | /ROOM roomname - Joins the specified room 

/KEEPOUTLIST - Displays a list of users kept out of your room

/KEEOUTINFO - Displays details of a specific keepout

/LASTKICK - Display the last person to be kicked (probably)

/LASTNULL - Display the last person to be nulled

/ME action - Sends an action to the server ("GreenReaper does something")

/MSG username [message] - Sends a private message to the user specified

/NICK newusername - Changes your name to the new name specified (by reconnecting). Names may be no longer than 31 characters.

/NOTE username|IP:ip [note] - set a note to be shown on entry. Leave out the note to read it, or use /unnote username|IP:ip to erase it.

/OPLIST [roomname] - Returns the ops online, or just in a room

/PASSWORD newpass - Sets the password to be used on login (for named accounts)

/QUIT, /PART - Disconnects from the server.

/QUERY username - Opens a message window to the specified user

/ROOM newroom - Change room.

/ROOMINFO roomname - Returns details on the specified room

/ROOMLIST - Returns a list of (remote) rooms

/SAY text - Says something (useful for saying commands)

/SEEN username|IP:ip - Displays lastseen info on a user or IP (partial username or IP matches the most all starting with it)

/SEENALT username|IP:ip - Displays lastseen info on a user or IP using the alternate lookup method of searching for users with the specified ID or IP's with that last user (partial username or IP matches all starting with it). Useful for historical information (what IP's has that user used, who has had that IP . . .)

/SEND username filename - Sends a file to a user. *Does not work* . . . at least, not usually (there's a problem with getting the right IP). It might for you - but only if you're both using JRNet.

/TIMESTAMP - Toggles timestamping of events

/USERLIST - Displays a list of users on the server

/WAITINFO - Displays details of a waitlist entry

/WAITLIST - Displays a list of waitlisted addresses (users with these IPs must be allowed on by a TempOp or higher)

/WHEREIS username - Tells you where a user is

/WHO roomname - Displays a list of the users in the specified room

/WHOIS username - Retrieve any information on the remote user(s) specified.

*Op commands* (NB: Not all have been tested, because I'm not an op. Be warned :-)

/BAN ip - Bans the specified IP (full or partial)

/DEOP username - Remove temp-op status from a user. You must be a SysOp or Master

/GAG[BYIP] user[,user2,...] [reason] - Gags a user

/KEEPOUT[BYIP] user[,user2,...]|ip[,ip2...] [reason] - Keeps a user from entering a room

/KICK user[,user2,...] [reason] - Kicks the specified user. TempOps may only kick from their own room.

/LOG [logfile|STDOUT] - Dumps a log of recent conversation. Writing it (to a logfile or standard output) is a Master-only operation.

/MAIL user[,user2,...] message - Sends a chat-mail to the specified users. SysOp only

/NAME newusername - Change your name. Master and SysOp only

/NULL username - Nulls a user (just a shortcut)

/OP username - Make a user a temp-op. You must be a SysOp or Master

/PERMROOM roomname - Makes a room permanent

/SERVERINFO - Returns information about the server (I don't know who has access to this, but it seems not users ;-).

/SETINFO user|room property [value] - Sets a property on an object. You must be SysOp to access users (lower than yourself), and may need to be Master for some operations

/SETROOM roomname property value - Sets a room property. You must be SysOp, possibly Master

/SHUTDOWN - Shuts the server down, probably. I haven't even tried this command. Highly likely to be Master-only.

/WAIT ip - Adds an IP to the waitlist

/Y username|/VOTE Y username - Allows a waitlisted user in

/N username|/VOTE N username - Prevents a waitlisted user from entering

*Option-related commands*

/ALIAS alias [aliascommand] - Adds, modifies or removes an alias. If the aliascommand is not present, the alias is removed (if it exists).

Aliases can consist of any string - if the string contains the special tokens %1, %2, ... they will be replaced with arguments, up to the maximum given (don't specify less than it expects, or you'll end up with tokens in your output :-). %0 = all the arguments. Example: suppose the alias 're' -> 'rehi %1!' was defined - then typing 're GreenReaper' would result in the output 'rehi GreenReaper!'. Commands are valid alias strings and will be processed as normal, however, you should *not* specify an alias as an alias string (to prevent loops, it will be aborted).

/ALIASLIST - Displays a list of all aliases

/AUTOCONNECT - Toggle auto-connect on launch

/COLOUR, /COLOUR - Opens the colour, font and background customization dialog

/DEBUG - Toggles display of the debug window

/!SEEN - Toggle response to private !seen requests (eg "!seen GreenReaper")

/!TIME - Toggles response to private !time requests (gives local time)

/EMPHASISFILTER - Toggles *emphasis* recognition
/EMPHASISSHOWSTARS - Toggles showing the *emphasis* stars

/FLASHCHANNEL - Toggle taskbar flashing when a normal message arrives
/FLASHPRIVATE - Toggle taskbar flashing when a private message arrives
/FLASHNOTAWAY - Toggle not flashing while away

/MESSAGES - Opens the message customization dialog

/MNADYSWITCH - Switches the URL and vote buttons around

/MSGWINDOWS - Toggles showing messages in per-user windows

/NOSCROLLSELECT - Toggles keeping selected text on the screen

/PREVSEEN - Toogles display of "previously known as" information

/REMEMBERPOSITION - Toggles remembering the on-exit window position/size

/STARTUPROOM - Change the startup room (where you're initially logged into - [null] is available)

/SOUND - Opens the sound customization dialog

/TIMEREFRESH - Toggles the timed refresh of the userlist (detects opping and a few other things)

/TIMESTAMP - Toggles timestamping

/WARNDISCONNECTALL - Toggles warning if you try to disconnect
/WARNDISCONNECTOP - Toggles warning if you try to disconnect and you're the only op around

*Changelog*
575 - Userlist IP option added (Rascii)
574 - " and .ca in url check, ...to *not* a URL, logging with *emphasis* fixed
573 - F3 now covers last use of /seen
572 - Disconnect warnings optional, /unalias required to remove aliases, /emphasisshowstars added
571 - *Emphasis* filtering added. Last-op and disconnect warnings added.
570 - "/msg Chani /me ..." fixed. View log for last user entered on F3 added. %n = last entered in aliases
569 - /!seenprivate -> /!seen (and menu changed), /note menu interface and multiple URL catching added
568 - /pwd vote spurious error fixed, config dialogs set to be floating
567 - F1 added (help), and F2 (connect), close warning when connected
566 - Fixes for F4
565 - Timer refreshed fixed, F4 = Un-stick last stuck name.
564 - /notelist added
563 - /nick query fixed
562 - Position remembering fixed
561 - /note text colour and sound added
560 - Error checking removal reversed
559 - /note fixed for partial ip's
558 - /note added
557 - Colours transferred on name change
556 - Vote button fixed
555 - No default password option added
554 - Italicising, bolding fixed
553 - Fixed /msg, added background in colour edit window
552 - Fixed normal font
550 - Added per user fonts and colours
548 - Sound test, /help, connect and disconnect sounds added, normal message now customizable
547 - F5, F6, F8 added as /y, discard vote, /n shortcuts
546 - /mnadyswitch added
545 - CTRL-C in chat window fixed
544 - /gagbyip fixed
543 - A few fixes and minor additions, CTRL + Right-click to vote no
542 - /keepoutbyip fixed
541 - %0 redefined to mean "every argument after the last one specified"
540 - !time added
539 - Re-entry problem fixed, inital name asking added, inital colours fixed, multiple user /null and /setinfo added. Highlight sound added (Rascii)
538 - Get latest update in Help menu
537 - Copy IP copies to clipboard
536 - /seenalt added to menus, /op multi-user fixed
535 - Timestamp log option fixed (Corey)
534 - Window positioning fixed, checks for validity
533 - !seen security bug fixed, /seenalt command added - shows "historical" data
532 - !seen in channel removed (LJR), /vote now a proper command (JF, Julianne)
531 - Chat window sizing with large fonts fixed
530 - Mail checking *fixed* (I hope . . .)
529 - ' and / now do not interrupt autocomplete
528 - Misc. small improvements.
527 - Flashing fixed for Win95/NT users, CTRL + N switches between /msg windows
525 - Now checking mail on load for passworded users
523 - Settings fixed for Large Fonts
521 - /mail recipient name issue fixed
520 - Fixed an autoconnect issue
519 - Changed label text colour (back ;-)
518 - Added separate "highlighted text" colour (currently messages with your name in)
517 - Message tab name changed on in-chat name change, URL button now caches URLs like vote button
515 - Added number of users display, op/user percentage and ratio, "op ratio low" warning sound
513 - Added generalised /SEEN - you can now search on partial names/IPs
512 - Fixed log viewing, decreased processor use (and username/status bar flickering)
511 - Fixed rename user menu option
508 - Added window position remembering
507 - Added auto-connection on launch
506 - Added &&& for multiple commands in one line/alias (Helen), fixed /say in message windows.
505 - /me in /msg windows fixed, multiple kick, leaving, property change fixed (all Chani), /ignorebyword added
504 - Changed some notice colours to warning, trims /me (helps with ; shortcut), password in menu.
503 - Fixed log view (Corey), alias listing (JacketFan)
502 - Added seen search in menus
501 - /log fixed, /alias user-proofed. Changelog added ;-)

*Credits*

Thanks to The Beatles and Ozy and Millie (www.ozyandmillie.org) for creative inspiration and comic relief (not necessarily in that order). Thanks also to everyone who offered testing or criticism, particularly Beth, Gate, JacketFan, Lacota and Rascii, and of course LummoxJR for permitting me to make this program.ting or criticism, particularly Beth, Gate, JacketFan, Lacota and Rascii, and of course LummoxJR for permitting me to make this program.