[PATCH 00/14] Tidying up references code

From: Michael Haggerty <mhagger@alum.mit.edu>

This is the next installment of the reference changes that I have been working on. This batch includes a lot of tidying up in preparation for the real changes.

The last few patches have a little bit of meat on them. They start changing the innards of refs.c to work less with strings and more with objects. This work will continue in later patches with the ultimate goal of swapping the data structure used to store cached references out from under the module--changing it from a sorted array of pointers into a hierarchical tree shaped like the reference namespace tree.

This patch series should be applied on top of "[PATCH v3] Provide API to invalidate refs cache". It has textual dependencies on that patch series, though logically I don't think that they interact.

Michael Haggerty (14):
  cache.h: add comments for git_path() and git_path_submodule()
  struct ref_list: document name member
  refs.c: rename some local "refname" variables
  refs: rename some parameters result -> sha1
  clear_ref_list(): rename from free_ref_list()
  resolve_gitlink_ref(): improve docstring
  is_refname_available(): remove the "quiet" argument
  parse_ref_line(): add docstring
  add_ref(): add docstring
  is_dup_ref(): extract function from sort_ref_list()
  refs: change signatures of get_packed_refs() and get_loose_refs()
  get_ref_dir(): change signature
  Pass a (cached_refs *) to the resolve_gitlink_*() functions
  resolve_gitlink_ref_recursive(): change to work with struct
    cached_refs

 cache.h |   15 +++
 refs.c  |  418 +++++++++++++++++++++++++++++++++-----------------------------
 refs.h  |   34 +++--
 3 files changed, 258 insertions(+), 209 deletions(-)