Skip to content

Commit 891f502

Browse files
dschomjcheetham
authored andcommitted
survey: clearly note the experimental nature in the output
While this command is definitely something we _want_, chances are that upstreaming this will require substantial changes. We still want to be able to experiment with this before that, to focus on what we need out of this command: To assist with diagnosing issues with large repositories, as well as to help monitoring the growth and the associated painpoints of such repositories. To that end, we are about to integrate this command into `microsoft/git`, to get the tool into the hands of users who need it most, with the idea to iterate in close collaboration between these users and the developers familar with Git's internals. However, we will definitely want to avoid letting anybody have the impression that this command, its exact inner workings, as well as its output format, are anywhere close to stable. To make that fact utterly clear (and thereby protect the freedom to iterate and innovate freely before upstreaming the command), let's mark its output as experimental in all-caps, as the first thing we do. Signed-off-by: Johannes Schindelin <[email protected]>
1 parent 6094506 commit 891f502

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

builtin/survey.c

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@
1818
#include "trace2.h"
1919
#include "tree.h"
2020
#include "tree-walk.h"
21+
#include "color.h"
2122

2223
static const char * const survey_usage[] = {
2324
N_("(EXPERIMENTAL!) git survey <options>"),
@@ -2265,6 +2266,10 @@ int cmd_survey(int argc, const char **argv, const char *prefix)
22652266

22662267
argc = parse_options(argc, argv, prefix, survey_options, survey_usage, 0);
22672268

2269+
color_fprintf_ln(stderr,
2270+
want_color_fd(2, GIT_COLOR_AUTO) ? GIT_COLOR_YELLOW : "",
2271+
"(THIS IS EXPERIMENTAL, EXPECT THE OUTPUT FORMAT TO CHANGE!)");
2272+
22682273
prepare_repo_settings(the_repository);
22692274

22702275
if (survey_opts.show_progress < 0)

0 commit comments

Comments
 (0)