Update and Remove Packages

By the end of this chapter, you will have reviewed an exact replacement, returned to a retained version and disabled or removed it explicitly. Use a disposable canary installation with releases 1.0.0 and 2.0.0 available.

Install version 2.0.0 through package-install, then decline its enablement review if you want to inspect it first. Version 1.0.0 remains active. Run package-update, choose installed version 2.0.0, and review the complete proposed composition and authority changes. Close Help and type yes once. The service verifies the exact replacement before exchanging contributions; a failed, cancelled or stale candidate preserves the confirmed generation.

Run package-cleanup, review the proposed unreachable content and confirm only that maintenance. The active release and complete previous lock remain protected. Cleanup does not remove your development source directory or arbitrary files. Installed, previous, pending, pinned and quarantined content remains reachable.

Run package-rollback, inspect the exact previous composition and authorities, then close Help and type yes. This is an explicit reviewed transition, not an automatic response to a failed update. Use package-list and package-describe to verify the resulting active version.

Run package-disable, choose rur.rot13@1.0.0, review the affected dependent closure and confirm. Its contributed commands disappear and new turns cannot enter that generation. An already admitted turn may finish under its captured authority before the owned worker retires. Disabling discovery with package-catalog-disable is a different action and does not disable installed commands.

Run package-remove only for an inactive, unrequired release. Review and confirm its removal. Active or required releases refuse removal. The previous lock may still retain exact bytes for recovery; explicit package-cleanup removes only objects outside the complete reachability set. Declared managed-data policy is preserved. A remove operation is not permission to delete arbitrary package data.

Previous: Use a Package Command | Part | User Guide | Next: Restore and Diagnose Packages