diff options
author | Luke Shumaker <LukeShu@sbcglobal.net> | 2013-05-21 08:38:58 -0400 |
---|---|---|
committer | Luke Shumaker <LukeShu@sbcglobal.net> | 2013-05-21 08:38:58 -0400 |
commit | fbdce812a178b23210b5b7d7560fcf14cd9b11ff (patch) | |
tree | ec8d37ff186d9b22ba8c75642aeb0fded9cd81fb /docs/format-pbs.md | |
parent | 1b1abf00833cd4796c98dc410978d042eaf8d001 (diff) |
add docs/
Diffstat (limited to 'docs/format-pbs.md')
-rw-r--r-- | docs/format-pbs.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/format-pbs.md b/docs/format-pbs.md new file mode 100644 index 0000000..4d75f7c --- /dev/null +++ b/docs/format-pbs.md @@ -0,0 +1,41 @@ +# Format: PBS (Parabola Build System) + +## The skinny + + * git-based (heavily) + * Designed to have the UX of abstree/abslibre, but the capabilities + of ABS + +## Details + +PBS is designed to look like ABS-tree, that is, a directory tree with +directories of the format: + + /<repo>/<pkgbase> + +In addition to this, there is a `/.pbs-root` file to identify the root +directory of the PBS repository. + +There are several branches; `master` is where development happens, and +there is a branch with the name of each architecture, which (should) +reflect what is currently available from the pacman repositories. + +Where this really differs from ABS-tree is that each `<pkgbase>` +directory is actually a git submodule. Despite being submodules, they +live in the same git repository; the default remote for them is the +git repository that they are submodules of. That is, in +`.gitmodules`, the `url = ./` for each submodule. + +Each package submodule there exists a file `.pbs-package` to identify +that directory as the root of a package. + +In a package submodule there may be a `pbstrack` file with the format + + <git-remote-repository> packages/<pkgbase> + +(or equivalently) + + <git-remote-repository> <git-remote-branch> + +that identifies a package that it is downstream/forked from, and can +be used to get updates. |