summaryrefslogtreecommitdiff
path: root/docs/format-absgit.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/format-absgit.md')
-rw-r--r--docs/format-absgit.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/format-absgit.md b/docs/format-absgit.md
new file mode 100644
index 0000000..f8cb02a
--- /dev/null
+++ b/docs/format-absgit.md
@@ -0,0 +1,25 @@
+# Format: ABSgit (ABS on git)
+
+## The skinny
+
+ * git-based
+ * Generated by running ABS through `svn2git`
+ * Canonically hosted at
+ git://projects.archlinux.org/svntogit/packages.git
+
+## Details
+
+ABSgit can be treated like ABS, but with git instead of SVN, if you
+only look at the `master` branch, which I will remind you is
+
+ * `/<pkgbase>/trunk/`
+ The "working copy" of `<pkgbase>`.
+ * `/<pkgbase>/repos/<repo>-<arch>/`
+ The version of <pkgbase> that is currently available on the
+ repository `<repo>` (eg, `core`, `extra`) for `<arch>`
+ architecture.
+
+However, it gives us a bunch of "convenience" branches. Each
+`<pkgbase>` directory is available by itself as the branch
+`packages/<pkgbase>`. HOWEVER, there may not be a separate branch for
+a directory if that directory is not present in `HEAD`.