From: "Wells Lu 呂芳騰" <wells.lu@sunplus.com>
To: Andy Shevchenko <andy.shevchenko@gmail.com>
Cc: Wells Lu <wellslutw@gmail.com>,
Linus Walleij <linus.walleij@linaro.org>,
"open list:GPIO SUBSYSTEM" <linux-gpio@vger.kernel.org>,
"Linux Kernel Mailing List" <linux-kernel@vger.kernel.org>,
Rob Herring <robh+dt@kernel.org>,
devicetree <devicetree@vger.kernel.org>,
linux-arm Mailing List <linux-arm-kernel@lists.infradead.org>,
"dvorkin@tibbo.com" <dvorkin@tibbo.com>
Subject: RE: [PATCH v4 2/2] pinctrl: Add driver for Sunplus SP7021
Date: Mon, 20 Dec 2021 06:02:04 +0000 [thread overview]
Message-ID: <b5f9e73ed23447a7a4d5bfef0a209ad4@sphcmbx02.sunplus.com.tw> (raw)
In-Reply-To: <CAHp75VcU_2HR2qamGmuYBjXtaG_b55vgAUv20rb7LfPo3q-HYA@mail.gmail.com>
Hi Andy,
> > > > > +/* FIRST register:
> > > > > + * 0: MUX
> > > > > + * 1: GPIO/IOP
> > > > > + * 2: No change
> > > > > + */
> > > >
> > > > For all comments starting from here and for similar cases elsewhere:
> > > > - why it is not in kernel doc?
> > > > - what the value that add?
> > > > (Some of them so cryptic or so obvious)
> > >
> > > The comment explains usage of 'enum mux_f_mg'
> > > The 'enum' is only used in the driver.
> > > It helps programmers to remember or look-up the define of the enum.
> > > Need we add this kind of comment to kernel doc?
> >
> > Why not?
Does the kerenl doc mean dt-binding document?
If not, could you pleae tell me where should I put the kernel document?
Any references for pinctrl drivers?
Can I add more comments for the enum in c file, instead of creating new
kernel doc?
Best regards,
Wells Lu
Smart Computing Program
Home Entertainment Business Unit
Sunplus Technology Co., Ltd.
19, Innovation 1st Road,
Science-based Industrial Park
Hsin-Chu, Taiwan 300
TEL:886-3-5786005 ext. 2580
prev parent reply other threads:[~2021-12-20 6:02 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-12-14 10:53 [PATCH v4 0/2] This is a patch series for pinctrl driver of Sunplus SP7021 SoC Wells Lu
2021-12-14 10:53 ` [PATCH v4 1/2] dt-bindings: pinctrl: Add dt-bindings for Sunplus SP7021 Wells Lu
2021-12-14 15:21 ` Rob Herring
2021-12-15 11:10 ` Wells Lu 呂芳騰
2021-12-14 10:53 ` [PATCH v4 2/2] pinctrl: Add driver " Wells Lu
2021-12-14 23:14 ` Andy Shevchenko
2021-12-15 9:40 ` Wells Lu 呂芳騰
2021-12-15 12:03 ` Andy Shevchenko
2021-12-15 15:32 ` Wells Lu 呂芳騰
2021-12-20 6:02 ` Wells Lu 呂芳騰 [this message]
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=b5f9e73ed23447a7a4d5bfef0a209ad4@sphcmbx02.sunplus.com.tw \
--to=wells.lu@sunplus.com \
--cc=andy.shevchenko@gmail.com \
--cc=devicetree@vger.kernel.org \
--cc=dvorkin@tibbo.com \
--cc=linus.walleij@linaro.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-gpio@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=robh+dt@kernel.org \
--cc=wellslutw@gmail.com \
/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
all inboxes | Powered by JetHome®