core changes patch file and documentation added