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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Stephen Boyd <bebarino@xxxxxxxxx> writes:

> Signed-off-by: Stephen Boyd <bebarino@xxxxxxxxx>
> ---
>
> 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.
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]