Bug 292301 - loader(8) intro: Not optimal choice of words
Summary: loader(8) intro: Not optimal choice of words
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: amd64 Any
: --- Affects Many People
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2026-01-09 16:26 UTC by Ulrich Eduard
Modified: 2026-01-22 09:33 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Ulrich Eduard 2026-01-09 16:26:28 UTC
It executes  boot scripts written in  one  of  several interpreters.

proposal for improvement:

It executes boot scripts written in one out of three different scripting languages (see below).
Comment 1 Alexander Ziaee freebsd_committer freebsd_triage 2026-01-09 16:43:07 UTC
Hi Ulrich, I think this works as intended for the following reasons:

1. "One of several" is scalable language.
2. We don't know much longer the forth loader is expected to exist.
3. The simple loader is not a scripting language, it has no control structure.

That said, these manuals could use some love, so I appreciate your thought on this.
Comment 2 Ulrich Eduard 2026-01-11 12:53:22 UTC
Hi Alexander,

Many thanks for taking the time to respond in such an elaborate manner.

The point I was trying to make is that "scripts written in ... interpreters" is, technically speaking, nonsensical, because a script can only be written in a language not "in an interpreter" because an interpreter is a program. The script is later on interpreted by an interpreter. I also think that using the word "scripts" implies that there will be an interpreter that understands the script. In this sense, the simple loader can be categorised as an interpreter—even though it doesn’t support control structures, it still reads a script and reacts to its contents.

That said, and taking into account your valuable points, I would like to suggest the following improvement:

    It executes boot scripts written in one of several scripting languages, depending on which interpreter is called.

One important condition is implied by this wording: there is only one interpreter active for the whole process, i.e. mixing different scripting language is not possible.

An even simpler improvement could be:

    It executes boot scripts written for one of several interpreters.


I’m not complaining about the documentation in general—I only want to iron out parts that could easily be misunderstood.
Comment 3 Ulrich Eduard 2026-01-22 09:33:49 UTC
Hi Alexander,

I re-opened the report only now because I didn't know that I had to change the status when I first commented it. Please see my elaborate comment #2.

Kind regards