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".
Example:
The trouble lies in how exactly to handle
.INLINEtype blocks, since if we wanted to just append the text to the top-level.SCRIPTDOCsegment, we would have to buffer the.SCRIPTDOCsegment in memory untilEOFis reached.Alternatively,
.INLINEsegments could be accumulated, concatenated, and added to the output afterEOFis reached, and thus displayed under a section header along the lines of "Further Notes".