backward compatibility notes for documentation; better lib code