Move doc to header files
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v5 Latest21 patches 0 repliesNew
- v421 patches 0 repliesSuperseded
- v321 patches 6 repliesSuperseded
Earlier versions · 2
| Version | Posted | Patches | Replies | Status |
|---|---|---|---|---|
| v2 | 20 patches | 15 replies | Superseded | |
| v1 | 10 patches | 4 replies | Superseded |
Patches in v5 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/21 | diff: move doc to diff.h and diffcore.hDocumentation/ diff.h diffcore.h | +158 | 0 replies | |
| 2/21 | dir: move doc to dir.hDocumentation/ dir.c dir.h | +114 | 0 replies | |
| 3/21 | graph: move doc to graph.h and graph.cDocumentation/ graph.c graph.h | +122 | 0 replies | |
| 4/21 | merge: move doc to ll-merge.hDocumentation/ ll-merge.h | +74 | 0 replies | |
| 5/21 | sha1-array: move doc to sha1-array.hDocumentation/ sha1-array.c sha1-array.h | +81 | 0 replies | |
| 6/21 | remote: move doc to remote.h and refspec.hDocumentation/ refspec.h remote.h | +70 | 0 replies | |
| 7/21 | refs: move doc to refs.hDocumentation/ refs.h | +51 | 0 replies | |
| 8/21 | attr: move doc to attr.hDocumentation/ attr.c attr.h | +135 | 0 replies | |
| 9/21 | revision: move doc to revision.hDocumentation/ Documentation/ revision.h | +60 | 0 replies | |
| 10/21 | pathspec: move doc to pathspec.hDocumentation/ pathspec.h | +34 | 0 replies | |
| 11/21 | sigchain: move doc to sigchain.hDocumentation/ sigchain.h | +45 | 0 replies | |
| 12/21 | cache: move doc to cache.hDocumentation/ Documentation/ cache.h | +39 | 0 replies | |
| 13/21 | argv-array: move doc to argv-array.hDocumentation/ argv-array.h | +62 | 0 replies | |
| 14/21 | credential: move doc to credential.hDocumentation/ Documentation/ Documentation/ +1 more | +238 | 0 replies | |
| 15/21 | parse-options: add link to doc file in parse-options.hparse-options.h | +4 | 0 replies | |
| 16/21 | run-command: move doc to run-command.hDocumentation/ run-command.h | +245 | 0 replies | |
| 17/21 | trace: move doc to trace.hDocumentation/ trace.h | +131 | 0 replies | |
| 18/21 | tree-walk: move doc to tree-walk.hDocumentation/ tree-walk.h | +120 | 0 replies | |
| 19/21 | submodule-config: move doc to submodule-config.hDocumentation/ submodule-config.h | +37 | 0 replies | |
| 20/21 | trace2: move doc to trace2.hDocumentation/ trace2.h | +111 | 0 replies | |
| 21/21 | api-index: remove api doc index filesDocumentation/ Documentation/ Documentation/ +2 more | +3 | 0 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v5 yet.
Cover letter [PATCH v5 00/21] [Outreachy] Move doc to header files
Move the documentation from Documentation/technical/api-*.txt to the corresponding header file, 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-*.txt is removed because the information it has is will be redundant and it'll be hard to keep it up to date and synchronized with the documentation in the header files.
api-trace2.txt is not removed because it has lots of valuable information that seems more appropriate to be in a separate doc file not in the trace2.h although the functions documentation is moved to the trace2.h
api-error-handling.txt is not removed as well because no other file seemed to be more suitable for the doc it contains. I'm open to suggestions though.
The ll-merge related doc was removed from api-merge.txt to ll-merge.h, while the rest of the file is left as is.
Heba Waly (21):
diff: move doc to diff.h and diffcore.h
dir: move doc to dir.h
graph: move doc to graph.h and graph.c
merge: move doc to ll-merge.h
sha1-array: move doc to sha1-array.h
remote: move doc to remote.h and refspec.h
refs: move doc to refs.h
attr: move doc to attr.h
revision: move doc to revision.h
pathspec: move doc to pathspec.h
sigchain: move doc to sigchain.h
cache: move doc to cache.h
argv-array: move doc to argv-array.h
credential: move doc to credential.h
parse-options: add link to doc file in parse-options.h
run-command: move doc to run-command.h
trace: move doc to trace.h
tree-walk: move doc to tree-walk.h
submodule-config: move doc to submodule-config.h
trace2: move doc to trace2.h
api-index: remove api doc index files
Documentation/Makefile | 11 +- Documentation/MyFirstObjectWalk.txt | 7 +- Documentation/git-credential.txt | 3 +- Documentation/git.txt | 3 - Documentation/gitcredentials.txt | 3 +- Documentation/technical/.gitignore | 1 - .../technical/api-allocation-growing.txt | 39 --- Documentation/technical/api-argv-array.txt | 65 ----- Documentation/technical/api-credentials.txt | 271 ------------------ Documentation/technical/api-diff.txt | 174 ----------- .../technical/api-directory-listing.txt | 130 --------- Documentation/technical/api-gitattributes.txt | 154 ---------- Documentation/technical/api-history-graph.txt | 173 ----------- Documentation/technical/api-index-skel.txt | 13 - Documentation/technical/api-index.sh | 28 -- Documentation/technical/api-merge.txt | 72 +---- Documentation/technical/api-oid-array.txt | 90 ------ Documentation/technical/api-ref-iteration.txt | 78 ----- Documentation/technical/api-remote.txt | 127 -------- .../technical/api-revision-walking.txt | 72 ----- Documentation/technical/api-run-command.txt | 264 ----------------- Documentation/technical/api-setup.txt | 47 --- Documentation/technical/api-sigchain.txt | 41 --- .../technical/api-submodule-config.txt | 66 ----- Documentation/technical/api-trace.txt | 140 --------- Documentation/technical/api-trace2.txt | 243 +--------------- Documentation/technical/api-tree-walking.txt | 149 ---------- argv-array.h | 62 ++++ attr.c | 3 +- attr.h | 141 ++++++++- cache.h | 41 ++- credential.h | 236 +++++++++++++++ diff.h | 126 ++++++++ diffcore.h | 32 +++ dir.c | 2 - dir.h | 119 +++++++- graph.c | 1 + graph.h | 121 ++++++++ ll-merge.h | 73 ++++- parse-options.h | 4 + pathspec.h | 35 ++- refs.h | 51 ++++ refspec.h | 16 ++ remote.h | 57 +++- revision.h | 59 ++++ run-command.h | 252 +++++++++++++++- sha1-array.c | 2 +- sha1-array.h | 80 ++++++ sigchain.h | 45 +++ submodule-config.h | 38 ++- trace.h | 133 ++++++++- trace2.h | 124 ++++++-- tree-walk.h | 122 +++++++- 53 files changed, 1934 insertions(+), 2505 deletions(-) delete mode 100644 Documentation/technical/.gitignore delete mode 100644 Documentation/technical/api-allocation-growing.txt delete mode 100644 Documentation/technical/api-argv-array.txt delete mode 100644 Documentation/technical/api-credentials.txt delete mode 100644 Documentation/technical/api-diff.txt delete mode 100644 Documentation/technical/api-directory-listing.txt delete mode 100644 Documentation/technical/api-gitattributes.txt delete mode 100644 Documentation/technical/api-history-graph.txt delete mode 100644 Documentation/technical/api-index-skel.txt delete mode 100755 Documentation/technical/api-index.sh delete mode 100644 Documentation/technical/api-oid-array.txt delete mode 100644 Documentation/technical/api-ref-iteration.txt delete mode 100644 Documentation/technical/api-remote.txt delete mode 100644 Documentation/technical/api-revision-walking.txt delete mode 100644 Documentation/technical/api-run-command.txt delete mode 100644 Documentation/technical/api-setup.txt delete mode 100644 Documentation/technical/api-sigchain.txt delete mode 100644 Documentation/technical/api-submodule-config.txt delete mode 100644 Documentation/technical/api-trace.txt delete mode 100644 Documentation/technical/api-tree-walking.txt
base-commit: d9f6f3b6195a0ca35642561e530798ad1469bd41
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-434%2FHebaWaly%2Fmove-doc-to-header-v5
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-434/HebaWaly/move-doc-to-header-v5
Pull-Request: https://github.com/gitgitgadget/git/pull/434
Range-diff vs v4:
1: 7f2f4c45a6 = 1: 7f2f4c45a6 diff: move doc to diff.h and diffcore.h 2: f87ca0228e = 2: f87ca0228e dir: move doc to dir.h 3: 495fe333bd = 3: 495fe333bd graph: move doc to graph.h and graph.c 4: 90baf409ec = 4: 90baf409ec merge: move doc to ll-merge.h 5: a76a2e2244 = 5: a76a2e2244 sha1-array: move doc to sha1-array.h 6: 5719b8141c = 6: 5719b8141c remote: move doc to remote.h and refspec.h 7: f84c1338fa = 7: f84c1338fa refs: move doc to refs.h 8: a007b50b9b = 8: a007b50b9b attr: move doc to attr.h 9: 88553030f5 = 9: 88553030f5 revision: move doc to revision.h 10: 0042d10223 = 10: 0042d10223 pathspec: move doc to pathspec.h 11: 240a4bcb32 = 11: 240a4bcb32 sigchain: move doc to sigchain.h 12: 3e0d3f2415 = 12: 3e0d3f2415 cache: move doc to cache.h 13: 4f805c8737 = 13: 4f805c8737 argv-array: move doc to argv-array.h 14: ea78cb4ae5 = 14: ea78cb4ae5 credential: move doc to credential.h 15: 7097de91c3 < -: ---------- parse-options: move doc to parse-options.h -: ---------- > 15: 0e9e89fd83 parse-options: add link to doc file in parse-options.h 16: 03aa723fb7 = 16: 474911ff77 run-command: move doc to run-command.h 17: 44a47075dc = 17: f313d74e1e trace: move doc to trace.h 18: 5b20c2794b = 18: 9063c2fad2 tree-walk: move doc to tree-walk.h 19: 251a08c1d8 = 19: 039598b04c submodule-config: move doc to submodule-config.h 20: 1f08493281 = 20: cf3e3dd0c2 trace2: move doc to trace2.h 21: 5f21417393 = 21: 3771f7e2cb api-index: remove api doc index files
Signature · 1 line
gitgitgadget