Bug#864035: deb.debian.org should be used throughout

2019-03-24 Thread Justin B Rye
Paul Gevers wrote:
>> Do we recommend using deb.debian.org as the default in
>> /etc/apt/sources.list (I think so)? If so, is that documented somewhere?
>> 
>> I think people that upgrade may have older entries and I think we should
>> suggest them to migrate, no? Where to find an authoritative answer?
> 
> What do you think of the attached patch?

It needs a couple of trivial language fixes, but it also runs into
bug #864017.  Oh - okay, while I was writing this you've commented
on that one, so I'll reply separately on that topic.

I would also suggest that we should reserve markup like apt for cases where we actually mean the
package "apt", as opposed to the package-management infrastructure in
general (aka "APT").

> diff --git a/en/upgrading.dbk b/en/upgrading.dbk
> index b779789f..f64458ca 100644
> --- a/en/upgrading.dbk
> +++ b/en/upgrading.dbk
> @@ -476,14 +476,33 @@ $ apt-forktracer | sort
>  
>
>  Adding APT Internet sources
> -
> -  TODO: [elbrus, 2019]: we now have deb.debian.org. This section could 
> do with
> -  some minor updates regarding using that.
> -
>  
> -  The default configuration is set up for installation from the main 
> Debian Internet
> -  servers, but you may wish to modify 
> /etc/apt/sources.list
> -  to use other mirrors, preferably a mirror that is closest to you in 
> network terms.
> +  The default configuration is set up for installation from the 
> +  apt CDN service, so on new installations you should always be getting
> +  packages from a server near you. As this is a relative new service, you
   ^ly
Slightly confusing use of "installation" in two different senses.

 On new installations the default is for APT to be set up to use the
  APT CDN service, which should ensure that packages are
 automatically downloaded from a server near you in network terms. As
 this is a relatively new service, older installations

> +  may have configuration that still points to one of the main 
> +  Internet servers or one of the mirrors. If you haven't done so yet, it 
> is
> +  recommended to switch over to the use of the CDN service in your apt
> +  configuration.
> +
> +
> +  To use the CDN service with  role="package">apt,
   ^^^
> +  you add this line to your /etc/apt/sources.list 
> file
 ^^^
> +  (assuming you are using main and
> +  contrib):
> +

I would recommend just:

   
To make use of the CDN service, add a line like this to your APT source
configuration (assuming you are using main and
contrib):
   

> +deb http://deb.debian.org/debian  main 
> contrib

(Yet another interacting change: we want people to start using HTTPS!
But it's much simpler to recommend that as a *post*-upgrade change.)

> +
> +  After adding your new sources, disable the previously existing
> +  deb lines in
> +  sources.list by placing a hash sign
> +  (#) in front of them.

If they've already got the right file open, there's no need to repeat
what might be a confusing filename.

 After adding your new sources, disable the previously existing
 deb lines by placing a hash sign
 (#) in front of them.

> +
> +
> +  Normally using the CDN service provides you with the best performance,
> +  however you may wish to modify sources.list to use
> +  one of the mirrors, preferably a mirror that is closest to you in 
> network
> +  terms.

The advantages normally expected from deb.debian.org are something
that should be explained above, not here - what we should be giving
here is some hint at the circumstances that might lead a user to pick
the non-default option.

   
 However, if you get better results using a specific mirror that is
 close to you in network terms, this option is still available.
   

>  
>  
>Debian mirror addresses can be found at  @@ -502,8 +521,10 @@ $ apt-forktracer | sort
>
> /debian/dists//contrib/binary-/...
>  
>  
> -  To use this mirror with apt, 
> you add this line to your
> -  sources.list file:
> +  To use this mirror with apt, 
> you
> +  add this line to your sources.list file (again,

 To configure APT to use a given mirror, add a line like this (again,

> +  assuming you are using main and
> +  contrib):
>  
>  deb /debian  main 
> contrib
>  
> @@ -511,9 +532,8 @@ $ apt-forktracer | sort
>after the release name are used to expand the path into multiple 
> directories.
>  
>  
> -  After adding your new sources, disable the previously existing
> -  deb lines in 
> sources.list by placing a
> -  hash sign (#) in front of them.
> +  Again, after adding your new sources, disable the 

Bug#864035: deb.debian.org should be used throughout

2019-03-24 Thread Paul Gevers
Control: tags -1 patch

Hi Adrian, all,

On 23-03-2019 22:29, Paul Gevers wrote:
> On Sat, 03 Jun 2017 17:14:18 +0300 Adrian Bunk  wrote:
>> "4.3.1. Adding APT Internet sources" is using mirrors
>> instead of deb.debian.org which should be used by default
>> (see section 2.2.5.).
> 
> Do we recommend using deb.debian.org as the default in
> /etc/apt/sources.list (I think so)? If so, is that documented somewhere?
> 
> I think people that upgrade may have older entries and I think we should
> suggest them to migrate, no? Where to find an authoritative answer?

What do you think of the attached patch?

Paul
From 92aa94112368b4fcc69218fcba3507b25d42af21 Mon Sep 17 00:00:00 2001
From: Paul Gevers 
Date: Sun, 24 Mar 2019 17:19:40 +0100
Subject: [PATCH] Recommend use of deb.debian.org instead of the mirrors

Closes: #864035
---
 en/upgrading.dbk  | 44 
 release-notes.ent |  1 -
 2 files changed, 32 insertions(+), 13 deletions(-)

diff --git a/en/upgrading.dbk b/en/upgrading.dbk
index b779789f..f64458ca 100644
--- a/en/upgrading.dbk
+++ b/en/upgrading.dbk
@@ -476,14 +476,33 @@ $ apt-forktracer | sort
 
   
 Adding APT Internet sources
-
-  TODO: [elbrus, 2019]: we now have deb.debian.org. This section could do with
-  some minor updates regarding using that.
-
 
-  The default configuration is set up for installation from the main Debian Internet
-  servers, but you may wish to modify /etc/apt/sources.list
-  to use other mirrors, preferably a mirror that is closest to you in network terms.
+  The default configuration is set up for installation from the 
+  apt CDN service, so on new installations you should always be getting
+  packages from a server near you. As this is a relative new service, you
+  may have configuration that still points to one of the main 
+  Internet servers or one of the mirrors. If you haven't done so yet, it is
+  recommended to switch over to the use of the CDN service in your apt
+  configuration.
+
+
+  To use the CDN service with apt,
+  you add this line to your /etc/apt/sources.list file
+  (assuming you are using main and
+  contrib):
+
+deb http://deb.debian.org/debian  main contrib
+
+  After adding your new sources, disable the previously existing
+  deb lines in
+  sources.list by placing a hash sign
+  (#) in front of them.
+
+
+  Normally using the CDN service provides you with the best performance,
+  however you may wish to modify sources.list to use
+  one of the mirrors, preferably a mirror that is closest to you in network
+  terms.
 
 
   Debian mirror addresses can be found at 
 
-  To use this mirror with apt, you add this line to your
-  sources.list file:
+  To use this mirror with apt, you
+  add this line to your sources.list file (again,
+  assuming you are using main and
+  contrib):
 
 deb /debian  main contrib
 
@@ -511,9 +532,8 @@ $ apt-forktracer | sort
   after the release name are used to expand the path into multiple directories.
 
 
-  After adding your new sources, disable the previously existing
-  deb lines in sources.list by placing a
-  hash sign (#) in front of them.
+  Again, after adding your new sources, disable the previously existing
+  deb lines.
 
   
 
diff --git a/release-notes.ent b/release-notes.ent
index 6d350512..7cbb2bee 100644
--- a/release-notes.ent
+++ b/release-notes.ent
@@ -46,7 +46,6 @@ Remember, this is XML; the *first* definition of an ENTITY wins.
 https://lists.debian.org/;>
 https://www.debian.org/distrib/ftplist;>
 
-
 http://mirrors.kernel.org;>
 http://www.oftc.net/;>
 
-- 
2.20.1



signature.asc
Description: OpenPGP digital signature


Bug#864035: deb.debian.org should be used throughout

2019-03-23 Thread Paul Gevers
Control: tags -1 moreinfo

Hi Adrian,

On Sat, 03 Jun 2017 17:14:18 +0300 Adrian Bunk  wrote:
> "4.3.1. Adding APT Internet sources" is using mirrors
> instead of deb.debian.org which should be used by default
> (see section 2.2.5.).

Do we recommend using deb.debian.org as the default in
/etc/apt/sources.list (I think so)? If so, is that documented somewhere?

I think people that upgrade may have older entries and I think we should
suggest them to migrate, no? Where to find an authoritative answer?

Paul



signature.asc
Description: OpenPGP digital signature


Bug#864035: deb.debian.org should be used throughout

2017-06-03 Thread Adrian Bunk
Package: release-notes
Severity: normal

"4.3.1. Adding APT Internet sources" is using mirrors
instead of deb.debian.org which should be used by default
(see section 2.2.5.).