Miroirs/slpkg
1
0
Fork 0
mirror of https://gitlab.com/dslackw/slpkg.git synced 2024-11-17 07:48:18 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated examples doc

Browse source
This commit is contained in:
Dimitris Zlatanidis 2022-05-24 16:48:35 +03:00
parent dad71c41ae
commit 7598b1fe9f
1 changed files with 0 additions and 87 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

87
EXAMPLES.md
View file

@ -1,92 +1,5 @@
# Slpkg
##### Usage
Before you start to use slpkg need to run '`slpkg update`' to synchronize the lists of packages,
also every time you add a new repository.
To add or remove repositories you have to edit the file '`/etc/slpkg/repositories.conf`'
or run '`slpkg repo-enable`' (python3-pythondialog required).
Add custom repositories with the command '`slpkg add-repo <repository name> <URL>`' and
after run '`slpkg update`' to update package list.
View list of repositories with the command `slpkg repo-list` or get repository information
with the command '`slpkg repo-info <repository>`'.
Update slpkg itself simply run '`slpkg update slpkg`', and slpkg check from GitLab repository if the
new version is available.
Checking packages health with the command '`slpkg health`' and slpkg check if the files missing
from the package file list.
View the dependencies status with the command '`slpkg deps-status`' or draw image map dependencies
with the additional option '`--graph=[image]`'.
Manage '`.new`' configuration files with the command '`slpkg new-config`', like remove, overwrite,
merge etc.
If you have already downloaded the script and the source code you can build the package with the
command '`slpkg -a <sbo_script.tar.gz> <sources>`'.
Manage the packages in the blacklist with the command '`slpkg -b <packages> --add or --remove`'.
Add the SBo packages to the queue with the command '`slpkg -q <packages> --add or --remove`' and
manage as build, install or build and install with the command '`slpkg build or install or
build-install`'. This is very useful if you want to install multiple packages together, suffice to
add in the right order if there are dependent packages.
View list of the packages from specific repository with command '`slpkg -l <repository>`'.
Combine with the command '`grep`' to catch the results you want.
Check and upgrade your distribution or upgrade your packages with the command '`slpkg -c <repository>
--upgrade`'. Don't forget to update the packages lists before (for the '`slack`' repository it's not
necessary). This command except upgrade the packages will fix the packages with the broken
dependencies. Switch off the automatic resolve dependencies with the additional option '`--resolve-off`'.
Use '`--checklist`' option to help you to choose easy the packages. For advanced users, the
option '`--skip`' give them more power (see manpage).
The most famous command is '`slpkg -s <repository> <packages>`', this command downloads, build and
installs packages and resolve all the dependencies or switch off resolve with the option
'`--resolve-off`'. Also the additional option '`--case-ins`' help you find the packages with case
insensitive. Two new arguments, help you to rebuild '`--rebuild`' or reinstall '`--reinstall`' packages.
The last one argument '`--patches`' help you to switch in the '`patches/`' directory, only for the slack
repository.
Tracking the dependencies of a package with command '`slpkg -t <repository> <package>`', displays a
package dependency tree and also shows to you which ones are installed on your system events.
Check if the packages used from other packages with the option '`--check-deps`' or draw image map
dependencies with the additional option '`--graph=[image]`'.
Get information description of a package with the command '`slpkg -p <repository> <package>`' and
change the color of the text with the additional flag '`--color=[]`'.
View a SBo package page on your terminal with command `slpkg -n <package>` and then manage
multiple choices such read, download, build, install etc.
If you want to find a package of all the repositories, this command will solve your hands
'`slpkg -F <packages>`', it will search in all the enable repositories and will print all the
packages that match the description that you enter.
If you want to see if any packages are installed on your system enter the command
'`slpkg -f <packages>`'. The option '`--third-party`' help you to view only the third-party
packages
The next three commands '`slpkg --installpkg, --upgradepkg, --removepkg <packages>`' install, upgrade,
remove packages from your system events. Notable mention you must give in the command
'`slpkg --removepkg <packages>`' which you can remove the packages with all dependencies together
after editing configuration file '`/etc/slpkg/slpkg.conf`' (default is disable) or add additional
option '`--deps`'. Also you can check if the packages they are used as dependency with additional
option '`--check-deps`'. Option '`--tag`' allow to remove packages by TAG. Optional you can use
the dialog utility with the additional option '`--checklist`' (require python3-pythondialog). Rmove
third-party packages with the option '`--third-party`'.
The command '`slpkg -d <packages>`' is useful to print the entire contents of a package.
Some examples you will see below.
##### Slpkg Examples
Enable or disable default repositories, edit '`/etc/slpkg/repositories.conf`' file or with the command.