STLFilt Command-Line Option Overview

Command-Line Options are case-insensitive, and may be prefixed by either '/' or '-'.
All quotation marks shown below are for readability only and must not be used in commands!

Default
Value

/width:nn
Set output text maximum line length

Will wrap message lines at column nn.
Required for /meta or /break

/lognative
Log native compiler's messages

Text is written to NativeLog.txt in the current working directory.
(For STLFilt debugging purposes only)

/banner:x
Control display of STLFilt sign-on banner

'x' may be 'Y' or 'N'.
Forced to N by the Proxy compilers, which display their own banners instead

/iter:x
Specify iterator policy

'x' may be:
'L' (Long): NEVER shorten fully qualified iterator type
'M' (Medium): USUALLY shorten it (but same as 'S' on some platforms)
'S' (Short): ALWAYS shorten it

/func:x
Specify functor policy

'x' may be:
'L' (Long): leave default functor info intact
'S' (Short): strip all default functor information

/plg
Specify we're processing a .PLG file

Useful when running from an MSVC "Tool" in conjunction with a batch file, such as the provided MFiltTool.BAT

/break:x
Break algorithm selection

'x' may be:
'D' ("Dave Abrahams") or 'P' ("Plain", the default).
"Dave" mode wraps long complex typenames in a way that makes it easier to see the nesting structure of parameter lists. This is most beneficial for types typical of template metaprogramming apps.
"Plain" mode simply applies some minimal aesthetic rules to choose the points at which to wrap

MSVC:
P

gcc:
D

/cbreak:x
Select "comma wrap" policy

'x' may be:
'B' (break before commas, the default) or 'A' (break after commas).
Applies in /break:D mode only

/closewrap:x
Select wrap policy w.r.t. closing delimiters

'x' may be:
'Y' (wrap before unmatched closing delimiters, the default) or 'N' (don't).
Applies in /break:D mode only

/meta:x
Select whether to auto-configure for long typename wrapping

'x' may be:
'Y' (or just /meta) forces /break:D, and also forces /cbreak and /closewrap settings as per the $meta_y_cbreak and $meta_y_closewrap script variables.

'N' forces /break:P (so /cbreak and /closewrap don't apply)

MSVC:
N

gcc:
Y

/nullarg:xxx
Add xxx (a fully-qualified type name) to the list of "null argument" names stripped when appearing as trailling items in a template argument list.

If 'xxx' is 'clear', the list of "null type names" is cleared.

See Perl script

/cand:x
Select template candidate policy

'x' may be:
'L' (long) or 'Y': Retain candidate list.
'M' (medium): Suppress candidates, but announce how many were suppressed
'S' (short) or 'N': completely ignore candidate list

/path:x
Select long pathname policy

'x' may be:
'L' (long) or 'Y': Retain entire pathname in all cases
'S' (short) or 'N': Discard all except base filename from pathnames

NOTE: Use 'L' if you rely upon your IDE to locate errors across multiple source files

/hdr:x or /hdr:nn
Specify Standard Library header error suppression policy

'x' may be:
'L' (long) or 'Y": Retain all messages referring to standard header files
'M' (medium): Retain only the first (by default) of each cluster of header messages
'S' (short) or 'N': Discard all message referring to standard header files

A numeric value 'nn' forces /hdr:M and tells how many messages (nn) to emit from each cluster.

In all cases, the number of messages suppressed from each cluster is announced by the Decryptor.

gcc:
LD2

others:
M

/hdr variations specific to gcc:
Activate backtrace re-ordering

/hdr:LD or /hdr:LD1 ("Dave Abrahams" long re-ordering mode 1): move actual error msg to front of instantiation backtrace

/hdr:LD2 ("Dave Abrahams" re-ordering mode 2): as above, plus duplicate the trigger line so it also appears before the backtrace

/with:x
'With' clause substitution policy

'x' may be:
'L' (long): Do not process 'with" clauses by substituting full template parameter types for the placeholders
'S' (short): Do process the "with" clauses

/showback:x
Specify backtrace display policy

'x' may be:
'Y' to show backtraces (also see /hdr:LDx above)
'N' to fully suppress all backtraces