Page 1 of 3

Where do I find Documentation/kernel/bootloader.txt?

Posted: Thu Aug 31, 2017 3:19 pm
by Hypex
I was examining a Kicklayout file and am interested in finding infomation on configuring it. It refers to a bootloader.txt file. Where do I find Documentation/kernel/bootloader.txt?

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Thu Aug 31, 2017 7:32 pm
by xenic
Hypex wrote:I was examining a Kicklayout file and am interested in finding infomation on configuring it. It refers to a bootloader.txt file. Where do I find Documentation/kernel/bootloader.txt?
I have backups of all my Workbench partitions dating back to OS4pre2 and a file search for 'bootloader.txt' didn't find anything. Apparently, the file never existed in any OS release.

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Thu Aug 31, 2017 11:21 pm
by tonyw
There is nothing called kick#?.txt in the source repository, I suspect it has never been written, or, perhaps, never committed to the svn.

What do you want to know about configuring the Kicklayout file? I thought the comments within the file were sufficient.

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Fri Sep 01, 2017 11:13 am
by gazelle
I found one in .../2008-05-14.amigaone.full/Documentation/kernel

It's about OS4 on classic Amiga:

Code: Select all

$ head -n 14 bootloader.txt
$VER: bootloader.txt 52.11 (14.10.2007)

Installing OS4 on a classic Amiga
=================================

Requirements
------------

Must-Haves:
- A CyberStorm PPC/Blizzard PPC
- Kickstart 3.0 or 3.1
- OS 3.9
- The OS 4 beta modules
- Patience

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Fri Sep 01, 2017 3:03 pm
by Hypex
tonyw wrote:
What do you want to know about configuring the Kicklayout file?
Namely, this:

Code: Select all

; Each configuration starts with the LABEL keyword, followed by the
; name of the configuration.  The name can be used to specify the
; configuration in the bootloader tool (see Documentation/kernel/
; bootloader.txt).
How does it mean in the name? If the name is a label how does it specify a configuration in the bootloader tool? This gives me the impression there are some extra settings that can be passed. At first I thought it may be in the EXEC line since this has the loader. But since it refered to a non-existent document this remained unclear.

I'm thinking it is simpler than it makes out and by configuration it means a labelled menu entry with associated Kickstart modules. But it doesn't say it like that. It talks of a configuration in the bootloader tool.

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Fri Sep 01, 2017 3:06 pm
by Hypex
gazelle wrote:I found one in .../2008-05-14.amigaone.full/Documentation/kernel
Okay thanks. So it goes way back. But looks like it is still relevant for all platforms.

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Fri Sep 01, 2017 6:42 pm
by Spektro
It might be a good idea to add a 'Configuring the Kickstart' section (or something like that) to this AmigaOS wiki article: http://wiki.amigaos.net/wiki/UserDoc:How_AmigaOS_Works. There is a section about Kickstart modules but nothing on customizing the Kickstart.

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Sat Sep 02, 2017 12:34 am
by tonyw
I don't think that page is the right place for a "How to Edit" section. It's a high-level description of the OS. Perhaps we could add a link to a better place.

I can see many typos and examples of bad English on that page, so I'll "have a go" at it.

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Sat Sep 02, 2017 11:46 am
by broadblues
Hypex wrote:
tonyw wrote:
What do you want to know about configuring the Kicklayout file?
Namely, this:

Code: Select all

; Each configuration starts with the LABEL keyword, followed by the
; name of the configuration.  The name can be used to specify the
; configuration in the bootloader tool (see Documentation/kernel/
; bootloader.txt).
How does it mean in the name? If the name is a label how does it specify a configuration in the bootloader tool? This gives me the impression there are some extra settings that can be passed. At first I thought it may be in the EXEC line since this has the loader. But since it refered to a non-existent document this remained unclear.

I'm thinking it is simpler than it makes out and by configuration it means a labelled menu entry with associated Kickstart modules. But it doesn't say it like that. It talks of a configuration in the bootloader tool.
It quite clear, (or at least the wording is unambiguous), your last paragraph is correct. The name specificed appears in the SLB / Amgaboot.of / whichever boloader your system uses bootmenu.

It *doesn't say* the name allows you to "configure" the bootloader, which is how you seem to be trying to read it.

I'm sure it could be reworded to make it clearer still, how would you word it?

Re: Where do I find Documentation/kernel/bootloader.txt?

Posted: Sat Sep 02, 2017 1:55 pm
by tonyw
@Hypex:

I don't really understand your difficulty. You've had an XE now for all these years, yet you've never edited the Kicklayout before now?

Please read the UserDoc wiki again - I've written a section about the Kicklayout today. See if it explains the content better: http://wiki.amigaos.net/wiki/UserDoc:Ho ... _Kickstart
.