and again some documetnaion clrifications