Thread (2 messages) flat view 2 messages, 2 authors, 2016-06-15

Re: [PATCH] technical-docs: document tree-walking API

From: Junio C Hamano <hidden>
Date: 2016-06-15 22:47:08

Stephen Boyd [off-list ref] writes:
Signed-off-by: Stephen Boyd <redacted>
---

This is a minor update incorporating feedback from Junio. Plus, I decided to
add an authors section.
I think the primary author is Linus for this API, but once you finished
the documentation, I do not think "authors" section is particularly
needed (git knows who the code came from reasonably well anyway).  The
names of people in these stub documents were there for people like you;
see 530e741 (Start preparing the API documents., 2007-11-24).

It might be a bit misleading to say that the path member of struct
name_entry is a "pathname".  It is _one_ path component, and by stringing
multiple struct traverse_info's (each of which has one struct name_entry)
together with their prev pointer, make_traverse_path() can reconstruct the
full pathname from the toplevel down to the level you have traversed into.
We may want to say "path component" to clarify the distinction.

But these are minor points.  I'll apply the patch as-is.

Thanks.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help