HTCondorWiki: Experimental Custom Print Formats

 where =<file>= has the following syntax:
 
 {code}
-SELECT [BARE | NOTITLE | NOHEADER | NOSUMMARY] [LABEL] [SEPARATOR <string>] [RECORDPREFIX <string>] [FIELDPREFIX <string>] [FIELDSUFFIX <string>]
-    <expr> [AS <string>] [PRINTF <format-string> | PRINTAS <function-name> | WIDTH [AUTO | [-]<INT>] ] [TRUNCATE] [LEFT | RIGHT] [NOPREFIX] [NOSUFFIX]
+SELECT [BARE | NOTITLE | NOHEADER | NOSUMMARY] [LABEL [SEPARATOR <string>]] [<record-sep>]
+    <expr> [AS <label>] [PRINTF <format-string> | PRINTAS <function-name> | WIDTH [AUTO | [-]<INT>] ] [TRUNCATE] [LEFT | RIGHT] [NOPREFIX] [NOSUFFIX]
     ... repeat the above line as needed...
 [WHERE <constraint-expr>]
 [GROUP BY <sort-expr> [ASCENDING | DECENDING] ]
 [SUMMARY [STANDARD | NONE]]
 {endcode}
-
-*: Lines beginning with # are comments
-*: escapes such as \n and \t are translated for most <string> arguments.
-*: <strings> may be wrapped in " or ',  but can't contain imbedded quotes of the same type as the outer quote, (the parser currently doesn't support escaping of quotes).
-*: if no quotes are used around <string> arguments, the first whitespace ends the argument.
-*: statements end at a newline, there is no line-continuation character.
-<expr> arguments may be wrapped in quotes like strings with the same rules applying regarding nested strings.
+where
+*: =<string>= is a string, delimited by either space, ' or "
+*: =<record-sep>= is one or more of =RECORDPREFIX <string>, RECORDSUFFIX <string>, FIELDPREFIX <string>, or FIELDSUFFIX <string>=
+*: =<expr>= is a Classad expression that extends from the start of the line until the first keyword (usually =AS=).
+*: =<label>= is a =<string>= used as a column heading, or as an item label when the =LABEL= keyword is used on the =SELECT= line.
+*: =<format-string>= is a printf format specifier
+*: =<function-name>= is the name of a formatting function
+*: =<constraint-expr>= is a Classad expression that extends to the end of the line.
+*: =<sort-expr>= is a Classad expression that extends to the next keyword.
+*: Lines beginning with =#= are comments
+*: Keywords are case sensitive, all uppercase and require whitespace on either side.
+*: Escapes such as =\n= and =\t= are translated for most =<string>= arguments.
+*: =<string>= may be wrapped in " or ',  but can't contain imbedded quotes of the same type as the outer quote, because the parser currently doesn't support escaping of quotes.
+*: If a =<string>= does not start with a single or double quote, then it is whitespace delimited.
+*: Statements end at a newline, there is no line-continuation character.
 *: =GROUP BY= currently only controls sorting, the code does not yet do any kind of aggregating.
 *: =PRINTAS=, =PRINTF= & =WIDTH= are not entirely mutually exclusive, but more than one will play strangely together,  there's actually a bunch of "intelligence" in the pretty printer code regarding the correct way to format strings vs numbers that's not desirable here but can't be disabled, you may need to play with combinations of formatting options to get things to line up perfectly.  for instance negative WIDTH statements and the LEFT keyword _should_ be interchangeable, but they aren't at present.
-Available keywords for PRINTAS can be found only in the code. search for CustomFormatFnTable, you should find one table in queue.cpp and one in prettyPrint.cpp (for condor_status).
-*: be aware that many PRINTAS functions are very special case and pay little or no attention to the attribute that they are told to print.
+*: Available keywords for =PRINTAS= can be found only in the code. search for =CustomFormatFnTable=, you should find one table in queue.cpp and one in prettyPrint.cpp (for condor_status). Many =PRINTAS functions are very specialized and pay little or no attention to the attribute that they are told to print.  =DATE=, =TIME=, and =QDATE= are well behaved, but most of the others aren't.
 
 You can set the default output of condor_status and/or condor_q to use one of these files by setting config parameters:
 
@@ -162,7 +169,6 @@
 
 {code}
 # status summary output for partitionable slots (8.1.6 or later for some fields)
-# assumes that the STATISTICS_WINDOW_SECONDS for the STARTD is set to 1200
 SELECT
    Machine              AS Machine   WIDTH -32 TRUNCATE
    strcat(OpSysAndVer,"_x",substr(Arch,-2))  AS Platform WIDTH -8