Skip to content

config: move documentation to config.h

Heba Waly via GitGitGadget git 3 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v3 Latest1 patch 2 repliesIn review
  2. v21 patch 3 repliesSuperseded
  3. v11 patch 5 repliesSuperseded

Patches in v3 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/1config: move documentation to config.hDocumentation/technical/api-config.txt config.h+335 -3192 replies

Reviews trailers per patch

The patch has a Reviewed-by or Acked-by.

PatchEmily Shaffer
1/1R-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v3 thread

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

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

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
+

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
+ * -------------

Signature · 1 line
gitgitgadget