Skip to content

Commit

Permalink
README: document building ncurses
Browse files Browse the repository at this point in the history
  • Loading branch information
stsp committed Oct 21, 2024
1 parent d3ae907 commit 77a8ed0
Showing 1 changed file with 27 additions and 0 deletions.
27 changes: 27 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -298,6 +298,33 @@ example, the order of the present ones didn't change.
Once you managed to link the objects, you get an executable that you can
run under dosemu2.

## building something real
Building [ncurses](https://github.com/stsp/ncurses) is as simple as this:
```
./configure-dj64
make -j 9
```
Directory `test` should be full of tests and demos. But how to run them
if they have no `.exe` extension? One way of solving the problem is to
add the `.exe` extention with the `link2exe.sh` script located in the
same `test` directory:
```
./link2exe.sh firework
```
This creates `firework.exe` from `firework` ELF file, so you can do:
```
dosemu ./firework.exe TERM=djgpp204
```
to watch some firework. Press `q` to quit the demo. But why would you
want to use some script to manually add an `.exe` extension to every
test, which are too many? And the good news is that you don't have to:
```
dosemu -K . -E "elfexec firework" TERM=djgpp204
```
This way we can ask dosemu2 to load the ELF file directly. Of course
you can't run every ELF program in dosemu2 this way. It can only execute
the ELF files produced with dj64dev.

## what's unsupported
- some crt0 overrides (only `_crt0_startup_flags` override is supported)

Expand Down

0 comments on commit 77a8ed0

Please sign in to comment.