Re: [PATCH 2/2] docs: add headers in MyFirstObjectWalk
- From
Eric Sunshine <sunshine@sunshineco.com>
- Date
- Oct 27, 2021, 17:09 UTC
- Message-ID
- <CAPig+cQxfJkV70sP8Ai3EQUrh3Y04WjkhjpG1zup7_gfg90jbg@mail.gmail.com>
- In-Reply-To
- <33cd9b2e8a675bf79132d312da8b7d8f4a2b84a3.1635343531.git.gitgitgadget@gmail.com>
On Wed, Oct 27, 2021 at 10:05 AM John Cai via GitGitGadget <gitgitgadget@gmail.com> wrote:
Show 12 quoted lines
> In several places, headers need to be included or else the code won't > compile. Since this is the first object walk, it would be nice to > include them in the tutorial to make it easier to follow. > > Signed-off-by: John Cai <johncai86@gmail.com> > --- > diff --git a/Documentation/MyFirstObjectWalk.txt b/Documentation/MyFirstObjectWalk.txt > @@ -57,9 +57,14 @@ command). So we will send our debug output to `trace_printf()` instead. When > Add usage text and `-h` handling, like all subcommands should consistently do > -(our test suite will notice and complain if you fail to do so). > +(our test suite will notice and complain if you fail to do so). We'll need to include > +the "parse-options.h" header.
Makes sense, but we should probably typeset these consistently with backticks rather than double quotes...
> @@ -195,9 +200,13 @@ Similarly to the default values, we don't have anything to do here yet > -Add a new function to `builtin/walken.c`: > +Add a new function to `builtin/walken.c`. We'll also need to include the "config.h" header:
... just as `builtin/walken.c` is typeset with backticks (as are other pathnames in this document).
> @@ -229,8 +238,14 @@ typically done by calling `repo_init_revisions()` with the repository you intend > -Add the `struct rev_info` and the `repo_init_revisions()` call: > +Add the `struct rev_info` and the `repo_init_revisions()` call. We'll also need to include > +the "revision.h" header:
And so on through the remainder of the patch.
Thanks.