Deprecates usage of #pid in favor of #id.
The method is defined in ActiveFedora::FedoraAttributes and includedin ActiveFedora::Base.
Replaces references to "pid" in other method names and comments with "id".

Closes #407.
Merge pull request #537 from afred/407-deprecate-pid

Deprecates usage of #pid in favor of #id.