apx: update page; apx-{pkgmanagers,stacks,subsystems}: add page (#10665)

* apx: update page; apx-{pkgmanagers,stacks,subsystems}: update page

* Apply suggestions from code review

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

* apx-stacks: update export description

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

---------

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

pages/linux/apx-pkgmanagers.md

@@ -0,0 +1,21 @@
+# apx pkgmanagers
+
+> Manage package managers in `apx`.
+> Note: user-created package manager configurations are stored in `~/.local/share/apx/pkgmanagers`.
+> More information: <https://github.com/Vanilla-OS/apx>.
+
+- Interactively create a new package manager configuration:
+
+`apx pkgmanagers create`
+
+- List all available package manager confirgurations:
+
+`apx pkgmanagers list`
+
+- Remove a package manager configuration:
+
+`apx pkgmanagers rm --name {{string}}`
+
+- Display information about a specific package manager:
+
+`apx pkgmanagers show {{name}}`

pages/linux/apx-stacks.md

@@ -0,0 +1,29 @@
+# apx stacks
+
+> Manage stacks in `apx`.
+> Note: user-created stack configurations are stored in `~/.local/share/apx/stacks`.
+> More information: <https://github.com/Vanilla-OS/apx>.
+
+- Interactively create a new stack configuration:
+
+`apx stacks new`
+
+- Interactively update a stack configuration:
+
+`apx stacks update {{name}}`
+
+- List all available stack configurations:
+
+`apx stacks list`
+
+- Remove a specified stack configuration:
+
+`apx stacks rm --name {{string}}`
+
+- Import a stack configuration:
+
+`apx stacks import --input {{path/to/stack.yml}}`
+
+- Export the stack configuration (Note: the output flag is optional, it is exported to the current working directory by default):
+
+`apx stacks export --name {{string}} --output {{path/to/output_file}}`

pages/linux/apx-subsystems.md

@@ -0,0 +1,29 @@
+# apx subsystems
+
+> Manage subsystems in `apx`.
+> Subsystems are containers that can be created based on pre-existing stacks.
+> More information: <https://github.com/Vanilla-OS/apx>.
+
+- Interactively create a new subsystem:
+
+`apx subsystems new`
+
+- List all available subsystems:
+
+`apx subsystems list`
+
+- Reset a specific subsystem to its initial state:
+
+`apx subsystems reset --name {{string}}`
+
+- [f]orce reset a specific subsystem:
+
+`apx subsystems reset --name {{string}} --force`
+
+- Remove a specific subsystem:
+
+`apx subsystems rm --name {{string}}`
+
+- [f]orce remove a specific subsystem:
+
+`apx subsystems rm --name {{string}} --force`

pages/linux/apx.md

@@ -1,37 +1,16 @@
 # apx
 
-> Package management utility.
-> Install packages inside managed containers from multiple sources (`apx` supports --aur,--dnf, --apk flags in all commands).
+> Package management utility with support for multiple sources, allowing you to install packages in subsystems.
 > More information: <https://github.com/Vanilla-OS/apx>.
 
-- Initialize or reinitialize a specific container:
+- View documentation for managing package managers:
 
-`apx init`
+`tldr apx pkgmanagers`
 
-- Install specific packages in the container:
+- View documentation for managing stacks:
 
-`apx install {{package1 package2 ...}}`
+`tldr apx stacks`
 
-- Install a DEB/RPM package inside the container (Use `--dnf` flag for installing RPMs):
+- View documentation for managing subsystems:
 
-`apx install --sideload {{path/to/package}}`
-
-- Remove specific packages from the container:
-
-`apx remove {{package1 package2 ...}}`
-
-- Search for specific packages:
-
-`apx search {{package1 package2 ...}}`
-
-- Enter the managed container shell to execute commands (type `exit` to exit the container):
-
-`apx enter`
-
-- Update the list of available packages in the container:
-
-`apx update`
-
-- Upgrade all installed packages in the container to their newest available version:
-
-`apx upgrade`
+`tldr apx subsystems`