diff options
authorNguyễn Thái Ngọc Duy <>2018-03-23 15:55:23 (GMT)
committerJunio C Hamano <>2018-03-23 18:04:52 (GMT)
commit00a3da2a131a3e122df7e053d992fbc1735bf4f9 (patch)
parent2bee50a083fbf549c3f062a2f89c6e636f532762 (diff)
repository.h: add comment and clarify repo_set_gitdir
The argument name "optional" may mislead the reader to think this option could be NULL. But it can't be. While at there, document a bit more about struct set_gitdir_args. Signed-off-by: Nguyễn Thái Ngọc Duy <> Signed-off-by: Junio C Hamano <>
1 files changed, 5 insertions, 1 deletions
diff --git a/repository.h b/repository.h
index e7127ba..f21fd93 100644
--- a/repository.h
+++ b/repository.h
@@ -82,6 +82,10 @@ struct repository {
extern struct repository *the_repository;
+ * Define a custom repository layout. Any field can be NULL, which
+ * will default back to the path according to the default layout.
+ */
struct set_gitdir_args {
const char *commondir;
const char *object_dir;
@@ -92,7 +96,7 @@ struct set_gitdir_args {
extern void repo_set_gitdir(struct repository *repo,
const char *root,
- const struct set_gitdir_args *optional);
+ const struct set_gitdir_args *extra_args);
extern void repo_set_worktree(struct repository *repo, const char *path);
extern void repo_set_hash_algo(struct repository *repo, int algo);
extern void initialize_the_repository(void);