Update description of FlakeRef, incorporating suggestion.

This commit is contained in:
Kevin Quick 2020-09-28 09:23:05 -07:00
parent bcb3da3b6b
commit 5ae164b7cf
No known key found for this signature in database
GPG key ID: E6D7733599CC0A21

View file

@ -12,12 +12,19 @@ class Store;
typedef std::string FlakeId; typedef std::string FlakeId;
// The FlakeRef represents a local nix store reference to a flake // A flake reference specifies how to fetch a flake or raw source
// input for a Flake (it may be helpful to think of this object by the // (e.g. from a Git repository). It is created from a URL-like syntax
// alternate name of "InputRefForFlake"). It is constructed by // (e.g. 'github:NixOS/patchelf'), an attrset representation (e.g. '{
// starting with an input description (usually the attrs or a url from // type="github"; owner = "NixOS"; repo = "patchelf"; }'), or a local
// the flake file), locating a fetcher for that input, and then // path.
// capturing the Input object that fetcher generates (usually via //
// Each flake will have a number of FlakeRef objects: one for each
// input to the flake.
//
// The normal method of constructing a FlakeRef is by starting with an
// input description (usually the attrs or a url from the flake file),
// locating a fetcher for that input, and then capturing the Input
// object that fetcher generates (usually via
// FlakeRef::fromAttrs(attrs) or parseFlakeRef(url) calls). // FlakeRef::fromAttrs(attrs) or parseFlakeRef(url) calls).
// //
// The actual fetch not have been performed yet (i.e. a FlakeRef may // The actual fetch not have been performed yet (i.e. a FlakeRef may