xref: /freebsd/share/examples/bootforth/README (revision 1719886f6d08408b834d270c59ffcfd821c8f63a)
1Here you can find some simple examples how to use BootFORTH (part of the
2new bootloader) together with terminal emulation code (available when
3compiling /stand/i386/libi386 with -DTERM_EMU).
4
5Normally, you can place the files in /boot as they are here, and they will be
6automatically loaded by /boot/loader. You must choose between boot.4th or
7loader.rc, though. Copy one or the other, but not both. Also, menu.4th is
8only used by boot.4th, and menuconf.4th is only used by loader.rc, so you
9don't need to copy both files.
10
11The files are:
12
13boot.4th	example of file which is always loaded by /boot/loader, if
14		present in /boot/
15loader.rc	example of file which is always loader by /boot/loader, if
16		present in /boot/
17screen.4th	helpful words for screen manipulation.
18frames.4th	basic frame drawing primitives. Requires screen.4th.
19menu.4th	example of simple startup menu.
20menuconf.4th	another example of simples startup menu.
21
22You're encouraged to add more features to these files - I'm not a Forth
23hacker, unfortunately...
24
25Andrzej Bialecki
26<abial@freebsd.org>
27
28If you use loader.rc/menuconf.4th, be sure to create /boot/stable.conf and
29/boot/current.conf, like described in loader.conf(5), with appropriate
30configuration to distinguish one from the other.
31
32Daniel C. Sobral
33<dcs@freebsd.org>
34