HomeDocumentationDownloadDevelopmentAboutDonorsForumLinks

Subversion Repository

Parent Directory Parent Directory | Revision Log Revision Log

Revision 116 - (show annotations)
Sun Oct 4 14:32:28 2009 UTC (3 years, 7 months ago) by cjg
File size: 3077 byte(s) 
added new ports
1 Introduction:
2 ==============
3
4 This program is a simple generator for Forth based BootMenu scripts for
5 Pegasos machines.
6
7 It's small and extremaly easy to use. And it's safe because it require no changes
8 on the hard drive only a small adjust of the OF settings.
9
10 Requirements:
11 ==============
12
13 Generaly only a recent version of OpenFirmware is required. If you still
14 use old version you can still use a menu generated by this program but with some limitations.
15 Generaly download and install OF upgrade from bPlan home page (http://www.bplan-gmbh.de)
16
17 Usage:
18 =======
19
20 In order to create your own boot menu you need to create a small file with
21 menu description, the file format is describe bellow. When the file is ready
22 you need to run BootCreator like that:
23
24 .> bootcreator <created file> <result boot menu script>
25
26 This call will read and interpret <created file> and save result as a Forth
27 script at the <result boot menu script> position.
28
29 Generaly thats all, now you ned adjust OF settings to read created menu file
30 instead of boot.img (Or linux kernel image) to make this change boot-file
31 env variable.
32
33 .> setenv boot-file <result boot menu script>
34
35 Of coz you need to copy created Forth script to partition where OF can find
36 it. In most cases to partition where you have MorphOS/Linux boot images.
37
38 Menu description file format:
39 ==============================
40
41 File is splited in to several sections separated by a new line character.
42 Section names begins with '[' character and end ']' character. Section names
43 are case sensitive.
44
45 [VERSION] Currently two versions are supported
46
47 0 - Extremaly simple boot menu format without timeout and some other
48 features. Use it if you want to use generated boot menu on Pegasos I or
49 you are still use older version of OF on Pegasos II machine.
50
51 1 - Default boot menu format
52
53 2 - Modified version of previous format. It should works on Pegasos I machines
54 too with timeut.
55
56 [TITLE] A title for generated boot menu
57
58 [SETTINGS]
59
60 AbortOnKey -
61 Timeout -
62 Default -
63
64 [SECTION] This is main part of menu. It describe the menu structure. It contains 2 parts
65 separated by newline. You can create maximun 10 sections.
66
67 1) Position label
68 2) Command. A command to run when this position is selected. As as special
69 case a '-' command may be used to leave menu and return to OF.
70
71 Please look at the examples/ directory to find a working example of menu
72 description file.
73
74 History:
75 =========
76
77 0.x - Older MorphOS only versions
78 1.0 - Ported to Linux
79 New menu description file format
80 1.1 - Released source code
81 1.2 - Added menu format 2 that should work fine on Pegasos I with timeout.
82
83 Last words:
84 ============
85
86 Fell free to contact with me in case of any suggestions.
87
88 If you have your own boot menu or have any suggestions to
89 the current one contact with me too, I can add it to the
90 generator if you want.
91
92 And finaly please remember this is a one night project and propably
93 contain many bug's, flaws, etc.
94
95 Author:
96 ========
97
98 Marcin "Morgoth" Kurek <morgoth6@box43.pl>
  ViewVC Help
Powered by ViewVC 1.1.2