spl:outdated

Introduction

spl:outdated tells you which products derive from an older model than one that exists. A pin by DOI keeps a build reproducible, so a product stays on its version until you move it. This command says when it has fallen behind.

splent spl:outdated

  spl:outdated

  my_spl
  my_product               pins 2, this workspace holds 3
  my_other_product         pins 3, up to date

  2 product(s) checked, 1 behind
  Only this workspace was consulted. Add --remote to ask UVLHub.

Move a product forward with spl:pin.

Comparing with what your workspace holds

Without options it needs no network. It compares each product’s pin with the model this workspace holds, the working copy or else the newest cache entry. That is what changes after you publish from here.

Another product’s pin is never the reference, and neither is the pin the CLI ships.

Asking UVLHub whether the line moved on

splent spl:outdated --remote

  my_product               pins 3, the line is on 5

--remote asks UVLHub for the newest version of each line, through the concept DOI the product’s pin records. Without one, the workspace model’s concept DOI is used.

When it cannot tell

A product is behind only when the version labels prove it (2 < 3 < 10, or v2 < v10). When they do not, the product is counted under “could not be determined”, never as up to date.

Line	Means
`pins <v>, this workspace holds <v>, could not tell which is newer`	The labels are not numbers
`pins <v>, other products pin <v>, could not tell which is newer`	Nothing is held locally and products pin different models
`pins <v>, no concept DOI so the line cannot be checked`	`--remote` with no concept DOI. Record one with `spl:pin --concept-doi`
`pins <v>, UVLHub did not say what the newest version is`	`--remote`, and UVLHub’s answer did not name the newest version
`no DOI recorded, run splent spl:pin`	The product names the line but pins no DOI

An unreachable UVLHub, or an answer other than 200, fails the command rather than reading as nothing changed.

Reference

Option	Description
`--remote`	Also ask UVLHub whether the line has moved on

Requirements

Detached mode, with no product selected. A leading SPLENT_APP= runs one command detached and keeps your selection.