Walker?

https://www.pygit2.org/commit_log.html describes a Walker object, but does not explain how to get one or how to use it. Are we to infer that the the iterator produced by the call to Repository.walk() immediately above is an object of type Walker? When I debug that seems to be the case.

For example, if heads is a list of heads and w a Walker, will

for h in heads:
    w.push(h)
    for cmt in w:
        do_stuff(cmt)

call do_stuff exactly once (i.e., the walker remembers and ignores commits already visited on later calls) for each commit in my repository that is reachable from any head?

Start with the commit_log documentation at https://www.pygit2.org/commit_log.html and the description of Repository.walk(). Clarify how a Walker is obtained and used, including whether iteration retains visited commits across repeated push calls. Done means the page answers the example's behavior without requiring readers to infer it.