Skip to content

Commit 8553043

Browse files
authored
Modify branch switch and sync instructions and add instructions for ENT tool (#60)
- Updated git commands for switching branches and syncing forks. - Document Ent tool for tracking package updates - Add Aside component for note on 'ent' command Co-authored-by: Rune Morling <ermo@aerynos.com>
1 parent bea7a78 commit 8553043

1 file changed

Lines changed: 41 additions & 0 deletions

File tree

src/content/docs/Packaging/Workflow/updating-an-existing-recipe.mdx

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title : 'Updating an existing package recipe'
33
date : 2025-08-01T14:33:00+01:00
44
---
5+
import { Aside } from '@astrojs/starlight/components';
56

67
This page details the process of updating a package that is already present in the [AerynOS repository](https://github.com/AerynOS/recipes).
78

@@ -125,3 +126,43 @@ sudo moss install "package name"
125126
```
126127

127128
Once you have tested the package, you can make a submission for including the update in the repository.
129+
130+
## Checking for updates
131+
132+
To simplify update tracking for package maintainers, AerynOS provides a tool called **Ent**. Ent checks recipes against upstream sources to determine whether updates are available.
133+
134+
Install Ent using `moss`:
135+
136+
```bash
137+
sudo moss install ent
138+
```
139+
**How Ent works**
140+
141+
Ent scans the current directory and all subdirectories beneath it. It inspects each recipe `monitoring.yaml` file and compares the referenced `stone.yaml` recipe upstreams to determine whether newer versions are available.
142+
143+
Because Ent operates relative to the directory in which it is executed, you can control the scope of the update check by choosing where to run the command within the recipes repository.
144+
145+
***Running update checks***
146+
147+
To check for updates across all recipes, run the following command from the root of the recipes repository:
148+
149+
```bash
150+
ent check updates
151+
```
152+
153+
You can also run this command from more specific locations:
154+
155+
* **Repository root**
156+
Checks all recipes in the repository.
157+
158+
* **Letter directory (for example, `f/`)**
159+
Checks only recipes whose names start with that letter.
160+
161+
* **Specific recipe directory (for example, `f/firefox/`)**
162+
Checks only that single recipe.
163+
164+
For example, running the command from `f/firefox/` will check only the Firefox recipe for available updates.
165+
166+
<Aside type="note">
167+
`ent` queries an upstream site for package release info *every time you run it*. Please be mindful of not running it gratuitously so as to remain a good ecosystem citizen.
168+
</Aside>

0 commit comments

Comments
 (0)