please add some examples to the ip man page

please add some examples to the ip man page

[積丹尼 Dan Jacobson]

$ man ip
should have some usage examples. Even one would be fine.

Re: please add some examples to the ip man page

[Stephen Hemminger]

On Wed, 08 Mar 2017 03:10:32 +0800
積丹尼 Dan Jacobson <jidanni@jidanni.org> wrote:

> $ man ip
> should have some usage examples. Even one would be fine.

Sure. Submit a patch.

Re: please add some examples to the ip man page

[積丹尼 Dan Jacobson]

>>>>> "SH" == Stephen Hemminger <stephen@networkplumber.org> writes:

SH> Sure. Submit a patch.

If only I could figure out how to use the command.

Re: please add some examples to the ip man page

[Stephen Hemminger]

On Wed, 08 Mar 2017 08:46:01 +0800
積丹尼 Dan Jacobson <jidanni@jidanni.org> wrote:

> >>>>> "SH" == Stephen Hemminger <stephen@networkplumber.org> writes:  
> 
> SH> Sure. Submit a patch.  
> 
> If only I could figure out how to use the command.

$ ip link show

$ ip addr show

$ ip route

Re: please add some examples to the ip man page

[David Ahern]

On 3/7/17 6:25 PM, Stephen Hemminger wrote:
> On Wed, 08 Mar 2017 08:46:01 +0800
> 積丹尼 Dan Jacobson <jidanni@jidanni.org> wrote:
> 
>>>>>>> "SH" == Stephen Hemminger <stephen@networkplumber.org> writes:  
>>
>> SH> Sure. Submit a patch.  
>>
>> If only I could figure out how to use the command.
> 
> $ ip link show
> 
> $ ip addr show
> 
> $ ip route
> 

a lot of examples here:
https://www.kernel.org/doc/Documentation/networking/vrf.txt

Re: please add some examples to the ip man page

[積丹尼 Dan Jacobson]

I see.
Perhaps on the man page add
EXAMPLES
   See https://www.kernel.org/doc/Documentation/networking/vrf.txt
   https://www.google.com/search?q=ip+linux+command+usage+examples
(I thought the latter would be hopeless, but actually found lots!)

Re: please add some examples to the ip man page

[Alexander Alemayhu]

On Wed, Mar 08, 2017 at 03:17:02PM +0800, 積丹尼 Dan Jacobson wrote:
> I see.
> Perhaps on the man page add
> EXAMPLES
>    See https://www.kernel.org/doc/Documentation/networking/vrf.txt
>    https://www.google.com/search?q=ip+linux+command+usage+examples
> (I thought the latter would be hopeless, but actually found lots!)
> 
Actual examples in the page would better than links IMO.  git has some
nice examples in gittutorial(7) and giteveryday(7). Maybe that can be
good inspiration?

-- 
Mit freundlichen Grüßen

Alexander Alemayhu

Re: please add some examples to the ip man page

[David Ahern]

On 3/9/17 3:56 AM, Alexander Alemayhu wrote:
> On Wed, Mar 08, 2017 at 03:17:02PM +0800, 積丹尼 Dan Jacobson wrote:
>> I see.
>> Perhaps on the man page add
>> EXAMPLES
>>    See https://www.kernel.org/doc/Documentation/networking/vrf.txt
>>    https://www.google.com/search?q=ip+linux+command+usage+examples
>> (I thought the latter would be hopeless, but actually found lots!)
>>
> Actual examples in the page would better than links IMO.  git has some
> nice examples in gittutorial(7) and giteveryday(7). Maybe that can be
> good inspiration?

excellent opportunity for an aspiring writer / user to make a
contribution to improve iproute2.

git clone
git://git.kernel.org/pub/scm/linux/kernel/git/shemminger/iproute2.git
cd iproute2
<make changes>

commit, send to netdev.