Bug#851229: net-tools no longer priority important, iproute2 is

[Baptiste Jammet <baptiste@mailoo.org>]

Hi, 

Dixit Martin Michlmayr, le 12/01/2017 :

>net-tools's priority has been changed from important to optional while
>iproute2 has been upgraded to important.
>
>I think this should be mentioned in the release-notes, ideally along
>with a description of the new commands to use for those not familiar
>with iproute2.

I add a line in "obsolete package" section and a full section at the
end. I didn't find anything in the Debian wiki, so I put a link to the
debian-reference manual.
Please review and comment if needed.

Thanks
Baptiste

Index: en/issues.dbk
===================================================================
--- en/issues.dbk	(révision 11415)
+++ en/issues.dbk	(copie de travail)
@@ -76,6 +76,16 @@
           extract your passwords from fpm2 before removing the package.
           </para>
         </listitem>
+        <listitem>
+          <para>
+          The <systemitem role="package">net-tools</systemitem> package
+          will be deprecated in favor of
+          <systemitem role="package">iproute2</systemitem>.
+          See <xref linkend="iproute2" /> or the
+          <ulink url="https://www.debian.org/doc/manuals/debian-reference/ch05#_the_low_level_network_configuration";>
+          Debian reference manual</ulink> for more informations.
+          </para>
+        </listitem>
       </itemizedlist>
     </para>
   </section>
@@ -579,6 +589,67 @@
     </para>
   </section>
 
+
+  <section id="iproute2">
+  <title>iproute2 will replace net-tools</title>
+    <para>
+      The <systemitem role="package">net-tools</systemitem> package's
+      priority has been changed from important to optional, while
+      <systemitem role="package">iproute2</systemitem> has been
+      upgraded to important.
+      New installations will have <systemitem role="package">iproute2</systemitem>
+      installed by default, while systems upgraded from Jessie should consider migrating
+      from <systemitem role="package">net-tools</systemitem> to
+      <systemitem role="package">iproute2</systemitem>.
+    </para>
+    <para>
+      Here is a summary of the net-tools commands, together with
+      their iproute2 equivalent:
+    </para>
+  <informaltable>
+    <tgroup cols="2">
+      <colspec align="justify"/>
+      <colspec align="justify"/>
+      <thead>
+        <row>
+          <entry>legacy net-tools commands</entry>
+          <entry>iproute2 replacement commands</entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry>arp</entry>
+          <entry>ip n (ip neighbor)</entry>
+        </row>
+        <row>
+          <entry>ifconfig</entry>
+          <entry>ip a (ip addr), ip link, ip -s (ip -stats)</entry>
+        </row>
+        <row>
+          <entry>iptunnel</entry>
+          <entry>ip tunnel</entry>
+        </row>
+        <row>
+          <entry>iwconfig</entry>
+          <entry>iw</entry>
+        </row>
+        <row>
+          <entry>nameif</entry>
+          <entry>ip link, ifrename</entry>
+        </row>
+        <row>
+          <entry>netstat</entry>
+          <entry>ss, ip route (for netstat-r), ip -s link (for netstat -i), ip maddr (for netstat-g)</entry>
+        </row>
+        <row>
+          <entry>route</entry>
+          <entry>ip r (ip route)</entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </informaltable>
+  </section>
+
 </section>
 
 </chapter>

Attachment: pgpMahguHmCk0.pgp
Description: OpenPGP digital signature