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

Re: testing group -- please test the documentation



Since you asked, read trough starting with install.html.

>Section 2.2.1 Supported Storage Systems
>
>	The 53c7 and 8xx NCR family of SCSI controllers, not to be confused
>	with the NCR 5380 controllers. 

The 53c8xx works fine with boot-floppies 2.1.4, in my case a Tekram 390-U.

>3.3.4 Virus Protection 
>... and Linux has a better method of protecting you from viruses. 

Makes one wounder, what method?

>2.5.3 Fake or ``Virtual'' Parity RAM
>3.3.9 Bad RAM

DIMM is common today.
And how about ECC, do Linux support it.
I can't find anything about it in the kernel sources.

>5.1 Introduction

>Once you've booted into Linux, the dbootstrap program will launch and
>guide you through the second step, the initial system configuration. This
>step is described in detail in Using dbootstrap for Initial System
>Configuration, chapter 7. 

I cannot find any binary named dbootstrap on the floppy.
Don't you mean dinstall.

Sorry, I don't have patches for the rest.

>7.3 ``Configure the Keyboard'' 

>Once the system is installed, you'll be able to select a keyboard layout
>from a wider range of choices.

You don't tell them how, and I don't remember any such question after the
harddisk reboot.

>7.4 The Shell

Tell them also that error messages might go the ALT-F3 screen.

>7.8 ``Initialize a Linux Partition'' 

>These floppies will not upgrade an old system without removing the files
>-- Debian provides a different procedure than using the boot floppies for
>upgrading existing Debian systems. Thus, if you are using old disk
>partitions that are not empty, you should
>initialize them (which erases all files) here.

One could get the impression that the Debian upgrade procedure is to erase
all old files.

>Once you've mounted the / partition, the ``Next'' menu item will be
>``Install Operating System Kernel and Modules'' unless you've already
>performed some of the installation steps. You can use the arrow keys to
>select the menu items to initialize and/or mount
>disk partitions if you have any more partitions to set up. If you have
>created separate partitions for /var, /usr, or other filesystems, you
>should initialize and/or mount them now. 

It is very easy to miss that part (initialize the other partitions).
It is too easy just to press enter and totaly miss the /usr, etc.
partitions.

>7.14 ``Make Linux Bootable Directly From Hard Disk''

You should tell the reader that he won't then be able to boot DOS etc.
without some work. Some people will be pretty surprised otherwise.

Seems you missed the:
7.17b, Create ordinary user

7.17c, Do you want shadow password support

7.17d, Shall we remove PCMCIA stuff

>7.18 Select and install programs

This section do need a facelift.

>7.20 Setting up PPP

Make a note that pon, plog and poff must be run from a root account.

>8.2 Further Reading and Information 
>You can find documentation for all the programs on your system in 
>/usr/doc. 

Not really true. Why not say:

You might find documentation on a program with

	man program
	info program

or check out

	/usr/doc/package

/usr/doc/HOWTO and /usr/doc/FAQ contains lots of interesting information.

>8.3 Compiling a New Kernel

>Hereafter, we'll assume your kernel source is located in /usr/local/src
>and we that your kernel version is 2.0.36. Change your directory to where
>you want to unpack the kernel sources (cd /usr/local/src), extract the
>kernel sources (tar >xzf /usr/src/kernel-source-2.0.36.tar.gz), change
>your directory to it (cd kernel-source-2.0.36).

Shouldn't it read:

Hereafter, we'll assume your kernel source is located in /usr/src   
and we that your kernel version is 2.0.36. Change your directory to where
you want to unpack the kernel sources (cd /usr/src), extract the    
kernel sources (tar xzf kernel-source-2.0.36.tar.gz), change
your directory to it (cd kernel-source-2.0.36).                                                    

I.e. no /local/ part and tar xzf without directory.

-------------------------------------------------------------------------------
Karl Hammar		Aspö Data		karl@kalle.csb.ki.se
Lilla Aspö 2340		0173 140 57
S-742 94 Östhammar	070 511 97 84		Professionella Linuxlösningar
Sweden
-------------------------------------------------------------------------------

On 5 Jan 1999, Adam Di Carlo wrote:

> 
> I'd like any comments or corrections from the new Installation Manual,
> to be found at <URL:http://www.debian.org/~aph/boot-floppies/i386>.
> Sections 1 through 5 are complete for x86.  I'd like any corrections,
> comments, whatever, esp. on those sections.
> 
> I know there are *tons* of problems with Sections 6 and beyond.  So if
> you're going to send me suggestions on that, I'd prefer patches.  You
> can access the SGML source (newly converted to debiandoc) at
> <URL:http://www.debian.org/~aph/boot-floppies/source/>.
> 
> I have people working on porter versions of the document, but even so,
> I'd appreciate any *patches* for porters.
> 
> --
> .....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>
> 
> 
> --  
> To UNSUBSCRIBE, email to debian-testing-request@lists.debian.org
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
> 


Reply to: