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

Re: [RFC] Some updates to the installation guide (2nd round)



On Monday 25 August 2008, Jérémy Bobbio wrote:
> More updates attached. More reviews welcome.

Same deal.

Cheers,
FJP

+++ b/manual/en/install-methods/downloading-files.xml
+Using the <classname>apt-spy</classname> package on an already installed
+Debian system can also help you in finding the fastest mirror available.

FJP: I'd tried apt-spy before and did again a few days ago and must say
     I'm not impressed. Getting it to do anything at all is not trivial.
     I had serious trouble finding that the "suite" option is required
     (would have been much better if that was a parameter instead).
     It segfaults if you give an option that needs a parameter without
     the parameter. It's not clear whether you should give a country
     name or code.
     But most of all, if I try it for NL, *only* ftp.nl.d.o is tried,
     which is rather useless.

     My conclusion is that it is *not* a tool for newbies. And especially
     for areas where you'd need it most you'd probably need to provide the
     list of mirrors to test manually.

     I personally would not mention it in the installation guide.

+++ b/manual/en/using-d-i/modules/partman.xml
+Each partition line consists of the partition number, its type, size, optional
+flags, file system, and mountpoint.

FJP: Note that this differs for some disk labels!
 
     <title>Manual Partitioning</title>

FJP: Maybe add a para explaining that pre-existing LVM/RAID will be
     activated and listed by default, but that pre-existing encrypted
     partitions will not be? Not sure if that should be here or earlier.

+If you choose manual partitioning, you will be presented with a list of
+your existing partitions. How to manually setup your partition table and the
+usage of partitions by your new Debian system will be covered in the remainder
+of this section. After make the necessary changes, the partition list might
+look like this:

FJP: s/make/making/

+This example shows two IDE harddrives divided into several partitions;
+the first disk has some free space. Each partition line consists of the
+partition number, its type, size, optional flags, file system, and
+mountpoint (if any).

FJP: s/harddrives/hard drives/
FJP: Same comment as above.
 
+++ b/manual/en/using-d-i/modules/lowmem.xml
@@ -29,13 +29,13 @@ additional memory and thus may cause the installation to fail.
 
 </para><para>
 
-If the installer runs in low memory mode, it is recommended to create
-a relatively large swap partition (64&ndash;128MB). The swap partition
-will be used as virtual memory and thus increases the amount of memory
-available to the system. The installer will activate the swap partition
-as early as possible in the installation process. Note that heavy use
-of swap will reduce performance of your system and may lead to high
-disk activity.
+If the installer runs in low memory mode, it is recommended to create a
+relatively large swap partition (at least 64&ndash;128MB). The swap
+partition will be used as virtual memory and thus increases the amount
+of memory available to the system. The installer will activate the swap
+partition as early as possible in the installation process. Note that
+heavy use of swap will reduce performance of your system and may lead to
+high disk activity.

FJP: Please do not reformat the whole para for a minor change.
     Suggest to remove the "&ndash;128" if you add "at least".

Attachment: signature.asc
Description: This is a digitally signed message part.


Reply to: