add docs for POLKIT_[BEGIN|END]_DECLS and also add POLKIT_GNUC_DEPRECATED
add docs for POLKIT_[BEGIN|END]_DECLS and also add POLKIT_GNUC_DEPRECATED

krytarowski/polkit,krytarowski/polkit,magcius/polkit,Distrotech/polkit,krytarowski/polkit,krytarowski/polkit,Distrotech/polkit,Distrotech/polkit,Distrotech/polkit,Distrotech/polkit,Distrotech/polkit,magcius/polkit,cgwalters/polkit,magcius/polkit,cgwalters/polkit,cgwalters/polkit,cgwalters/polkit,magcius/polkit,magcius/polkit,krytarowski/polkit,cgwalters/polkit