Skip to content

feat: expand RPM documentation#411

Draft
Owen-sz wants to merge 5 commits intomainfrom
owen/expand-rpm
Draft

feat: expand RPM documentation#411
Owen-sz wants to merge 5 commits intomainfrom
owen/expand-rpm

Conversation

@Owen-sz
Copy link
Copy Markdown
Member

@Owen-sz Owen-sz commented Apr 29, 2026

WIP, starting with sections page

Signed-off-by: Owen-sz <owen@fyralabs.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 29, 2026

Deploying devdocs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 8513ba6
Status: ✅  Deploy successful!
Preview URL: https://e16d904e.devdocs-next.pages.dev
Branch Preview URL: https://owen-expand-rpm.devdocs-next.pages.dev

View logs

Owen-sz added 3 commits April 28, 2026 21:59
Signed-off-by: Owen-sz <owen@fyralabs.com>
Signed-off-by: Owen-sz <owen@fyralabs.com>
Signed-off-by: Owen-sz <owen@fyralabs.com>
@Owen-sz
Copy link
Copy Markdown
Member Author

Owen-sz commented Apr 29, 2026

Sections page is pretty much done. Working on macros now


### `%description [-n]<name>`
Used to define a description for a subpackage.
Requires if `%package` is used.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is always required

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I think this should be refactored to explain the behavior when %package is used. I would also very much suggest making the header -n <name> as that is the format you would usually see for subpackages.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is supposed to be a distinction here between %description and %description [-n]<name>

I can reword this one better though


##### `%_smp_build_ncpus` [#_smp_build_ncpus]

Expands to the output of `nproc` (the build host's thread count)
Copy link
Copy Markdown
Collaborator

@GildedRoach GildedRoach Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the default behavior, but only because %{__smp_use_cpus} uses this if no other argument is passed to the macro. You can actually use this macro, or preferrably %{_smp_ncpus_max}, to give a different amount of CPUs available to the build, which will also affect $RPM_BUILD_NCPUS.

Used to define a description for a subpackage.
Requires if `%package` is used.

The `-n` and `<name>` options work the same, however if not defined this will refer to the main package.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They don't work the same by this very description, though?

Signed-off-by: Owen-sz <owen@fyralabs.com>
@Owen-sz
Copy link
Copy Markdown
Member Author

Owen-sz commented Apr 30, 2026

The most recent commit is super WIP but looking for feedback on how to best implement what I'm trying to do here, plus I'm tired

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants