[Bug-gnubg] Nardy's Directions, and some help, please.

[Rob]

I have made some notes regarding Nardy's directions for building under
Win32.

1. I have made a modified version of the page at
http://users.skynet.be/bk228456/gnubg_new_build.html

I have attached it here


The modifications are to clarify it some.

a. Changed "5. Notes" to "8. Notes"
b. Added section 0: Install Gnubg for Win32, reordered table of contents
c. Separated out mingw download because it's not clear that packages.zip
didn't have it. You'll see.

2. You need to change nardy.bat

if NOT %MINGWDR%=="" goto IFEXIST
must change to
if NOT "%MINGWDR%"=="" goto IFEXIST

3. After getting the latest CVS sources, I got the following compiler error:

gcc -Os -mms-bitfields -Wall -DHAVE_CONFIG_H -DLOCALEDIR=\"locale\" -I. -I./
lib -I/MinGW/lib/gtk+/include -I/MinGW/lib/glib-2.0/include -I/MinGW/include
/glib-2.0 -I/MinGW/include/libxml2 -I/MinGW/include/freetype2   -c -o
gtkprefs.o gtkprefs.c
gtkprefs.c: In function `GeneralPage':
gtkprefs.c:1419: structure has no member named `showMoveIndicator'
gtkprefs.c: In function `UseDesign':
gtkprefs.c:1655: structure has no member named `showMoveIndicator'
gtkprefs.c: In function `GetPrefs':
gtkprefs.c:2519: structure has no member named `showMoveIndicator'
mingw32-make.exe: *** [gtkprefs.o] Error 1

How to compile a new build of "GNU Backgammon for Windows"

Updated 030813
(Makefile)
Finds Language Package
Reorganized by Rob K

1. Download and install Gnubg for Win32	2. Get an archive utility	3. Download MinGW	4. Download packages
5. Install packages	6. Fetch the source	7. Copy DLLs	8. Download Makefile, ...
	9. Compile/link a new build	10. Notes

Goto Main GNU Bg Page

All info about GNU Backgammon can be found at www.gnubg.org

1. Download and install Gnubg for Win32

If you do not have GNU Backgammon for Windows installed on your Win32 computer already, download and install the Installation archive (12 MB) of Øystein O Johansen.

You will build a replacement gnubg.exe that sits on top of it.

2. Get yourself an archive utility program

For instance: 7-zip
http://www.7-zip.org/

Remark:
When  you opt for another utility, be aware some of them alter the end-of-line characters from *nix to Windows.

(back to top)

3. Download MinGW (SourceForge) 030704

• MinGW-2.0.0-3.exe (MinGW 2)  (12 MB)

Download: MinGW-2.0.0-3.exe
(from URL: http://sourceforge.net/project/showfiles.php?group_id=2435 )

MinGW 2 bundles:

• GCC-3.2-core-20020817-1
• binutils-2.13-20020903-1
• mingw-runtime-2.2 w32api-2.0
• gdb-5.1.1-1
• make-3.79.1-20010722 (binary renamed as mingw32-make)

4. Download the library packages

a. 1) SourceForge 1   03 07 04

• freetype-2.1.4-bin.zip (freetype2 bin)
• freetype-2.1.4-lib.zip (freetype2 lib)
• gdbm-1.8.0-bin.zip (gdbm bin)
• gdbm-1.8.0-lib.zip (gdbm lib)
• libart-2.3.3-bin.zip (libpng bin)
• libart-2.3.3-1-lib.zip (libpng lib)
• libpng-1.2.4-1-bin.zip (libpng bin)
• libpng-1.2.4-1-lib.zip (libpng lib)
• libxml2-2.4.12-bin.zip (libxml2 bin)
• libxml2-2.4.12-1-lib.zip (libxml2 lib)
• zlib-1.1.4-1-bin.zip (zlib bin)
• zlib-1.1.4-1-lib.zip (zlib lib)

(from URL: http://sourceforge.net/project/showfiles.php?group_id=23617 )
Remark: these packages are included in packages.zip (see d.)
I renamed zlib-1.dll of zlib-1.1.4.1-bin.zip to zlib.dll (needed by libpng)

a. 2) SourceForge 2    03 07 04

• libiconv-1.9-w32.2.bin.woe32.zip (iconv.dll)

(from URL: http://sourceforge.net/project/showfiles.php?group_id=25167 )
Remark: included in packages.zip (see d.)
I adapted the directory structure to suit building gnubg.

b. GIMP   03 07 04

• gettext-dev-0.10.40-20020904.zip (gettext - libintl)
• glib-2.2.1.zip (glib 2.0)
• glib-dev-2.2.1.zip (glib 2.0 dev)
• gtk+-1.3.0-20030216.zip (GTK+ 1.3)
• gtk+-dev-1.3.0-20030115.zip (GTK+ 1.3 dev)
• libintl-0.10.40-tml-20020904.zip (libintl-1)

(from URL: http://www.gimp.org/~tml/gimp/win32/downloads.html )
Remark: included in packages.zip (see d.)

d. packages.zip, containing all above packages  03 07 04

All above packages are zipped into one file.
Download packages.zip:  http://www.gnubg.org/win32/packages.zip (6.4 MB)
(contains all packages mentioned above)

e. Remark

If you want to download the packages one by one, go here.
The source files of the packages are available too (GNU General Public License).

(back to top)

5. Install the packages from 2. and 3.

• First install MinGW 2 into [drive]:\mingw) ^(a)
• Then extract packages.zip into [drive]:\mingw
  Keep the directory structure!!  ^(b)
  (default value if you use 7-Zip)

(back to top)

6. Fetch the GNU Backgammon sources

Get a snapshot,  or  use CVS
Remark: If you don't know what CVS is, just take the latest snapshot :-)
Remark: To keep things easy, put the GNU Backgammon sources on the same drive as MingW

Download the daily snapshot

ftp://alpha.gnu.org/gnu/gnubg/snapshots/
(It's a good idea to bookmark this page)

Extract the snapshot to [dir]\gnubg ^(c)

OR

Use the CVS repository

Look for "Anonymous CVS access" at
http://www.gnu.org/software/gnubg/gnubg.html

You will need a CVS utility for Windows
Look at:
    http://www.tortoisecvs.org/
or
    http://www.wincvs.org/

'Check out' the GNU Backgammon CVS repository to [dir]\gnubg ^(c)
(or somewhere else, and copy the complete gnubg folder to [dir])

(back to top)

7. Used DLLs

No need to copy anymore. The installation archive of Øystein uses the same :-)

Where do I find the DLLs? [installed dir of GNU Backgammon] ^(e)

• freetype-6.dll (from [drive]:\mingw\bin) ^(a)
• gdbm.dll (from [drive]:\mingw\bin)
• iconv.dll (from [drive]:\mingw\bin)
• libart_lgpl.dll (from [drive]:\mingw\bin)
• libpng.dll (from [drive]:\mingw\bin)
• libxml2.dll (from [drive]:\mingw\bin)
• zlib.dll (from [drive]:\mingw\bin)
•  
• libgdk-0.dll (from [drive]:\mingw\lib)
• libglib-2.0-0.dll (from [drive]:\mingw\lib)
• libgmodule-2.0-0.dll (from [drive]:\mingw\lib)
• libgtk-0.dll (from [drive]:\mingw\lib)
• libintl-1.dll (from [drive]:\mingw\lib)

back to top)

8. Download Makefile(s), config.gui and nardy.bat

MakeConfigNardy.exe is a self-extracting file (version 030813)
Save as... and run it from your PC
or Open it

It contains:

• nardy.bat (030705)
• config.gui (030802)
• makefile (030813)
• lib\Makefile (030704)
• lib\libevent.a (030704)

When you run it, it proposes C:\gnubg as directory for these files
Change C:\gnubg to [dir]\gnubg ^(c) if you opted for another directory for the source files of GNU Backgammon

The builds made from now one (030813) will look for a localized version. Danish, German, Italian and Japanese are available now. If you are interested: get the Language Package

(back to top)

9. Compiling a new build

a. Get the GNU Backgammon sources

Download a snapshot or 'check out' the CVS repository (See 4.)

b. Run nardy.bat

Open My Computer and go to [dir]\gnubg ^(c)

Double click on nardy.bat (or nardy, if known file extensions are hidden)
If you get an error message, you may need to change nardy.bat ^(d)

gnubg.exe will be built (in [dir]\gnubg)

c. Move the new build to your GNU Backgammon folder

Copy the freshly build gnubg.exe to the folder of your installed GNU Backgammon for Windows ^{(e)
Please take a backup of your 'old' gnubg.exe!}

(back to top)

10. Notes

a. [drive]:
    You can simply replace [drive] with C if you like. This way you'll get C:\mingw and you don't need to adapt nardy.bat
    But you are free to opt for another drive(letter). Just be sure it is available and you have write access to it ;-)
    REMARK: keep MingW and the gnubg sources to be compiled on the same drive!

b. Keep the directory structure
    The files in packages.zip have a relative path (\bin or \lib or ...)
    All \bin files must go into [drive]:\mingw\bin and so on.
    After extracting the packages, check if \mingw\include has \gtk and \freetype2. That way you know your extraction utility did its job

c. [dir]
    [dir] can be any (sub)directory on any drive.
    You can (again) keep it easy, and choose C:. Thus [dir] would be C:
        and the full path to gnubg would be: C:\gnubg
    But D:\Test\Win32Builds\gnubg will work too. D:\Test\Win32Builds replaces [dir] in this case.
    REMARK: don't use spaces or special characters in your directory name!!
    REMARK: keep MingW and the gnubg sources on the same drive!

d. nardy.bat 
    If you didn't installed MinGW to C:\mingw, you will have to adapt the file nardy.bat.
    The procedure itself tells you how-to.

e. Directory of the installed GNU Backgammon for Windows
    On Win9x systems, the default directory is C:\Program Files\gnubg,
    It is the directory where you installed the Installation Archive (Setup.exe) from http://home.online.no/~oeysteij/

(back to top)

Any comments?

mailto:address@hidden