indent: fix 'blank line above first statement in function body'

indent: implement 'blank line above first statement in function body'

indent: properly store parser state in debug mode

The stacks in the parser state are allocated now and need to be copied
individually.

The test whether two paren stacks are equal was broken since 2023-06-14
14:11:28.

indent: miscellaneous cleanups

No binary change.

indent: merge lexer symbols for type in/outside parentheses

indent: add debug output for typedef declarations

indent: don't force a blank line between '}' and preprocessing line

indent: rename a field of the parser state

The previous name 'comment_in_first_line' was misleading, as it could
mean that there was a comment in the first line of the file.

No functional change.

indent: rename state variable to be more accurate

No binary change.

indent: clean up the code, add a few tests

indent: clean up array indexing for parser symbols

With 'top' pointing to the actual top element, the array was indexed in
the closed range from 0 to top. All other arrays are indexed by the
usual half-open interval from 0 to len.

No functional change.

indent: allow more than 20 nested parentheses or brackets

indent: clean up debugging code

indent: clean up handling of comments

One less moving part in the parser state.

No functional change.

indent: remove another flag from parser state

When processing a comment, the flag ps.next_col_1 was not used for the
next token, but for a line within a comment. As its scope was limited
to a single comment, there is no need to store it any longer than that

No functional change.

indent: remove a redundant flag from the parser state

No functional change.

indent: merge parser symbols for stmt and stmt_list

They were handled in exactly the same way.

indent: rename misleading variable

The name started with 'line_start', but the value is not always the
value from the beginning of the line.

No functional change.

indent: fix debug output

When the parser state was first printed, there were unintended diff
markers. Treat the previous lexer symbol like the other parts of the
parser state, as omitting it from the diff output is confusing.

indent: fix line break between semicolon and brace

indent: miscellaneous cleanups

indent: clean up function names, fix blank lines in debug output

indent: distinguish blank lines from newline characters

indent: clean up debug output

In diff mode, don't print a diff of the very first parser state, instead
print its full state.

Don't print headings for empty sections of the parser state.

indent: clean up function and variable names

indent: explain right-aligned code

indent: rename and sort variables in parser state

No functional change.

indent: sync debug information for lexer symbols

indent: don't treat function call expressions as cast expressions

indent: when an indentation is ambiguous, indent one level further

The '-eei' mode now applies whenever the indentation from a multi-line
expression could be confused with a following statement.

indent: remove fragile heuristic for detecting cast expressions

The assumption that in an expression of the form '(a * anything)', the
'*' marks a pointer type was too simple-minded.

For now, fix the obvious cases and leave the others for later. If
needed, they can be worked around using the '-T' option.

indent: extract the stack of parser symbols to a separate struct

No functional change.

indent: send all debug output to the same stream

indent: sort functions in call order

No functional change.

indent: improve layout of debug output

indent: sync debug output with parser state

indent: remove read pointer from buffers that don't need it

The only buffer that needs a read pointer is the current input line in
'inp'.

No functional change.

indent: track the kind of '{' on the parser stack

indent: fix debug output of the parser symbol stack

Even though the stack always contains a stmt_list as first element,
print it nevertheless to avoid confusion about starting at index 1, and
to provide the full picture.

indent: rename struct field, for better symmetry

No binary change outside debug mode.

lint: use separate lexer symbols for 'case' and 'default'

It's not strictly necessary since these tokens behave in the same way,
still, the code is more straight-forward when there are separate tokens.

indent: classify 'inline' as a modifier rather than a word

indent: use separate lexer symbols for the different kinds of ':'

indent: handle the indentation of 'case' in a simpler way

indent: separate code for handling parentheses and brackets

Handling parentheses is more complicated than for brackets.

indent: clean up

Only print the 'token' buffer in debug mode if it is interesting, group
the blocks in handling of '(' tokens by topic, remove obsolete comment
from test.

indent: fix formatting of declarations with preprocessing lines

indent: fix indentation of struct declarations

indent: split debug output into paragraphs

The paragraphs separate the different processing steps: getting a token
from the lexer, processing the token, updating the parser state, sending
a finished line to the output.

indent: fix spacing in declarations in for loops

indent: implement suppressing optional blank lines

indent: extract the output state from the parser state

The parser state depends on the preprocessing lines, the output state
shouldn't.

indent: implement blank line above block comment

indent: implement blank line after function body

indent: implement blank lines around conditional compilation

indent: add debug logging for brace indentation

No functional change outside debug mode, as the initialization of
di_stack[0] was redundant.

indent: manually wrap overly long lines

No functional change.

indent: switch to standard code style

Taken from share/misc/indent.pro.

Indent does not wrap code to fit into the line width, it only does so
for comments. The 'INDENT OFF' sections and too long lines will be
addressed in a follow-up commit.

No functional change.

indent: fix indentation in preprocessor line

No binary change.

indent: allow comments in column 1 to be formatted

indent: remove support for form feed characters inside a line

Form feeds are occasionally used to split code into pages, and this use
is still supported. Having a form feed in the middle of a line is
exotic.

indent: clean up detection of whether parentheses form a cast

No functional change.

indent: indent multi-line conditions

No functional change.

indent: document feature toggle for debugging output

indent: move debugging code to separate file

No functional change.

indent: clean up memory and buffer management

Remove the need to explicitly initialize the buffers. To avoid
subtracting null pointers or comparing them using '<', migrate the
buffers from the (start, end) form to the (start, len) form. This form
also avoids inconsistencies in whether 'buf.e == buf.s' or 'buf.s ==
buf.e' is used.

Make buffer.st const, to avoid accidental modification of the buffer's
content.

Replace '*buf.e++ = ch' with buf_add_char, to avoid having to keep track
how much unwritten space is left in the buffer. Remove all safety
margins, that is, no more unchecked access to buf.st[-1] or appending
using '*buf.e++'.

Fix line number counting in lex_word for words that contain line breaks.

No functional change.

indent: implement 'blank after declarations'

indent: use enum instead of magic numbers for tracking declarations

No functional change.

indent: add debug logging for enum token classification

indent: move debugging code to separate file

No functional change.