add readme
All checks were successful
Gentoo Utils / build-oci-image (push) Successful in 20s
Gentoo Utils / grep (push) Successful in 4s
Gentoo Utils / check-format (push) Successful in 10s
Gentoo Utils / docs (push) Successful in 18s
Gentoo Utils / build (push) Successful in 28s
Gentoo Utils / test (push) Successful in 34s
Gentoo Utils / fuzz (push) Successful in 1m26s
All checks were successful
Gentoo Utils / build-oci-image (push) Successful in 20s
Gentoo Utils / grep (push) Successful in 4s
Gentoo Utils / check-format (push) Successful in 10s
Gentoo Utils / docs (push) Successful in 18s
Gentoo Utils / build (push) Successful in 28s
Gentoo Utils / test (push) Successful in 34s
Gentoo Utils / fuzz (push) Successful in 1m26s
This commit is contained in:
50
README.org
Normal file
50
README.org
Normal file
@@ -0,0 +1,50 @@
|
||||
#+title: Gentoo Utils
|
||||
|
||||
* Getting Started
|
||||
|
||||
Gentoo Utils must be compiled from source currently. See the compiling from source section for more information.
|
||||
|
||||
* Development :development:contributing:
|
||||
|
||||
There are two main avenues for development:
|
||||
- compiling normally using packages via portage
|
||||
- using the podman container
|
||||
|
||||
** Development without using a podman container
|
||||
*** Install Build Prerequisites
|
||||
- dev-lang/rust-bin-9999
|
||||
- llvm-core/clang
|
||||
- llvm-core/lld
|
||||
- sys-process/parallel (Needed for =check.sh=)
|
||||
- dev-build/meson
|
||||
|
||||
Install build deps:
|
||||
#+begin_src bash :noeval
|
||||
emerge -a dev-lang/rust-bin-9999 \
|
||||
llvm-core/clang \
|
||||
llvm-core/lld \
|
||||
sys-process/parallel
|
||||
#+end_src
|
||||
|
||||
Compiling this project currently requires using a patched meson. Install patched meson:
|
||||
#+begin_src bash :noeval
|
||||
EGIT_OVERRIDE_REPO_MESONBUILD_MESON=https://jturnerusa.dev/cgit/meson emerge -a =dev-build/meson-9999::gentoo
|
||||
#+end_src
|
||||
|
||||
** Development using a podman container
|
||||
The podman image comes with all the tools required to compile gentoo-utils.
|
||||
|
||||
Clone the repo
|
||||
#+begin_src bash :noeval
|
||||
git clone https://git.epenguin.net/gentoo-utils/gentoo-utils.git
|
||||
cd gentoo-utils
|
||||
#+end_src
|
||||
|
||||
Run the check script:
|
||||
#+begin_src bash :noeval
|
||||
podman run --rm --userns=keep-id -v $PWD:/workspace git.epenguin.net/gentoo-utils/gentoo-utils:latest ./check.sh
|
||||
#+end_src
|
||||
|
||||
|
||||
* Resources
|
||||
pms-utils spec link
|
||||
Reference in New Issue
Block a user