update Makefile
+ doc
adapt to interface changes