testsAndMisc/linux_configuration/fresh-install/README.md

# Package Lists

This directory contains package lists for the fresh install script:

- `pacman_packages.txt` - List of packages to install via pacman
- `aur_packages.txt` - List of AUR packages with their repository URLs

## Format

### pacman_packages.txt

One package name per line:

```
package1
package2
package3
# This is a comment and will be ignored
# Another comment
```

### aur_packages.txt

Package name and repository URL separated by space:

```
package-name https://aur.archlinux.org/package-name.git
another-package https://aur.archlinux.org/another-package.git
# This is a comment and will be ignored
# Another comment
```

**Note**: Lines starting with anything other than lowercase letters (a-z) or digits (0-9) will be ignored as comments. This includes lines starting with `#`, spaces, uppercase letters, or special characters.

## Usage

The `main.sh` script will automatically read from these files:

- Pacman packages will be installed via `pacman -Sy --noconfirm`
- AUR packages will be built and installed via the `install_from_aur` function

## Modifying Package Lists

To add or remove packages:

1. Edit the appropriate `.txt` file
2. For AUR packages, ensure the format is correct (package-name followed by space and URL)
3. You can add comments by starting lines with `#` or any non-alphanumeric character
4. Save the file - the script will automatically pick up changes on next run

### Comments

You can add comments to organize your package lists:

```
# Essential packages
git
vim

# Development tools
gcc
make

# Optional packages (commented out)
# some-package-i-might-want-later
```