On 05/02/18 00:34, Randy Dunlap wrote:

On 02/04/2018 08:47 AM, Igor Stoppa wrote:

[...]

It would be good for a lot of this to be in a source file or the
pmalloc.rst documentation file instead of living only in the git repository.

This is actually about genalloc. The genalloc documentation is high
level and mostly about the API, while this talks about the guts of the
library. The part modified by the patch. This text doesn't seem to
belong to the generic genalloc documentation.
I will move it to the .c file, but isn't it too much text in a source file?

[...]

quoted

+ * @order: pow of 2 represented by each entry in the bitmap

              power

ok

[...]

quoted

+ * chunk_size - dimension of a chunk of memory

can this be more explicit about which dimension?

I'll put "size in bytes of a chunk of memory"


[...]

quoted

+ * cleart_bits_ll - according to the mask, clears the bits specified by

      clear_bits_ll

yes :-(

[...]

quoted

- * bitmap_clear_ll - clear the specified number of bits at the specified position
+ * alter_bitmap_ll - set or clear the entries associated to an allocation

                                                            with an allocation

ok

quoted

+ * @alteration: selection if the bits selected should be set or cleared

                   indicates if

ok


[...]

quoted

+	/* Prepare for writing the initial part of the allocation, from
+	 * starting entry, to the end of the UL bitmap element which
+	 * contains it. It might be larger than the actual allocation.
+	 */

Use kernel multi-line comment style.

ok, also for further occurrences

[...]

quoted

+	index =  BITS_DIV_LONGS(start_bit);

	index = BITS_DIV_LONGS
(only 1 space after '=')

oops, yes

--
thank you, igor

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to majordomo@kvack.org.  For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"dont@kvack.org"> email@kvack.org </a>