Merge from vendor branch BINUTILS:
[dragonfly.git] / share / examples / bootforth / README
1 Here you can find some simple examples how to use BootFORTH (part of the
2 new bootloader) together with terminal emulation code (available when
3 compiling /sys/boot/i386/libi386 with -DTERM_EMU).
4
5 Normally, you can place the files in /boot as they are here, and they will be
6 automatically loaded by /boot/loader. You must choose between boot.4th or
7 loader.rc, though. Copy one or the other, but not both. Also, menu.4th is
8 only used by boot.4th, and menuconf.4th is only used by loader.rc, so you
9 don't need to copy both files.
10
11 The files are:
12
13 boot.4th        example of file which is always loaded by /boot/loader, if
14                 present in /boot/
15 loader.rc       example of file which is always loader by /boot/loader, if
16                 present in /boot/
17 screen.4th      helpful words for screen manipulation.
18 frames.4th      basic frame drawing primitives. Requires screen.4th.
19 menu.4th        example of simple startup menu.
20 menuconf.4th    another example of simples startup menu.
21
22 You're encouraged to add more features to these files - I'm not a Forth
23 hacker, unfortunately...
24
25 Andrzej Bialecki
26 <abial@freebsd.org>
27
28 If 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
30 configuration to distinguish one from the other.
31
32 Daniel C. Sobral
33 <dcs@freebsd.org>
34
35 $FreeBSD: src/share/examples/bootforth/README,v 1.3 1999/08/28 00:19:09 peter Exp $
36 $DragonFly: src/share/examples/bootforth/README,v 1.2 2003/06/17 04:36:57 dillon Exp $