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. Signed-off-by: Heba Waly heba.waly@xxxxxxxxx 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 -- gitgitgadget
