Date: Fri, 20 Aug 1999 15:23:45 +0400 (MSD) From: "Alexey M. Zelkin" <phantom@cris.net> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/13271: [PATCH] sysinstall.8 style and content modification Message-ID: <199908201123.PAA00931@scorpion.crimea.ua>
next in thread | raw e-mail | index | archive | help
>Number: 13271 >Category: docs >Synopsis: sysinstall.8 still have some style problems and out-of-date >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Aug 20 11:50:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -CURRENT sources, cvsuped this night >Description: . First off, Mike -- you commit (rev.1.20) wasn't complete because one string of removed paragraph left there. (cvs diff -c -r 1.19 -r 1.20 sysinstall.8 for more details) . Added dists - compat22, compat3x; removed - sebones. . I everytime thought that ftp url will look like ftp://host/, not ftp:/host/ . Stylify (.Fx, .Dq) . Make better visible (removed somethere spaces, added .Pp) . freebsd.org -> FreeBSD.org >How-To-Repeat: >Fix: Index: sysinstall.8 =================================================================== RCS file: /usr/local/CVSROOT/src/release/sysinstall/sysinstall.8,v retrieving revision 1.21 diff -c -r1.21 sysinstall.8 *** sysinstall.8 1999/08/18 05:54:54 1.21 --- sysinstall.8 1999/01/20 10:14:32 *************** *** 1,5 **** .\" Copyright (c) 1997 ! .\" Jordan Hubbard <jkh@freebsd.org>. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions --- 1,5 ---- .\" Copyright (c) 1997 ! .\" Jordan Hubbard <jkh@FreeBSD.org>. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions *************** *** 37,47 **** .Op Ar ... .Sh DESCRIPTION .Nm ! is a utility for installing and configuring FreeBSD systems. ! It is the first utility invoked by the FreeBSD installation boot floppy and is also copied into .Pa /stand/sysinstall ! on newly installed FreeBSD systems for use in later configuring the system. .Pp The .Nm --- 37,53 ---- .Op Ar ... .Sh DESCRIPTION .Nm ! is a utility for installing and configuring ! .Fx ! systems. ! It is the first utility invoked by the ! .Fx ! installation boot floppy and is also copied into .Pa /stand/sysinstall ! on newly installed ! .Fx ! systems for use in later configuring the system. .Pp The .Nm *************** *** 63,72 **** of the .Xr libdisk 3 library) and install distributions or packages onto new and ! existing FreeBSD systems. It also contains some extra intelligence for running as a replacement for .Xr init 8 ! when it's invoked by the FreeBSD installation boot procedure. It assumes very little in the way of additional utility support and performs most file system operations by calling the relevant syscalls (such as --- 69,82 ---- of the .Xr libdisk 3 library) and install distributions or packages onto new and ! existing ! .Fx ! systems. It also contains some extra intelligence for running as a replacement for .Xr init 8 ! when it's invoked by the ! .Fx ! installation boot procedure. It assumes very little in the way of additional utility support and performs most file system operations by calling the relevant syscalls (such as *************** *** 79,89 **** library to do user interaction with simple ANSI line graphics, color support for which is enabled by either running on a syscons VTY or some other color-capable terminal emulator (newer versions of xterm will support ! color when using the ``xterm-color'' termcap entry). .Pp This product is currently at the end of its life cycle and will eventually be replaced. - utility. .Sh RUNNING SCRIPTS .Nm may be either driven interactively through its various internal menus --- 89,100 ---- library to do user interaction with simple ANSI line graphics, color support for which is enabled by either running on a syscons VTY or some other color-capable terminal emulator (newer versions of xterm will support ! color when using the ! .Dq xterm-color ! termcap entry). .Pp This product is currently at the end of its life cycle and will eventually be replaced. .Sh RUNNING SCRIPTS .Nm may be either driven interactively through its various internal menus *************** *** 124,130 **** For example: .nf ! /stand/sysinstall _ftpPath=ftp:/ziggy/pub/ mediaSetFTP configPackages .fi Would initialize --- 135,141 ---- For example: .nf ! /stand/sysinstall _ftpPath=ftp://ziggy/pub/ mediaSetFTP configPackages .fi Would initialize *************** *** 178,184 **** .Bl -tag -width indent .It router can be set to the name of the desired routing daemon, ! e.g. ``routed'' or ``gated'', otherwise it is prompted for. .El .It configNFSServer Configure host as an NFS server. --- 189,199 ---- .Bl -tag -width indent .It router can be set to the name of the desired routing daemon, ! e.g. ! .Dq routed ! or ! .Dq gated , ! otherwise it is prompted for. .El .It configNFSServer Configure host as an NFS server. *************** *** 226,243 **** .It partition Set to disk partitioning type or size, its value being .Ar free ! in order to use only remaining free space for FreeBSD, .Ar all ! to use the entire disk for FreeBSD but maintain a proper partition table, .Ar existing ! to use an existing FreeBSD partition (first found), .Ar exclusive ! to use the disk in ``dangerously dedicated'' mode or, finally, .Ar somenumber to allocate .Ar somenumber ! blocks of available free space to a new FreeBSD partition. Default: Interactive mode. .It bootManager is set to one of --- 241,267 ---- .It partition Set to disk partitioning type or size, its value being .Ar free ! in order to use only remaining free space for ! .Fx , .Ar all ! to use the entire disk for ! .Fx ! but maintain a proper partition table, .Ar existing ! to use an existing ! .Fx ! partition (first found), .Ar exclusive ! to use the disk in ! .Dq dangerously dedicated ! mode or, finally, .Ar somenumber to allocate .Ar somenumber ! blocks of available free space to a new ! .Fx ! partition. Default: Interactive mode. .It bootManager is set to one of *************** *** 262,268 **** \fBVariables:\fR None .It diskLabelEditor Invokes the disk label editor. This is a bit trickier from a script ! since you need to essentially label everything inside each FreeBSD (type 0xA5) partition created by the .Ar diskPartitionEditor function, and that requires knowing a few rules about how things are --- 286,293 ---- \fBVariables:\fR None .It diskLabelEditor Invokes the disk label editor. This is a bit trickier from a script ! since you need to essentially label everything inside each ! .Fx (type 0xA5) partition created by the .Ar diskPartitionEditor function, and that requires knowing a few rules about how things are *************** *** 273,287 **** the script. .Pp For example, let's say you have a SCSI disk on which you've created a new ! FreeBSD partition in slice 2 (your DOS partition residing in slice 1). The slice name would be .Ar da0s2 ! for the whole FreeBSD partition ( ! .Ar da0s1 being your DOS primary partition). Now let's further assume that you have 500MB in this partition and you want to sub-partition that space into root, swap, ! var and usr file systems for FreeBSD. Your invocation of the .Ar diskLabelEditor function might involve setting the following variables: .Bl -tag -width findx --- 298,317 ---- the script. .Pp For example, let's say you have a SCSI disk on which you've created a new ! .Fx ! partition in slice 2 (your DOS partition residing in slice 1). The slice name would be .Ar da0s2 ! for the whole ! .Fx ! partition ! .Ar ( da0s1 being your DOS primary partition). Now let's further assume that you have 500MB in this partition and you want to sub-partition that space into root, swap, ! var and usr file systems for ! .Fx . ! Your invocation of the .Ar diskLabelEditor function might involve setting the following variables: .Bl -tag -width findx *************** *** 336,346 **** .It distSetCustom Allows the selection of a custom distribution set (e.g. not just on of the existing "canned" sets) with no user interaction. \fBVariables:\fR .Bl -tag -width indent .It dists List of distributions to load. Possible distribution values are: ! .Bl -tag -width indent .It Li bin The base binary distribution. .It Li doc --- 366,377 ---- .It distSetCustom Allows the selection of a custom distribution set (e.g. not just on of the existing "canned" sets) with no user interaction. + \fBVariables:\fR .Bl -tag -width indent .It dists List of distributions to load. Possible distribution values are: ! .Bl -tag -width indentxx .It Li bin The base binary distribution. .It Li doc *************** *** 360,378 **** .It Li des DES encryption binaries and libraries. .It Li compat1x ! Compatibility with FreeBSD 1.x .It Li compat20 ! Compatibility with FreeBSD 2.0 .It Li compat21 ! Compatibility with FreeBSD 2.1 .It Li ports The ports collection. .It Li krb Kerberos binaries. .It Li ssecure /usr/src/secure - .It Li sebones - /usr/src/eBones .It Li sbase /usr/src/[top level files] .It Li scontrib --- 391,421 ---- .It Li des DES encryption binaries and libraries. .It Li compat1x ! Compatibility with ! .Fx 1.x .It Li compat20 ! Compatibility with ! .Fx 2.0 .It Li compat21 ! Compatibility with ! .Fx 2.1 ! .It Li compat22 ! .Fx 2.2 ! and ! .Fx 3.0 ! a.out binary compatibility ! .It Li compat3x ! Compatibility with ! .Fx 3.x ! (available for ! .Fx 4.0 ! systems only) .It Li ports The ports collection. .It Li krb Kerberos binaries. .It Li ssecure /usr/src/secure .It Li sbase /usr/src/[top level files] .It Li scontrib *************** *** 564,569 **** --- 607,613 ---- Commit any and all pending changes to disk. This function is essentially shorthand for a number of more granular "commit" functions. + .Pp \fBVariables:\fR None .It installExpress Start an "express" installation, asking few questions of *************** *** 613,619 **** The fully pathname of the file to load. .El .It mediaSetCDROM ! Select a FreeBSD CDROM as the installation media. .Pp \fBVariables:\fR None .It mediaSetFloppy --- 657,665 ---- The fully pathname of the file to load. .El .It mediaSetCDROM ! Select a ! .Fx ! CDROM as the installation media. .Pp \fBVariables:\fR None .It mediaSetFloppy *************** *** 641,648 **** .It defaultrouter The default router for this host (non-optional). .It netDev ! Which host interface to use ( ! .Ar ed0 or .Ar ep0 , for example. Non-optional). --- 687,694 ---- .It defaultrouter The default router for this host (non-optional). .It netDev ! Which host interface to use ! .Ar ( ed0 or .Ar ep0 , for example. Non-optional). *************** *** 654,662 **** .It netmask The netmask for the selected host interface (non-optional). .It _ftpPath ! The fully qualified URL of the FTP site containing the FreeBSD distribution you're interested in, e.g. ! .Ar ftp://ftp.freebsd.org/pub/FreeBSD/ . .El .It mediaSetFTPActive Alias for --- 700,709 ---- .It netmask The netmask for the selected host interface (non-optional). .It _ftpPath ! The fully qualified URL of the FTP site containing the ! .Fx distribution you're interested in, e.g. ! .Ar ftp://ftp.FreeBSD.org/pub/FreeBSD/ . .El .It mediaSetFTPActive Alias for *************** *** 679,685 **** \fBVariables:\fR .Bl -tag -width indent .It ufs ! full /path to directory containing the FreeBSD distribution you're interested in. .El .It mediaSetNFS --- 726,734 ---- \fBVariables:\fR .Bl -tag -width indent .It ufs ! full /path to directory containing the ! .Fx ! distribution you're interested in. .El .It mediaSetNFS *************** *** 693,700 **** .It defaultrouter The default router for this host (non-optional). .It netDev ! Which host interface to use ( ! .Ar ed0 or .Ar ep0 , for example. Non-optional). --- 742,749 ---- .It defaultrouter The default router for this host (non-optional). .It netDev ! Which host interface to use ! .Ar ( ed0 or .Ar ep0 , for example. Non-optional). *************** *** 707,713 **** The netmask for the selected host interface (non-optional). .It nfs full hostname:/path specification for directory containing ! the FreeBSD distribution you're interested in. .El .It mediaSetFTPUserPass .Pp --- 756,764 ---- The netmask for the selected host interface (non-optional). .It nfs full hostname:/path specification for directory containing ! the ! .Fx ! distribution you're interested in. .El .It mediaSetFTPUserPass .Pp >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199908201123.PAA00931>