From mboxrd@z Thu Jan 1 00:00:00 1970 From: Stephen Hurd Subject: Re: New driver (large patch) question. Date: Wed, 2 Mar 2016 15:10:51 -0800 Message-ID: References: <1915798.D06pWLxedU@xps13> <3156888.xIWalfADA6@xps13> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Cc: dev@dpdk.org, David Christensen , Carl Tung To: Thomas Monjalon Return-path: Received: from mail-ig0-f171.google.com (mail-ig0-f171.google.com [209.85.213.171]) by dpdk.org (Postfix) with ESMTP id 839B1298F for ; Thu, 3 Mar 2016 00:10:52 +0100 (CET) Received: by mail-ig0-f171.google.com with SMTP id z8so5756667ige.0 for ; Wed, 02 Mar 2016 15:10:52 -0800 (PST) In-Reply-To: <3156888.xIWalfADA6@xps13> List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On Wed, Mar 2, 2016 at 2:15 PM, Thomas Monjalon wrote: > > The comments in it are the only publicly available > > documentation on the hardware I'm aware of. > > So you must keep the comments. > That's my goal, but the comments are well over the 300k limit. > > The driver itself doesn't have a lot of optional features in it, it's the > > header file that's too big. > > It is big because there are many different things. > You can split the file in different patches. > Examples: > - a patch for RSS will bring the hardware structures for RSS > - a patch for the stats will bring the hardware stats structures > etc > Should I split additional definitions/documentation that's not currently used in the driver as well? Or should it stay as only enough to document what the driver already does? The header file is expected to be publicly released in the future, so I tried to keep it as close to the original as possible. I'm not strongly attached to this approach, but it does make it easier to support future firmware releases. It's a fairly work-intensive project to deconstruct the existing driver into a series of small patches that work at each step, is this a hard requirement? (if so, I'd better get cracking) PS: please answer inline > Sorry, $work just switched us to GMail and I'm still learning the ropes.