How to migrate

[jonocodes]

How about providing some instructions on how one would migrate to using this from an existing system.

For example lets say I'm in arch and I have already installed a bunch of packages in pacman and AUR.

If I just create a file for metapac with nothing in it, would it remove everything I already installed? And if so is there a suggested way to go from the old system to one managed by metapac. Perhaps its as simple as doing something like pacman -Qe (which lists explicitly packages), and copying that into the file.

Or should I include non-explicitly installed ones.

[ripytide]

Yes it would attempt to remove all your packages if you don't first set up your group files.

You can run metapac unmanaged, this will output a valid group file with all your explicitly installed packages (internally it does essentially call pacman -Qe). You should never have to write down implicit packages. Make sure to first set the arch_package_helper to your aur helper first if you want it to include your installed AUR packages too.

I'm happy to add a section to the readme for this, if you think it's not clear enough, thanks.

[jonocodes]

Thanks. Yes it would be helpful. As would any other getting started info.
For example its not clear what the workflow is for adding a managed package.
Also I cant figure out how to remove a package. For example

pacman -Qe

only shows htop, btop, and metapac. Those are roughtly whats in my groups/default.toml

but lets say I dont want 'meld' installed any more. It came installed on my EndeavourOS system, but I dont want it. How do I remove using metapac?

Basically some more docs.

[ripytide]

I've attempted to add all the points discussed here to the new Getting Started section on the readme, please let me know if there's anything I missed.