fix: drop --locked from VCS PKGBUILDs, add setup and troubleshooting docs

--locked is unreliable for -git packages where Cargo.lock may diverge
from the latest source. Also documents the required paru -Sy --pkgbuilds
step and common error resolutions.

README.md

@@ -19,6 +19,14 @@ Add to `~/.config/paru/paru.conf`:
 Url = https://gitea.moonarch.de/nevaforget/moonarch-pkgbuilds
 ```
 
+Then sync the repository index:
+
+```bash
+paru -Sy --pkgbuilds
+```
+
+This downloads the PKGBUILDs from Gitea. Without this step, paru will not find the moonarch packages.
+
 ## Install
 
 ```bash
@@ -32,3 +40,14 @@ Standard system upgrade picks up new versions automatically:
 ```bash
 paru -Syu
 ```
+
+## Troubleshooting
+
+**"not downloaded (use -Sy --pkgbuilds to download)"**: Run `paru -Sy --pkgbuilds` to fetch the repo index.
+
+**"cannot update the lock file ... --locked was passed"**: The PKGBUILD cache is stale. Clear it and retry:
+
+```bash
+rm -rf ~/.cache/paru/clone/repo/moonarch
+paru -Sy --pkgbuilds && paru -S <package>
+```

moongreet-git/PKGBUILD

@@ -32,7 +32,7 @@ pkgver() {
 
 build() {
     cd "$srcdir/greetd-moongreet"
-    cargo build --release --locked
+    cargo build --release
 }
 
 package() {

moonlock-git/PKGBUILD

@@ -36,7 +36,7 @@ pkgver() {
 
 build() {
     cd "$srcdir/moonlock"
-    cargo build --release --locked
+    cargo build --release
 }
 
 package() {