NetBSD-Bugs archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

install/56953: install notes are slightly outdated



>Number:         56953
>Category:       install
>Synopsis:       install notes are slightly outdated
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    install-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Aug 04 18:30:00 +0000 2022
>Originator:     Martin Husemann
>Release:        NetBSD 9.99.99
>Organization:
The NetBSD Foundation, Inc.
>Environment:
System: NetBSD martins.aprisoft.de 9.99.99 NetBSD 9.99.99 (GENERIC) #142: Sat Jul 30 14:28:52 CEST 2022 martin%martins.aprisoft.de@localhost:/usr/src/sys/arch/amd64/compile/GENERIC amd64
Architecture: x86_64
Machine: amd64
>Description:

The installation notes, especially distrib/notes/common/sysinst, are
slightly wrong/outdated.

Unfortunately they are a twisty maze of machine dependend .if and need
very carefull editing and proofreading.

>How-To-Repeat:
Read the INSTALL.html of a daily HEAD build, e.g.
https://nycdn.NetBSD.org/pub/NetBSD-daily/HEAD/latest/amd64/INSTALL.html

Note that:
 - it lists "Selecting which sets to install" very early, while it only
   actually happens after partitioning and file system creation (in
   the current numbering: between step 11 and 12)
 - in step 9 "Partitioning the disk" and 10 "Editing the NetBSD disklabel"
   it does not mention GPT options (side note: it also only explains MBR/fdisk
   for i386, but not amd64)
   Probably both of these sections should be rewritten from scratch,
   mentioning that available partitioning schemes will vary by
   architecture and sometimes even by install medium selected (due to
   space constraints). Most of the .if spagethi can probably removed
   and a general one (GPT or disklabel, depending on machine and boot
   details) or two level (outer [MBR] and inner [disklabel]) scheme
   explained.

>Fix:
yes, *roff wizards and well trained english writers: please do :-}



Home | Main Index | Thread Index | Old Index