git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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.
Previous: John Cai via GitGitGadgetNext: Junio C Hamano
Message 5 of 16 in “fix up example code in MyFirstObjectWalk tutorial”
  1. 0/2 fix up example code in MyFirstObjectWalk tutorialJohn Cai via GitGitGadget, Oct 27, 2021
  2. 1/2 docs: fix places that break compliation in MyFirstObjectWalkJohn Cai via GitGitGadget, Oct 27, 2021
  3. Eric SunshineOct 27, 2021
  4. 2/2 docs: add headers in MyFirstObjectWalkJohn Cai via GitGitGadget, Oct 27, 2021
  5. Eric SunshineOct 27, 2021
  6. Junio C HamanoOct 27, 2021
  7. Bagas SanjayaOct 30, 2021
  8. Eric SunshineOct 30, 2021
  9. 0/2 fix up example code in MyFirstObjectWalk tutorialJohn Cai via GitGitGadget, Oct 29, 2021
  10. 1/2 docs: fix places that break compilation in MyFirstObjectWalkJohn Cai via GitGitGadget, Oct 29, 2021
  11. Eric SunshineOct 29, 2021
  12. 2/2 docs: add headers in MyFirstObjectWalkJohn Cai via GitGitGadget, Oct 29, 2021
  13. 0/2 fix up example code in MyFirstObjectWalk tutorialJohn Cai via GitGitGadget, Oct 29, 2021
  14. 1/2 docs: fix places that break compilation in MyFirstObjectWalkJohn Cai via GitGitGadget, Oct 29, 2021
  15. 2/2 docs: add headers in MyFirstObjectWalkJohn Cai via GitGitGadget, Oct 29, 2021
  16. Eric SunshineOct 29, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.