[iputils/f17: 5/7] Clarify ping -I in the manpage

[jsynacek]

commit c4d6fe97a6cd892a93443b4f6a44d20682eb660b
Author: Jan Synacek <jsynacek at redhat.com>
Date:   Fri Dec 7 14:56:56 2012 +0100

    Clarify ping -I in the manpage

 iputils-20101006-man2.patch |   34 ++++++++++++++++++++++++++++++++++
 iputils.spec                |    3 +++
 2 files changed, 37 insertions(+), 0 deletions(-)
---
diff --git a/iputils-20101006-man2.patch b/iputils-20101006-man2.patch
new file mode 100644
index 0000000..ffbbd20
--- /dev/null
+++ b/iputils-20101006-man2.patch
@@ -0,0 +1,34 @@
+commit 28e2ab7db41b5e5c894a245c10035e84bdc7a08c
+Author: YOSHIFUJI Hideaki <yoshfuji at linux-ipv6.org>
+Date:   Sat Dec 1 04:38:13 2012 +0900
+
+    ping: Clarify difference between -I device and -I addr.
+    
+    Signed-off-by: YOSHIFUJI Hideaki <yoshfuji at linux-ipv6.org>
+
+diff --git a/doc/ping.sgml b/doc/ping.sgml
+index fb3c3ac..4e0e65f 100644
+--- a/doc/ping.sgml
++++ b/doc/ping.sgml
+@@ -141,11 +141,16 @@ to values less 0.2 seconds.
+   </para></listitem>
+  </varlistentry>
+  <varlistentry>
+-  <term><option>-I <replaceable/interface address/</option></term>
+-  <listitem><para>
+-Set source address to specified interface address. Argument
+-may be numeric IP address or name of device. When pinging IPv6
+-link-local address this option is required.
++  <term><option>-I <replaceable/interface/</option></term>
++  <listitem><para>
++<replaceable/interface/ is either an address, or an interface name.
++If <replaceable/interface/ is an address, it sets source address
++to specified interface address.
++If <replaceable/interface/ in an interface name, it sets
++source interface to specified interface.
++For <command/ping6/, when doing ping to a link-local scope
++address, link specification (by the '%'-notation in
++<replaceable/destination/, or by this option) is required.
+   </para></listitem>
+  </varlistentry>
+  <varlistentry>
diff --git a/iputils.spec b/iputils.spec
index b7a7700..4761d07 100644
--- a/iputils.spec
+++ b/iputils.spec
@@ -31,6 +31,7 @@ Patch17: iputils-20101006-eth.patch
 Patch18: iputils-20101006-rr.patch
 Patch21: iputils-20101006-caps.patch
 Patch22: iputils-s20101006-sobinddevice-fatal.patch
+Patch23: iputils-20101006-man2.patch
 
 BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
 BuildRequires: docbook-utils perl-SGMLSpm
@@ -88,6 +89,7 @@ The iputils-sysvinit contains SysV initscritps support.
 %patch18 -p1 -b .rr
 %patch21 -p1 -b .caps
 %patch22 -p1 -b .sobinddevice-fatal
+%patch23 -p1 -b .man2
 
 %build
 %ifarch s390 s390x
@@ -196,6 +198,7 @@ rm -rf ${RPM_BUILD_ROOT}
   isn't working) and drop unnecessary patches
 - Drop subint patch and make SO_BINDTODEVICE failure fatal
 - Comment capability patch
+- Clarify ping -I in the manpage
 
 * Mon Jun 25 2012 Jan Synáček <jsynacek at redhat.com> 20101006-15
 - Ping fixes: