diff --git a/about.html b/about.html index 1fbca7b..c2605ec 100644 --- a/about.html +++ b/about.html @@ -69,7 +69,7 @@ diff --git a/css/nord.css b/css/nord.css index 39a4113..406791f 100644 --- a/css/nord.css +++ b/css/nord.css @@ -385,3 +385,7 @@ body, html { transform: translate(-50%, -50%); color: white; } + +hr { + color: #88c0d0; +} diff --git a/docs/dev-docs.html b/docs/dev-docs.html index 4b5c3a5..cb94d38 100644 --- a/docs/dev-docs.html +++ b/docs/dev-docs.html @@ -28,7 +28,8 @@
This page contains developer-specific documentation.
1.1 File Structure
+1.1 C
+1.1.1 File Structure
Files should follow this format:
Note that function declarations should be defined in a separate header, ex:
Indentations should be a single tab and be equal to 8 characters for better readability.
-1.2 Functions
+1.1.2 Functions
Functions should have their return type on one line, their name and parameters one line down, and the bracket one line under the name and arguments.
Example:
}
-1.3 Example Program
+1.1.3 Example Program
#include <stdio.h>
@@ -83,6 +84,31 @@
#endif
1.1.4 common.h
+For large programs which include many header files, it is perfectly acceptable to define these includes in a separate header and then include that in each file.
+#ifndef COMMON_H_
+#define COMMON_H_
++
#include <color.h>
+#include <stdio.h>
+#include <unistd.h>
++
#endif
+#include "common.h"
++
int
+main()
+{
+printf("hello\n"); +
}
+1.2 Bash/Shell
2.1 Disclaimer
A system profile describes your base system, including C library, architecture, SELinux support, multilib support, etc.
3.1 gpkg
-'gpkg' is the program most users will be interacting with. It handles the downloading, installation, and logging of packages.
+3.2 syspkg
-'syspkg' is like 'gpkg', except it operates on the system index, rather than the local index. End users should not use this unless instructed to.
+3.3 glist
-'glist' lists all installed packages, allowing the user to filter by name. +
3.4 gquery
-'gquery' queries information on a package.
-3.5 glacier-mkprofile
-'glacier-mkprofile' makes changes to the system-wide profile. Users should not interact with this unless needed.
+3.5 gpc
+3.6 glacier-mkprofile
+3.7 glacier-update-pkdgb
+Frontends, or wrappers, may provide additional functionality to Glacier.
5.1 Using gpkg
To merge a package from a repository:
-(root)# gpkg -f repo/pkg
- For instance, to install 'vim' in the 'world' repository:
-(root)# gpkg -f world/vim
+ (root)# gpkg -f pkg
+ For instance, to install 'vim':
+(root)# gpkg -f vim
5.2 Using syspkg
-Using 'syspkg' is not recommended for end users because all changes to the global package index will be overwritten when pulling a new update.
-If you understand these risks, and wish to use 'syspkg' anyways, you are acknowledging that things may break.
-To merge a package from a repository:
-(root)# syspkg -f repo/pkg
+ Using
If you understand these risks, and wish to use
To merge a package:
+(root)# syspkg -f pkg
6.1 Introduction
-When merging a package into any index, the package file is retained in said index. This provides most information needed to keep track of the package, however, when updating, an updated package file will need to be downloaded. Old package files will be retained as 'pkgname.old'.
+When merging a package into any index, the package file is retained in said index. This provides most information needed to keep track of the package, however, when updating, an updated package file will need to be downloaded. Old package files will be retained as
6.2 Using gpkg
To update a package:
-(root)# gpkg -u repo/pkg
+ (root)# gpkg -u pkg
6.3 Using syspkg
-As mentioned above, 'syspkg' is intended for system development, and NOT for end users.
-However, 'syspkg -u' has some use cases for end users. These include:
+As mentioned above,
However,
To update a package:
-(root)# syspkg -u repo/pkg
+ (root)# syspkg -u pkg
7.1 Introduction
-When removing a package, the package info file is moved from the appropriate index to /tmp, and saved as 'pkgname.rm'. This means it will be wiped after the next reboot.
+When removing a package, the package info file is moved from the appropriate index to /tmp, and saved as
7.2 Using gpkg
To remove a package:
(root)# gpkg -x pkg
- Note that no repository name was provided. It is not required, as no files will be downloaded during the removal process.
If a package is a dependency for another, you will be shown the following error:
[x] Could not remove (package_name): is a dependency for (package_name)
7.3 Using syspkg
@@ -98,20 +101,20 @@Patching packages is the act of editing a package file to change compile options, optimizations, etc. It is very useful if used correctly.
The officially tested and verified method for patching is as follows:
8.2 Custom package repository
If Glacier's standard package repository is not sufficient, you can use a custom one.
Ensure the repository you wish to migrate to supports your system profile. For example, if your profile is 'x86-musl', the new repository should offer packages compatible with 'x86-musl'.
+Ensure the repository you wish to migrate to supports your system profile. For example, if your profile is
Errors will occur if this is not taken into account.
To use a custom repository once, to merge a package:
(root)# GREPO=http://some-repo.org gpkg -f repo/pkg
- To make the changes persistent, change the 'GREPO' variable in '/etc/glacier.conf':
+To make the changes persistent, change the
export GREPO="https://some-repo.org
diff --git a/docs/meta-reading.html b/docs/meta-reading.html index 8a2bf3f..5c0fb4c 100644 --- a/docs/meta-reading.html +++ b/docs/meta-reading.html @@ -29,7 +29,7 @@Documentation for Everest is formatted in a specific way. This page explains how a page is formatted, and what certain things mean, in as much detail as possible.
2.1 Introduction
-Most Everest documentation pages will contain some type of a "card". Put simply, these are small sections that contain file contents, kernel configurations, warnings, notes, etc. There are 6 types of cards:
+Most Everest documentation pages will contain some type of a "card". Put simply, these are small containers that contain file contents, kernel configurations, warnings, notes, etc. There are 6 types of cards:
2.2 Note
This card is the most simple. It contains a note on a certain section. They are usually not required to read, but contain important information.
This is an example of a news card.
Everest documentation pages are organized into:
+3.1 Chapters
+Chapters are typically the largest sections on a given page. The topics they cover are very broad. Each chapter contains its own sections.
+A chapter header is large, bold, has a colored sidebar, and is denoted by its number.
+3.2 Sections
+Sections are nested within chapters, and typically pertain to more specific topics related to a chapter.
+A section header is bold, and is denoted by the number of the chapter it is nested under, followed by that section's number.
+3.3 Subsections
+Subsections are nested within sections, and usually contain very specific topics pertaining to a section (and chapter at large). Sometimes, a page does not use subsections at all.
+A subsection header is italic, and is denoted by the number of the chapter it is nested under, followed by the number of the section it is nested under, followed by that subsection's number.
+Copyright (C) 2021-2023 Everest Linux
+Copyright (C) 2021-2024 Everest Linux
Linux (R) is a registered trademark of Linus Torvalds.
Everest Linux is provided AS IS, WITHOUT WARRANTY.
Copyright (C) 2021-2023 Everest Linux
+Copyright (C) 2021-2024 Everest Linux
Linux (R) is a registered trademark of Linus Torvalds.
Everest Linux is provided AS IS, WITHOUT WARRANTY.