[LTP] [PATCH 1/1] doc: libltpswap: Add kerneldoc

Petr Vorel pvorel@suse.cz
Fri Apr 26 20:28:53 CEST 2024


Hi Andrea,

> > - * Macro to create minimal swapfile.
> > + * MAKE_SMALL_SWAPFILE - create small swap file.
> > + *
> > + * Macro to create small small swap file. Size defined with MINIMAL_SWAP_SIZE_MB.
> "small small" sounds weird. Maybe "really small"

+1, my typo, thanks!

> > + *
> > + * @swapfile: swap filename.
> >    */
> >   #define MAKE_SMALL_SWAPFILE(swapfile) \
> >       make_swapfile(__FILE__, __LINE__, swapfile, MINIMAL_SWAP_SIZE_MB, 0, \
> >   		  SWAPFILE_BY_SIZE)
> >   /**
> > - * Macro to create minimal swapfile.
> > + * SAFE_MAKE_SMALL_SWAPFILE - create small swap file (safe version).
> > + *
> > + * Macro to create small small swap file. Size defined with MINIMAL_SWAP_SIZE_MB.
> >    * Includes safety checks to handle potential errors.
> Same here
Yeah.

BTW we need to have CI job which tries to generate our docs with sphinx.

Kind regards,
Petr


More information about the ltp mailing list