diff -up net-tools-1.60/man/en_US/arp.8.man-obsolete net-tools-1.60/man/en_US/arp.8
--- net-tools-1.60/man/en_US/arp.8.man-obsolete	2010-12-16 12:40:19.000000000 +0100
+++ net-tools-1.60/man/en_US/arp.8	2010-12-16 12:43:31.000000000 +0100
@@ -1,6 +1,8 @@
 .TH ARP 8 "5 Jan 1999" "net-tools" "Linux Programmer's Manual"
+
 .SH NAME
 arp \- manipulate the system ARP cache
+
 .SH SYNOPSIS
 .B arp 
 .RB [ \-evn ] 
@@ -44,6 +46,10 @@ arp \- manipulate the system ARP cache
 .RB [ "-i if" ]
 .B -f [filename]
 
+.SH NOTE
+.P 
+This program is obsolete. For replacement check \fBip neighbor\fR.
+
 .SH DESCRIPTION
 .B Arp
 manipulates the kernel's ARP cache in various ways.  The primary options
@@ -51,6 +57,7 @@ are clearing an address mapping entry an
 debugging purposes, the
 .B arp
 program also allows a complete dump of the ARP cache.
+
 .SH OPTIONS
 .TP
 .B "\-v, \-\-verbose"
@@ -107,6 +114,7 @@ table. For
 entries the specified interface is the interface on which ARP requests will
 be answered. 
 .br
+
 .B NOTE:
 This has to be different from the interface to which the IP
 datagrams will be routed.
@@ -171,6 +179,7 @@ flag. Permanent entries are marked with
 and published entries have the
 .B P
 flag.
+
 .SH FILES
 .I /proc/net/arp,
 .br
@@ -179,8 +188,10 @@ flag.
 .I /etc/hosts
 .br
 .I /etc/ethers
+
 .SH SEE ALSO
-rarp(8), route(8), ifconfig(8), netstat(8)
+.BR ip(8)
+
 .SH AUTHORS
 Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org> with a lot of improvements
 from net-tools Maintainer Bernd Eckenfels <net-tools@lina.inka.de>.
diff -up net-tools-1.60/man/en_US/ethers.5.man-obsolete net-tools-1.60/man/en_US/ethers.5
--- net-tools-1.60/man/en_US/ethers.5.man-obsolete	1999-01-09 16:55:31.000000000 +0100
+++ net-tools-1.60/man/en_US/ethers.5	2010-12-16 12:40:19.000000000 +0100
@@ -1,7 +1,9 @@
 .TH ETHERS 5 "April 26th, 1996" "" "File formats"
+
 .SH NAME \"{{{roff}}}\"{{{
 ethers \- Ethernet address to IP number database
 .\"}}}
+
 .SH DESCRIPTION \"{{{
 \fB/etc/ethers\fP contains 48 bit Ethernet addresses and their corresponding
 IP numbers, one line for each IP number:
@@ -20,12 +22,11 @@ which represents one byte of the address
 order (big-endian).  The \fIIP-number\fP may be a hostname which
 can be resolved by DNS or a dot separated number.
 .\"}}}
+
 .SH EXAMPLES \"{{{
 08:00:20:00:61:CA  pal
 .\"}}}
+
 .SH FILES \"{{{
 /etc/ethers
 .\"}}}
-.SH "SEE ALSO" \"{{{
-rarp(8)
-.\"}}}
diff -up net-tools-1.60/man/en_US/ifconfig.8.man-obsolete net-tools-1.60/man/en_US/ifconfig.8
--- net-tools-1.60/man/en_US/ifconfig.8.man-obsolete	2010-12-16 12:40:19.000000000 +0100
+++ net-tools-1.60/man/en_US/ifconfig.8	2010-12-16 12:41:23.000000000 +0100
@@ -1,10 +1,19 @@
 .TH IFCONFIG 8 "14 August 2000" "net-tools" "Linux Programmer's Manual"
+
 .SH NAME
 ifconfig \- configure a network interface
+
 .SH SYNOPSIS
 .B "ifconfig [interface]"
 .br
 .B "ifconfig interface [aftype] options | address ..."
+
+.SH NOTE
+.P 
+This program is obsolete!
+For replacement check \fBip addr\fR and \fBip link\fR.
+For statistics use \fBip -s link\fR.
+
 .SH DESCRIPTION
 .B Ifconfig
 is used to configure the kernel-resident network interfaces.  It is
@@ -44,6 +53,7 @@ octal, or hexadecimal, as specified in t
 or 0X implies hexadecimal; otherwise, a leading '0' implies octal; otherwise,
 the number is interpreted as decimal). Use of hexadecimal and octal numbers
 is not RFC-compliant and therefore its use is discouraged and may go away.
+
 .SH OPTIONS
 .TP
 .B interface
@@ -172,29 +182,41 @@ Set the length of the transmit queue of 
 to small values for slower devices with a high latency (modem links, ISDN)
 to prevent fast bulk transfers from disturbing interactive traffic like
 telnet too much. 
+
 .SH NOTES
 Since kernel release 2.2 there are no explicit interface statistics for
 alias interfaces anymore. The statistics printed for the original address
 are shared with all alias addresses on the same device. If you want per-address
 statistics you should add explicit accounting
 rules for the address using the 
-.BR ipchains(8)
+.BR iptables(8)
 command.
 .LP
 Interrupt problems with Ethernet device drivers fail with EAGAIN. See
 .I http://www.scyld.com/expert/irq-conflict.html
 for more information.
+
 .SH FILES
 .I /proc/net/socket 
 .br
 .I /proc/net/dev
 .br
 .I /proc/net/if_inet6
+
 .SH BUGS
+Ifconfig uses obsolete kernel interface.
+It uses the ioctl access method to get the full address information,
+which limits hardware addresses to 8 bytes.
+Since an Infiniband address is 20 bytes,
+only the first 8 bytes of Infiniband address are displayed.
+.LP
 While appletalk DDP and IPX addresses will be displayed they cannot be
 altered by this command.
+
 .SH SEE ALSO
-route(8), netstat(8), arp(8), rarp(8), ipchains(8)
+.BR ip(8),
+.BR iptables(8)
+
 .SH AUTHORS
 Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
 .br
--- net-tools-1.60/man/en_US/mii-tool.8.obsolete	2000-05-21 16:21:38.000000000 +0200
+++ net-tools-1.60/man/en_US/mii-tool.8	2004-11-11 10:45:51.155113000 +0100
@@ -18,6 +18,12 @@
 [\fB\-F\fR, \fB\-\-force=\fImedia\fR]
 .RI [ "interface\ ..." ]
 
+.SH NOTE
+.P 
+This program is obsolete. Valid media are only \fB100baseT4\fR, 
+\fB100baseTx-FD\fR,\fB100baseTx-HD\fR, \fB10baseT-FD\fR and 
+\fB10baseT-HD\fR ethernet cards. For replacement check \fBethtool\fB.
+
 .SH DESCRIPTION
 This utility checks or sets the status of a network interface's Media
 Independent Interface (MII) unit.  Most fast ethernet adapters use an
@@ -72,6 +78,9 @@
 commas.  Valid media are \fB100baseT4\fR, \fB100baseTx-FD\fR,
 \fB100baseTx-HD\fR, \fB10baseT-FD\fR, and \fB10baseT-HD\fR.
 
+.SH SEE ALSO
+ethtool(8)
+
 .SH AUTHORS
 David Hinds \- dhinds@pcmcia.sourceforge.org
 .br
diff -up net-tools-1.60/man/en_US/nameif.8.man-obsolete net-tools-1.60/man/en_US/nameif.8
--- net-tools-1.60/man/en_US/nameif.8.man-obsolete	2000-10-18 19:26:29.000000000 +0200
+++ net-tools-1.60/man/en_US/nameif.8	2010-12-16 12:43:10.000000000 +0100
@@ -1,10 +1,18 @@
 .TH NAMEIF 8 "18 Oct 2000" "net-tools" "Linux's Administrator's Manual"
+
 .SH NAME
 nameif \- name network interfaces based on MAC addresses
+
 .SH SYNOPSIS
 .B "nameif [-c configfile] [-s]"
 .br
 .B "nameif [-c configfile] [-s] {interface macaddress}"
+
+.SH NOTE
+.P 
+This program is obsolete. For replacement check \fBip link\fR.
+This functionality is also much better provided by udev methods.
+
 .SH DESCRIPTION
 .B nameif 
 renames network interfaces based on mac addresses. When no arguments are
@@ -31,5 +39,10 @@ should be run before the interface is up
 
 .SH FILES
 /etc/mactab
+
+.SH SEE ALSO
+.BR ip(8),
+.BR udev(7)
+
 .SH BUGS
 Only works for Ethernet currently.
diff -up net-tools-1.60/man/en_US/netstat.8.man-obsolete net-tools-1.60/man/en_US/netstat.8
--- net-tools-1.60/man/en_US/netstat.8.man-obsolete	2010-12-16 12:40:19.000000000 +0100
+++ net-tools-1.60/man/en_US/netstat.8	2010-12-16 12:42:07.000000000 +0100
@@ -92,6 +92,14 @@ netstat \- Print network connections, ro
 .RB [ \-\-netrom ]
 .RB [ \-\-ddp ]
 
+.SH NOTE
+.P 
+This program is obsolete.
+Replacement for \fBnetstat\fR is \fBss\fR.
+Replacement for \fBnetstat -r\fR is \fBip route\fR.
+Replacement for \fBnetstat -i\fR is \fBip -s link\fR.
+Replacement for \fBnetstat -g\fR is \fBip maddr\fR.
+
 .SH DESCRIPTION
 .B Netstat
 prints information about the Linux networking subsystem.  The type of
@@ -439,13 +447,13 @@ status information via the following fil
 -- statistics
 .fi
 .P
+
 .SH SEE ALSO
-.BR route (8), 
-.BR ifconfig (8), 
-.BR ipchains (8),
-.BR iptables (8),
-.BR proc (5)
+.BR ss(8),
+.BR ip(8),
+.BR iptables(8)
 .P
+
 .SH BUGS
 Occasionally strange information may appear if a socket changes
 as it is viewed. This is unlikely to occur.
diff -up net-tools-1.60/man/en_US/route.8.man-obsolete net-tools-1.60/man/en_US/route.8
--- net-tools-1.60/man/en_US/route.8.man-obsolete	2000-05-21 20:59:03.000000000 +0200
+++ net-tools-1.60/man/en_US/route.8	2010-12-16 12:44:10.000000000 +0100
@@ -1,6 +1,8 @@
 .TH ROUTE 8 "2 January 2000" "net-tools" "Linux Programmer's Manual"
+
 .SH NAME
 route \- show / manipulate the IP routing table
+
 .SH SYNOPSIS
 .B route
 .RB [ \-CFvnee ]
@@ -52,6 +54,11 @@ If]
 .RB [ \-\-version ]
 .RB [ \-h ]
 .RB [ \--help ]
+
+.SH NOTE
+.P 
+This program is obsolete. For replacement check \fBip route\fR.
+
 .SH DESCRIPTION
 .B Route
 manipulates the kernel's IP routing tables.  Its primary use is to set
@@ -306,6 +313,7 @@ address is not needed for the interface 
 .B Arp (cached only)
 Whether or not the hardware address for the cached route is up to date.
 .LP
+
 .SH FILES
 .I /proc/net/ipv6_route
 .br
@@ -313,9 +321,11 @@ Whether or not the hardware address for 
 .br
 .I /proc/net/rt_cache
 .LP
+
 .SH SEE ALSO
-.I ifconfig(8), netstat(8), arp(8), rarp(8)
+.BR ip(8)
 .LP
+
 .SH HISTORY
 .B Route
 for Linux was originally written by Fred N.  van Kempen,