================================================================================
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)

================================================================================