Tweaked man page format
This commit is contained in:
parent
d540a98d33
commit
78d9a7ad97
3
Makefile
3
Makefile
|
@ -17,7 +17,8 @@ shellcheck.1: shellcheck.1.md
|
||||||
pandoc -s -t man $< -o $@
|
pandoc -s -t man $< -o $@
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -f .tests shellcheck *.hi *.o ShellCheck/*.hi ShellCheck/*.o
|
rm -f .tests shellcheck shellcheck.1
|
||||||
|
rm -f *.hi *.o ShellCheck/*.hi ShellCheck/*.o
|
||||||
rm -rf dist
|
rm -rf dist
|
||||||
|
|
||||||
regardless:
|
regardless:
|
||||||
|
|
|
@ -28,32 +28,34 @@ corner cases can cause delayed failures.
|
||||||
|
|
||||||
: Explicitly exclude the specified codes from the report. Subsequent **-e**
|
: Explicitly exclude the specified codes from the report. Subsequent **-e**
|
||||||
options are cumulative, but all the codes can be specified at once,
|
options are cumulative, but all the codes can be specified at once,
|
||||||
coma-separated as a single argument.
|
comma-separated as a single argument.
|
||||||
|
|
||||||
|
Also note that shellcheck supports multiple Bourne shell dialects, and
|
||||||
|
examines the file's shebang to determine which one to use.
|
||||||
|
|
||||||
# FORMATS
|
# FORMATS
|
||||||
|
|
||||||
**tty**
|
**tty**
|
||||||
|
|
||||||
: This is the default format, a plain text output. If your terminal handles
|
: Plain text, human readable output. This is the default.
|
||||||
colors, messages are printed with a different color depending on their
|
|
||||||
types (error, warnings etc). You get a pretty terminal frontend.
|
|
||||||
|
|
||||||
**gcc**
|
**gcc**
|
||||||
|
|
||||||
: This format outputs messages similar to those from gcc.
|
: GCC compatible output. Useful for editors that support compiling and
|
||||||
|
showing syntax errors.
|
||||||
|
|
||||||
`<file>:<line>:<column>: <type>: <message>`
|
For example, in Vim, `:set makeprg=shellcheck\ -f\ gcc\ %` will allow
|
||||||
|
using `:make` to check the script, and `:cnext` to jump to the next error.
|
||||||
|
|
||||||
|
<file>:<line>:<column>: <type>: <message>
|
||||||
|
|
||||||
**checkstyle**
|
**checkstyle**
|
||||||
|
|
||||||
: Checkstyle is a development tool to help programmers write Java code that
|
: Checkstyle compatible XML output. Supported directly or through plugins
|
||||||
adheres to a coding standard. Checkstyle reports are XML files that can
|
by many IDEs and build monitoring systems.
|
||||||
be integrated with a wide range of tools from text editors to continuous
|
|
||||||
integration platforms.
|
|
||||||
|
|
||||||
```
|
<?xml version='1.0' encoding='UTF-8'?>
|
||||||
<?xml version='1.0' encoding='UTF-8'?>
|
<checkstyle version='4.3'>
|
||||||
<checkstyle version='4.3'>
|
|
||||||
<file name='file'>
|
<file name='file'>
|
||||||
<error
|
<error
|
||||||
line='line'
|
line='line'
|
||||||
|
@ -64,17 +66,15 @@ corner cases can cause delayed failures.
|
||||||
...
|
...
|
||||||
</file>
|
</file>
|
||||||
...
|
...
|
||||||
</checkstyle>
|
</checkstyle>
|
||||||
```
|
|
||||||
|
|
||||||
**json**
|
**json**
|
||||||
|
|
||||||
: Json is a popular serialization format that is more suitable for web
|
: Json is a popular serialization format that is more suitable for web
|
||||||
applications. ShellCheck's json is compact and contains only the strict
|
applications. ShellCheck's json is compact and contains only the bare
|
||||||
minimum.
|
minimum.
|
||||||
|
|
||||||
```
|
[
|
||||||
[
|
|
||||||
{
|
{
|
||||||
"line": line,
|
"line": line,
|
||||||
"column": column,
|
"column": column,
|
||||||
|
@ -83,8 +83,7 @@ corner cases can cause delayed failures.
|
||||||
"message": message
|
"message": message
|
||||||
},
|
},
|
||||||
...
|
...
|
||||||
]
|
]
|
||||||
```
|
|
||||||
|
|
||||||
# SEE ALSO
|
# SEE ALSO
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue