From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-3.7 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 74E9AC433E0 for ; Thu, 11 Jun 2020 22:18:55 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 5439D20656 for ; Thu, 11 Jun 2020 22:18:55 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=networkplumber-org.20150623.gappssmtp.com header.i=@networkplumber-org.20150623.gappssmtp.com header.b="NUyFh8Q2" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726306AbgFKWSy (ORCPT ); Thu, 11 Jun 2020 18:18:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47704 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726251AbgFKWSx (ORCPT ); Thu, 11 Jun 2020 18:18:53 -0400 Received: from mail-pj1-x1044.google.com (mail-pj1-x1044.google.com [IPv6:2607:f8b0:4864:20::1044]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 39063C03E96F for ; Thu, 11 Jun 2020 15:18:52 -0700 (PDT) Received: by mail-pj1-x1044.google.com with SMTP id k2so2780800pjs.2 for ; Thu, 11 Jun 2020 15:18:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=eIuvM/OKnK+zQ/LartuQZpG8vXnwcvR8INYrEn0R5R4=; b=NUyFh8Q2TnsU8ltEQNe7J7LwTSvZrB6Cq9gkQ7p5A+Clk29jyYVy8MNifGzGpV0zyZ PEefeHax6ZoqLeSb3VVRP+PWkxrj+RrpbBJvfMYIik97YLFmrzXlPgFlbQz5KZjU8gy6 FD+sskFw5KdEPWJsl4GqjpBpU/RMvJH+MIeGfKV8MYs70gu+EUZF+hWwSPw0kfDwHPle ZbucTPb38yKN7iGYzkXH9gaSR7BxD7Mht9ZCh5JiXI/1CkOOqHHKvlkmi7otROPHv3e2 l1jqDX7qi+7Ebe4cwalx9dTi+SXNrcCsHzUONy8SCpODoHUcEfAsjN7me19JZKYjoVqy VUcA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=eIuvM/OKnK+zQ/LartuQZpG8vXnwcvR8INYrEn0R5R4=; b=avuyT7gDn+rWlEokscZAzr/YEGDfhm+U9wO0DDPqdvt+2XOsdb/1whVTk3DV3Zau9p dAssm3skXa9ojAKckQUkf/OigTqiIRD/gSEg67twN+VqVLYhM43qo8UC+k4AzMD18M1a /AEVYAGP8eWD76GeUifeX7/00m6q33ha65AX0MQaVXsQF9NhY5RLY8gOKDKmUQPbvPxI m4L+hHRari/3eZ4/scmkcrUk8aQCgzYWufECZiVMm/bUn1JuQAKOrxSk7Ckha+2fvrqQ fr9jocF4ASyXX2oHTc239JJqJ8BPk14i3jrZPchC+4ZajW5GM3BekvnSXI8UtM8JUpDl Q9uQ== X-Gm-Message-State: AOAM5328hh7pmhan8wxqwcr8OeHXXvunT42MeTwitFpZGluaV1omQjo2 QKS/1UsJrd0t8Kf/0iiDbKlUEs4trUs= X-Google-Smtp-Source: ABdhPJwGLgBVqD466hTlBYJLbaLCOy72mLHwmyH1kGI2DFm6zhwNicxqC3HQ2ZEkoZ3+VYJ2qM7xvg== X-Received: by 2002:a17:90a:b013:: with SMTP id x19mr10429690pjq.229.1591913931484; Thu, 11 Jun 2020 15:18:51 -0700 (PDT) Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id t186sm2670253pfc.39.2020.06.11.15.18.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Jun 2020 15:18:51 -0700 (PDT) Date: Thu, 11 Jun 2020 15:18:42 -0700 From: Stephen Hemminger To: "Kirsher, Jeffrey T" Cc: Jakub Kicinski , "davem@davemloft.net" , "netdev@vger.kernel.org" , "linux-doc@vger.kernel.org" , "klassert@kernel.org" , "akiyano@amazon.com" , "irusskikh@marvell.com" , "ioana.ciornei@nxp.com" , "kys@microsoft.com" , "saeedm@mellanox.com" , "jdmason@kudzu.us" , "snelson@pensando.io" , "GR-Linux-NIC-Dev@marvell.com" , "stuyoder@gmail.com" , "sgoutham@marvell.com" , "luobin9@huawei.com" , "csully@google.com" , "kou.ishizaki@toshiba.co.jp" , "peppe.cavallaro@st.com" , "chessman@tux.org" Subject: Re: [RFC 1/8] docs: networking: reorganize driver documentation again Message-ID: <20200611151842.392642c5@hermes.lan> In-Reply-To: <61CC2BC414934749BD9F5BF3D5D94044986F4FAE@ORSMSX112.amr.corp.intel.com> References: <20200611173010.474475-1-kuba@kernel.org> <20200611173010.474475-2-kuba@kernel.org> <61CC2BC414934749BD9F5BF3D5D94044986F4FAE@ORSMSX112.amr.corp.intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Thu, 11 Jun 2020 21:17:49 +0000 "Kirsher, Jeffrey T" wrote: > > -----Original Message----- > > From: Jakub Kicinski > > Sent: Thursday, June 11, 2020 10:30 > > To: davem@davemloft.net > > Cc: netdev@vger.kernel.org; linux-doc@vger.kernel.org; Jakub Kicinski > > ; klassert@kernel.org; akiyano@amazon.com; > > irusskikh@marvell.com; ioana.ciornei@nxp.com; kys@microsoft.com; > > saeedm@mellanox.com; jdmason@kudzu.us; snelson@pensando.io; GR-Linux- > > NIC-Dev@marvell.com; stuyoder@gmail.com; Kirsher, Jeffrey T > > ; sgoutham@marvell.com; luobin9@huawei.com; > > csully@google.com; kou.ishizaki@toshiba.co.jp; peppe.cavallaro@st.com; > > chessman@tux.org > > Subject: [RFC 1/8] docs: networking: reorganize driver documentation again > > > > Organize driver documentation by device type. Most documents > > have fairly verbose yet uninformative names, so let users > > first select a well defined device type, and then search for > > a particular driver. > > > > While at it rename the section from Vendor drivers to > > Hardware drivers. This seems more accurate, besides people > > sometimes refer to out-of-tree drivers as vendor drivers. > > > > Signed-off-by: Jakub Kicinski How much of it is still relevant and useful? The last time I checked, lots of this had bad advice about settings. And there was lots of drivers documenting what was generic Linux functionality And still there were references to old commands like ifconfig or ifenslave.