Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Please document expressions for depencencies #3359

Open
cryptomilk opened this issue Oct 4, 2024 · 4 comments
Open

Please document expressions for depencencies #3359

cryptomilk opened this issue Oct 4, 2024 · 4 comments

Comments

@cryptomilk
Copy link

The Spec file format doesn't describe the expressions implemented e.g. for Requires. There are several operators like and, or, if, unless, else, with and without.

Example:

Requires:       ( pkgA >= 1.2.3 or pkgB )
@pmatilai
Copy link
Member

pmatilai commented Oct 4, 2024

I suggest looking at the top-level manual for a wider perspective of what's documented. You'll find multiple articles on dependencies there, including one on boolean dependencies: https://rpm-software-management.github.io/rpm/manual/

The way our manual is constructed leaves a lot to be desired for sure, for proper organization it'd call for something other than bunch of files in markdown really. Besides historical reasons, there's a reason why dependencies are described outside spec syntax: these exist in various forms outside the spec, so documenting them as spec syntax would be overly limiting.

@cryptomilk
Copy link
Author

Then it should be interlinked. I would expect that a "Spec file format" document either explain everything or link accordingly.

@pmatilai
Copy link
Member

pmatilai commented Oct 4, 2024

I don't disagree, just pointing out that you'll be missing a lot of documentation if you only look at the spec syntax document currently.

@pmatilai pmatilai added this to RPM Oct 4, 2024
@github-project-automation github-project-automation bot moved this to Backlog in RPM Oct 4, 2024
@gotmax23
Copy link
Contributor

gotmax23 commented Oct 7, 2024

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Backlog
Development

No branches or pull requests

3 participants