add blank time support; docs improved