Subject: [PATCH v5 11/11] repo: refine path keys for repo info

From: "Eslam reda ragheb via GitGitGadget" <[email-masked]>
Date: Fri, 27 Feb 2026 19:30:40 +0000

From: Eslam reda ragheb <[email-masked]>

Rename path.git-prefix to path.prefix, add path.work-tree as an alias
for path.toplevel, and drop reflog/ref-file-oriented path keys.

This narrows the path surface to keys that are less tied to direct
file access while keeping tests and documentation in sync.

Also normalize prefix handling in repo_info context so path.prefix has
a stable empty-string behavior.

Signed-off-by: Eslam reda ragheb <[email-masked]>
---
 Documentation/git-repo.adoc | 14 ++++-------
 builtin/repo.c              | 45 ++++++++--------------------------
 t/t1900-repo.sh             | 48 +++++++++++++++++--------------------
 3 files changed, 36 insertions(+), 71 deletions(-)

diff --git a/Documentation/git-repo.adoc b/Documentation/git-repo.adoc
index b575977a4b..3d34c6edca 100644
--- a/Documentation/git-repo.adoc
+++ b/Documentation/git-repo.adoc
@@ -114,7 +114,7 @@ Here's a list of the available keys and the values that they return:
 `path.git-dir`::
 	The path to the git directory.
 
-`path.git-prefix`::
+`path.prefix`::
 	The path of the current working directory relative to the top-level
 	directory.
 
@@ -127,18 +127,9 @@ Here's a list of the available keys and the values that they return:
 `path.index-file`::
 	The path to the index file.
 
-`path.logs-directory`::
-	The path to the `logs` directory.
-
 `path.objects-directory`::
 	The path to the objects directory.
 
-`path.packed-refs-file`::
-	The path to the `packed-refs` file.
-
-`path.refs-directory`::
-	The path to the `refs` directory.
-
 `path.shallow-file`::
 	The path to the `shallow` file.
 
@@ -150,6 +141,9 @@ Here's a list of the available keys and the values that they return:
 	The path to the top-level working tree directory, or an empty string
 	for bare repositories.
 
+`path.work-tree`::
+	Alias for `path.toplevel`.
+
 `references.format`::
 	The reference storage format. The valid values are:
 +
diff --git a/builtin/repo.c b/builtin/repo.c
index ecd9d3aee5..9fbd13a358 100644
--- a/builtin/repo.c
+++ b/builtin/repo.c
@@ -109,10 +109,9 @@ static int get_path_git_dir(struct repo_info *info, struct strbuf *buf)
 	return 0;
 }
 
-static int get_path_git_prefix(struct repo_info *info, struct strbuf *buf)
+static int get_path_prefix(struct repo_info *info, struct strbuf *buf)
 {
-	if (info->prefix)
-		strbuf_addstr(buf, info->prefix);
+	strbuf_addstr(buf, info->prefix);
 	return 0;
 }
 
@@ -137,39 +136,12 @@ static int get_path_index_file(struct repo_info *info, struct strbuf *buf)
 	return 0;
 }
 
-static int get_path_logs_directory(struct repo_info *info, struct strbuf *buf)
-{
-	struct strbuf path = STRBUF_INIT;
-
-	repo_info_add_path(info, buf, repo_git_path_replace(info->repo, &path, "logs"));
-	strbuf_release(&path);
-	return 0;
-}
-
 static int get_path_objects_directory(struct repo_info *info, struct strbuf *buf)
 {
 	repo_info_add_path(info, buf, repo_get_object_directory(info->repo));
 	return 0;
 }
 
-static int get_path_packed_refs_file(struct repo_info *info, struct strbuf *buf)
-{
-	struct strbuf path = STRBUF_INIT;
-
-	repo_info_add_path(info, buf, repo_git_path_replace(info->repo, &path, "packed-refs"));
-	strbuf_release(&path);
-	return 0;
-}
-
-static int get_path_refs_directory(struct repo_info *info, struct strbuf *buf)
-{
-	struct strbuf path = STRBUF_INIT;
-
-	repo_info_add_path(info, buf, repo_git_path_replace(info->repo, &path, "refs"));
-	strbuf_release(&path);
-	return 0;
-}
-
 static int get_path_shallow_file(struct repo_info *info, struct strbuf *buf)
 {
 	struct strbuf path = STRBUF_INIT;
@@ -201,6 +173,11 @@ static int get_path_toplevel(struct repo_info *info, struct strbuf *buf)
 	return 0;
 }
 
+static int get_path_work_tree(struct repo_info *info, struct strbuf *buf)
+{
+	return get_path_toplevel(info, buf);
+}
+
 static int get_references_format(struct repo_info *info, struct strbuf *buf)
 {
 	struct repository *repo = info->repo;
@@ -217,17 +194,15 @@ static const struct field repo_info_fields[] = {
 	{ "path.common-dir", get_path_common_dir },
 	{ "path.config-file", get_path_config_file },
 	{ "path.git-dir", get_path_git_dir },
-	{ "path.git-prefix", get_path_git_prefix },
 	{ "path.grafts-file", get_path_grafts_file },
 	{ "path.hooks-directory", get_path_hooks_directory },
 	{ "path.index-file", get_path_index_file },
-	{ "path.logs-directory", get_path_logs_directory },
 	{ "path.objects-directory", get_path_objects_directory },
-	{ "path.packed-refs-file", get_path_packed_refs_file },
-	{ "path.refs-directory", get_path_refs_directory },
+	{ "path.prefix", get_path_prefix },
 	{ "path.shallow-file", get_path_shallow_file },
 	{ "path.superproject-working-tree", get_path_superproject_working_tree },
 	{ "path.toplevel", get_path_toplevel },
+	{ "path.work-tree", get_path_work_tree },
 	{ "references.format", get_references_format },
 };
 
@@ -378,7 +353,7 @@ static int cmd_repo_info(int argc, const char **argv, const char *prefix,
 	enum output_format format = FORMAT_KEYVALUE;
 	struct repo_info info = {
 		.repo = repo,
-		.prefix = prefix,
+		.prefix = prefix ? prefix : "",
 		.path_format = PATH_FORMAT_ABSOLUTE,
 	};
 	int all_keys = 0;
diff --git a/t/t1900-repo.sh b/t/t1900-repo.sh
index dcacf84cc3..2351b772b2 100755
--- a/t/t1900-repo.sh
+++ b/t/t1900-repo.sh
@@ -13,17 +13,15 @@ REPO_INFO_KEYS='
 	path.common-dir
 	path.config-file
 	path.git-dir
-	path.git-prefix
 	path.grafts-file
 	path.hooks-directory
 	path.index-file
-	path.logs-directory
 	path.objects-directory
-	path.packed-refs-file
-	path.refs-directory
+	path.prefix
 	path.shallow-file
 	path.superproject-working-tree
 	path.toplevel
+	path.work-tree
 	references.format
 '
 
@@ -31,17 +29,15 @@ REPO_INFO_PATH_KEYS='
 	path.common-dir
 	path.config-file
 	path.git-dir
-	path.git-prefix
 	path.grafts-file
 	path.hooks-directory
 	path.index-file
-	path.logs-directory
 	path.objects-directory
-	path.packed-refs-file
-	path.refs-directory
+	path.prefix
 	path.shallow-file
 	path.superproject-working-tree
 	path.toplevel
+	path.work-tree
 '
 
 # Test whether a key-value pair is correctly returned
@@ -172,12 +168,12 @@ test_expect_success 'path.toplevel is empty in bare repository' '
 	test_cmp expect actual
 '
 
-test_expect_success 'path.git-prefix matches rev-parse --show-prefix' '
+test_expect_success 'path.prefix matches rev-parse --show-prefix' '
 	git init path-prefix &&
 	mkdir -p path-prefix/a/b &&
 	expected_value=$(git -C path-prefix/a/b rev-parse --show-prefix) &&
-	echo "path.git-prefix=$expected_value" >expect &&
-	git -C path-prefix/a/b repo info path.git-prefix >actual &&
+	echo "path.prefix=$expected_value" >expect &&
+	git -C path-prefix/a/b repo info path.prefix >actual &&
 	test_cmp expect actual
 '
 
@@ -209,27 +205,27 @@ test_expect_success 'git-path style keys match rev-parse --git-path' '
 	git -C path-git-path repo info path.config-file >actual &&
 	test_cmp expect actual &&
 
-	expected_value=$(git -C path-git-path rev-parse --path-format=absolute --git-path logs) &&
-	echo "path.logs-directory=$expected_value" >expect &&
-	git -C path-git-path repo info path.logs-directory >actual &&
-	test_cmp expect actual &&
-
-	expected_value=$(git -C path-git-path rev-parse --path-format=absolute --git-path packed-refs) &&
-	echo "path.packed-refs-file=$expected_value" >expect &&
-	git -C path-git-path repo info path.packed-refs-file >actual &&
-	test_cmp expect actual &&
-
-	expected_value=$(git -C path-git-path rev-parse --path-format=absolute --git-path refs) &&
-	echo "path.refs-directory=$expected_value" >expect &&
-	git -C path-git-path repo info path.refs-directory >actual &&
-	test_cmp expect actual &&
-
 	expected_value=$(git -C path-git-path rev-parse --path-format=absolute --git-path shallow) &&
 	echo "path.shallow-file=$expected_value" >expect &&
 	git -C path-git-path repo info path.shallow-file >actual &&
 	test_cmp expect actual
 '
 
+test_expect_success 'path.work-tree matches path.toplevel' '
+	git init path-work-tree &&
+	expected_value=$(git -C path-work-tree rev-parse --show-toplevel) &&
+	echo "path.work-tree=$expected_value" >expect &&
+	git -C path-work-tree repo info path.work-tree >actual &&
+	test_cmp expect actual
+'
+
+test_expect_success 'path.work-tree is empty in bare repository' '
+	git init --bare bare-path-work-tree &&
+	echo "path.work-tree=" >expect &&
+	git -C bare-path-work-tree repo info path.work-tree >actual &&
+	test_cmp expect actual
+'
+
 test_expect_success 'path.superproject-working-tree is empty when not a submodule' '
 	git init path-superproject &&
 	echo "path.superproject-working-tree=" >expect &&
-- 
gitgitgadget