Follow up on documentation links, and revise Solaris/illumos packaging aids#2743
Merged
jimklimov merged 21 commits intonetworkupstools:masterfrom Jan 3, 2025
Merged
Follow up on documentation links, and revise Solaris/illumos packaging aids#2743jimklimov merged 21 commits intonetworkupstools:masterfrom
jimklimov merged 21 commits intonetworkupstools:masterfrom
Conversation
…be consistent Signed-off-by: Jim Klimov <[email protected]>
…entation links [networkupstools#722] Signed-off-by: Jim Klimov <[email protected]>
…DE script launch Signed-off-by: Jim Klimov <[email protected]>
… the SEMVER part Signed-off-by: Jim Klimov <[email protected]>
… CPU support) of installation host vs. build target host Signed-off-by: Jim Klimov <[email protected]>
…U support) of build target host in package naming Signed-off-by: Jim Klimov <[email protected]>
…etworkupstools#722] Signed-off-by: Jim Klimov <[email protected]>
Signed-off-by: Jim Klimov <[email protected]>
…Link() for actual SMF command syntax [networkupstools#722] Signed-off-by: Jim Klimov <[email protected]>
… section names Certain distributions have to patch built NUT artifacts for their packaging with their man page sectioning standards. Make life easier, be friendlier out of the box :) Signed-off-by: Jim Klimov <[email protected]>
Signed-off-by: Jim Klimov <[email protected]>
… to provide corrected man page sections where needed Signed-off-by: Jim Klimov <[email protected]>
Signed-off-by: Jim Klimov <[email protected]>
…ripts/systemd/nut*.in, scripts/Solaris/*.xml.in: when suggesting man pages for further reading, refer to correct (configurable) section identifier [networkupstools#722] Signed-off-by: Jim Klimov <[email protected]>
…ts/Solaris/*.xml.in: when suggesting man pages in service metadata, refer to packaged NUT_MANDIR [networkupstools#722] Signed-off-by: Jim Klimov <[email protected]>
jimklimov
added
packaging
documentation
systemd
CI
Signed-off-by: Jim Klimov <[email protected]>
Signed-off-by: Jim Klimov <[email protected]>
…ble doc building by themselves Signed-off-by: Jim Klimov <[email protected]>
…e builds with Sun make: handle plain filenames in $(PREP_SRC) without a prefixed directory Looking at generated docinfo.xml and linkman-* files respectively. Signed-off-by: Jim Klimov <[email protected]>
…e builds: only rewrite "linkman" references for doc text sources that have them [networkupstools#722] Spare asciidoc.conf, docinfo.xml and similar resource files, as well as docs that do not have those tags in the first place. Signed-off-by: Jim Klimov <[email protected]>
|
❌ Build nut 2.8.2.2576-master failed (commit 4c56fab36d by @jimklimov) |
|
✅ Build nut 2.8.2.2578-master completed (commit c293e4327a by @jimklimov) |
…h different MKDIR_P as we "cd" around [networkupstools#722] Signed-off-by: Jim Klimov <[email protected]>
jimklimov
added a commit
to jimklimov/nut
that referenced
this pull request
Feb 9, 2025
…SITE_BASE to asciidoc attributes [networkupstools#722, networkupstools#2733, networkupstools#2743] If we ever decide to forgo rewritting of man page numbers and website URLs during creation of *-prepped sources fed into asciidoc (as done by PRs above) and directly use expadable asciidoc attributes in text, the Makefiles are ready. One downside is that plaintext original docs would become barely useful, with all those links externalized... Signed-off-by: Jim Klimov <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Several fixes for #2733 (for #722) regarding Solaris SMF syntax, completing that issue.
During work on that, realized that e.g. OpenIndiana packaging has to maintain patch-files that replace man page titles and cross-links with section code
1mwhere8is used (System mgmt programs), which is unwieldy as man pages change between releases in both content and population. Now theconfigurescript andMakefilemesh allow to customize this right away, impacting both man page file names and thelinkman:name[section]references; the resulting section name references from pre-installed service manifest templates as well as additions generated at run-time (NDE wrapped drivers) and reported in usage/help messages would use the system-specific value. Also the NUT path to man pages is used per packaging, not hard-coding.During local testing of the package and services, a number of other issues were found and fixed, notably about making the ISA (64/32-bitness) more visible.