kernel-api.rst: fix some complex tags at lib/bitmap.c (40bf19a8) · Commits · 戴 / test

lib/bitmap.c

+17 −11

Original line number	Diff line number	Diff line
		@@ -502,11 +502,11 @@ EXPORT_SYMBOL(bitmap_print_to_pagebuf);
		* Syntax: range:used_size/group_size
		* Example: 0-1023:2/256 ==> 0,1,256,257,512,513,768,769
		*
		* Returns 0 on success, -errno on invalid input strings.
		* Error values:
		* %-EINVAL: second number in range smaller than first
		* %-EINVAL: invalid character in string
		* %-ERANGE: bit number specified too large for mask
		* Returns: 0 on success, -errno on invalid input strings. Error values:
		*
		* - ``-EINVAL``: second number in range smaller than first
		* - ``-EINVAL``: invalid character in string
		* - ``-ERANGE``: bit number specified too large for mask
		*/
		static int __bitmap_parselist(const char *buf, unsigned int buflen,
		int is_user, unsigned long *maskp,
		@@ -864,14 +864,16 @@ EXPORT_SYMBOL(bitmap_bitremap);
		* 11 was set in @orig had no affect on @dst.
		*
		* Example [2] for bitmap_fold() + bitmap_onto():
		* Let's say @relmap has these ten bits set:
		* Let's say @relmap has these ten bits set::
		*
		* 40 41 42 43 45 48 53 61 74 95
		*
		* (for the curious, that's 40 plus the first ten terms of the
		* Fibonacci sequence.)
		*
		* Further lets say we use the following code, invoking
		* bitmap_fold() then bitmap_onto, as suggested above to
		* avoid the possibility of an empty @dst result:
		* avoid the possibility of an empty @dst result::
		*
		* unsigned long *tmp; // a temporary bitmap's bits
		*
		@@ -882,22 +884,26 @@ EXPORT_SYMBOL(bitmap_bitremap);
		* various @orig's. I list the zero-based positions of each set bit.
		* The tmp column shows the intermediate result, as computed by
		* using bitmap_fold() to fold the @orig bitmap modulo ten
		* (the weight of @relmap).
		* (the weight of @relmap):
		*
		* =============== ============== =================
		* @orig tmp @dst
		* 0 0 40
		* 1 1 41
		* 9 9 95
		* 10 0 40 (*)
		* 10 0 40 [#f1]_
		* 1 3 5 7 1 3 5 7 41 43 48 61
		* 0 1 2 3 4 0 1 2 3 4 40 41 42 43 45
		* 0 9 18 27 0 9 8 7 40 61 74 95
		* 0 10 20 30 0 40
		* 0 11 22 33 0 1 2 3 40 41 42 43
		* 0 12 24 36 0 2 4 6 40 42 45 53
		* 78 102 211 1 2 8 41 42 74 (*)
		* 78 102 211 1 2 8 41 42 74 [#f1]_
		* =============== ============== =================
		*
		* .. [#f1]
		*
		* (*) For these marked lines, if we hadn't first done bitmap_fold()
		* For these marked lines, if we hadn't first done bitmap_fold()
		* into tmp, then the @dst result would have been empty.
		*
		* If either of @orig or @relmap is empty (no set bits), then @dst

Admin message