fixed various bugs arising with links and broken links
added @ext attribute
mostly improved documentation