On Wed, Jun 22, 2022 at 01:54:46PM -0700, Stephen Hemminger wrote:
> On Wed, 22 Jun 2022 13:37:12 -0700
> Tyler Retzlaff <roret...@linux.microsoft.com> wrote:
> 
> > On Wed, Jun 22, 2022 at 01:27:36PM -0700, Stephen Hemminger wrote:
> > > The phrase "This API is used to" is unnecessary and changes the
> > > documentation into passive voice.
> > > 
> > > Stephen Hemminger (2):
> > >   rawdev, dmadev: remove passive voice in function doc
> > >   eal: remove passive voice from interrupt function documentation
> > > 
> > >  drivers/raw/ioat/rte_ioat_rawdev.h |  2 +-
> > >  lib/dmadev/rte_dmadev.h            |  2 +-
> > >  lib/eal/include/rte_interrupts.h   | 23 +++++++++++------------
> > >  3 files changed, 13 insertions(+), 14 deletions(-)
> > > 
> > > --   
> > 
> > the re-wording has shortened some of the lines, i'm not sure what
> > takes precedence (minimum diff vs line length convention).
> > 
> 
> Doxygen repacks line during documentation generation

no worries either way, myself i don't read doxygen i read the
code/comments directly.

Reply via email to