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

[PATCH v3 0/1] [Outreachy] config: move documentation to config.h

From
Heba Waly via GitGitGadget <gitgitgadget@gmail.com>
Date
Oct 23, 2019, 05:30 UTC
Message-ID
<pull.405.v3.git.1571808652.gitgitgadget@gmail.com>
In-Reply-To
<pull.405.v2.git.1571727906.gitgitgadget@gmail.com>

Move the documentation from Documentation/technical/api-config.txt into config.h as it's easier for the developers to find the usage information beside the code instead of looking for it in another doc file, also documentation/technical/api-config.txt is removed because the information it has is now redundant and it'll be hard to keep it up to date and synchronized with the documentation in config.h

Signed-off-by: Heba Waly heba.waly@gmail.com [heba.waly@gmail.com]
Heba Waly (1):
  config: move documentation to config.h
 Documentation/technical/api-config.txt | 319 -----------------------
 config.h                               | 335 +++++++++++++++++++++++++
 2 files changed, 335 insertions(+), 319 deletions(-)
 delete mode 100644 Documentation/technical/api-config.txt
base-commit: 108b97dc372828f0e72e56bbb40cae8e1e83ece6
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-405%2FHebaWaly%2Fconfig_documentation-v3
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-405/HebaWaly/config_documentation-v3
Pull-Request: https://github.com/gitgitgadget/git/pull/405
Range-diff vs v2:
 1:  1a9aa33b46 ! 1:  d6cbb3197a config: move documentation to config.h
     @@ -3,7 +3,12 @@
          config: move documentation to config.h
      
          Move the documentation from Documentation/technical/api-config.txt into
     -    config.h
     +    config.h as it's easier for the developers to find the usage information
     +    beside the code instead of looking for it in another doc file, also
     +    documentation/technical/api-config.txt is removed because the information
     +    it has is now redundant and it'll be hard to keep it up to date and
     +    syncronized with the documentation in config.h
     +
          Signed-off-by: Heba Waly <heba.waly@gmail.com>
      
       diff --git a/Documentation/technical/api-config.txt b/Documentation/technical/api-config.txt
     @@ -341,8 +346,7 @@
      +
      +/**
      + * The config API gives callers a way to access Git configuration files
     -+ * (and files which have the same syntax). See linkgit:git-config[1] for a
     -+ * discussion of the config file syntax.
     ++ * (and files which have the same syntax).
      + *
      + * General Usage
      + * -------------
-- 
gitgitgadget
Previous: Heba WalyNext: Heba Waly via GitGitGadget
Message 13 of 16 in “config: add documentation to config.h”
  1. 0/1 config: add documentation to config.hHeba Waly via GitGitGadget, Oct 18, 2019
  2. 1/1 config: add documentation to config.hHeba Waly via GitGitGadget, Oct 18, 2019
  3. Jonathan TanOct 18, 2019
  4. Heba WalyOct 20, 2019
  5. Emily ShafferOct 18, 2019
  6. Heba WalyOct 20, 2019
  7. Emily ShafferOct 22, 2019
  8. 0/1 [Outreachy] config: move documentation to config.hHeba Waly via GitGitGadget, Oct 22, 2019
  9. 1/1 config: move documentation to config.hHeba Waly via GitGitGadget, Oct 22, 2019
  10. Emily ShafferOct 22, 2019
  11. Junio C HamanoOct 23, 2019
  12. Heba WalyOct 23, 2019
  13. 0/1 [Outreachy] config: move documentation to config.hHeba Waly via GitGitGadget, Oct 23, 2019
  14. 1/1 config: move documentation to config.hHeba Waly via GitGitGadget, Oct 23, 2019
  15. Emily ShafferOct 23, 2019
  16. Junio C HamanoOct 24, 2019

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.