doc - a note on proxy.mapping - closes #738