update-microsoft-git: create barebones builtin

Just do the boilerplate stuff of making a new builtin, including
documentation and integration with git.c.

Signed-off-by: Derrick Stolee <[email protected]>

Author: derrickstolee

.gitignore

@@ -175,6 +175,7 @@
 /git-unpack-file
 /git-unpack-objects
 /git-update-index
+/git-update-microsoft-git
 /git-update-ref
 /git-update-server-info
 /git-upload-archive

Documentation/git-update-microsoft-git.adoc

@@ -0,0 +1,24 @@
+git-update-microsoft-git(1)
+===========================
+
+NAME
+----
+git-update-microsoft-git - Update the installed version of Git
+
+
+SYNOPSIS
+--------
+[verse]
+'git update-microsoft-git'
+
+DESCRIPTION
+-----------
+This version of Git is based on the Microsoft fork of Git, which
+has custom capabilities focused on supporting monorepos. This
+command checks for the latest release of that fork and installs
+it on your machine.
+
+
+GIT
+---
+Part of the linkgit:git[1] suite

Documentation/lint-manpages.sh

@@ -28,6 +28,7 @@ check_missing_docs () (
 		git-remote-*) continue;;
 		git-stage) continue;;
 		git-gvfs-helper) continue;;
+		git-update-microsoft-git) continue;;
 		git-legacy-*) continue;;
 		git-?*--?* ) continue ;;
 		esac

Documentation/meson.build

@@ -149,6 +149,7 @@ manpages = {
   'git-unpack-file.adoc' : 1,
   'git-unpack-objects.adoc' : 1,
   'git-update-index.adoc' : 1,
+  'git-update-microsoft-git.adoc' : 1,
   'git-update-ref.adoc' : 1,
   'git-update-server-info.adoc' : 1,
   'git-upload-archive.adoc' : 1,

Makefile

@@ -1338,6 +1338,7 @@ BUILTIN_OBJS += builtin/tag.o
 BUILTIN_OBJS += builtin/unpack-file.o
 BUILTIN_OBJS += builtin/unpack-objects.o
 BUILTIN_OBJS += builtin/update-index.o
+BUILTIN_OBJS += builtin/update-microsoft-git.o
 BUILTIN_OBJS += builtin/update-ref.o
 BUILTIN_OBJS += builtin/update-server-info.o
 BUILTIN_OBJS += builtin/upload-archive.o

builtin.h

@@ -240,6 +240,7 @@ int cmd_tag(int argc, const char **argv, const char *prefix, struct repository *
 int cmd_unpack_file(int argc, const char **argv, const char *prefix, struct repository *repo);
 int cmd_unpack_objects(int argc, const char **argv, const char *prefix, struct repository *repo);
 int cmd_update_index(int argc, const char **argv, const char *prefix, struct repository *repo);
+int cmd_update_microsoft_git(int argc, const char **argv, const char *prefix, struct repository *repo);
 int cmd_update_ref(int argc, const char **argv, const char *prefix, struct repository *repo);
 int cmd_update_server_info(int argc, const char **argv, const char *prefix, struct repository *repo);
 int cmd_upload_archive(int argc, const char **argv, const char *prefix, struct repository *repo);

builtin/update-microsoft-git.c

@@ -0,0 +1,27 @@
+#include "builtin.h"
+#include "repository.h"
+#include "parse-options.h"
+#include "run-command.h"
+
+static int platform_specific_upgrade(void)
+{
+	return 1;
+}
+
+static const char * const update_microsoft_git_usage[] = {
+	N_("git update-microsoft-git"),
+	NULL,
+};
+
+
+int cmd_update_microsoft_git(int argc, const char **argv, const char *prefix UNUSED, struct repository *repo UNUSED)
+{
+	static struct option microsoft_git_options[] = {
+		OPT_END(),
+	};
+	show_usage_with_options_if_asked(argc, argv,
+					 update_microsoft_git_usage,
+					 microsoft_git_options);
+
+	return platform_specific_upgrade();
+}

git.c

@@ -711,6 +711,7 @@ static struct cmd_struct commands[] = {
 	{ "unpack-file", cmd_unpack_file, RUN_SETUP | NO_PARSEOPT },
 	{ "unpack-objects", cmd_unpack_objects, RUN_SETUP | NO_PARSEOPT },
 	{ "update-index", cmd_update_index, RUN_SETUP },
+	{ "update-microsoft-git", cmd_update_microsoft_git },
 	{ "update-ref", cmd_update_ref, RUN_SETUP },
 	{ "update-server-info", cmd_update_server_info, RUN_SETUP },
 	{ "upload-archive", cmd_upload_archive, NO_PARSEOPT },

meson.build

@@ -671,6 +671,7 @@ builtin_sources = [
   'builtin/unpack-file.c',
   'builtin/unpack-objects.c',
   'builtin/update-index.c',
+  'builtin/update-microsoft-git.c',
   'builtin/update-ref.c',
   'builtin/update-server-info.c',
   'builtin/upload-archive.c',