                                                     Last Updated: 16 June 1997

Known big bugs:

- Lines are not processed by <CR> _OR_ <LF> instead they require a <CR><LF> to
  mark the end of a line.  (problem with NTCPDRV I think)
- QUOTING not implemented
- INSERT MODE DOES *NOT* WORK.
- Doesn't display correctly after the 80th column.  Can't figure out why
  "MOD" didn't work before but since I still can't use it we are stuck with
  only 80 columns visible.  However it will continue on (probably to a max of
  255 chrs, however MAX size for outgoing messages is:

          123456789
  PRIVMSG <destination> :<msg>
  1234567890123456789012.....1  2
                             CR LF
  roughly 255-24 characters.


LastFixed:

- This is now listed in changes.log (in the zip file) and chjpirc.txt on the
  web site.

Possibly Answers to possible problems:

* Multiple channels?

  /A  will list all the channels jpIRC "thinks" you are in
  F5 is supposed to cycle the active channel in the window you are using.
  F6 to switch among which is the active windows (/WINDOW NEW seems to work
     for having two windows, after that things can get pretty messy).

|
* People are typing lines too long
|
| This is a big problem with Turbo Pascal not being able to handle strings
  longer than 255 chrs.   I can probably write around the problem, but that
  could take weeks of REWRITING *EVERYTHING* (I'll probably get started and
  slowly change each thing bit by bit).  I will try to fix it up some more
  before then though...


Don't want to spend much time on any documentation just yet.  Trying to patch
things up and take the stuff that is patched up and clean it up.


In order to run this you will need a packet driver.  This FTP site URL points
to a lot of the most common packet drivers around:

ftp://ftp.simtel.net/pub/simtelnet/msdos/pktdrvr/


In addition you need:

ftp://ftp.trumpet.com/tcp-abi/ntcpdrv.zip


JPTCP.INI must exist.   Entries allowed in the file are:

                            (Stuff on this side should NOT be in the INI file
                             unless it is ; commented out (I "think" commenting
                             out works, but haven't tried using the .INI file
                             with them in it))

[JPIRC]
Nick =                        Your IRC Nick
RealName =                    Real Name, but do you really want/need to put it?
                              I notice some IRC clients use this to put email
                              address.  To be honest I think its not that great
                              an idea.
DefaultServer =               Default Servername
DefaultPort = 6667            Port number for Server
UserInfo =                    User info displayed when FINGER'd
DebugLogFlag = No             Logs incoming stuff to debug.irc (F9 to toggle)
                              This log is very verbose and probably won't be
                              entirely useful for the user.  (I may change this
                              in the late future)
UserName =                    account name
AutoRegister = N              Y=Auto-connects to DefaultServer on startup
ExitFirstQuit = Y             Y=Automatically exit jpIRC when /QUIT used.
hostname = *                  Set this to your IP Address' hostname or leave *
                              * = your IP Address by number
                              ! = your domain name
TcpOpenTime = 450             Increase this if it is timing out before
                              successfully connecting with the server.
MOTD =                        QuoteD servername
                              Quote of the Day  <or>  "Cookie" (UDP 17) and
                              this is currently not used (I was playing with
                              it a bit but found it can sometimes be quite
                              slow at starting up.

And set UserName and RealName in [identd] to match the above.

And in the [pop3] section:
Server = pop3 server name
User = account name
Password = password
Port = 110

I noticed lots of IRC clients out there asking for an Email address in their
setup files, however I have never seen anything in any IRC specs regarding
the passing of an email address.

PgpInfo is a little CTCP I decided to add to the client for those who want
to show where people can get their PGP public key.   PGP stands for Pretty Good
Privacy and is a Public/Secret Key method encryption program.   People should
note that if you have your email address with your name in your public key
and point to your public key that people on IRC can get your email address this
way.   This entry in the INI file is completely optional and is only useful
for those who want to show everyone their public key.

;          size   key-id        p g p   f i n g e r p r i n t             simpile directions to get it
PgpInfo = "0000/00000000:00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00:http://www.pgp.net/pgp/"

Size is the PGP Public key size (bits).   This information is shown when doing
a PGP -kv of the public key ring.  for example my PgpInfo is set at:

PgpInfo = "2048/A8A1DCD5:E0 9E 9B EF C8 E4 68 3D  B5 9C 72 4C EC 61 DD 7A:http://www.pgp.net/pgp/"

The only things needed for someone to actually find a key is the key ID
"A8A1DCD5" and the last thing on the list which points to where the key can
be obtained.

There isn't any help available yet (although /HELP will list most of the main
command portions).   Don't use /WINDOW NEW yet, it sort of works and sort of
doesn't (mostly doesn't).  Or if you do use it F6 toggles what window is active
and you should also note that /WINDOW KILL works less than /WINDOW NEW (and you
can not kill Window #1).

SECURITY CONSIDERATIONS
=======================
  Be aware that any TCP connections are nearly always plain-text (can EASILY be
read with a packet sniffer or software that does the same).   Sensitive info
such as passwords are often sent the same way (although some programs do use
a form of simple encryption-like methods to not send passwords in the open).

The POP3 mail checker program here (as well as on a number of other programs)
does not currently use MD5 checksums (unless I can figure a way to do MD5 in
Turbo Pascal on a 8086+) therefore passwords are sent in the clear.  If you
are sure there isn't enough hops between your connection and the POP3
mailserver then you probably don't have much to worry about.   Everytime this
program does any checking for mail it will send USER <pop3user> then
PASS <pop3password> when it does (which is by default every 180 seconds).


Running as a BOBCAT external:
============================

You'll have to figure out the subdirectories below on your own for now...
When jpIRC is called with the following batchfile (showing BOBCAT as the
first parameter on the command-line), a few things are overridden from the
JPTCP.INI file.  These things are:
ExitFirstQuit = True
BeStrict = False
AutoRegister = True
DefaultServer = ParamStr(2)
DefaultPort = ParamStr(3)

future versions may process the channel from ParamStr(4) (bobcat's %1)

Other Notes:
- Bobcat doesn't use the standard default irc port of 6667.
- Bobcat doesn't process "irc:/#channel" to use a default server.

NTCPDRV.EXE should be in the path or in the same directory as jpirc, otherwise
you will have to specify in the batchfile where it can be found...

It is very important that NTCPDRV.EXE -u  is called when exiting!!!
(because NTCPDRV is a TSR)

Create the following batchfile in bobcat's EXTERNAL\ subdirectory:
-- IRC.BAT ------%<---
@echo off
c:
cd ..\..\jpirc
ntcpdrv
jpirc BOBCAT %2 %3 %1
ntcpdrv -u
cd ..\bobcat
--- cut here ---->%---


ErrorLevels Returned: (other than the standard Turbo Pascal RunTime Errors)
====================
61      - NTCPDRV not installed
86      - CPU is less than a 286 (currently disabled)
113     - IDENTD couldn't startup
255     - Invalid NTCPDRV Interrupt number specified on command line
          (first parameter after program.  e.g. :  C> PROGRAM.EXE 0x61
           uses Int # 61h (hexadecimal))


