Update api documentation

I am removing the tag because I have updated the two items mentioned originally in the issue.

What's left here now is: review and update doxygen docblocks when it's applicable.

Related commits added upstream:

• Issue #1291904: Update api documentation for entity CRUD hooks.
• Issue #1291904: Remove deprecated hooks from documentation file.
• Issue #1291904: First round of updates to the example fakevcs backend module.

Just added docs for hook_versioncontrol_code_arrival()

This will be unblocked when we removed enough unrelevant code.

Thanks for the new documentation :-) I've added it to both 7.x-1.x and 6.x-2.x branches.

I forgot one thing, IMHO is important. We provide an example backend module(versioncontrol_fakevcs), which I initially clean up a little because of this issue, but it is still a little far from being functional/complete.
A good idea could be add an info file on local development to find out what is missing, the next step could be to check versioncontrol_git implementation to remember what we are missing there.

Update: Also it's a good idea is to look at the test backend, which is updated with main code.

I opened a new topic branch called doc-d7, and it has some tweaking on the current documentation. Current commits there:

c840acd Issue #1291904 follow-up: Moves the backend module to an examples directory.
3d30df0 Issue #1291904 follow-up: Adds a note about 7.x-1.x branch to README.
7f3a208 Issue #1291904 follow-up: Removes unmaintained changelog file.
5d18753 Issue #1291904 follow-up: Removes documentation of dead hook_versioncontrol_authorization_methods().
61f0a0e Issue #983926 follow-up: Removes unused repository authorization_method.
34f8ba7 Issue #1291904 follow-up: Fixes typo.
ab7667b Issue #1291904 follow-up: Updates doxygen configuration file.
fb70423 Issue #1291904 follow-up: Removes OOP_TODO moving useful information elsewhere.

It still needs what is mentioned on comment 9, moving to NR for testbot (I'm making a minor schema change to clean an old non-used field and be sure it's not used anywhere).

The backend code seems to be good enough now, but I am adding one more thing before rebasing/merging this topic branch into mainline: Provide an example reposync plugin.

154e392 Issue #1291904 follow-up: Adds event and its controller class to the example backend implementation.
ed79fdd Issue #1291904 follow-up: Adds hook_schema for example backend module.
a450f86 Issue #1291904 follow-up: Minor documentation block formatting.
f18e3ad Issue #1291904 follow-up: Adds info file for example backend module.
2c1261c Issue #1291904 follow-up: Start an example reposync plugin for fake backend module, unfinished.

After thinking on this a little more, I decided to separate the last bit on a different issue: #2009948: Provide an example reposync plugin, which should not block a stable release.

See added commits:

2903862 Issue #1291904 follow-up: Moves the backend module to an examples directory.
f975352 Issue #1291904 follow-up: Documentation files tweaking.
612ca59 Issue #1291904 follow-up: Minor documentation block formatting.
c3fd5f4 Issue #1291904 follow-up: Documentation updates on example backend module.

Also I added another not-completely-related one(relevant in the sense of better documentation is also about removing unused information):
4df6600 Issue #983926 follow-up: Removes unused repository authorization_method.

Then, marking NW for D6 version of this last set of patches.

Let testbot agree before actually adding this commit series.

Minor changes reflected in commit comments:

• Port hook_update_N() to D6.
• Do not add the note about 7.x-1.x branch to README.

Added to 6.x-2.x