git/Documentation/technical/api-string-list.txt, branch v2.0.2

Merge branch 'mh/ceiling'

2013-01-02T18:36:59Z

An element on GIT_CEILING_DIRECTORIES list that does not name the real path to a directory (i.e. a symbolic link) could have caused the GIT_DIR discovery logic to escape the ceiling. * mh/ceiling: string_list_longest_prefix(): remove function setup_git_directory_gently_1(): resolve symlinks in ceiling paths longest_ancestor_length(): require prefix list entries to be normalized longest_ancestor_length(): take a string_list argument for prefixes longest_ancestor_length(): use string_list_split() Introduce new function real_path_if_valid() real_path_internal(): add comment explaining use of cwd Introduce new static function real_path_internal()

string_list: add a function string_list_remove_empty_items()

2012-11-08T16:34:08Z

Signed-off-by: Michael Haggerty Acked-by: Johan Herland Signed-off-by: Jeff King

string_list_longest_prefix(): remove function

2012-10-29T06:34:58Z

This function was added in f103f95b11d087f07c0c48bf784cd9197e18f203 in the erroneous expectation that it would be used in the reimplementation of longest_ancestor_length(). But it turned out to be easier to use a function specialized for comparing path prefixes (i.e., one that knows about slashes and root paths) than to prepare the paths in such a way that a generic string prefix comparison function can be used. So delete string_list_longest_prefix() and its documentation and test cases. Signed-off-by: Michael Haggerty Signed-off-by: Jeff King

string_list API: document what "sorted" means

2012-09-18T18:41:06Z

The recent work on using string_list to represent the list of refs that matched with the refs on the other side during fetch heavily depends on the sort order by string_list's implementation, and changing string_list will break it. Document that it uses strcmp() order, at least for now. Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano

api-string-list.txt: initialize the string_list the easy way

2012-09-12T18:43:25Z

In the demo code blurb, show how to initialize the string_list using STRING_LIST_INIT_NODUP rather than memset(). Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano

string_list: add a function string_list_longest_prefix()

2012-09-12T18:43:25Z

Add a function that finds the longest string from a string_list that is a prefix of a given string. Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano

string_list: add a new function, string_list_remove_duplicates()

2012-09-12T18:43:25Z

Add a function that deletes duplicate entries from a sorted string_list. Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano

string_list: add a new function, filter_string_list()

2012-09-12T18:43:25Z

This function allows entries that don't match a specified criterion to be discarded from a string_list while preserving the order of the remaining entries. Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano

string_list: add two new functions for splitting strings

2012-09-12T18:43:24Z

Add two new functions, string_list_split() and string_list_split_in_place(). These split a string into a string_list on a separator character. The first makes copies of the substrings (leaving the input string untouched) and the second splits the original string in place, overwriting the separator characters with NULs and referring to the original string's memory. These functions are similar to the strbuf_split_*() functions except that they work with the more powerful string_list interface. Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano

string_list: add function string_list_append_nodup()

2012-09-12T18:43:24Z

Add a new function that appends a string to a string_list without copying it. This can be used to pass ownership of an already-copied string to a string_list that has strdup_strings set. Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano