public inbox for u-boot@lists.denx.de
 help / color / mirror / Atom feed
From: Mike Frysinger <vapier@gentoo.org>
To: u-boot@lists.denx.de
Subject: [U-Boot] [PATCH 2/2] document network driver framework
Date: Tue, 21 Jul 2009 02:28:09 -0400	[thread overview]
Message-ID: <200907210228.09882.vapier@gentoo.org> (raw)
In-Reply-To: <4A654D77.4070901@gmail.com>

On Tuesday 21 July 2009 01:09:11 Ben Warren wrote:
> Mike Frysinger wrote:
> > Signed-off-by: Mike Frysinger <vapier@gentoo.org>
> > ---
> > Ben: some things to note:
> > 	- i adopted Jean's proposed naming scheme in the CONFIG section
>
> Is this a generally-accepted naming convention?  I personally think it's
> crap, and since there isn't a single driver that uses it yet, you might
> say this is a bit ahead of the curve.

some style needed to be suggested, and what Jean proposed is better than what 
we have today (which is nothing)

> > 	- i deprecated calling the driver-specific entry point
> > 	  "xxx_initialization()" in favor of "xxx_register()" because the
> > 	  former is way too confusing with everyone also having "xxx_init()"
>
> That may be so, but since there isn't a single driver that uses this
> naming convention, you're wishing something that ain't so.

that's why i said "should", deprecated current naming, and noted existing 
practice.  if you agree with the proposal, it's easy enough to run sed on a 
few files to fix one function name.  you agree with my comment that today's 
behavior is confusing even if you stare and bang on the code day in and day 
out ?  it's even worse for the occasional observer ...
-mike
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 836 bytes
Desc: This is a digitally signed message part.
Url : http://lists.denx.de/pipermail/u-boot/attachments/20090721/ac05a5f9/attachment.pgp 

  reply	other threads:[~2009-07-21  6:28 UTC|newest]

Thread overview: 23+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-07-16  1:39 [U-Boot] eth/net driver documentation Mike Frysinger
2009-07-16 17:36 ` Ben Warren
2009-07-19  1:04   ` [U-Boot] [PATCH 1/2] net: rename NetRxPkt to NetRxPacket Mike Frysinger
2009-07-21  4:49     ` Ben Warren
2009-07-19  1:04   ` [U-Boot] [PATCH 2/2] document network driver framework Mike Frysinger
2009-07-21  5:09     ` Ben Warren
2009-07-21  6:28       ` Mike Frysinger [this message]
2009-07-21  7:32         ` Wolfgang Denk
2009-07-21 20:38           ` Mike Frysinger
2009-07-21 20:55             ` Ben Warren
2009-07-21 21:08               ` Mike Frysinger
2009-07-21  7:27       ` Wolfgang Denk
2009-07-22 23:00     ` Andy Fleming
2009-07-23  0:16       ` Mike Frysinger
2009-07-23 21:49     ` Jean-Christophe PLAGNIOL-VILLARD
2009-07-23 22:06       ` Wolfgang Denk
2009-07-23 22:14         ` Ben Warren
2009-07-23 22:24           ` Wolfgang Denk
2009-09-09 18:41     ` [U-Boot] [PATCH v2] " Mike Frysinger
2009-09-22 18:34       ` Wolfgang Denk
2009-10-04 19:12       ` Wolfgang Denk
2009-10-04 22:07         ` Ben Warren
2009-10-05  6:05       ` Ben Warren

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=200907210228.09882.vapier@gentoo.org \
    --to=vapier@gentoo.org \
    --cc=u-boot@lists.denx.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox