On Mon, 2015-05-18 at 17:27 +0200, Michael Wang wrote:
>
> On 05/18/2015 05:21 PM, Doug Ledford wrote:
> [snip]
> >>
> >> I'll put the highlights and changelog under '---' in next version, is it
> >> looks like this?
> >
> > We're still missing Jason's feedback request though. Specifically, he
> > pointed out that kdocs are usually not done in Documentation/*, they are
> > done in the .c files where the function is (or the .h file if the
> > function is an inline, which these all are). So, you included some
> > limited documentation for each of these items in your original patches
> > that added them. His request was that you put this expanded information
> > not in Documentation/infiniband where someone has to go looking for it,
> > but as part of the kdoc header for each of the various helpers in
> > ib_verbs.h itself.
>
> I see :-) I've not work with the kdoc yet, not sure if there is any
> guidelines on how to write the header of inline func for kdoc?
It's an automated tool thing. Any comment section that starts with /**
is automatically included as a kdoc. Then there is an expected format
after that. See Documentation/kernel-doc-nano-HOWTO.txt.
> >
> > Just because I want to move this along versus waiting for another
> > respin, I'm going to copy and paste these into those locations and clean
> > up the changelog when I integrate this patch.
>
> Got it, if there is anything I could help, please let me know ;-)
I'm sending the patch for review, please let me know if you are OK with
how I handled the attribution.
--
Doug Ledford <dledford@xxxxxxxxxx>
GPG KeyID: 0E572FDD
Attachment:
signature.asc
Description: This is a digitally signed message part
