linux-staging.lists.linux.dev archive mirror
 help / color / mirror / Atom feed
From: Dan Carpenter <dan.carpenter@oracle.com>
To: Jordan Vaughn <jordanvaughn1@gmail.com>
Cc: gregkh@linuxfoundation.org, ganesanr@broadcom.com,
	linux-staging@lists.linux.dev,
	Jordan Vaughn <jordvaughn1@gmail.com>,
	jchandra@broadcom.com
Subject: Re: [PATCH] netlogic: This patch formats existing comments to Linux standards found in TODO.
Date: Tue, 4 May 2021 11:17:58 +0300	[thread overview]
Message-ID: <20210504081758.GT1981@kadam> (raw)
In-Reply-To: <20210503170353.66415-1-jordvaughn1@gmail.com>

The subject doesn't make sense.

> -/*
> - * Configure the 6 FIFO's that are used by the network accelarator to
> +/**
> + * xlr_config_fifo_spill_area() - Configure the 6 FIFO's that are used by the network accelarator to

This comment is way too long now.  For comments, we want to be within
the 80 character limit.


>   * communicate with the rest of the XLx device. 4 of the FIFO's are for
>   * packets from NA --> cpu (called Class FIFO's) and 2 are for feeding
>   * the NA with free descriptors.
> @@ -440,8 +439,8 @@ static void xlr_config_fifo_spill_area(struct xlr_net_priv *priv)

[ snip ]

> @@ -599,7 +600,7 @@ static int xlr_phy_write(u32 *base_addr, int phy_addr, int regnum, u16 val)
>  	unsigned long timeout, stoptime, checktime;
>  	int timedout;
>  
> -	/* 100ms timeout*/
> +
>  	timeout = msecs_to_jiffies(100);

This patch introduces a double blank line checkpatch warning.

>  	stoptime = jiffies + timeout;
>  	timedout = 0;
> @@ -629,7 +630,7 @@ static int xlr_phy_read(u32 *base_addr, int phy_addr, int regnum)
>  	unsigned long timeout, stoptime, checktime;
>  	int timedout;
>  
> -	/* 100ms timeout*/
> +
>  	timeout = msecs_to_jiffies(100);

Same.

>  	stoptime = jiffies + timeout;
>  	timedout = 0;

[ snip ]

> @@ -951,9 +954,7 @@ static int xlr_net_probe(struct platform_device *pdev)
>  	int err, port;
>  
>  	pr_info("XLR/XLS Ethernet Driver controller %d\n", pdev->id);
> -	/*
> -	 * Allocate our adapter data structure and attach it to the device.
> -	 */
> +	 /* Allocate our adapter data structure and attach it to the device.*/

There needs to be a space before the "*/" closing.

>  	adapter = devm_kzalloc(&pdev->dev, sizeof(*adapter), GFP_KERNEL);
>  	if (!adapter)
>  		return -ENOMEM;

regards,
dan carpenter


  parent reply	other threads:[~2021-05-04  8:18 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-05-03 17:03 [PATCH] netlogic: This patch formats existing comments to Linux standards found in TODO Jordan Vaughn
2021-05-03 17:34 ` Greg KH
2021-05-04  8:17 ` Dan Carpenter [this message]
2021-05-04  8:29   ` Dan Carpenter

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=20210504081758.GT1981@kadam \
    --to=dan.carpenter@oracle.com \
    --cc=ganesanr@broadcom.com \
    --cc=gregkh@linuxfoundation.org \
    --cc=jchandra@broadcom.com \
    --cc=jordanvaughn1@gmail.com \
    --cc=jordvaughn1@gmail.com \
    --cc=linux-staging@lists.linux.dev \
    /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;
as well as URLs for NNTP newsgroup(s).