strbuf.h: format asciidoc code blocks as 4-space indent
This is much easier to read when the whole thing is stuffed inside a comment block. And there is precedent for this convention in markdown (and just in general ascii text). Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jeff King committed
Jan 16, 2015 at 04:05 UTC
088c9a86ff5332ee15415be3408ccf34687bc2d2
1 file changed
+4
-7
strbuf.h
+4
-7
@@ -33,10 +33,9 @@
33
* NOTE: It is OK to "play" with the buffer directly if you work it this
34
* way:
35
*
36
- * ----
37
- * strbuf_grow(sb, SOME_SIZE); <1>
38
- * strbuf_setlen(sb, sb->len + SOME_OTHER_SIZE);
39
- * ----
36
+ * strbuf_grow(sb, SOME_SIZE); <1>
37
+ * strbuf_setlen(sb, sb->len + SOME_OTHER_SIZE);
38
+ *
39
* <1> Here, the memory array starting at `sb->buf`, and of length
40
* `strbuf_avail(sb)` is all yours, and you can be sure that
41
* `strbuf_avail(sb)` is at least `SOME_SIZE`.
@@ -261,9 +260,7 @@ extern void strbuf_add(struct strbuf *, const void *, size_t);
260
* NOTE: This function will *always* be implemented as an inline or a macro
261
* using strlen, meaning that this is efficient to write things like:
262
*
264
- * ----
265
- * strbuf_addstr(sb, "immediate string");
266
- * ----
263
+ * strbuf_addstr(sb, "immediate string");
264
*
265
*/
266
static inline void strbuf_addstr(struct strbuf *sb, const char *s)