JICB v1.1, a Java ICB client
Copyright 1996-2004 by Mark Hughes <mark@markdamonhughes.com>
You can always find the current version of JICB at
  <http://markdamonhughes.com/JICB/>

_______________________________________________________________________________
WHAT'S NEW

v1.1
* Repackaged for easier install.
* Updated default server
* Fixed input line flickering, though now you have to click to focus on the
  input line.  Guess you'll have to live with it.
* Support for larger fonts.  This is experimental and often ugly.
  java -jar jicb.jar -i 14 -f 14
  -i sets the input line font, -f sets the terminal font.
  12 point is the default value, change it to whatever you like.

v1.091
* Timestamps!  "/option timestamp true" will show the current time in front
  of every line, so you know exactly WHEN something happened!
* Clipboard!  You can now copy text to the clipboard just by selecting it,
  and paste it in by hitting alt-P or the Paste button on the toolbar.
  You can even paste text as a private message to someone with "/paste <name>"
* Memory!  The JICB window now remembers where you left it!  If you get it
  stuck off the screen, just quit, delete the jicb.dat file, and restart.

v1.09
* NOW IN COLOR!  Yes, colorization has come to JICB, with the /color command!
* Toolbar!  Now there's a handy and attractive toolbar full of commands you'll
  use every day - and if you don't, you can type "/option toolbar false" and
  get rid of it.
* Dialogs!  The help system is now a nice clickable menu, passwords are
  entered in secret dialogs instead of on the command line, and more.

v1.08
* Upgraded to JDK 1.2 and made it vastly easier to install and use.
* Went to an open-source license.  Read "license.txt" for the rights and
  restrictions on use of this program.

_______________________________________________________________________________
WHERE TO GET IT

  <http://markdamonhughes.com/JICB/> will always have the latest
version of JICB.

_______________________________________________________________________________
INSTALLATION

  Carefully read and follow these steps, one at a time.  No, really, this
MATTERS.

0) GETTING JAVA (if you don't have it already)
   If it is not pre-installed on your OS, install a JRE (Java Runtime
   Environment) from <http://java.com>.


1) EXTRACTING THE ARCHIVE
   Unzip this archive with Info-ZIP or Winzip (pkunzip does not handle long
   filenames) anywhere you like on your hard drive.  You will now have a
   directory named "jicb" somewhere.

   Example:
    [C:\] unzip jicb-1.1.zip
    Archive:  jicb-1.1.zip
       creating: jicb/                 
      inflating: jicb/jicb.jar       
      inflating: jicb/!README!.TXT       
      ...

   You can get Info-ZIP at <http://www.cdrom.com/pub/infozip/>
   You can get winzip at <http://www.winzip.com/>


2) JICBRC - YOUR OWN CUSTOMIZABLE SETUP
   If you want to customize JICB, you'll need to put the commands in a file
   named "jicbrc" in the JICB directory.  I have an example as jicbrc.sample.

   Copy the "jicbrc.sample" file to "jicbrc":
     [C:\jicb] copy jicbrc.sample jicbrc
   Be sure to go through it and change whatever you like - it's simply a list
   of commands to execute, just as if you typed them yourself (but without
   the "/" - you can use "say <text>" to say something to the group once you
   are connected).

   If you want JICB to automatically try to connect to the server when it
   starts, have the last command in it "connect" (see "/help local" for more
   information).

   If you have commands that have to happen after connection, use
   "option deflogin <scriptfile>", and put those commands in <scriptfile>.

   What does "rc" mean, you ask?
    According to Hacker's Jargon File <http://www.tuxedo.org/~esr/jargon/>:
    rc file /R-C fi:l/ /n./
    [Unix: from `runcom files' on the CTSS system ca.1955, via the startup
    script / etc/rc] Script file containing startup instructions for an
    application program (or an entire operating system), usuall y a text file
    containing commands of the sort that might have been invoked manually once
    the system was running but are to be executed automatically each time the
    system starts up.  See also dot file, profile (sense 1).


3) RUN JICB!
   Windows: Double-click on jicb.jar

   Unix: chmod 700 jicbunix.sh; ./jicbunix.sh
    Under KDE, you can launch it by double-clicking, but first you have
    to alter how Konqueror handles jars.  Right-click on jicb.jar, click
    Edit File Type, Add application, and type "java -jar".  Hit OK.  Now
    try double-clicking, and it should work.

   MacOS X: Double-click on jicb.jar

   OS/2: Run jicbos2.cmd

   When JICB comes up, type /help or hit F1 if you need help, and then read
   the rest of the help subjects.  The online help is there FOR YOU.  If you
   do not read it, the author will not help you in any way, except to point
   you back at the online help.

_______________________________________________________________________________
BREAKING THROUGH A FIREWALL
   If you are behind a firewall, set the PROXY_HOST environment variable to
     <proxy host dns name>:<proxy port>
   Example:
     SET PROXY_HOST=proxyhost:8080

_______________________________________________________________________________
KNOWN BUGS/LIMITATIONS

* Slow scrolling.  This can be a real problem if you're using a large screen. 
  Try setting '/option scrolljump 3' (or even higher), and see if that helps. 
  If not, let me know - the more demand for a faster screen, the more work
  I'll put into it.

* If you stay online for a very long time, the scrollback will eventually
  consume all memory and bring about the heat death of the universe.  This
  isn't normally a problem, but theoretically it could happen.

* When JICB loses a connection to the server, it has no clue.  You have to
  hang up (alt-h or '/hangup') and re-connect.  This is a Java socket
  limitation, and I am trying to find a solution.

_______________________________________________________________________________
WHAT USED TO BE NEW

v1.07
* Integrated the scrollback into the terminal.  When your screen goes grey,
  you're looking at the scrollback - the history of all text that's gone by
  before.  Hit PGUP and PGDN to move around in it, and ESC to get rid of it. 
  You don't really want to use JICB all the time in scrollback mode, because
  it doesn't show a cursor and it doesn't move along with the text.  It also
  displays a bit slower than usual.

v1.06
* Added simplistic clipboard support - drag the mouse over text, and a
  rectangular region will be highlighted and placed in a text area.  Then just
  hit your usual "copy to clipboard" key (control-insert on OS/2 and Windows,
  Propeller-C on Macs, etc.)  Hit escape or close the "clipboard" window to
  get rid of it.
* Put help files in pop-up windows, so they don't scroll off the screen.

v1.04
* Made more stable on and compatible with more platforms.
* Added '!' and '>' commands, to execute local programs from inside JICB.
* Added 'unmacro' command and changed 'macro <name>' to be consistent with
  'option'.
* Command-line option to change the size of the scrollback buffer.

EOF