upgraded doc: some formating