git/Documentation/technical/api-strbuf.txt, branch v1.7.3.4

strbuf: add strbuf_addbuf_percentquote

2010-01-14T17:25:15Z

This is handy for creating strings which will be fed to printf() or strbuf_expand(). Signed-off-by: Jeff King Signed-off-by: Junio C Hamano

strbuf_expand: convert "%%" to "%"

2010-01-14T17:24:42Z

The only way to safely quote arbitrary text in a pretty-print user format is to replace instances of "%" with "%x25". This is slightly unreadable, and many users would expect "%%" to produce a single "%", as that is what printf format specifiers do. This patch converts "%%" to "%" for all users of strbuf_expand(): (1) git-daemon interpolated paths (2) pretty-print user formats (3) merge driver command lines Case (1) was already doing the conversion itself outside of strbuf_expand(). Case (2) is the intended beneficiary of this patch. Case (3) users probably won't notice, but as this is user-facing behavior, consistently providing the quoting mechanism makes sense. Signed-off-by: Jeff King Signed-off-by: Junio C Hamano

api-strbuf.txt: fix typos and document launch_editor()

2009-12-18T05:54:28Z

Signed-off-by: Stephen Boyd Signed-off-by: Junio C Hamano

Documentation: Typo / spelling / formatting fixes

2009-03-04T05:43:19Z

Signed-off-by: Mike Ralphson Signed-off-by: Junio C Hamano

Merge branch 'maint'

2009-02-04T08:12:19Z

* maint: User-manual: "git stash " form is long gone add test-dump-cache-tree in Makefile fix typo in Documentation apply: fix access to an uninitialized mode variable, found by valgrind Conflicts: Makefile

Merge branch 'maint-1.6.0' into maint

2009-02-04T07:50:09Z

* maint-1.6.0: User-manual: "git stash " form is long gone add test-dump-cache-tree in Makefile fix typo in Documentation apply: fix access to an uninitialized mode variable, found by valgrind

fix typo in Documentation

2009-02-04T06:09:03Z

Signed-off-by: Guanqun Lu Signed-off-by: Junio C Hamano

strbuf: instate cleanup rule in case of non-memory errors

2009-01-07T06:13:43Z

Make all strbuf functions that can fail free() their memory on error if they have allocated it. They don't shrink buffers that have been grown, though. This allows for easier error handling, as callers only need to call strbuf_release() if A) the command succeeded or B) if they would have had to do so anyway because they added something to the strbuf themselves. Bonus hunk: document strbuf_readlink. Signed-off-by: Rene Scharfe Signed-off-by: Junio C Hamano

add strbuf_expand_dict_cb(), a helper for simple cases

2008-11-24T03:55:47Z

The new callback function strbuf_expand_dict_cb() can be used together with strbuf_expand() if there is only a small number of placeholders for static replacement texts. It expects its dictionary as an array of placeholder+value pairs as context parameter, terminated by an entry with the placeholder member set to NULL. The new helper is intended to aid converting the remaining calls of interpolate(). strbuf_expand() is smaller, more flexible and can be used to go faster than interpolate(), so it should replace the latter. Signed-off-by: Rene Scharfe Signed-off-by: Junio C Hamano

Strbuf documentation: document most functions

2008-06-04T22:02:42Z

All functions in strbuf.h are documented, except launch_editor(). Signed-off-by: Miklos Vajna Signed-off-by: Junio C Hamano