Meta tags:
description=A program for developing Haskell projects. ;
author=Stack contributors;

Headings (most frequently used words):

including, the, include, directive, value, sequence, merging, mappings, nested, includes,

Text of the page (most frequently used words):
the (35), stack (19), file (19), include (17), configuration (13), yaml (13), project (12), snapshot (11), #directive (11), content (9), with (8), included (8), for (7), and (7), lts (7), ghc (7), files (6), can (6), key (6), package (6), including (6), that (5), config (5), merge (5), options (5), value (5), commands (5), includes (4), nested (4), flags (4), level (4), example (4), directory (4), more (4), mappings (4), extra (4), deps (4), sequence (4), build (4), contributors (3), shared (3), this (3), following (3), would (3), given (3), used (3), merging (3), use (3), relative (3), path (3), version (3), get (3), involved (3), integration (3), building (3), topics (3), configure (3), getting (3), started (3), cannot (2), note (2), directives (2), also (2), true (2), flag (2), wall (2), everything (2), equivalent (2), those (2), into (2), current (2), mapping (2), one (2), provided (2), scalar (2), global (2), another (2), table (2), contents (2), glossary (2), faq (2), how (2), works (2), upgrading (2), maintainers (2), code (2), non (2), docker (2), script (2), cabal (2), location (2), environment (2), specific (2), projects (2), setting (2), welcome (2), github (2), made, material, mkdocs, copyright, 2015, 2025, back, top, itself, has, already, detects, raises, error, cyclic, themselves, contain, allowing, composition, placed, line, after, combined, indicate, all, keys, specified, should, inserted, text, short, acme, missiles, not, limited, replaces, its, modify, excludes, relevant, uses, set, warning, containing, both, are, format, supports, local, tag, together, represents, absolute, provides, allows, history, other, resources, overview, signing, self, hosted, runners, haskellstack, org, zip, msys2, add, maintainer, team, process, releases, scheme, dev, containers, contributor, guide, haskell, lock, azure, travis, shell, auto, completion, developing, windows, visual, studio, editor, debugging, from, source, standard, initialization, nix, interpreter, specification, work, directories, root, customisation, scripts, variables, upload, upgrade, update, unpack, uninstall, test, templates, setup, sdist, runhaskell, runghc, run, repl, query, purge, new, list, install, init, ide, hpc, hoogle, haddock, ghci, exec, eval, dot, clean, bench, conclusion, using, interactively, executing, locations, multi, targets, synonyms, installed, databases, existing, your, description, hello, world, initializing, search, skip,

Text of the page (random words):
the include directive stack skip to content stack the include directive initializing search github welcome setting up getting started commands configure topics get involved faq glossary more stack github welcome setting up getting started getting started 1 a hello world example 2 package description 3 project configuration 4 building your project 5 building existing projects 6 installed package databases 7 stack build synonyms 8 stack build targets 9 multi package projects 10 cabal flags and ghc options 11 locations used by stack 12 executing commands 13 using ghc interactively 14 stack configuration 15 in conclusion commands commands bench build clean config dot docker eval exec ghc ghci haddock hoogle hpc ide init install list ls new path purge query repl run runghc runhaskell script sdist setup templates test uninstall unpack update upgrade upload configure configure environment variables configuration files configuration files project specific configuration non project specific configuration the include directive the include directive table of contents including a value including a sequence merging mappings nested includes global flags and options customisation scripts topics topics stack root stack work directories stack environment snapshot location package location snapshot specification stack yaml vs a cabal file script interpreter docker integration nix integration non standard project initialization building ghc from source debugging editor integration stack and visual studio code developing on windows shell auto completion ci travis ci azure ci lock files haskell and c code get involved get involved contributors contributors contributor s guide dev containers maintainers maintainers version scheme releases maintainer team process add ghc version upgrading msys2 upgrading 7 zip haskellstack org self hosted runners signing key how stack works how stack works build overview faq glossary more more other resources version history table of contents including a value including a sequence merging mappings nested includes the include directive stack s configuration files are in the yaml format stack also supports the use of an include local tag together with scalar content that represents an absolute or relative path to another file this provides a directive that allows the content of one yaml file to be included in another the directive can be used in both project level and global configuration files note an included relative file path is relative to the directory containing the file with the include directive warning the stack config set commands cannot modify a configuration file that excludes the relevant key and uses include directives including a value a value for a key can be provided by an included file for example given a file snapshot yaml in the project directory with the content lts 24 43 the following project level configuration file would use lts 24 43 as the snapshot snapshot include snapshot yaml the included file replaces the include directive with its content so this is equivalent to snapshot lts 24 43 including a sequence the value provided by an included file is not limited to scalar content it can be a yaml sequence for example given a file extra deps yaml in the project directory with the content acme missiles 0 3 text short 0 1 6 the following project level configuration file would use those as extra deps snapshot lts 24 43 extra deps include extra deps yaml merging mappings yaml s merge key is used to indicate that all of the keys of one or more specified mappings should be inserted into the current mapping yaml s merge key can be combined with an include directive to merge the content of an included file into the current mapping for example given a file shared config yaml in the project directory with the content ghc options everything wall flags my package my flag true the following project level configuration file would merge those options snapshot lts 24 43 include shared config yaml this is equivalent to snapshot lts 24 43 ghc options everything wall flags my package my flag true the include directive can also be placed on the line after the merge key snapshot lts 24 43 include shared config yaml nested includes included files can themselves contain include directives allowing for nested composition of configuration note a file cannot include itself or a file that has already included the file stack detects and raises an error for cyclic includes back to top copyright c 2015 2025 stack contributors made with material for mkdocs