This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
deb-goldedplus/docs/building.txt

161 lines
5.7 KiB
Plaintext
Raw Normal View History

2000-02-25 10:15:17 +00:00
GoldED+ compilation howto
2000-02-25 10:15:17 +00:00
-------------------------------------------------------------------------------
2005-11-01 16:27:47 +00:00
Table of contents
1. Build Golded+ binaries using GNU C.
2. Build Golded+/Win32 binaries using Microsoft Visual C.
3. Build Golded+ distribution packages.
2007-01-16 13:20:03 +00:00
4. Notes for RPM (DEB & etc.) builders.
2005-11-01 16:27:47 +00:00
-------------------------------------------------------------------------------
1. Build Golded+ binaries using GNU C.
2000-02-25 10:15:17 +00:00
To compile GoldED+ and utilities you'll need:
2005-11-01 16:27:47 +00:00
- GNU C/C++ at least 2.95.4, gcc 3.x.x are recommended
- binutils: ar, ranlib, strip
2003-06-09 05:47:39 +00:00
- GNU make, GNU sed and GNU grep
2005-11-01 16:27:47 +00:00
- shell ans file utilities: cat, mkdir, echo, rm, [ AKA test (If it's is
internal commands of your shell, then these utilities don't needs.)
- (optional) GNU Groff - if you wants to make html or txt documentation
instead man pages
2000-02-25 10:15:17 +00:00
- vi, emacs, or any other editor you like
2000-10-24 05:02:25 +00:00
- beer or bear on your choice ;-)
2000-02-25 10:15:17 +00:00
2006-02-18 14:07:55 +00:00
---- MINGW OVER CYGWIN ONLY ----
Visits to http://www.cygwin.org/, download setup.exe and install Cygwin with
following packages: bash, binutils, fileutils, gcc, gpp, grep, make, sed,
sh-utils.
----------- COMMON -------------
2000-03-22 17:59:18 +00:00
2005-11-01 16:27:47 +00:00
---- DJGPP ONLY ----
Visits to http://www.delorie.com/djgpp/ and download following packages: djdev,
bash, binutils, fileutils, gcc, gpp, grep, make, sed, Sh-utils, ntlfn, Groff.
Install these packages and run bash.
------ COMMON ------
First, edit GNUmakef.def for the preferrable compilation options.
2002-06-09 09:36:02 +00:00
---- DJGPP ONLY ----
When building in DJGPP environment you may wish to use liblocal which may be
found on DJGPP site (visits a http://www.delorie.com/djgpp/ and locate for
llocl02b.zip) or on Alexander S. Aganichev's personal page (direct link is
http://aaganichev.narod.ru/djgpp/llocl02b.zip). This library provides basic
2002-06-09 09:36:02 +00:00
locale support via country.sys driver. Otherwise just comment -llocal in
GNUmakef.def.
------ COMMON ------
-- unix-like ONLY --
When building in Linux, FreeBSD or another unix-like OS if you wants use
unicode-compatible Golded+ then build Golded+ using ncurses v.5.x with
2011-02-18 23:42:24 +00:00
libncursesw, a wide-characters ncurses version. (This issue is suggested
by Dmitry Rodin 2:5020/5410@fidonet.)
------ COMMON ------
2000-06-16 23:30:48 +00:00
Now go to golded3 and copy mygolded.__h to mygolded.h and adjust it for
2000-02-25 10:15:17 +00:00
yourself (put your name, FTN address and e-mail). Goto root again.
2011-02-18 23:42:24 +00:00
Exec 'make' (or `gmake' on BSD). You may specify following parameters in the
make call:
"BUILD=minimal" Compile Golded+ with support only most popular formats of
message bases (OPUS, Jam, Squish).
"USE_NCURSES=0" if you dislike curses library (Linux version requires to
use curses)
"WIDE_NCURSES=1" if it is needed to use wide characters with curses library
"BUGGY_NCURSES=1" if Golded+ requires additional keypresses to pass areascan
"KOI8=1" Better koi-8 support for linux. Do not set this for
international builds since latin-1 support will be broken.
"ICONV=1" Use iconv library for recoding text. Experimental! Do not
set this if you don't sure!
"PLATFORM=xxx" Overwrite platform auto detection. Here "xxx" may be:
"cyg" - for MinGW or Cygwin (MinGW build),
"lnx" - for GNU/Linux or any BSD,
"emx" - for OS/2 EMX
"sun" - for SunOS (Solaris)
"osx" - for OS X
"djg" - for DJGPP (DOS with DPMI)
"be" - for BeOS
If you do not know that means the parameter, please do not specify it in
command line.
While make work, you may drink beer or play with bear until
compilation in progress. But better - help your wife (if you have one) or
wives (if you have more :)) with home work ;-)
2000-02-25 10:15:17 +00:00
2011-02-18 23:42:24 +00:00
2000-02-25 10:15:17 +00:00
ls bin/
You have to get ged{short-patform-name}, gn{short-patform-name}, and
rddt{short-patform-name}. If so, you did it!
2005-11-01 16:27:47 +00:00
2. Build Golded+/Win32 binaries using Microsoft Visual C.
To compile GoldED+ and utilities you'll need Visual Studio 6.0 with Service
Pack 5 or Visual Studio .NET.
First, propetly install a following Visual Studio's components:
- Visual C/C++ compiler;
- Nmake utility.
Next, copy golded3\mygolded.__h to golded3\mygolded.h and edit last to adjust
it for yourself (put your name, FTN address and e-mail).
2005-11-02 08:52:25 +00:00
Last, run following command:
2005-11-01 16:27:47 +00:00
nmake /f golded.mak CFG="Release"
and make some home work :) until compulation ends.
Locate following files in Release\bin sub-directory: gedwin.exe, gnwin.exe and rddtwin.exe.
If true - then you have Golded+/W32-MSVC :).
3. Build Golded+ distribution packages.
If you want to make binary package of Golded+ then you may call one of gp*.sh
shell scripts:
- dist-gps.sh to produce full sources package;
- dist-gpc.sh to produce config files package;
- dist-gpd.sh to produce DOS binaries package;
2005-11-01 16:27:47 +00:00
- dist-gpv.sh to produce Win32 (MS Visual C) binaries package;
- dist-gpw.sh to produce Win32 (MINGW32) binaries package;
- dist-gpl.sh to produce linux binaries package;
- dist-sx86.sh to produce Solaris/x86 binaries package.
The InfoZIP archiver is required for make Win32, DOS, Solaris/x86 and config
packages.
TAR and BZip2 is required for make linux package.
Iconv program is required for make russian documentation in several encodings
in linux package.
4. Notes for RPM (DEB & etc.) builders.
Please constructs specs for build Golded+ 1.1.5 using following version
numeration and naming style:
2007-01-16 13:20:03 +00:00
Development (current) Golded+ 1.1.5 (snapshot of the Golded+):
- version number: 1.1.5.0;
2007-01-16 13:20:03 +00:00
- release name: string "currentYYYYMMDD", where YYYYMMDD is modification date
of sources on cvs (you may look this date using `cvs log` command).
Example of naming Golded+ snapshot RPM:
Golded+ 1.1.5.0-current20061116
2007-01-16 13:20:03 +00:00
Near future release of Golded+ 1.1.5:
- version number: 1.1.5.1;
2007-01-16 13:20:03 +00:00
- release name: "release".
2007-01-16 13:20:03 +00:00
Example of naming Golded+ release RPM:
Golded+ 1.1.5.1-release