* [PATCH 1/1] Adding examples in ip man page on basic use of the ip command.
@ 2011-11-24 12:00 Alex Juncu
2011-11-24 19:12 ` Ben Hutchings
2011-11-29 1:39 ` Stephen Hemminger
0 siblings, 2 replies; 3+ messages in thread
From: Alex Juncu @ 2011-11-24 12:00 UTC (permalink / raw)
To: netdev, shemminger
---
man/man8/ip.8 | 43 +++++++++++++++++++++++++++++++++++++++++++
1 files changed, 43 insertions(+), 0 deletions(-)
diff --git a/man/man8/ip.8 b/man/man8/ip.8
index a20eca7..99c8953 100644
--- a/man/man8/ip.8
+++ b/man/man8/ip.8
@@ -2855,6 +2855,49 @@ can be
.SS ip xfrm monitor - state monitoring for xfrm objects
The xfrm objects to monitor can be optionally specified.
+.SH EXAMPLES
+.LP
+To turn on an interface:
+.RS
+.nf
+.B ip link set up dev eth0
+.fi
+.RE
+.LP
+To add an IPv4 address to an interface:
+.RS
+.nf
+.B ip address add 141.85.37.42/24 dev eth0
+.fi
+.RE
+.LP
+To add a default route in the IPv4 routing table using a next hop IP
address:
+.RS
+.nf
+.B ip route add default via 141.85.37.1
+.fi
+.RE
+.LP
+Equivalent ways of listing address information for all the interfaces:
+.RS
+.nf
+.B ip addr show
+.fi
+.RE
+.LP
+.RS
+.nf
+.B ip a s
+.fi
+.RE
+.LP
+.RS
+.nf
+.B ip a
+.fi
+.RE
+.LP
+
.SH HISTORY
.B ip
was written by Alexey N. Kuznetsov and added in Linux 2.2.
--
1.7.4.1
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH 1/1] Adding examples in ip man page on basic use of the ip command.
2011-11-24 12:00 [PATCH 1/1] Adding examples in ip man page on basic use of the ip command Alex Juncu
@ 2011-11-24 19:12 ` Ben Hutchings
2011-11-29 1:39 ` Stephen Hemminger
1 sibling, 0 replies; 3+ messages in thread
From: Ben Hutchings @ 2011-11-24 19:12 UTC (permalink / raw)
To: Alex Juncu; +Cc: netdev, shemminger
On Thu, 2011-11-24 at 14:00 +0200, Alex Juncu wrote:
> ---
> man/man8/ip.8 | 43 +++++++++++++++++++++++++++++++++++++++++++
> 1 files changed, 43 insertions(+), 0 deletions(-)
>
> diff --git a/man/man8/ip.8 b/man/man8/ip.8
> index a20eca7..99c8953 100644
> --- a/man/man8/ip.8
> +++ b/man/man8/ip.8
> @@ -2855,6 +2855,49 @@ can be
Although it's customary to put EXAMPLES near the bottom of the page, I
suspect that the same users who are intimidated by the long usage
description are unlikely ever to get this far. But I may be wrong;
maybe people do specifically look for this section.
Alternately, it may be more helpful to reorder the SYNOPSIS to emphasise
the most commonly used commands.
Ben.
> .SS ip xfrm monitor - state monitoring for xfrm objects
> The xfrm objects to monitor can be optionally specified.
>
> +.SH EXAMPLES
> +.LP
> +To turn on an interface:
> +.RS
> +.nf
> +.B ip link set up dev eth0
> +.fi
> +.RE
> +.LP
> +To add an IPv4 address to an interface:
> +.RS
> +.nf
> +.B ip address add 141.85.37.42/24 dev eth0
> +.fi
> +.RE
> +.LP
> +To add a default route in the IPv4 routing table using a next hop IP
> address:
> +.RS
> +.nf
> +.B ip route add default via 141.85.37.1
> +.fi
> +.RE
> +.LP
> +Equivalent ways of listing address information for all the interfaces:
> +.RS
> +.nf
> +.B ip addr show
> +.fi
> +.RE
> +.LP
> +.RS
> +.nf
> +.B ip a s
> +.fi
> +.RE
> +.LP
> +.RS
> +.nf
> +.B ip a
> +.fi
> +.RE
> +.LP
> +
> .SH HISTORY
> .B ip
> was written by Alexey N. Kuznetsov and added in Linux 2.2.
--
Ben Hutchings, Staff Engineer, Solarflare
Not speaking for my employer; that's the marketing department's job.
They asked us to note that Solarflare product names are trademarked.
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH 1/1] Adding examples in ip man page on basic use of the ip command.
2011-11-24 12:00 [PATCH 1/1] Adding examples in ip man page on basic use of the ip command Alex Juncu
2011-11-24 19:12 ` Ben Hutchings
@ 2011-11-29 1:39 ` Stephen Hemminger
1 sibling, 0 replies; 3+ messages in thread
From: Stephen Hemminger @ 2011-11-29 1:39 UTC (permalink / raw)
To: Alex Juncu; +Cc: netdev
On Thu, 24 Nov 2011 14:00:54 +0200
Alex Juncu <ajuncu@ixiacom.com> wrote:
> ---
> man/man8/ip.8 | 43 +++++++++++++++++++++++++++++++++++++++++++
> 1 files changed, 43 insertions(+), 0 deletions(-)
>
> diff --git a/man/man8/ip.8 b/man/man8/ip.8
> index a20eca7..99c8953 100644
> --- a/man/man8/ip.8
> +++ b/man/man8/ip.8
> @@ -2855,6 +2855,49 @@ can be
> .SS ip xfrm monitor - state monitoring for xfrm objects
> The xfrm objects to monitor can be optionally specified.
>
> +.SH EXAMPLES
> +.LP
> +To turn on an interface:
> +.RS
> +.nf
> +.B ip link set up dev eth0
> +.fi
> +.RE
> +.LP
> +To add an IPv4 address to an interface:
> +.RS
> +.nf
> +.B ip address add 141.85.37.42/24 dev eth0
> +.fi
> +.RE
> +.LP
> +To add a default route in the IPv4 routing table using a next hop IP
> address:
> +.RS
> +.nf
> +.B ip route add default via 141.85.37.1
> +.fi
> +.RE
> +.LP
> +Equivalent ways of listing address information for all the interfaces:
> +.RS
> +.nf
> +.B ip addr show
> +.fi
> +.RE
> +.LP
> +.RS
> +.nf
> +.B ip a s
> +.fi
> +.RE
> +.LP
> +.RS
> +.nf
> +.B ip a
> +.fi
> +.RE
> +.LP
> +
Simple examples at bottom of page are good, but it is unnecessary
to show how to abbreviate. That just confuses the newbie reading the examples.
Give one example of each of the basic normal tasks. See the git man pages
for good examples.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2011-11-29 1:39 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-11-24 12:00 [PATCH 1/1] Adding examples in ip man page on basic use of the ip command Alex Juncu
2011-11-24 19:12 ` Ben Hutchings
2011-11-29 1:39 ` Stephen Hemminger
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).