@@ -0,0 +1,121 @@
1+{-
2+Welcome to your new Dhall package-set!
3+
4+Below are instructions for how to edit this file for most use
5+cases, so that you don't need to know Dhall to use it.
6+
7+## Warning: Don't Move This Top-Level Comment!
8+
9+Due to how `dhall format` currently works, this comment's
10+instructions cannot appear near corresponding sections below
11+because `dhall format` will delete the comment. However,
12+it will not delete a top-level comment like this one.
13+
14+## Use Cases
15+
16+Most will want to do one or both of these options:
17+1. Override/Patch a package's dependency
18+2. Add a package not already in the default package set
19+
20+This file will continue to work whether you use one or both options.
21+Instructions for each option are explained below.
22+
23+### Overriding/Patching a package
24+
25+Purpose:
26+- Change a package's dependency to a newer/older release than the
27+ default package set's release
28+- Use your own modified version of some dependency that may
29+ include new API, changed API, removed API by
30+ using your custom git repo of the library rather than
31+ the package set's repo
32+
33+Syntax:
34+Replace the overrides' "{=}" (an empty record) with the following idea
35+The "//" or "⫽" means "merge these two records and
36+ when they have the same value, use the one on the right:"
37+-------------------------------
38+let override =
39+ { packageName =
40+ upstream.packageName // { updateEntity1 = "new value", updateEntity2 = "new value" }
41+ , packageName =
42+ upstream.packageName // { version = "v4.0.0" }
43+ , packageName =
44+ upstream.packageName // { repo = "https://www.example.com/path/to/new/repo.git" }
45+ }
46+-------------------------------
47+
48+Example:
49+-------------------------------
50+let overrides =
51+ { halogen =
52+ upstream.halogen // { version = "master" }
53+ , halogen-vdom =
54+ upstream.halogen-vdom // { version = "v4.0.0" }
55+ }
56+-------------------------------
57+
58+### Additions
59+
60+Purpose:
61+- Add packages that aren't already included in the default package set
62+
63+Syntax:
64+Replace the additions' "{=}" (an empty record) with the following idea:
65+-------------------------------
66+let additions =
67+ { "package-name" =
68+ mkPackage
69+ [ "dependency1"
70+ , "dependency2"
71+ ]
72+ "https://example.com/path/to/git/repo.git"
73+ "tag ('v4.0.0') or branch ('master')"
74+ , "package-name" =
75+ mkPackage
76+ [ "dependency1"
77+ , "dependency2"
78+ ]
79+ "https://example.com/path/to/git/repo.git"
80+ "tag ('v4.0.0') or branch ('master')"
81+ , etc.
82+ }
83+-------------------------------
84+
85+Example:
86+-------------------------------
87+let additions =
88+ { benchotron =
89+ mkPackage
90+ [ "arrays"
91+ , "exists"
92+ , "profunctor"
93+ , "strings"
94+ , "quickcheck"
95+ , "lcg"
96+ , "transformers"
97+ , "foldable-traversable"
98+ , "exceptions"
99+ , "node-fs"
100+ , "node-buffer"
101+ , "node-readline"
102+ , "datetime"
103+ , "now"
104+ ]
105+ "https://github.com/hdgarrood/purescript-benchotron.git"
106+ "v7.0.0"
107+ }
108+-------------------------------
109+-}
110+
111+let mkPackage =
112+ https://raw.githubusercontent.com/purescript/package-sets/psc-0.12.3-20190315/src/mkPackage.dhall sha256:0b197efa1d397ace6eb46b243ff2d73a3da5638d8d0ac8473e8e4a8fc528cf57
113+
114+let upstream =
115+ https://raw.githubusercontent.com/purescript/package-sets/psc-0.12.3-20190315/src/packages.dhall sha256:08714bc666b16834f0f4cf86d408745ce005c43e3343821e4c3864ef28709177
116+
117+let overrides = {=}
118+
119+let additions = {=}
120+
121+in upstream // overrides // additions