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 | * @sg: The current sg entry | 99 | * @sg: The current sg entry |
| 100 | * | 100 | * |
| 101 | * Description: | 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 | * of a chained scatterlist, it could jump to the start of a new | 103 | * of a chained scatterlist, it could jump to the start of a new |
| 104 | * scatterlist array. | 104 | * scatterlist array. |
| 105 | * | 105 | * |
| @@ -254,7 +254,7 @@ static inline void __sg_chain(struct scatterlist *chain_sg, · 148 unmodified lines | |||
| 254 | * @sgl: Second scatterlist | 254 | * @sgl: Second scatterlist |
| 255 | * | 255 | * |
| 256 | * Description: | 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 | static inline void sg_chain(struct scatterlist *prv, unsigned int prv_nents, | 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 | * Should only be used casually, it (currently) scans the entire list | 73 | * Should only be used casually, it (currently) scans the entire list |
| 74 | * to get the last entry. | 74 | * to get the last entry. |
| 75 | * | 75 | * |
| 76 | * Note that the @sgl@ pointer passed in need not be the first one, | 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 | 77 | * the important bit is that @nents denotes the number of entries that |
| 78 | * exist from @sgl@. | 78 | * exist from @sgl. |
| 79 | * | 79 | * |
| 80 | **/ | 80 | **/ |
| 81 | struct scatterlist *sg_last(struct scatterlist *sgl, unsigned int nents) | 81 | struct scatterlist *sg_last(struct scatterlist *sgl, unsigned int nents) |
| @@ -345,7 +345,7 @@ EXPORT_SYMBOL(__sg_alloc_table); · 263 unmodified lines | |||
| 345 | * @gfp_mask: GFP allocation mask | 345 | * @gfp_mask: GFP allocation mask |
| 346 | * | 346 | * |
| 347 | * Description: | 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 | * SG_MAX_SINGLE_ALLOC a chained sg table will be setup. | 349 | * SG_MAX_SINGLE_ALLOC a chained sg table will be setup. |
| 350 | * | 350 | * |
| 351 | **/ | 351 | **/ |