Skip to main content

kmpkg x-add-version

This section covers an experimental feature of kmpkg which may change or be removed at any time.

Synopsis​

kmpkg x-add-version [port-name] [options] [--all] [--overwrite-version] [--skip-formatting-check] [--skip-version-format-check] [--verbose]

Description​

The x-add-version command updates the version database for kmpkg ports. By default, it operates on a specified port. With the appropriate switches, users can choose to process all ports or change the default behavior regarding formatting checks and version updates.

To use the command:

  1. After making changes to a port, navigate to the kmpkg directory.
  2. Run kmpkg x-add-version <port-name>, replacing <port-name> with the name of the port you've edited.

This will add or update the version entry for your port in the version database.

info

The hash used in the version database is computed from the complete file contents of the port. Any untracked files in the port directory will affect the resulting hash. Users should ensure that any files they do not intend to track are removed before invoking this command.

Options​

All kmpkg commands support a set of common options.

[port-name]​

Specifies the name of the port to be updated. If not provided, the user should use the --all option to process all ports.

--all​

Process all the ports in the built-in ports directory.

--overwrite-version​

Allows overwriting an existing version in the database.

Without this flag, kmpkg will refuse to overwrite existing versions.

info

This option is designed for ongoing development when preparing a version for registry inclusion. For example, consider addressing an issue in the foo port and executing kmpkg x-add-version foo. For subsequent modifications to the port, utilize kmpkg x-add-version foo --overwrite-version to refresh the version entry prior to registry inclusion.

--skip-formatting-check​

Skips the check for proper formatting in the manifest file (kmpkg.json) of the port. By default, proper formatting is checked and required.

--skip-version-format-check​

Skips the version format check. By default, versions are checked to ensure they adhere to a specific format.

--verbose​

Provides verbose output, giving more details about the operations being carried out.