extend C interaction docs to show how to cpdef an external C function

--HG--
extra : amend_source : d2906987d10e7770ca09dde406219fb0d6a5d38c
slightly update "sharing declarations" section
fix typo
update "external C code" docs