[PATCH 2/4] strbuf.h: drop asciidoc list formatting from API docs

2014-12-12 Thread Jeff King
Using a hanging indent is much more readable. This means we won't format as asciidoc anymore, but since we don't have a working system for extracting these comments anyway, it's probably more important to just make the source readable. Signed-off-by: Jeff King --- strbuf.h | 74 +

Re: [PATCH 2/4] strbuf.h: drop asciidoc list formatting from API docs

2014-12-12 Thread Junio C Hamano
Jeff King writes: > Using a hanging indent is much more readable. This means we > won't format as asciidoc anymore, but since we don't have a > working system for extracting these comments anyway, it's > probably more important to just make the source readable. Yeah. Those who want to strip the

Re: [PATCH 2/4] strbuf.h: drop asciidoc list formatting from API docs

2014-12-12 Thread Jonathan Nieder
Jeff King wrote: > Using a hanging indent is much more readable. This means we > won't format as asciidoc anymore, but since we don't have a > working system for extracting these comments anyway, it's > probably more important to just make the source readable. > > Signed-off-by: Jeff King > ---