Fixes #30072 - Update documentation to show that the old DIR option can target a single file instead

This commit is contained in:
Brian Sidebotham 2022-06-21 13:54:44 +01:00 committed by Martin Atkins
parent 7feef1c4aa
commit 7dd199cbd0
2 changed files with 10 additions and 8 deletions

View File

@ -528,15 +528,16 @@ func (c *FmtCommand) trimNewlines(tokens hclwrite.Tokens) hclwrite.Tokens {
func (c *FmtCommand) Help() string {
helpText := `
Usage: terraform [global options] fmt [options] [DIR]
Usage: terraform [global options] fmt [options] [TARGET]
Rewrites all Terraform configuration files to a canonical format. Both
configuration files (.tf) and variables files (.tfvars) are updated.
JSON files (.tf.json or .tfvars.json) are not modified.
If DIR is not specified then the current working directory will be used.
If DIR is "-" then content will be read from STDIN. The given content must
be in the Terraform language native syntax; JSON is not supported.
If TARGET is not specified then the current working directory will be
used. If TARGET is a file, only that file will be used. If TARGET is
"-" then content will be read from STDIN. The given content must be in
the Terraform language native syntax; JSON is not supported.
Options:

View File

@ -45,12 +45,13 @@ and the generated files.
## Usage
Usage: `terraform fmt [options] [DIR]`
Usage: `terraform fmt [options] [TARGET]`
By default, `fmt` scans the current directory for configuration files. If
the `dir` argument is provided then it will scan that given directory
instead. If `dir` is a single dash (`-`) then `fmt` will read from standard
input (STDIN).
a directory is provided for the `target` argument then it will scan that
given directory instead. If `target` is a file then `fmt` will process just
that file, and if a single dash (`-`) then `fmt` will read from standard input
(STDIN).
The command-line flags are all optional. The list of available flags are: