new segment type: inline #3
Description
Example:
... some code ...
# .INLINE
Some documentation which is directly pertinent to this code, but which also needs to wind up in the generated reST
# .ENDOC
... more code ...
The trouble lies in how exactly to handle .INLINE type blocks, since if we wanted to just append the text to the top-level .SCRIPTDOC segment, we would have to buffer the .SCRIPTDOC segment in memory until EOF is reached.
Alternatively, .INLINE segments could be accumulated, concatenated, and added to the output after EOF is reached, and thus displayed under a section header along the lines of "Further Notes".