> > --- a/drivers/staging/lustre/lustre/obdclass/obd_mount.c > > +++ b/drivers/staging/lustre/lustre/obdclass/obd_mount.c > > @@ -871,6 +871,87 @@ static int lmd_parse_mgs(struct lustre_mount_data *lmd, char **ptr) > > return 0; > > } > > > > +/** > > + * Find the first comma delimiter from the specified \a buf and make \a *endh > > + * point to the string starting with the comma. The commas in expression list > > + * [...] will be skipped. > > + * > > + * \param[in] buf a comma-separated string > > + * \param[in] endh a pointer to a pointer that will point to the string > > + * starting with the comma > > Please drop this mess of \param, it's not needed and is not kernel-doc > format. Is it just the [in] mess that needs to be removed or does the doc style need to migrate to another format. Looking online doesn't reveal much and' I saw something about @arg format as well. I see both in tree. What is the right one to use and do clear docs on this format exist somewhere. _______________________________________________ devel mailing list devel@xxxxxxxxxxxxxxxxxxxxxx http://driverdev.linuxdriverproject.org/mailman/listinfo/driverdev-devel
