Skip to content
GitLab
Explore
Sign in
Register
Primary navigation
Search or go to…
Project
GHC
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Requirements
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Locked files
Build
Pipelines
Jobs
Pipeline schedules
Test cases
Artifacts
Deploy
Releases
Package Registry
Model registry
Operate
Terraform modules
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Code review analytics
Issue analytics
Insights
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Dave Barton
GHC
Commits
58fea28e
Commit
58fea28e
authored
3 years ago
by
Matthew Pickering
Committed by
Marge Bot
3 years ago
Browse files
Options
Downloads
Patches
Plain Diff
hadrian: Update documentation for new verbosity options
parent
66c85e2e
No related branches found
No related tags found
No related merge requests found
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
hadrian/README.md
+5
-2
5 additions, 2 deletions
hadrian/README.md
hadrian/doc/user-settings.md
+0
-35
0 additions, 35 deletions
hadrian/doc/user-settings.md
with
5 additions
and
37 deletions
hadrian/README.md
+
5
−
2
View file @
58fea28e
...
...
@@ -117,8 +117,11 @@ four settings: `none`, `brief` (one line per build command; this is the default
setting),
`normal`
(typically a box per build command), and
`unicorn`
(when
`normal`
just won't do).
*
`--verbose`
: run Hadrian in verbose mode. In particular this prints diagnostic
messages by Shake oracles.
*
`-V`
/
`--verbose`
: run Hadrian in verbose mode. This makes commands print their stdout
and produces slightly more output on a failure (including hadrian call stacks).
*
`-VV`
: run hadrian in diagnostics mode: In particular this prints diagnostic
messages by Shake oracles and full command lines for all commands.
*
`--lint`
: run
[
Shake Lint
](
https://shakebuild.com/manual#lint
)
during the
build to check that the build system is well formed. Note that the Lint check
...
...
This diff is collapsed.
Click to expand it.
hadrian/doc/user-settings.md
+
0
−
35
View file @
58fea28e
...
...
@@ -220,41 +220,6 @@ noDynamicFlavour = defaultFlavour
,
libraryWays
=
remove
[
dynamic
]
defaultLibraryWays
}
```
### Verbose command lines
By default Hadrian does not print full command lines during the build process
and instead prints short human readable digests for each executed command. You
can suppress this behaviour completely or partially using
`verboseCommand`
setting:
```
haskell
-- | Set to 'True' to print full command lines during the build process. Note:
-- this is a 'Predicate', hence you can enable verbose output only for certain
-- targets, e.g.: @verboseCommand = package ghcPrim@.
verboseCommand
::
Predicate
verboseCommand
=
do
verbosity
<-
expr
getVerbosity
return
$
verbosity
>=
Verbose
```
For example, to print the full command lines used to compile GHC executables,
set
`verboseCommands`
to:
```
haskell
verboseCommand
::
Predicate
verboseCommand
=
input
"ghc/Main.hs"
```
Below are a few other examples:
```
haskell
-- Print command lines for all Ghc Link invocations:
verboseCommand
=
builder
(
Ghc
Link
)
-- Print command lines when compiling files in package compiler using Gcc:
verboseCommand
=
builder
(
Gcc
Compile
)
&&^
package
compiler
-- Use patterns when matching files:
verboseCommand
=
output
"**/rts/sm/*"
&&^
way
threaded
-- Print all commands:
verboseCommand
=
return
True
```
### Documentation
`Flavour`
's
`ghcDocs :: Action DocTargets`
field lets you
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment