glacier-pkgs/README

79 lines
2.3 KiB
Plaintext
Raw Permalink Normal View History

2023-01-08 12:30:30 -05:00
+--------------------------------------+
| Welcome to the Glacier package index |
+--------------------------------------+
This is the official package repository for Glacier.
+---------------------+
| Submitting Packages |
+---------------------+
Submitting packages is limited to trusted users only.
Additionally, these steps assume you have access to gpc.
A copy is available in glacier-pkgs/devtools
1) Clone this repository. This will take a while.
2) Ensure your trusted user key is valid.
3) Create a package archive. This needs to include the following:
- The package's source tree
- INSTALL.sh
- UPDATE.sh
- REMOVE.sh
- package_name-pkginfo.json, containing the following:
{
"package_name": "",
"package_version": "",
"package_description": "",
"src_tree_size": "",
"exec_size": "",
"license": ""
}
- package_name.ts.sh, containing the following:
#!/bin/sh
touch /var/log/glacier/package_name.timestamp
date >> /var/log/glacier/package_name.timestamp
As well as submitting the package itself, a separate file, package_name.checksum
needs to be submitted as well.
Licenses need to follow this naming scheme:
- GPL V3, GPL V2
- MIT, BSD, Apache
For all other licenses, use the license name.
Once all of these files are in a directory, run:
(user)$ gpc check package_dir
# If any errors are detected by gpc, recheck everything
(user)$ gpc mkpkg package_dir
(user)$ mv package_dir/package_name.tar.gz package_dir/package_name.checksum .
4) Create a new branch from main. Name it the following:
maintainer_name-date
5) Submit the package, ensuring it is in the correct directory within this repository:
- world-testing, for system software
- galaxy-testing, for GPL software ONLY
- universe-testing, for other open source licensed software
- multiverse-testing, for proprietary, EULA, and binary-redistributable software
6) Merge your branch with main.
7) Test your package. 1 other trusted user must test the package
and ensure it works correctly.
After the package has been verified, repeat step 4, and move your package out
of testing and into stable.
+------------------------------+
| Reporting License Violations |
+------------------------------+
If your software is included in Glacier's package index, and we
are violating your license, reach out to any developer and we
will be happy to resolve the issue with you.