xref: /freebsd/share/examples/bootforth/README (revision 05248206f720394d95c2a7475429311df670a2e9)
17b753b61SAndrzej BialeckiHere you can find some simple examples how to use BootFORTH (part of the
27b753b61SAndrzej Bialeckinew bootloader) together with terminal emulation code (available when
3*ca987d46SWarner Loshcompiling /stand/i386/libi386 with -DTERM_EMU).
47b753b61SAndrzej Bialecki
57b753b61SAndrzej BialeckiNormally, you can place the files in /boot as they are here, and they will be
63a91f98cSDaniel C. Sobralautomatically loaded by /boot/loader. You must choose between boot.4th or
73a91f98cSDaniel C. Sobralloader.rc, though. Copy one or the other, but not both. Also, menu.4th is
83a91f98cSDaniel C. Sobralonly used by boot.4th, and menuconf.4th is only used by loader.rc, so you
93a91f98cSDaniel C. Sobraldon't need to copy both files.
107b753b61SAndrzej Bialecki
117b753b61SAndrzej BialeckiThe files are:
127b753b61SAndrzej Bialecki
137b753b61SAndrzej Bialeckiboot.4th	example of file which is always loaded by /boot/loader, if
147b753b61SAndrzej Bialecki		present in /boot/
153a91f98cSDaniel C. Sobralloader.rc	example of file which is always loader by /boot/loader, if
163a91f98cSDaniel C. Sobral		present in /boot/
177b753b61SAndrzej Bialeckiscreen.4th	helpful words for screen manipulation.
187b753b61SAndrzej Bialeckiframes.4th	basic frame drawing primitives. Requires screen.4th.
197b753b61SAndrzej Bialeckimenu.4th	example of simple startup menu.
203a91f98cSDaniel C. Sobralmenuconf.4th	another example of simples startup menu.
217b753b61SAndrzej Bialecki
227b753b61SAndrzej BialeckiYou're encouraged to add more features to these files - I'm not a Forth
237b753b61SAndrzej Bialeckihacker, unfortunately...
247b753b61SAndrzej Bialecki
257b753b61SAndrzej BialeckiAndrzej Bialecki
267b753b61SAndrzej Bialecki<abial@freebsd.org>
277b753b61SAndrzej Bialecki
283a91f98cSDaniel C. SobralIf you use loader.rc/menuconf.4th, be sure to create /boot/stable.conf and
293a91f98cSDaniel C. Sobral/boot/current.conf, like described in loader.conf(5), with appropriate
303a91f98cSDaniel C. Sobralconfiguration to distinguish one from the other.
313a91f98cSDaniel C. Sobral
323a91f98cSDaniel C. SobralDaniel C. Sobral
333a91f98cSDaniel C. Sobral<dcs@freebsd.org>
34