cordle/dosbox/cordle_dos_REAMDE.txt

130 lines
3.7 KiB
Plaintext

================================================================================
CORDLE - DOS BUILD INSTRUCTIONS
================================================================================
Building Cordle on DOS requires DJGPP (DJ Delorie's GCC Port) and PDCurses.
================================================================================
1. INSTALL DJGPP
================================================================================
Download and install DJGPP from: http://www.delorie.com/djgpp/
Required packages:
- djdev205.zip (DJGPP development kit)
- gcc930b.zip (GNU C Compiler)
- bnu234b.zip (GNU Binutils)
- mak43b.zip (GNU Make)
- fil41b.zip (GNU File utilities)
Unzip all packages to C:\DJGPP
Set environment variables in AUTOEXEC.BAT:
SET DJGPP=C:\DJGPP\DJGPP.ENV
SET PATH=C:\DJGPP\BIN;%PATH%
================================================================================
2. INSTALL PDCURSES
================================================================================
Download PDCurses from: https://pdcurses.org/
Build PDCurses for DOS:
cd pdcurses\dos
make -f Makefile.dj
Copy files:
copy pdcurses.a C:\DJGPP\LIB\libpdcurses.a
copy curses.h C:\DJGPP\INCLUDE\
copy panel.h C:\DJGPP\INCLUDE\
================================================================================
3. BUILD CORDLE
================================================================================
Copy the Cordle source files to your DOS system:
- cordle.c
- Makefile
- wordlists\ directory (with all word list files)
Build the game:
cd \CORDLE
make
This will create CORDLE.EXE
================================================================================
4. RUN THE GAME
================================================================================
Run with default settings:
cordle
Run with specific difficulty:
cordle --easy
cordle --medium
cordle --hard
Show help:
cordle --help
================================================================================
5. MEMORY REQUIREMENTS
================================================================================
Minimum:
- 2 MB RAM
- VGA compatible display (for colors)
- DOS 5.0 or higher
Recommended:
- 4 MB RAM
- 80x25 text mode or larger
================================================================================
6. TROUBLESHOOTING
================================================================================
Error: "Out of memory"
- Increase DOS memory limit
- Try using CWSDPMI.EXE memory extender
Error: "libpdcurses.a not found"
- Ensure PDCurses is properly installed
- Check library path: C:\DJGPP\LIB\
Error: "curses.h not found"
- Copy curses.h to C:\DJGPP\INCLUDE\
Colors not working:
- Ensure display supports VGA colors
- Try different terminal emulator
================================================================================
7. TESTING
================================================================================
Tested on:
- MS-DOS 6.22
- FreeDOS 1.3
- DOSBox (with DJGPP)
- DOSBox-X
================================================================================
8. FILE STRUCTURE
================================================================================
Required files:
CORDLE.EXE Main executable
WORDLISTS\ Word list directory
PYRDLE_WORDS_EASY.TXT
PYRDLE_WORDS_MEDIUM.TXT
PYRDLE_WORDS_HARD.TXT
(... other word lists ...)
================================================================================
For modern systems, use CMake build instead (see README.md)
================================================================================