From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alex Kost Subject: Re: feedback as solicited by Guix manual (Section 7.1.5) Date: Thu, 02 Jun 2016 11:37:55 +0300 Message-ID: <8737ownfz0.fsf@gmail.com> References: <574B8D1E.6080000@ethan-stefan.net> <20160531155854.GA27525@jasmine> <87oa7mxk8b.fsf@mailerver.i-did-not-set--mail-host-address--so-tickle-me> <20160531175659.GA17589@jasmine> <87mvn6xehy.fsf@mailerver.i-did-not-set--mail-host-address--so-tickle-me> <8760tundc2.fsf@gnu.org> <20160601045313.hzbhirssd52sd2pn@venom> <87r3cgofqa.fsf@gmail.com> <87shww9fon.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:42715) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b8O8e-0003oC-9f for guix-devel@gnu.org; Thu, 02 Jun 2016 04:38:01 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b8O8Z-0006DI-AP for guix-devel@gnu.org; Thu, 02 Jun 2016 04:38:00 -0400 In-Reply-To: <87shww9fon.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Thu, 02 Jun 2016 10:07:52 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ludovic =?utf-8?Q?Court=C3=A8s?= Cc: guix-devel@gnu.org Ludovic Court=C3=A8s (2016-06-02 11:07 +0300) wrote: > Alex Kost skribis: > >> Tom=C3=A1=C5=A1 =C4=8Cech (2016-06-01 07:53 +0300) wrote: >> >>> On Tue, May 31, 2016 at 11:10:21PM +0200, Ludovic Court=C3=A8s wrote: >>>>Matthew Jordan skribis: >>>> >>>>> mentions using ifconfig, correct me if I"m wrong but isn't ifconfig >>>>> considered deprecated? >>>> >>>>This ifconfig (part of GNU Inetutils) is maintained, so I think it=E2= =80=99s >>>>fine. :-) >>> >>> Yes, ifconfig is considered deprecated for more than decade. I'm not >>> networking guy but colleague of mine who is told me that ifconfig is >>> just ugly wrapper not reflecting how the kernel is handling it. >>> http://serverfault.com/questions/633087/where-is-the-statement-of-depre= cation-of-ifconfig-on-linux >>> >>> iproute2 is way to go. >> >> I would also prefer to see "ip" command instead of "ifconfig" in the >> manual. Alternatively both can be mentioned.. > > I have a hard time leaving ifconfig/iwconfig. ;-) > > I was about to change the manual=E2=80=99s examples to =E2=80=98ip=E2=80= =99, but then realized > that this is Linux-specific and doesn=E2=80=99t buy us much for these sim= ple > cases. So, what about this: Wow, do you mean that ifconfig is not only for Linux kernel? > diff --git a/doc/guix.texi b/doc/guix.texi > index 6d47976..5fd4679 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -5999,7 +5999,9 @@ more information. >=20=20 > @subsubsection Networking >=20=20 > -Run the following command see what your network interfaces are called: Run the following command to see what your network interfaces are called: BTW I think there is a typo here =E2=86=91, isn't it? > +Run the following command see what your network interfaces are called > +(on GNU/Linux, seasoned users may prefer the versatile @command{ip} > +command over @command{ifconfig}): >=20=20 > @example > ifconfig -a > > Dunno if it really helps, since =E2=80=9Cseasoned users=E2=80=9D already = know that =E2=80=98ip=E2=80=99 > is the thing. If ifconfig is a general thing (suitable for Hurd) then I agree; we should probably leave it as it is now. Otherwise I would also add a mention how to do it with "ip", like this: @example ifconfig -a @end example or @example ip a @end example --=20 Alex