META: Bump to v1.3.0

shoppepm · Oct 27, 2019 · 7efce59 · 7efce59
2 parents 8c2dd23 + c045c7e
commit 7efce59
Show file tree

Hide file tree

Showing 6 changed files with 204 additions and 75 deletions.
diff --git a/docs/frontend-support.md b/docs/frontend-support.md
@@ -1,10 +1,10 @@
 # Package manager support
 
-| Package manager                  | Install | Remove | Update | Upgrade | Query | List all | \-\-noconfirm switch |
-| ---                              | ---     | ---    | ---    | ---     | ---   | ---      | ---                  |
-| apt/apt-get/pkg (Debian-based)   | [X]     | [X]    | [X]    | [X]     | [x]   | [x]      | [x]                  |
-| yum/dnf (Fedora, CentOS, RedHat) | [X]     | [X]    | [X]    | [X]     | [x]   | [x]      | [x]                  |
-| pacman (Arch Linux)              | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [x]                  |
-| zypper (openSUSE and related)    | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [x]                  |
-| apk (Alpine Linux, postmarketOS) | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [ ]                  |
-| eopkg (Solus)                    | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [ ]                  |
+| Package manager                  | commonpm | Install | Remove | Update | Upgrade | Query | List all | \-\-noconfirm switch |
+| ---                              | ---      | ---     | ---    | ---    | ---     | ---   | ---      | ---                  |
+| apt/apt-get/pkg (Debian-based)   | apt      | [X]     | [X]    | [X]    | [X]     | [x]   | [x]      | [x]                  |
+| yum/dnf (Fedora, CentOS, RedHat) | dnf      | [X]     | [X]    | [X]    | [X]     | [x]   | [x]      | [x]                  |
+| pacman/yay/pacaur (Arch Linux)   | pacman   | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [x]                  |
+| zypper (openSUSE and related)    | zypper   | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [x]                  |
+| apk (Alpine Linux, postmarketOS) | apk      | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [ ]                  |
+| eopkg (Solus)                    | eopkg    | [X]     | [X]    | [X]    | [X]     | [X]   | [X]      | [ ]                  |
diff --git a/docs/package-groups.md b/docs/package-groups.md
@@ -0,0 +1,21 @@
+# Package groups
+
+Package groups allow for multiple packages to be installed in one small command quickly.
+
+## Creating a package group
+
+Creating a package group is simmilar to adding a package (see (Packages)[packages.md]).
+
+Package groups use shoppepkg files, just like regular packages. However, package groups
+only have the following variables:
+
+- pkgname
+- pkgdesc
+- pkgrel
+- pkgver
+- **group**
+- **optgroup**
+
+The group variable contains the packages in the group, separated by spaces.
+
+The optgroup variable contains the optional packages in the group. You can store optional dependency descriptions in the ``optdeps`` file, just like in regular packages. This process is described in the regular package documentation ((Packages)[packages.md]).
diff --git a/docs/packages.md b/docs/packages.md
@@ -74,3 +74,7 @@ shoppepkg_build() {
 
 # You can also specify post- and pre-install hooks, by creating the shoppepkg_preinstall and shoppepkg_postinstall functions.
 ```
+
+## Package groups
+
+See: (Package groups)[package-groups.md].
diff --git a/docs/pkg-alternative-lists.md b/docs/pkg-alternative-lists.md
@@ -0,0 +1,19 @@
+# Package alternative lists
+
+Package alternative lists are files that contain alternative names for certain packages.
+
+When a package is named differently in one distro, and differently in another, a package alternative list that is specific to each package manager can solve this issue.
+
+## Creating a package alternative list
+
+Package manager specific lists use the commonpm variable (see [[Package manager support]](frontend-support.md)) as their name, for example the alternative list for apt will be called ``apt.altlist``.
+
+The list follows the following format:
+
+```
+pkgname pkgalt
+```
+
+where each package alternative is separated by a newline.
+
+You can also place your own custom alternative rules in the ``custom.altlist`` file.