Re: [RFR] Installation Guide - update of apt-setup section for multiple CDs

2008-03-05 Thread Jens Seidel
On Wed, Mar 05, 2008 at 03:27:02AM +0100, Frans Pop wrote:
 I've updated the section in the installation guide about configuring apt to 
 describe that it is now possible to scan multiple CDs.
 
 I'd welcome comments on the new text before I commit the changes.

My comments are maybe a little bit too verbose, so ignore anything you
do not like ...

 +If you are installing from a full CD or a DVD that is part of a larger

I would drop the a infront of DVD or full altogeher. What does
full stand for? A non netinst or business version of the installer?
You know that it is possible to burn such an image also on a DVD, in
this case full should also apply to DVD. But maybe I understand full
wrong.

 +set, the installer will ask if you want to scan additional CDs or DVDs.
 +If you have additional CDs or DVDs available, you probably want to do
 +this so the installer can use the packages included on them.

 +them is not required. If you also do not use a network mirror (as explained
 +in the next section), it can mean that not all packages belonging to the
 +tasks you select in the next step of the installation can be installed.

you WILL select?

 +Packages are included on CDs in the order of their popularity. This means

Above you write CDs or DVDs here you mention only CDs.

 +that for most uses only the first CDs in a set are needed and that only

Plural of CD was intended? Maybe first few CDs to avoid confusion with
first CD ...

 +very few people actually use any of the packages included on the last CDs
 +in a set.

 +If you do scan multiple CDs or DVDs, the installer will prompt you to

Drop do or replace with will?

 +exchange them when it needs packages from another CD/DVD than the one

CD/DVD is used beside CD or DVD from above ...

 +currently in the drive. Note that only CDs or DVDs that belong to the
 +same set should be scanned.

Really? I should avoid mixing a weekly snapshot of the first 5 CDs with
older onces of the remaining CDs? Wouldn't it be possible that a missing
dependency can be resolved on an older disc?

 +If you are installing from a full CD or using a full CD image (not DVD),

not DVD refers only to the image? Otherwise remember that it is indeed
possible to burn a CD image on a DVD (lack of empty CDs ...).

 +using a network mirror is not required, but is still strongly recommended
 +because a single CD contains only a fairly limited number of packages.
  
 +of a network mirror is optional. One advantage of adding a network mirror is
 +that it will make updates of packages in point releases of the distribution

Please check grammar in point releases??? Is just a available
missing.?

 +available for installation.
  
 +In summary: selecting a network mirror is generally a good idea, except

s/selecting/Selecting/ ???

 +if you do not have a good Internet connection. If the current version of
 +a package is available on the CD/DVD, the installer will always use that.

s,the CD/DVD,a CD/DVD,

 +The amount of data that will be downloaded if you do select a mirror thus

Drop do?

 +depends on
  
 +which of those packages are present on the CDs or DVDs you have scanned, and
  
 +whether any updated versions of packages included on the CDs or DVDs are

Plural of version after any is OK?

 +available from a mirror (either a regular package mirror, or a mirror for
 +security or volatile updates).
  
Jens


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Re: [RFR] Installation Guide - update of apt-setup section for multiple CDs

2008-03-05 Thread Philip Hands
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Jens Seidel wrote:
...
  If you are installing from a full CD or a DVD that is part of a larger

 I would drop the a infront of DVD or full altogeher.
...

I'd rather say that you should drop the full here, since the is part of
a larger set implies a full CD anyway, so how about:

  If you are installing from a CD or DVD that is part of a larger set

...
 +currently in the drive. Note that only CDs or DVDs that belong to the
 +same set should be scanned.
 
 Really? I should avoid mixing a weekly snapshot of the first 5 CDs with
 older onces of the remaining CDs? Wouldn't it be possible that a missing
 dependency can be resolved on an older disc?

No -- dependencies are always satisfied on earlier disks, and while
having some older ones tagged on the end might work, it might cause
upset when things on the earlier disks have been upgraded such that they
no longer satisfy later dependencies on the later disks.

Also, if things on the earlier disks have grown, then some packages will
have fallen off the end of the last new disk you have, but still be
missing on the old one that you might have thought follows it.

...
 +using a network mirror is not required, but is still strongly recommended
 +because a single CD contains only a fairly limited number of packages.
   
 +of a network mirror is optional. One advantage of adding a network mirror is
 +that it will make updates of packages in point releases of the distribution
 
 Please check grammar in point releases??? Is just a available
 missing.?
 
 +available for installation.

I think you have a point here -- how about:

  One advantage of adding a network mirror is that updates that have
  occurred since the CD/DVS set was made, and are part of a newer point
  release, will become available for installation, thus extending the
  life of your CD/DVD set without compromising the security or stability
  of the installed system.

Other than that, I'm afraid I'd tend to disagree with most of the other
points you made (although well done for putting the effort in).  You
appear to be applying grammatical rules in a way that, while perhaps
strictly correct, doesn't end up sounding like natural English (of
course, being English, the only grammar I was ever taught at school was
in Latin  French, so perhaps I'm not qualified to comment on English
grammar ;-)

Finally, one change I spotted:

 In most cases you are better of getting
   ^^
   off

Cheers, Phil.
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHzyYOYgOKS92bmRARAmd9AKClFVW0a6iT9o5v5hMRvinoIAHpFwCffSi6
AJC1yT98zEOFooYDMpUi3eE=
=yELI
-END PGP SIGNATURE-


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Re: [RFR] Installation Guide - update of apt-setup section for multiple CDs

2008-03-05 Thread Frans Pop
On Thursday 06 March 2008, Philip Hands wrote:
   If you are installing from a full CD or a DVD that is part of a
   larger
 
  I would drop the a infront of DVD or full altogeher.

 I'd rather say that you should drop the full here, since the is part of
 a larger set implies a full CD anyway, so how about:

   If you are installing from a CD or DVD that is part of a larger set

Well, we do normally use full to refer to the these images (see e.g. the D-I 
page. Basically we have:
- businesscard CD
- netinst CD
- full CD (where full is meant as not incomplete)
- DVD (is indeed technically also a full image as it is not incomplete, but
  the prefix is not needed to distinguish it as with CDs)

I repeated a because that does make clear that full does not refer to 
the DVD. But I agree that set implies that we're talking about full CDs, so 
it could be dropped.

  +currently in the drive. Note that only CDs or DVDs that belong to the
  +same set should be scanned.
 
  Really? I should avoid mixing a weekly snapshot of the first 5 CDs with
  older onces of the remaining CDs? Wouldn't it be possible that a
  missing dependency can be resolved on an older disc?

 No -- dependencies are always satisfied on earlier disks, and while
 having some older ones tagged on the end might work, it might cause
 upset when things on the earlier disks have been upgraded such that they
 no longer satisfy later dependencies on the later disks.

 Also, if things on the earlier disks have grown, then some packages will
 have fallen off the end of the last new disk you have, but still be
 missing on the old one that you might have thought follows it.

Yes. Mixing sets is in general a bad idea, unless you know what you're doing 
or also have a network mirror selected. I don't think we want to suggest to 
people to do that in the manual though.

 I think you have a point here -- how about:

   One advantage of adding a network mirror is that updates that have
   occurred since the CD/DVS set was made, and are part of a newer point
   release, will become available for installation, thus extending the
   life of your CD/DVD set without compromising the security or stability
   of the installed system.

Right. Used with a few minor modifications.

 Other than that, I'm afraid I'd tend to disagree with most of the other
 points you made (although well done for putting the effort in).  You
 appear to be applying grammatical rules in a way that, while perhaps
 strictly correct, doesn't end up sounding like natural English (of
 course, being English, the only grammar I was ever taught at school was
 in Latin  French, so perhaps I'm not qualified to comment on English
 grammar ;-)

I have made a few other changes based on Jens' comments.

Thanks to you both for the review.


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


Re: [RFR] Installation Guide - update of apt-setup section for multiple CDs

2008-03-05 Thread Frans Pop
On Wednesday 05 March 2008, Jens Seidel wrote:
  +The amount of data that will be downloaded if you do select a mirror
  thus

 Drop do?

Adding do here adds emphasis. Note that do would be required if the 
sentence were negative (... if you do not select ...), so it is 
definitely not wrong.

Other comments covered in my reply to Phil's mail.

Thanks,
FJP


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


Re: [RFR] Installation Guide - update of apt-setup section for multiple CDs

2008-03-04 Thread Christian Perrier
Quoting Frans Pop ([EMAIL PROTECTED]):
 Hi,
 
 I've updated the section in the installation guide about configuring apt to 
 describe that it is now possible to scan multiple CDs.
 
 I'd welcome comments on the new text before I commit the changes.


I read the entire proposal and found nothing that could deserve a
comment. As usual in the install manual, things are well and clearly
explained.

While writing this, I'm wondering whether we could launch the
-l10n-english fellows on the giant task of reviewing the installation
manual...As I stopped working on Smith reviews temporarily, I
have to keep them busy...:-)






signature.asc
Description: Digital signature


Re: [RFR] Installation Guide - update of apt-setup section for multiple CDs

2008-03-04 Thread Frans Pop
On Wednesday 05 March 2008, Christian Perrier wrote:
 While writing this, I'm wondering whether we could launch the
 -l10n-english fellows on the giant task of reviewing the installation
 manual...As I stopped working on Smith reviews temporarily, I
 have to keep them busy...:-)

I'm not in favor of that, mainly because ATM I have no intention of spending 
significant amounts of time on reviewing and committing a huge amount of 
reviews. Also, there are still large parts of the manual that really need a 
rewrite and a comprehensive review would better be done after that.


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