general command line arguments
This are switches that don’t really belong in any other section.
| general.class | Nitpick class values. |
| general.classic | Report all classes used, not just those in CSS files. |
| general.cgi -W | Check environment variables for snippets of HTML. ssc expects environment variables as produced by OpenBSD’s native httpd, produced using <FORM METHOD=GET…>. Do NOT let ssc anywhere near untrusted data. Ignores many options such as shadowing. |
| general.custom EL | Define a custom element <EL> for verifying the IS attribute. May be repeated. |
| general.datapath dir -C dir | Look for any configuration, caches, and other useful files, in this directory. |
| general.defthrd n -Y n | If general.thread is not given, then set the number of threads to n. |
| general.error x -E | If nits of the specified category or worse are generated, then, on exit, return an error code. Values are: ‘catastrophe’, ‘abhorrent‘, ‘error’ (the default), ‘warning’, ‘info’, or ‘comment’. |
| general.exclude xxx | Ignore all paths containing xxx. May be repeated. Case independent under Windows only. .DS_Store is always excluded under darwin. |
| general.file XXX | File for persistent data. See also general.datapath. Default extension: .ndx. |
| general.ignore EL | ignore attributes and content of the element <EL>. May be repeated. |
| general.info | Report launch context when starting. |
| general.lang LA | If an X/HTML file does not have a language / dialect specified (e.g. “en” for standard English, “en-IE” for Irish English, “lb-LU” for Luxembourgish, “ma” for Marain, etc.), default to “LA”. If not given, the default is your system default, or, if none, then “en-US”. |
| general.maxfilesize n | Do not process HTML source files that exceed n bytes in size (default: 4M). Specify 0 for unlimited, although be warned that ssc is stunningly stupid in such circumstances and may even attempt to load files bigger than available memory. |
| general.output file -o file | Output to the specified file. If this switch is not used, standard output is used. |
| general.progress -D | Dump progress information to standard output. This can interfere with formatted output. |
| general.rdfa | Check RDFa attributes. |
| general.rel | Only mention <LINK> REL values, found neither in the living standard nor at microformats.org, in debug output. |
| general.rpt | Report CSS files that are opened. |
| general.sloven | Ignore perfectly legal yet inefficient, indeed thoroughly slovenly, HTML, such as being far too lazy to bother to get round to closing elements. |
| general.spec -j | Reset the values of most switches to false. |
| general.ssi -I | Process Server Side Includes (SSIs). Note ssc cannot process SSIs directives with formulae. Processing SSIs may cause incorrect line numbers to be mentioned when an issue is reported. |
| general.test -T | Output data in automated test format. Used by ssc-test. Not generally useful. Documented so you can avoid using it! |
| general.thread N -y N | Use N threads when running. Defaults to a value appropriate for the hardware. Too high a value can cause problems. See also general.defthrd. |
| general.vcs | Excludes, as per general.exclude, files and directories called: .bazaar, .bk, CVS, .cvsignore, _darcs, .fslckout, .git, .gitattributes, .gitignore, .gitmodules, .pijul, RCS, SCCS, & .svn |
| general.verbose x -v x | Output nits to the specified verbosity: ‘catastrophe’, ‘abhorrent’, ‘error’, ‘warning’, ‘info’ (the default), ‘comment’, or ‘0’ for silence. Additional values are available when debugging. Each level includes its preceding level, so, for example, ‘warning’ will also output ‘catastrophe’, ‘abhorrent’, and ‘error’ nits. |
Dylan Harris
December 2024