[pacman-dev] DRAFT: API changes for pacman-3.5

[Allan McRae]

This is a draft for the README file update for pacman-3.5.

I have flagged two areas that I am not particularly clear at what 
happened.  I would be great if the people involved in those changes 
could make the appropriate adjustments.

Allan


API CHANGES BETWEEN 3.4 AND 3.5
===============================

[REMOVED]
- alpm_db_register_local()
- alpm_pkg_has_force()

[CHANGED]
- interface to pkgcache
   - alpm_db_get_pkgcache() returns pmpkghash_t
   - alpm_db_get_pkgcache_list() can be used to get an alpm_list_t
     interface to the pmpkghash_t
- alpm_trans_cb_progress type had some types changed from int to size_t


## HELP!!!
- these changes...
     -int alpm_sync_target(char *target);
     -int alpm_sync_dbtarget(char *db, char *target);
     -int alpm_add_target(char *target);
     -int alpm_remove_target(char *target);
     +int alpm_add_pkg(pmpkg_t *pkg);
     +int alpm_remove_pkg(pmpkg_t *pkg);


## HELP!!!
- alpm_deptest() is replaced by the more flexibile alpm_find_satisfier()
     -int alpm_depcmp(pmpkg_t *pkg, pmdepend_t *dep);
      alpm_list_t *alpm_checkdeps(alpm_list_t *pkglist, int reversedeps,
                     alpm_list_t *remove, alpm_list_t *upgrade);
     -alpm_list_t *alpm_deptest(pmdb_t *db, alpm_list_t *targets);
     +pmpkg_t *alpm_find_satisfier(alpm_list_t *pkgs, const char 
*depstring);
     +pmpkg_t *alpm_find_dbs_satisfier(alpm_list_t *dbs, const char 
*depstring);


- size_t used for alpm_list_t sizes
   - return type for alpm_list_count()
   - parameter type in alpm_list_msort() and alpm_list_nth()

[ADDED]
- pmpkghash_t struct
- alpm_option_get_checkspace(), alpm_option_set_checkspace()
- alpm_find_grp_pkgs()
- alpm_trans_get_flags()
- error codes:
    PM_ERR_DISK_SPACE, PM_ERR_WRITE
- flags
    PM_TRANS_FLAG_NODEPVERSION, PM_TRANS_EVT_DISKSPACE_START,
    PM_TRANS_EVT_DISKSPACE_DONE, PM_TRANS_CONV_SELECT_PROVIDER,
    PM_TRANS_PROGRESS_DISKSPACE_START, PM_TRANS_PROGRESS_INTEGRITY_START