Skip to content

Commit 88011fa

Browse files
committed
Improve online docs for stack unpack
1 parent a8813bc commit 88011fa

File tree

1 file changed

+17
-5
lines changed

1 file changed

+17
-5
lines changed

doc/unpack_command.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,25 @@ the package index (e.g. Hackage) and unpacks each archive.
1111

1212
By default:
1313

14-
* the download is for the most recent version of the package in the package
15-
index. Specify the package name and its version (for example,
16-
`acme-missiles-0.1.0.0`) for a particular version of the package.
17-
Optionally, a specific revision in the package index can be specified by
18-
appending `@rev:<number>` or `@sha256:<sha>`; and
14+
* if Stack's `--resolver` option is not specified, the download is for the
15+
most recent version of the package in the package index. Specify the package
16+
name and its version (for example, `acme-missiles-0.1.0.0`) for a particular
17+
version of the package. Optionally, a specific revision in the package index
18+
can be specified by appending `@rev:<number>` or `@sha256:<sha>`;
19+
20+
* if Stack's `--resolver` option is specified and the package's version is not
21+
specified, the download is for the version of the package included directly
22+
in the specified snapshot; and
1923

2024
* the package is unpacked into a directory named after the package and its
2125
version. Pass the option `--to <directory>` to specify the destination
2226
directory. The directory can be an absolute one or relative to the current
2327
directory.
28+
29+
!!! note
30+
31+
Stackage snapshots do not include directly most GHC boot packages (packages
32+
that come with GHC and are included in GHC's global package database) but
33+
some snapshots may include directly some boot packages. In particular, some
34+
snapshots include directly `Win32` (which is a boot package on Windows)
35+
while others do not.

0 commit comments

Comments
 (0)