!Boot 5.18 (12 Oct 2002)
=====

Introduction
------------

The !Boot directory contains everything needed to boot
your system. Its structure has been streamlined to remove
references to, and support for, any version of RISC OS
prior to RISC OS 4.

The main additions are in the Choices directory. This has
been extended to allow support for Hardware detection and
configuration, along with multi-user and location choices.

All your old Boot.Choices files should now appear in
Boot.Choices.Users.xxxx


Creating a new user
-------------------

Tools exist within RISC OS Select (from release 2 onward)
which allow the creation and configuration of new users.
Clients wishing to manually create new users can do so by
copying the directory <Boot$Dir>.Choices.NewUser as
<Boot$Dir>.Choices.Users.<username>. This new user will
have no configuration but that provided by the Default
and Hardware configuration. An entry should be made within
the Boot:Choices.passwd file to describe the user in the
form :

<user>:<password>:<uid>:<gid>:<name>:<directory>

Where :
  <user> is the user name
  <password> is the crypt'd password, or empty for no
             password
  <uid> and <gid> are unused and should be empty
  <name> is the full name of the user
  <home> is the home directory, with colons replaced
         by asterisks

This file is used by the !SetUser application.


Selecting users
---------------

The choice of which user should be selected is made by the
file Boot:Choices.!SetUser. If this is not present (as is the
case with single-user systems), the user 'Single' is selected.

The standard user selection tool may be replaced by the user
but be aware that upgrades of later versions of Select may
replace any tool placed there.
