Re: corrections to the Installation manual
On Sun, Mar 07, 1999 at 06:27:14PM -0500, Adam Di Carlo wrote:
> >>>>> "Matej" == Matej Vela <mvela@public.srce.hr> writes:
> Matej> <digging through old junk> A magazine from 1995 says:
>
> Matej> ``It is important that for defragmenting, which can speed up
> Matej> the computer several times, only the distributed [with Windows
> Matej> 95] Defragmenter is used, since older programs of this type,
> Matej> like Norton Speedisk, do not recognize the VFAT structure and
> Matej> will corrupt data on the disk.''
>
> Um, does this mean the Install Manual is right or wrong?
A bit wrong.
--- install.sgml.orig Tue Mar 9 08:17:40 1999
+++ install.sgml Tue Mar 9 11:00:16 1999
@@ -1848,7 +1848,7 @@
later can easily do the job. See the <prgn>fips</prgn> documentation
for a list of other software that may do the trick. Note that if you
have Windows 95, you must run <prgn>defrag</prgn> from there, since
-DOS doesn't understand the FAT32 type disk allocation tables sometimes
+DOS doesn't understand VFAT, support for long filenames,
used in Windows 95 and higher.
<p>
After running the defragmenter (which can take a while on a large
> Matej> install.sgml, line 3108:
> >> You can do two things at the <tt>boot:</tt> prompt. You can press
> >> the function keys <em>F1</em> through <em>F10</em> to view a few
> >> pages of helpful information, or you can boot the system.
> Matej> The function keys aren't available on sparc nor vme (probably
> Matej> other platforms too).
>
> Huh? I have a Sun5 keyboard and it has function keys and they work fine.
:-) Sorry, I wanted to say that you can't use them ``to view a few
pages of helpful information'' from the boot: prompt.
And more:
--- dselect-beginner.sgml.orig Wed Mar 3 13:00:22 1999
+++ dselect-beginner.sgml Tue Mar 9 09:06:00 1999
@@ -118,7 +118,7 @@
<item>
Quite large and powerful, this complex method is the recommended way
of installing a recent version of Debian from a set of multiple binary
-CDs. Each of these CDs should contains information about the packages
+CDs. Each of these CDs should contain information about the packages
in itself and all prior CDs (in the file <file>Packages.cd</file>).
When you first select this method, be sure the CD-ROM you will be
using is not mounted. Place the last <em>binary</em> disk of the set
--- install.sgml.orig Tue Mar 9 08:17:40 1999
+++ install.sgml Tue Mar 9 11:00:16 1999
@@ -1130,7 +1130,7 @@
In older revisions of OpenBoot, device naming is a bit different: the
floppy device is called ``/fd'', and SCSI disk devices are of the form
``sd(<var>controller</var>, <var>disk-target-id</var>,
-<var>disk-lun</var>). The command <tt>show-devs</tt> in newer
+<var>disk-lun</var>)''. The command <tt>show-devs</tt> in newer
OpenBoot revisions is useful for viewing the currently configured
devices. For full information, whatever your revision, see the <url
id="&url-openboot;" name="Sun OpenBoot Reference">.
@@ -2670,7 +2670,7 @@
program. First issue the <tt>obase=16</tt> command to set the output
to hex, then enter the individual components of the client IP one at a
time. As for <var>client-architecture</var>, try out some values.
-<![ %sparc [ architectures for instance use the sub-architecture
+<![ %sparc [ SPARC architectures for instance use the sub-architecture
names, such as ``SUN4M'' or ``SUN4C''; in some cases, the architecture
is left blank, so the file the client looks for is just
<file>client-ip-in-hex</file>.]]> Once you've determined the name,
@@ -3476,7 +3476,7 @@
<p>
Furthermore, on &arch-title; disks, make sure your first partition on
your boot disk starts at cylinder 0. While this is required, it also
-means that the first partition will the partition table and the boot
+means that the first partition will contain the partition table and the boot
block, which are the first two sectors of the disk. You must
<em>not</em> put swap on the first partition of the boot drive, since
swap partitions do not preserve the first few sectors of the
@@ -3928,11 +3928,11 @@
Next, the system will ask whether you want to enable shadow passwords.
This is a system in which your Linux system is made to be a bit more secure. In
a system without shadow passwords, passwords are stored (encrypted) in
-a world-readable file, <file>/etc/password</file>. This file has to
+a world-readable file, <file>/etc/passwd</file>. This file has to
be readable to anyone who can log in because it contains vital user
information, for instance, how to map between numeric user identifiers
and login names. Therefore, someone could conceivably grab your
-<file>/etc/password</file> file and run a brute force attack against
+<file>/etc/passwd</file> file and run a brute force attack against
it to try to determine passwords.
<p>
If you have shadow passwords enabled, passwords are instead stored in
@@ -4032,9 +4032,9 @@
<prgn>more</prgn>, and <prgn>zmore</prgn> for compressed files with a
<tt>.gz</tt> extension. For example, to view
<file>README.debian.gz</file>, type <tt>zmore README.debian.gz</tt>.
-The only editor that comes with the base
-system is <prgn>ae</prgn>, which also poses as <prgn>vi</prgn>. It is
-very simple to use, but does not have a lot of features. You will
+The base system comes with two editors: <prgn>ae</prgn>, which is very
+simple to use, but does not have a lot of features, and
+<prgn>elvis-tiny</prgn>, a limited clone of <prgn>vi</prgn>. You will
probably want to install more full-featured editors and viewers later,
such as <prgn>nvi</prgn>, <prgn>less</prgn>, and <prgn>emacs</prgn>.
<p>
@@ -4241,7 +4241,7 @@
<p>
Once the compilation is complete, you can install your custom kernel
like any package. As root, do <tt>dpkg -i
-../kernel-image-&kernelversion;-<var>subarch</var>_config.1.0_&architecture;.deb</tt>.
+../kernel-image-&kernelversion;-<var>subarch</var>_custom.1.0_&architecture;.deb</tt>.
The <var>subarch</var> part is an optional sub-architecture, <![ %i386
[ such as ``i586'', ]]> depending on what kernel options you set.
<tt>dpkg -i kernel-image...</tt> will install the kernel, along with
@@ -4305,7 +4305,7 @@
<item>
Initial RAM disk
<item>
-FAT, Minix, and EXT2 filesystems (some architecture don't need FAT
+FAT, Minix, and EXT2 filesystems (some architectures don't need FAT
and/or Minix filesystems -- see the source)
<item>
ELF executables
@@ -4339,7 +4339,7 @@
<sect id="about">About This Document
<p>
This document is written in SGML, using the ``DebianDoc'' DTD.
-Output formats are generated by the programs
+Output formats are generated by programs from the
<package>debiandoc-sgml</package> package.
<p>
In order to increase the maintainability of this document, we use a
Reply to: