Skip to content

Mention that standard libraries have a version number since 1.11 #4363

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Aug 25, 2025
Merged

Mention that standard libraries have a version number since 1.11 #4363

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
40da56d
Mention that standard libraries have a version number now
felixcremer Aug 13, 2025
2ded0b1
Update docs/src/managing-packages.md
felixcremer Aug 21, 2025
7c8cb40
Update `add` and `st` example to julia 1.13
felixcremer Aug 22, 2025
1c7ce3b
Update docs/src/managing-packages.md
felixcremer Aug 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 36 additions & 29 deletions docs/src/managing-packages.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,22 +10,23 @@ The most frequently used is `add` and its usage is described first.
In the Pkg REPL, packages can be added with the `add` command followed by the name of the package, for example:

```julia-repl
(@v1.10) pkg> add JSON
Installing known registries into `~/`
(@v1.13) pkg> add JSON
Resolving package versions...
Installed Parsers ─ v2.4.0
Installed JSON ──── v0.21.3
Updating `~/.julia/environments/v1.10/Project.toml`
[682c06a0] + JSON v0.21.3
Updating `~/.julia/environments/v1.10/Manifest.toml`
[682c06a0] + JSON v0.21.3
[69de0a69] + Parsers v2.4.0
[ade2ca70] + Dates
[a63ad114] + Mmap
[de0858da] + Printf
[4ec0a83e] + Unicode
Precompiling environment...
2 dependencies successfully precompiled in 2 seconds
Updating `~/.julia/environments/v1.13/Project.toml`
[682c06a0] + JSON v0.21.4
Updating `~/.julia/environments/v1.13/Manifest.toml`
[682c06a0] + JSON v0.21.4
[69de0a69] + Parsers v2.8.3
[aea7be01] + PrecompileTools v1.3.2
[21216c6a] + Preferences v1.5.0
[ade2ca70] + Dates v1.11.0
[a63ad114] + Mmap v1.11.0
[de0858da] + Printf v1.11.0
[9a3f8284] + Random v1.11.0
[ea8e919c] + SHA v0.7.0
[fa267f1f] + TOML v1.0.3
[cf7118a7] + UUIDs v1.11.0
[4ec0a83e] + Unicode v1.11.0
```

Here we added the package `JSON` to the current environment (which is the default `@v1.10` environment).
Expand All @@ -40,25 +41,31 @@ It is possible to add multiple packages in one command as `pkg> add A B C`.
The status output contains the packages you have added yourself, in this case, `JSON`:

```julia-repl
(@v1.10) pkg> st
Status `~/.julia/environments/v1.10/Project.toml`
[682c06a0] JSON v0.21.3
(@v1.13) pkg> st
Status `~/.julia/environments/v1.13/Project.toml`
[682c06a0] JSON v0.21.4
```

The manifest status shows all the packages in the environment, including recursive dependencies:

```julia-repl
(@v1.10) pkg> st -m
Status `~/.julia/environments/v1.10/Manifest.toml`
[682c06a0] JSON v0.21.3
[69de0a69] Parsers v2.4.0
[ade2ca70] Dates
[a63ad114] Mmap
[de0858da] Printf
[4ec0a83e] Unicode
```

Since standard libraries (e.g. ` Dates`) are shipped with Julia, they do not have a version.
(@v1.13) pkg> st -m
Status `~/.julia/environments/v1.13/Manifest.toml`
[682c06a0] JSON v0.21.4
[69de0a69] Parsers v2.8.3
[aea7be01] PrecompileTools v1.3.2
[21216c6a] Preferences v1.5.0
[ade2ca70] Dates v1.11.0
[a63ad114] Mmap v1.11.0
[de0858da] Printf v1.11.0
[9a3f8284] Random v1.11.0
[ea8e919c] SHA v0.7.0
[fa267f1f] TOML v1.0.3
[cf7118a7] UUIDs v1.11.0
[4ec0a83e] Unicode v1.11.0
```

Note that before 1.11 standard libraries (e.g. ` Dates`) did not have dedicated version numbers.

To specify that you want a particular version (or set of versions) of a package, use the `compat` command. For example,
to require any patch release of the v0.21 series of JSON after v0.21.4, call `compat JSON 0.21.4`:
Expand Down
Loading