Skip to content

Commit fd64e95

Browse files
committed
Update the packdiff readme
1 parent c6f0f81 commit fd64e95

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

README.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,21 @@
1-
packdiff diff streamly-process rev1 streamly-process rev2
1+
# packdiff
2+
3+
**Usage:**
4+
5+
```
6+
packdiff diff <package-name> <rev1> <package-name> <rev2>
7+
```
8+
9+
**Limitations:**
10+
11+
Packdiff uses the hoogle file created by haddock to generate and compare the
12+
difference between multiple versions of a package
13+
14+
1. The API for modules in the `other-modules` sections is not generated or
15+
compared.
16+
2. The re-exported module is just considered a re-exported module. The API of
17+
the re-exported module isn't merged with the module that re-exports it.
18+
19+
The 2nd limitation might end up falsely reporting a diff even if the diff does
20+
not exist. In our use-case where we have manual intervention this isn't a
21+
problem and does the job well.

0 commit comments

Comments
 (0)