Hi! That's the readme file for the sources.

0. Urgent! I'm in a hurry ...
1. Introduction
2. What do you need
2.1 For the DOS version
2.2 For the Linux version
2.3 Additional requirements
3. How to compile
3.1 How to create the DOS installer

-----------------------------------------------------------------------------

0. Urgent! I'm in a hurry ...

  If that's your situation I doubt you'll go very far, but you can skip all
this text and go directly to makes/readme.txt . Don't forget to install Turbo
Vision first!! [Note: If you are using SETEdit or RHIDE pressing Ctrl+Enter
over the makes/readme.txt label you can jump to the text]



1. Introduction:

  For information about copyrights read the copyrigh file, the editor is
mostly GPL/LGPL. I made it GPL because is the less restrictive license for
developing, not for people trying to use the editor's sources. Why? if the
code is GPL I can use GPL sources in my code without problems and I want to
use good code from others instead of reinventing things.
  Note: I put a lot of effort to make the compilation smooth but you should
read all the docs and get all the needed tools.



2. What do you need:

  Currently I don't know if you'll be able to compile the editor because too
much things are needed but that's the best I can do now. I'm basically
releasing the code to avoid violating the GPL license. If you have problems
compiling contact me and I'll enhance this readme.

2.1 For the DOS version:

* DJGPP v2.02, v2.01 have some bugs that affect the editor and this release
doesn't include the patches to fix it.
* GCC 2.7.x/2.8.x or EGCS 1.x. Currently I use gcc 2.8.1, Andris compiled my
classes using egcs but I never tried. You'll need the C++ stuff.
* RHIDE 1.4.7, a previous version won't work and 1.4 will probably crash if
you try to load the project files included here.
* Robert's port of TVision with my last patches, they are *a lot* so get
TVision from the distribution I maintain and that's available from Simtelnet.
* Allegro 3.1 (with my 16 bits mixing routines ;-). Download it from
Simtelnet. You don't need it if you disable the MP3 support.
* LibAMP, if you are lucky I included the sources in the mp3/libamp directory
;-). Read more about it in the makes/readme.txt. You don't need it if you
disable the MP3 support.
* ZLib 1.1.2 or compatible. Again a copy should be included in support/djgpp.
* Perl-Compatible Regular Expressions library. Look in support/djgpp.
* If you want to compile the documentations you'll need Texinfo 3.12 (I think
3.9 works too), additionally if you want postscript you'll need TeX.
* If you want to run some scripts floating around you'll need Perl 5.x. The
scripts are needed to install or create the distribution.
* Gettext library, if you don't have it you must tweak TVision to drop the
international support and define NO_INTL_SUP in ceditint.h. The package is
called gtxt032b.zip and is available in Simtelnet (v2gnu directory).
* PCRE library v2.0.7. That's Perl Compatible Regular Expressions. A 
precompiled copy is included just in case you can get it.

  If you don't have Allegro and LibAMP you can compile the editor without MP3
support commenting the #define SUP_MP3 line in ceditint.h. And removing the
references to alleg and amp in the makes/rhide.env and/or editor.mak. I say
it in various places in the hope you'll understand what's needed ;-)
  If you don't have the PCRE library you can compile the editor without Perl
regex commenting the #define SUP_PCRE line in ceditint.h.
  If you don't have ZLib library you can compile the editor without gzip
internal support, that's a bad idea because when editing .gz files the editor
won't save the file compressed, commenting the #define SUP_GZ line in
ceditint.h.

2.2 For the Linux version:

* Linux 2.0.X, Robert uses 2.0.29 and I use 2.0.34/5/6. I guess other 2.0.x
versions should do the work OK. I use Debian 2.0 to do the work.
* GCC 2.7.x/2.8.x or EGCS 1.x. Currently I use gcc 2.7.2.3, Andris compiled
my classes using egcs but I never tried. You'll need the C++ stuff.
* GLibc 2.x. Even when Robert uses Libc5 the projects are for glibc 2, if you
don't have it try using libc5 and adding gettext as library. See the
rhide.env file for adding "magical" libraries without touching the projects.
* RHIDE 1.4.7, a previous version won't work and 1.4 will probably crash if
you try to load the project files included here.
* Robert's port of TVision with my last patches, they are *a lot* so get
TVision from the distribution I maintain and that's available from Simtelnet
or my homepage.
* ZLib 1.1.2 or compatible. A copy should be included in support/linux.
* Perl-Compatible Regular Expressions library. Look in support/linux.
* If you want to compile the documentations you'll need Texinfo 3.12 (I think
3.9 works too), additionally if you want postscript you'll need TeX. Note:
I found that makeinfo (the program needed to create the docs) is located in
a very strange package in Debian distributions, I think is inside the Tetex
package, as that's huge I just extracted the needed file.
* If you want to run some scripts floating around you'll need Perl 5.x. The
scripts are needed to install or create the distribution.
* NCurses, I use v4.2, I used v3.4 and works too even when you lose some
small features.
* GPM, I use 1.13. Compiling with 1.17 works but be careful 1.13 and 1.14+
are incompatible at binary level.
* gzip and tar are needed to create the distribution and install the package.
* The headers of the X11R6 Xlib. That's needed to compile gkeyli.cc which
uses the keysyms values.
* PCRE library v2.0.7. That's Perl Compatible Regular Expressions. A 
precompiled copy is included just in case you can get it.

  If you don't have the PCRE library you can compile the editor without Perl
regex commenting the #define SUP_PCRE line in ceditint.h.
  If you don't have ZLib library you can compile the editor without gzip
internal support, that's a bad idea because when editing .gz files the editor
won't save the file compressed, commenting the #define SUP_GZ line in
ceditint.h.
  To create the .deb package you'll need Debian Helpers v1.2.9 or newer.
Download it from Potato distribution. Just run "debian/rules binary" from
this directory. Be sure debian/rules is executable ;-)



2.3 Additional requirements:

* A huge pair of balls ... crystal ones ;-))). Really: you'll need to be
patient not all will work in the first try and perhaps you'll need to write
me an e-mail to get help.
* A good machine with a lot of memory or you'll need to wait a lot to compile
I use an AMD K6-2 of 300 MHz with 64 Mb of SDRAM and an UltraDMA 2 disk. In
the past I used a Cyrix 5x86 of 120 MHz with 32 Mb of DRAM and an ATA-2 disk
and the difference of time is huge (2.5 or 3 times).
* In DOS I work in a directory called e:/dj/contrib/setedit, I think any
directory will work but TVision should be at the same level than setedit
directory in the tree because I use relative paths for it. Under Linux I use
/usr/src/setedit.



3. How to compile:

  Read the makes/readme.txt for it.


  I hope you will be able to compile it currently the transportation of the
sources from/to Linux and the diffs I send to Robert work so you should get
all the needed files. Additionally I recompile the editor in other machines
as test.


3.1 How to create the DOS installer:

  Run "make installer" from the makes directory or if you want to debug and
edit the sources use "rhide install" (in the makes directory) and to create
the full installer run the Perl script found in install directory.

Happy hacking.
