{"thread":{"id":"19531","subject":"[PATCH 1/7] Add specification of git-vcs-* helper programs","startedAt":"2009-05-27T18:15:29Z","lastAt":"2009-05-27T18:15:29Z","messageCount":1,"participants":["Daniel Barkalow"],"isPatch":true,"patchVersion":1,"patchTotal":7},"messages":[{"id":"114818","messageId":"alpine.LNX.2.00.0905271403570.2147@iabervon.org","threadId":"19531","inReplyTo":null,"subject":"[PATCH 1/7] Add specification of git-vcs-* helper programs","fromName":"Daniel Barkalow","fromEmail":"barkalow@iabervon.org","sentAt":"2009-05-27T18:15:29Z","receivedAt":"2009-05-27T18:15:29Z","isPatch":true,"sender":{"key":"barkalow@iabervon.org","avatar":"https://avatars.githubusercontent.com/u/55364219?v=4"},"body":"Signed-off-by: Daniel Barkalow <barkalow@iabervon.org>\n---\n Documentation/git-vcs.txt |   77 +++++++++++++++++++++++++++++++++++++++++++++\n 1 files changed, 77 insertions(+), 0 deletions(-)\n create mode 100644 Documentation/git-vcs.txt\n\ndiff --git a/Documentation/git-vcs.txt b/Documentation/git-vcs.txt\nnew file mode 100644\nindex 0000000..402c927\n--- /dev/null\n+++ b/Documentation/git-vcs.txt\n@@ -0,0 +1,77 @@\n+git-vcs(1)\n+============\n+\n+NAME\n+----\n+git-vcs - Helper programs for interoperation with foreign systems\n+\n+SYNOPSIS\n+--------\n+'git vcs-<system>' <remote>\n+\n+DESCRIPTION\n+-----------\n+\n+These programs are normally not used directly by end users, but are\n+invoked by various git programs that interact with remote repositories\n+when the repository they would operate on uses a foreign system.\n+\n+Each 'git vcs-<system>' is a helper for interoperating with a\n+particular version control system. Different helpers have different\n+capabilities (limited both by the particular helper and by the\n+capabilities of the system they connect to), and they report what\n+capabilities they support.\n+\n+These programs can store refs in refs/<system>/*, and arbitrary\n+information in info/<system>.\n+\n+COMMANDS\n+--------\n+\n+Commands are given by the caller on the helper's standard input, one per line.\n+\n+'capabilities'::\n+\tOutputs a single line with a list of feature names separated\n+\tby spaces. Each of these indicates a supported feature of the\n+\thelper, and the caller will only attempt operations that are\n+\tsupported.\n+\n+'list'::\n+\tOutputs the names of refs, one per line. These may be\n+\tfollowed, after a single space, by \"changed\" or \"unchanged\",\n+\tindicating whether the foreign repository has changed from the\n+\tstate in the ref. If the helper doesn't know, it doesn't have\n+\tto provide a value. (In particular, it shouldn't do expensive\n+\toperations, such as importing the content, to see whether it\n+\tmatches.) Other information, not yet supported, may be output\n+\tas well, separated by single spaces.\n+\n+'import' ref::\n+\tImports the given ref by outputting it in git-fast-import\n+\tformat.\n+\n+'export' commit ref::\n+\tSends the given commit to the foreign system, with the\n+\tlocation given by ref, and reimports it by outputting it in\n+\tgit-fast-import format as the foreign system rendered it.\n++\n+All parents of commit must either have been created with 'import' or\n+have been passed to 'export' previously. Depending on the features,\n+there may be other restrictions on what may be exported.\n+\n+FEATURES\n+--------\n+\n+'export'::\n+\tHelper supports exporting commits, at least exporting\n+\tnon-merge commits whose parents are not the parents of any\n+\tother commit exported to the same branch or make in the other\n+\tsystem on the same branch.\n+\n+'export-branch'::\n+\tHelper supports creating new branches by exporting commits to\n+\tthem.\n+\n+'export-merges'::\n+\tHelper supports exporting two-parent merges, where both\n+\tparents have already been exported successfully.\n-- \n1.6.0.6\n"}]}