[flang] Added documentation explaining the use of std::list (flang-compiler/f18#988)

Original-commit: flang-compiler/f18@094f558907
Reviewed-on: https://github.com/flang-compiler/f18/pull/988
This commit is contained in:
David Truby 2020-03-12 16:38:59 +00:00 committed by GitHub
parent 3064bdcce9
commit 232711df35

View File

@ -164,7 +164,12 @@ Parse tree entities should be viewed as values, not objects; their
addresses should not be abused for purposes of identification. They are
assembled with C++ move semantics during parse tree construction.
Their default and copy constructors are deliberately deleted in their
declarations.
declarations.
The std::list<> data type is used in the parse tree to reliably store pointers
to other relevant entries in the tree. Since the tree lists are moved and
spliced at certain points std::list<> provides the necessary guarantee of the
stability of pointers into these lists.
There is a general purpose library by means of which parse trees may
be traversed.