issue #19 docu for PWS