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

Petr Vorel
2024-04-26T18:29:13Z

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