diff options
| author | emmett1 <me@emmett1.my> | 2026-06-22 22:14:09 +0800 |
|---|---|---|
| committer | emmett1 <me@emmett1.my> | 2026-06-22 22:14:09 +0800 |
| commit | e77535b362933895c8634b41ed41efed5951e4a2 (patch) | |
| tree | 2e8c6bc3ff3bc8bfb75c5ff4daae818115316215 /docs | |
| parent | 5c618c1aeb65b4b05956d7f7574691d15896c103 (diff) | |
| download | alicelinux-e77535b362933895c8634b41ed41efed5951e4a2.tar.gz alicelinux-e77535b362933895c8634b41ed41efed5951e4a2.zip | |
updated buildsite.sh and installation doc
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/01-install.md | 47 |
1 files changed, 21 insertions, 26 deletions
diff --git a/docs/01-install.md b/docs/01-install.md index d032ad51..3c0a301d 100644 --- a/docs/01-install.md +++ b/docs/01-install.md @@ -58,22 +58,17 @@ Once we have the repositories cloned, we need to configure `apkg`. `apkg` is Ali First, we set `CFLAGS` and `CXXFLAGS`. Alice base packages are built using `-O3 -march=x86-64 -pipe`. You can use these settings or change them to your preference. ``` -# echo 'export CFLAGS="-O3 -march=x86-64 -pipe"' >> /etc/profile.d/apkg.sh +# export CFLAGS="-O3 -march=x86-64 -pipe" ``` And use whats in `CFLAGS` for `CXXFLAGS`. ``` -# echo 'export CXXFLAGS="$CFLAGS"' >> /etc/profile.d/apkg.sh +# export CXXFLAGS="$CFLAGS" ``` Next set `MAKEFLAGS`. I will use `6` for my `8 threads` machine. ``` -# echo 'export MAKEFLAGS="-j6"' >> /etc/profile.d/apkg.sh -``` - -I'm also going to set `NINJAJOBS` here. Without it, `ninja` will use all threads of your machine when compiling. -``` -# echo 'export NINJAJOBS="6"' >> /etc/profile.d/apkg.sh +# export MAKEFLAGS="-j6" ``` Next, we need to set the package's build scripts path (I'll call it `package repos`) so `apkg` can find them. The `APKG_REPO` variable can accept multiple values for multiple `package repos`. @@ -82,17 +77,17 @@ Alice provides two (2) `package repos` (at the time of this writing): `core` and I'm gonna use directory `/var/lib/repos/core` and `/var/lib/repos/extra` for `core` and `extra` repos respectively. ``` -# echo 'export APKG_REPO="/var/lib/repos/core /var/lib/repos/extra"' >> /etc/profile.d/apkg.sh +# export APKG_REPO="/var/lib/repos/core /var/lib/repos/extra" ``` -You can also create a directory the community repo. -> NOTE: The community repo is not held to the same standards as the official repos. +You can also add `community` repo too. +> NOTE: The `community` repo is not held to the same standards as the official repos. > Additionally all repo paths must be declared in the APKG_REPO variable, separated by a single space. ``` -# echo 'export APKG_REPO="/var/lib/repos/core /var/lib/repos/extra /var/lib/repos/community"' >> /etc/profile.d/apkg.sh +# export APKG_REPO="/var/lib/repos/core /var/lib/repos/extra /var/lib/repos/community" ``` -Next, we will set up directories for `packages`, `sources`, and `work`. By default, these directories are inside the package template, but we will change them to `/var/cache/pkg`, `/var/cache/src`, and `/var/cache/work` respectively. You can change these to any location where you want to store these files. +Next, we will set up directories for `packages`, `sources`, and `work`. By default, these directories are inside the package port, but we will change them to `/var/cache/pkg`, `/var/cache/src`, and `/var/cache/work` respectively. You can change these to any location where you want to store these files. First, create the directories. ``` @@ -101,30 +96,30 @@ First, create the directories. # mkdir -p /var/cache/work ``` -Then add these paths to `/etc/profile.d/apkg.sh`. +export These configuration environment ``` -# echo 'export APKG_PACKAGE_DIR=/var/cache/pkg' >> /etc/profile.d/apkg.sh -# echo 'export APKG_SOURCE_DIR=/var/cache/src' >> /etc/profile.d/apkg.sh -# echo 'export APKG_WORK_DIR=/var/cache/work' >> /etc/profile.d/apkg.sh +# export APKG_PACKAGE_DIR=/var/cache/pkg +# export APKG_SOURCE_DIR=/var/cache/src +# export APKG_WORK_DIR=/var/cache/work ``` Configure reposync -------------------- -`reposync` is a tool to sync package templates from git repositories. Like `apkg`, `reposync` configuration is environment-based. Add remote repos for `core` and `extra` to `/etc/profile.d/reposync.sh` (system-wide) or `~/.profile` (per-user). The format is `<gitrepo>|<branch>|<localpath>`. +`reposync` is a tool to sync package ports from git repositories. Like `apkg`, `reposync` configuration is environment-based. Add remote repos for `core` and `extra` to `/etc/profile.d/reposync.sh` (system-wide) or `~/.profile` (per-user). The format is `<gitrepo>|<branch>|<localpath>`. ``` -# echo 'export REPOSYNC_CORE="https://codeberg.org/emmett1/alicelinux|core|/var/lib/repos/core"' >> /etc/profile.d/reposync.sh -# echo 'export REPOSYNC_EXTRA="https://codeberg.org/emmett1/alicelinux|extra|/var/lib/repos/extra"' >> /etc/profile.d/reposync.sh +# export REPOSYNC_CORE="https://codeberg.org/emmett1/alicelinux|core|/var/lib/repos/core" +# export REPOSYNC_EXTRA="https://codeberg.org/emmett1/alicelinux|extra|/var/lib/repos/extra" ``` -If you also want the community repo, add it as well. -> NOTE: The community repo is not held to the same standards as the official repos. +If you also want the `community` repo, add it as well. +> NOTE: The `community` repo is not held to the same standards as the official repos. ``` -# echo 'export REPOSYNC_COMMUNITY="https://codeberg.org/emmett1/alicelinux|community|/var/lib/repos/community"' >> /etc/profile.d/reposync.sh +# export REPOSYNC_COMMUNITY="https://codeberg.org/emmett1/alicelinux|community|/var/lib/repos/community" ``` -Now run `reposync` to sync latest package templates. +Now run `reposync` to sync latest ports. ``` # reposync ``` @@ -138,7 +133,7 @@ swaylock sway ``` -Lets combine with `-p` flags to show path or package templates. +Lets combine with `-p` flags to show path or package port. ``` # apkg -p $(apkg -s sway) /var/lib/repos/extra/sway @@ -156,7 +151,7 @@ On the first install, we should upgrade the system first. Before we do, install development packages first. ``` -# apkg -I meson cmake pkgconf libtool automake perl +# apkg -I muon cmake pkgconf libtool automake perl python ``` > NOTE: use uppercase 'i' for solve dependencies, lowercase 'i' without solve dependencies. |