Comparision between 4' and 5' TParagraph

Questions welcome ...

>> Do you mean that par.next also retrieves the nested paragraphs? Or are these nested paragraphs skipped in the loop?

Yes, exactly. The functions 'next' and 'prev' retrieve the logical next or previous paragraph - children paragraphs always come first. After the last inner child the paragraph which follows the parent paragraph is the next. The function 'next' is processeed quite quickly, 'prev' can be a bit slower since the last inner child of the previous paragraph must be sometimes located in a loop.

PrevPar and NextPar are the regular link references to siblings. These properties are are writeable. So if you want to move a paragraph, You can simply assign it to the NextPar or PrevPar of a different paragraph. This will only move this paragraph (+ children), not the siblings. To also move those paragraphs You can use
the function UnlinkParagraphList to get a 'free floating paragraph list'.
To move a paragraph into the previous paragraph use the function AsChildOfPreviousPar.