readme.txt

一组Delphi/C++Builder上使用的Internet构件源码

ICS - Internet Component Suite
==============================
(Aka FPIETTE's Components)


Revised: October 3, 1999
http://www.rtfm.be/fpiette/indexuk.htm

Legal issues: 
-------------
              Copyright (C) 1997, 1998, 1999 by Fran鏾is PIETTE 
              Rue de Grady 24, 4053 Embourg, Belgium
              <[e-mail]> <[e-mail]>

              This software is provided 'as-is', without any express or
              implied warranty. In no event will the author be held liable
              for any damages arising from the use of this software.

              Permission is granted to anyone to use this software for any
              purpose, including commercial applications, and to alter it
              and redistribute it freely, subject to the following
              restrictions:

              1. The origin of this software must not be misrepresented,
                 you must not claim that you wrote the original software.
                 If you use this software in a product, an acknowledgment
                 in the product documentation would be appreciated but is
                 not required.

              2. Altered source versions must be plainly marked as such, and
                 must not be misrepresented as being the original software.

              3. This notice may not be removed or altered from any source
                 distribution.

              4. You must register this software by sending a picture postcard
                 to the author. Use a nice stamp and mention your name, street
                 address, EMail address and any comment you like to say.


Register
--------

ICS is freeware. If you use the components, you must register by sending a 
picture postcard showing the area you lives in and some beautiful stamps for 
my kids who are stamp collectors. Do not use an envelop, I collect USED
postcards sent to me.

Address your card to: Francois PIETTE, rue de Grady 24, 4053 Embourg, Belgium.
Don't forget to mention your name, address and EMail.


Installation:
-------------

The zip file has subdirectories in it. You must use the pkunzip -d option
to restore this directory tree or you will have problems because the files 
will not be in their proper subdirectories.

This is the subdirectory layout:

.\                           Info directory
.\delphi\internet            Delphi sample applications (all Delphi versions)
.\cpp\internet               C++Builder sample applications
.\cpp\internet\bcb1          C++Builder version 1 projects
.\cpp\internet\bcb3          C++Builder version 3 projects
.\cpp\internet\bcb4          C++Builder version 4 projects
.\delphi\vc                  Delphi 1.x files (winsock.pas 16 bits and *.dcr)
.\delphi\vc32                Delphi (1/2/3/4/5) and C++Builder (1/3/4) components

DELPHI 5: Directory VC32 contains IcsDel50.dpk which is a package source for
all components. Using Delphi, do a file/open, select *.dpk and browse to
the VC32 directory. Select IcsDel50.dpk and open it. Then click on the 
Install button. You should see the FPiette tab on the component gallery.

Once the package is installed, you may open the sample projects. There is a
project group called Del50Sam.bpg which has all sample programs. Open it
with file/open, browse to the Internet directory, selct and open Del50Sam.bpg.
Then Project/Build all projects. You'll get all sample programs compiled.

Note: Packages are in the full ICS, in ICS.ZIP file. If you downloaded a
partial ICS, then you have to add each component by hand in the package
of your choice.

DELPHI 4: Same installation as Delphi 5. Files are IcsDel40.dpk and Del40Sam.bpg.

DELPHI 3: Same installation as Delphi 5. Files are IcsDel30.dpk and Del30Sam.bpg.

DELPHI2: Directory VC32 contains all components. You must add all those
components into your library. But warning: not all files are components.
Only those with a Register procedure are components. Other are just support
files and must not be installed as components. To install a component file,
do Component/Install, then click on the Add button, then click on the Browse
button and browse to the VC32 directory. Select a component file such as
wsocket.pas and click on OK. Do it again for all component files and
finally click OK button on the Install Component dialog window. Your 
library will be rebuilt. You should see the tab FPiette added to your
component gallery.

Once the components are all installed, you may open the sample projects
each one after the other and compile them. For each project, do file/open
and select the dpr file in the internet directory. Then Project/Build All.


DELPHI1: The install procedure is the same as for Delphi 2. But you must
add the directory VC into the library path before VC32 directory which
will be added automatically when you add the first component source.
VC directory in the library path is needed because Delphi 1 doesn't have 
built in winsock support. ICS contains winsock.pas in VC directory to 
add winsock support. VC directory also contains 16 bits component resource 
files (*.dcr) needed by Delphi 1. VC32 contains the 32 bits resource files.
If you use only Delphi 1, you can safely copy all files from VC to VC32
directory, but not the contrary.

Once the components are all installed, you may open the sample projects
each one after the other and compile them. For each project, do file/open
and select the dpr file in the internet directory. Then Project/Build All.


BCB4: First you need to install all components. There is a package in
Delphi\VC32 directory, called IcsBcb40.bpk. You do File/Open project and
browse to IcsBcb40.bpk. Select and open it, then Project/Build IcsBcb40.
Once the package is compiled, you can install it into your component
palette: Component/Install Packages, click the Add button and select 
Delphi\VC32\IcsBcb40.bpl (you just generated this file by compiling the 
package). Click OK button. You must now see FPiette Tab on the component 
gallery.

Once the components are all installed, you may open the sample projects
each one after the other and compile them. For each project, do file/open
and select the dpr file in the internet directory. Then Project/Build All.
Projects are located in CPP/INTERNET/BCB4. There is also a project groupd
Bcb40Sam.bpg which contains all sample projects.

Note: Packages are in the full ICS, in ICS.ZIP file. If you downloaded a
partial ICS, then you have to add each component by hand in the package
of your choice.

BCB 3: Same procedure as BCB4. Files are IcsBcb40.bpk and Bcb40Sam.bpg.
Directory is CPP/INTERNET/BCB3.

BCB1: First you need to install all components that are located in
Delphi/VC32. Components are all Object Pascal sources. You must select
*.pas when in the open dialog box (Menu/Component/Install/Add/Browse).
Components are files with a register procedure. Do not install files
with no register procedure (if you try, you'll get an error message).

Once the components are all installed, you may open the sample projects
each one after the other and compile them. For each project, do file/open
and select the dpr file in the internet directory. Then Project/Build All.
Projects are located in CPP/INTERNET/BCB1.


NOTES: 
- If you use Delphi 1, 2, 3, 4 or BCB 1 or 3, you may have an error 
message complaining about Font.Charset, OldCreateOrder and other
properties. Those are two new properties in newer Delphi versions. 
You can safely ignore those errors because those properties are not 
used by the components nor sample programs. You may encounter this 
error at run time. To avoid it, you must open each form at design time
and ignore the error. Then recompile. If you don't ignore the error 
at design time, you'll have it at runtime !

- If you are using BCB3 or BCB4, you may encounter an error at link time 
such as "Unable to open file MWBCB30.LIB" (or other libs). This is a bug
in BCB. To solve it, close BCB and open the package or project file with 
notepad or any text editor and remove any reference to the missing library. 
Then start BCB again, reopen the project and rebuilt it.

- Don't forget that the C++Builder components are located in .\delphi\vc32 
which is object pascal source code (not a problem for C++Builder, just 
indicate that the *.pas files are displayed when installing). C++Builder 
will create the *.hpp files. There are some on-line help files in the VC32
directory.

- The following is a list of the files that should be installed in order to
properly add all of the available components in this collection.  Note that 
you may not have all of these present:

> WSocket.pas      (Winsock component - TCP, UDP, DNS,...)
> WSocketS.pas     (Winsock component for building servers)
> HttpProt.pas     (HTTP client protocol - used by the web)
> FtpCli.pas       (FTP client protocol - file transfert)
> FtpSrv.pas       (FTP server protocol - file transfert)
> Ping.pas         (ICMP echo protocol - ping a host)
> Pop3Prot.pas     (POP3 client protocol - get mail from mail server)
> MimeDec.pas      (MIME component - decode file attach, use with POP3)
> SmtpProt.pas     (SMTP client protocol - send mail to server)
> NntpCli.pas      (NNTP client protocol - send and receive newsgroups messages)
> TnCnx.pas        (TELNET client protocol - terminal emulation protocol)
> TnScript.pas     (TELNET client protocol - with automation)
> EmulVT.pas       (ANSI terminal emulation in a control)