Using "@argname@" in kernel-doc produces "argname****" (with "argname" in bold) in the generated html output, so use the expected kernel-doc notation of just "@argname" instead. "Fixes:" lines are added in case Matthew's patch [1] is backported.
Unified · Split
| @@ -99,7 +99,7 @@ static inline bool sg_is_last(struct scatterlist *sg) · 98 unmodified lines | ||
| 99 | 99 | * @sg: The current sg entry |
| 100 | 100 | * |
| 101 | 101 | * Description: |
| 102 | − * Usually the next entry will be @sg@ + 1, but if this sg element is part | |
| 102 | + * Usually the next entry will be @sg + 1, but if this sg element is part | |
| 103 | 103 | * of a chained scatterlist, it could jump to the start of a new |
| 104 | 104 | * scatterlist array. |
| 105 | 105 | * |
| @@ -254,7 +254,7 @@ static inline void __sg_chain(struct scatterlist *chain_sg, · 148 unmodified lines | ||
| 254 | 254 | * @sgl: Second scatterlist |
| 255 | 255 | * |
| 256 | 256 | * Description: |
| 257 | − * Links @prv@ and @sgl@ together, to form a longer scatterlist. | |
| 257 | + * Links @prv and @sgl together, to form a longer scatterlist. | |
| 258 | 258 | * |
| 259 | 259 | **/ |
| 260 | 260 | static inline void sg_chain(struct scatterlist *prv, unsigned int prv_nents, |
| @@ -73,9 +73,9 @@ EXPORT_SYMBOL(sg_nents_for_len); · 72 unmodified lines | ||
| 73 | 73 | * Should only be used casually, it (currently) scans the entire list |
| 74 | 74 | * to get the last entry. |
| 75 | 75 | * |
| 76 | − * Note that the @sgl@ pointer passed in need not be the first one, | |
| 77 | − * the important bit is that @nents@ denotes the number of entries that | |
| 78 | − * exist from @sgl@. | |
| 76 | + * Note that the @sgl pointer passed in need not be the first one, | |
| 77 | + * the important bit is that @nents denotes the number of entries that | |
| 78 | + * exist from @sgl. | |
| 79 | 79 | * |
| 80 | 80 | **/ |
| 81 | 81 | struct scatterlist *sg_last(struct scatterlist *sgl, unsigned int nents) |
| @@ -345,7 +345,7 @@ EXPORT_SYMBOL(__sg_alloc_table); · 263 unmodified lines | ||
| 345 | 345 | * @gfp_mask: GFP allocation mask |
| 346 | 346 | * |
| 347 | 347 | * Description: |
| 348 | − * Allocate and initialize an sg table. If @nents@ is larger than | |
| 348 | + * Allocate and initialize an sg table. If @nents is larger than | |
| 349 | 349 | * SG_MAX_SINGLE_ALLOC a chained sg table will be setup. |
| 350 | 350 | * |
| 351 | 351 | **/ |