core specifications of the struct functions

First version of  specifications.  Its only the core and shoud be reviewed next time.