New README and devtools created
This commit is contained in:
78
README
Normal file
78
README
Normal file
@@ -0,0 +1,78 @@
|
||||
+--------------------------------------+
|
||||
| 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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user