diff options
Diffstat (limited to 'distrib/notes/m4.common')
-rw-r--r-- | distrib/notes/m4.common | 130 |
1 files changed, 64 insertions, 66 deletions
diff --git a/distrib/notes/m4.common b/distrib/notes/m4.common index 23f2c74bffc..11b6c638be2 100644 --- a/distrib/notes/m4.common +++ b/distrib/notes/m4.common @@ -1,5 +1,5 @@ dnl -dnl $OpenBSD: m4.common,v 1.127 2017/08/23 02:59:45 nayden Exp $ +dnl $OpenBSD: m4.common,v 1.128 2019/08/01 19:42:51 jmc Exp $ dnl dnl Copyright (c) 2004 Todd T. Fries <todd@OpenBSD.org> dnl @@ -194,7 +194,7 @@ define({:-OpenBSDfloppydesc-:}, {:-Bootable installation/upgrade floppy image$3: The $1 floppy image$3 can be copied to a floppy using rawrite.exe, - ntrw.exe, or `dd', as described later in this document. + ntrw.exe, or "dd", as described later in this document. $2 floppy image is a bootable install floppy which can be used both to install and to upgrade OpenBSD to the current version. It is also useful for maintenance and disaster recovery.-:})dnl @@ -274,7 +274,7 @@ If any question has a default answer, it will be displayed in brackets ("[]") after the question. If you wish to stop the installation, you may hit Control-C at any time, but if you do, you'll have to begin the installation process again from scratch. Using Control-Z to suspend the process may be a -better option, or at any prompt enter `!' to get a shell, from which 'exit' +better option, or at any prompt enter "!" to get a shell, from which "exit" will return you back to that prompt. -:})dnl dnl @@ -290,8 +290,8 @@ define({:-OpenBSDInstallPart3-:}, dnl dot.profile After the kernel is done initializing, you will be asked whether you wish to do an "(I)nstall", "(U)pgrade" or an "(A)utoinstall". - Enter 'I' for a fresh install or 'U' to upgrade an existing - installation. Enter 'A' to start an unattended installation + Enter "I" for a fresh install or "U" to upgrade an existing + installation. Enter "A" to start an unattended installation where all of your answers are supplied in a response file (more on that in "Preparing an unattended installation of OpenBSD"). @@ -308,8 +308,8 @@ ifelse(MDKBD,,,{:- If you are connected using a glass console, you will next be asked for your keyboard layout (the default being the US QWERTY layout). Depending on your keyboard type, not all international - layouts may be supported; answering `?' (which, on QWERTY layouts, - is the key to the left of the right `sh{:--:}ift' key, shifted) will + layouts may be supported; answering "?" (which, on QWERTY layouts, + is the key to the left of the right "sh{:--:}ift" key, shifted) will display a list of supported layouts. (If you do not need to change the keyboard layout, just press enter.)-:})dnl @@ -341,11 +341,11 @@ dnl XXX add a MDVLAN feature and document vlan setup beginning of the installation). - the IPv4 settings: address and netmask. If the IP address - should be obtained from a DHCP server, simply enter ``dhcp'' + should be obtained from a DHCP server, simply enter "dhcp" when asked for the address. - the IPv6 settings (address, prefix length, and default router). - You may enter ``autoconf'' when asked for the address for the + You may enter "autoconf" when asked for the address for the interface to configure automatically via router solicitation messages. @@ -378,7 +378,7 @@ ifelse(MDXAPERTURE,,,{:- System on your machine. The install program needs to know this, to change a configuration setting controlling whether the X server will be able to access the xf86(4) driver; it - is not necessary to answer `y' to this question if you only + is not necessary to answer "y" to this question if you only intend to run X client programs on a remote display. -:})dnl dnl install.sub (install) questions(): MDXDM @@ -386,7 +386,7 @@ ifelse(MDXDM,,, {:-ifelse(MDXAPERTURE,,{:- Since the X Window System can run on OpenBSD/MACHINE without the need for a configuration file, you will get asked-:}, -{:- If you answered `y' to this question, you will get asked-:}) +{:- If you answered "y" to this question, you will get asked-:}) whether you want to start xenodm(1) on boot. -:})dnl dnl install.sub (install) questions(): serial console setup @@ -401,15 +401,15 @@ ifelse(MDSERCONS,,,{:- dnl install.sub (install) user_setup() You will now be given the possibility to setup a user account on the forthcoming system. This user will be added to the - `wheel' group. + "wheel" group. - Enter the desired login name, or `n' if you do not want to + Enter the desired login name, or "n" if you do not want to add a user account at this point. Valid login names are sequences of digits and lowercase letters, and must start with a lowercase letter. If the login name matches this criteria, and doesn't conflict with any of the administrative - user accounts (such as `root', `daemon' or `ftp'), you - will be prompted with the users descriptive name, as well + user accounts (such as "root", "daemon" or "ftp"), you + will be prompted for the user's descriptive name, as well as its password, twice. As for the root password earlier, the install program will only @@ -422,13 +422,11 @@ dnl install.sub (install) user_setup() dnl install.sub (install) set_timezone ifelse(MDTZ,,, {:- - You may now be given the opportunity to configure the time zone - your system will be using (this depends on the installation - media you are using). - - If the installation program skips this question, do not be - alarmed, the time zone will be configured at the end - of the installation. + Depending on the installation media you are using, you may now + be given the opportunity to configure the time zone your system + will use. If the installation program skips this question, do + not be alarmed: the time zone will be configured at the end of + the installation. -:})dnl dnl install.sh ask whether to use DUIDs before the md_prep_disklabel loop The installation program will now tell you which disks it can @@ -442,8 +440,8 @@ dnl Describes MBR partitioning. So much to save four lines of text dnl duplicated 5 times. dnl define({:-OpenBSDInstallMBRPart1-:}, -{:- Disks on OpenBSD/MACHINE are partitioned using either ``MBR'' - or ``GPT'' partitioning schemes. You will need to create one +{:- Disks on OpenBSD/MACHINE are partitioned using either "MBR" + or "GPT" partitioning schemes. You will need to create one disk partition in which the OpenBSD filesystems will be created. -:})dnl dnl @@ -454,8 +452,8 @@ define({:-OpenBSDInstallMBRPart2-:}, dnl install.md md_prep_fdisk {:- The installation program will ask you if you want to use the whole disk for OpenBSD. If you don't need to or don't intend - to share the disk with other operating systems, answer `w' - here to use ``MBR'' partitioning or 'g' to use ``GPT'' + to share the disk with other operating systems, answer "w" + here to use "MBR" partitioning or "g" to use "GPT" partitioning. The installation program will then create a single partition spanning the whole disk, dedicated to OpenBSD. @@ -478,9 +476,9 @@ dnl Describes the disklabel operation dnl define({:-OpenBSDInstallPart5-:}, {:- The file system layout is stored in the OpenBSD disk label. Each - file system is stored in its own ``disk label partition'', which + file system is stored in its own "disk label partition", which is a subdivision of the OpenBSD disk partition you created. In - the text below ``partition'' refers to these subdivisions. + the text below, "partition" refers to these subdivisions. You will be shown a default layout with the recommended file systems. This default layout is based on the disk size. @@ -490,14 +488,14 @@ define({:-OpenBSDInstallPart5-:}, last two choices will invoke the disklabel(8) interactive editor, allowing you to create your desired layout. - Within the editor, you will see at least a 'c' partition of - fstype 'unused'. This represents the whole disk and cannot be + Within the editor, you will see at least a "c" partition of + fstype "unused". This represents the whole disk and cannot be modified.$1 - You must create partition 'a' as a native OpenBSD partition, i.e. + You must create partition "a" as a native OpenBSD partition, i.e. one with "4.2BSD" as the fstype, to hold the root file system.$2 - In addition to partition 'a' you should create partition 'b' with + In addition to partition "a" you should create partition "b" with fstype "swap", and native OpenBSD partitions to hold separate file systems such as /usr, /tmp, /var, and /home. @@ -506,21 +504,21 @@ define({:-OpenBSDInstallPart5-:}, 4.2BSD fstype, will neither be formatted nor mounted during the installation. - For quick help while in the interactive editor, enter '?'. The - `z' command (which deletes all partitions and starts with a - clean label), the `A' command (which performs the automatic - partition layout) and the `n' command (to change mount points) + For quick help while in the interactive editor, enter "?". + The "z" command (which deletes all partitions and starts with a + clean label), the "A" command (which performs the automatic + partition layout) and the "n" command (to change mount points) are of particular interest. - Although the partitions position and size are written in exact + Although the partitions' position and size are written in exact sector values, you do not need a calculator to create your - partitions! Human-friendly units can be specified by adding `k', - `m' or `g' after any numbers to have them converted to kilobytes, + partitions! Human-friendly units can be specified by adding "k", + "m" or "g" after any numbers to have them converted to kilobytes, megabytes or gigabytes. Or you may specify a percentage of the - disk size using `%' as the suffix. + disk size using "%" as the suffix. - Enter 'M' to view the entire manual page (see the info on the - ``-E'' flag). To exit the editor enter 'q'.-:})dnl + Enter "M" to view the entire manual page (see the info on the + "-E" flag). To exit the editor enter "q".-:})dnl dnl dnl OpenBSDInstallPart6(other installation sources) define({:-OpenBSDInstallPart6-:}, @@ -602,7 +600,7 @@ define({:-OpenBSDNFSInstall-:}, You will also have to provide the relative path to the directory on the file system where the distribution sets are located. Note that this path should not be prefixed - with a '/'. + with a "/". Then refer to the section named "installation set selection" below.-:})dnl @@ -631,7 +629,7 @@ define({:-OpenBSDDISKInstall-:}, This is normally $1"sdN", where N is a number. Next you will have to identify the partition within that disk that holds the distribution; this is a single letter between - 'a' and 'p'. + "a" and "p". You will also have to identify the type of file system residing in the partition identified. Currently, you can @@ -641,7 +639,7 @@ define({:-OpenBSDDISKInstall-:}, You will also have to provide the relative path to the directory on the file system where the distribution sets are located. Note that this path should not be prefixed - with a '/'. + with a "/". dnl Then refer to the section named "installation set selection" dnl below. @@ -652,19 +650,19 @@ define({:-OpenBSDCommonInstall-:}, A list of available distribution sets found on the given location will be listed. - You may individually select distribution sets to install, - by entering their name, or wildcards (e.g. `*.tgz' or - `base*|comp*', or `all' to select all the sets (which - is what most users will want to do). - You may also enter `abort' to deselect everything and + You may individually select distribution sets to install + by entering their names or wildcards (e.g. "*.tgz" or + "base*|comp*"), or you may enter "all" to select all the + sets (which is what most users will want to do). + You may also enter "abort" to deselect everything and restart the selection from scratch, or unselect sets - by entering their name prefixed with `-' (e.g. `-x*'). + by entering their name prefixed with "-" (e.g. "-x*"). It is also possible to enter an arbitrary filename and have it treated as a file set. When you are done selecting distribution sets, enter - `done'. The files will begin to extract.-:})dnl + "done". The files will begin to extract.-:})dnl dnl dnl Description of the end of the installation procedure. dnl @@ -698,9 +696,9 @@ dnl install.sh finish_up() system, and will install bootblocks on the root disk. ifelse(MDSMP,,,{:- On multiprocessor systems, if the bsd.mp kernel has been installed, - it will be renamed to `bsd', which is the default kernel the boot - blocks look for. The single processor kernel, `bsd', will be - available as `bsd.sp'. + it will be renamed to "bsd", which is the default kernel the boot + blocks look for. The single processor kernel, "bsd", will be + available as "bsd.sp". -:}) Finally, you will be asked whether you would like to install non-free firmware files (which can't be tightly integrated to @@ -710,8 +708,8 @@ dnl define({:-OpenBSDCongratulations-:},{:- Congratulations, you have successfully installed OpenBSD OSREV. When you reboot into OpenBSD, you should log in as "root" at the login prompt. -You should create yourself an account and protect it and the "root" -account with good passwords. +You should create yourself an account, if you skipped this step during +installation, and protect it and the "root" account with good passwords. The install program leaves root an initial mail message. We recommend you read it, as it contains answers to basic questions you might have @@ -743,16 +741,16 @@ define({:-OpenBSDUnattendedInstallation-:}, Preparing an unattended installation of OpenBSD: ------------------------------------------------ -If '(A)utoinstall' is chosen at the install prompt or if the +If "(A)utoinstall" is chosen at the install prompt or if the installation system detects that it booted from the network, and isn't interrupted within 5 seconds, it attempts a fully-automatic installation. The installer runs dhclient(8) on the network interface the system booted from, or in case of multiple interfaces it will ask which one -to use. Upon success it retrieves a response file via HTTP. If that -fails, the installer asks for the response file location which can be -either an url or a local path and retrieves the response file from +to use. Upon success, it retrieves a response file via HTTP. If that +fails, the installer asks for the response file location, which can be +either a URL or a local path, and retrieves the response file from there. The "next-server" DHCP option specifies the hostname part of the URL, @@ -762,10 +760,10 @@ architectures where this parameter is used for netbooting, create a symbolic link named "auto_install" pointing to the boot program. The response file contains lines with key/value pairs separated by -an equals sign '=', where the key is a non-ambiguous part (up to the +an equals sign "=", where the key is a non-ambiguous part (up to the question mark) of the installer question, consisting of whitespace separated words. The value is what would have been entered at the -interactive prompt. Empty lines and lines beginning with a '#' +interactive prompt. Empty lines and lines beginning with a "#" character are ignored. The installer uses default answers in case of missing answers. @@ -813,7 +811,7 @@ releases, but might not execute some migration tasks that would be necessary for a proper upgrade. The best solution, whenever possible, is to backup your data and reinstall -from scratch. As a minimum, if the toolchain (the ``comp'' set) was installed, +from scratch. As a minimum, if the toolchain (the "comp" set) was installed, you should remove all files within /usr/{:-include-:} before attempting to upgrade. @@ -839,7 +837,7 @@ However, it is strongly advised that you unpack the etc{:--:}.tgz and the xetc{:--:}.tgz files found in /var/sysmerge in a temporary directory and merge changes by hand, or with the help of the sysmerge(8) helper script, since all components of your system may not function -correctly until your files in `/etc' are updated.-:})dnl +correctly until your files in "/etc" are updated.-:})dnl dnl dnl dnl ========== Installation media preparation @@ -1017,7 +1015,7 @@ the following: is recommended that you upgrade the other sets, as well.-:})dnl dnl define({:-OpenBSDInstNFS-:}, -{:-Now you must populate the `/dev' directory for your client. If the server +{:-Now you must populate the "/dev" directory for your client. If the server does not run OpenBSD you might save the MAKEDEV output: eo=echo ksh MAKEDEV all > all.sh |