[development] important reminder: do not use API functions inupdate code

[Gábor Hojtsy]

On Dec 4, 2007 5:07 PM, Daniel F. Kudwien <news at unleashedmind.com> wrote:
> Just curious: Wouldn't it make sense to move all _old_ API functions as stub
> functions into a new update_api.inc (or similar named file) that is only
> included by update.php?
>
> Example:
>
> function menu_rebuild() {
>   ...calls to new API functions...
> }
>
> So we wouldn't loose version-hopping and would probably get a nice overview
> of old API functions along with their new replacements. If properly
> documented with phpdoc blocks, this *could* be a neat replacement for our
> module update handbook pages.

Sun, this does not solve anything, as you would still need these
versioned by update number. In system_update_77655() the database
behind the menu_rebuild() you would call might easily be different to
the database behing system_update_77658() - three updates later.

Gabor