Mega-commit to document the API with doxygen.

Some changes were made to the API when making the documentation:

- A few exported functions are now hidden, because they were only used
  internally in the library.
- A few exported symbols were renamed to document them better than
  previously.
- Cosmetic changes all along the way, as well as some fixes here and there.

--HG--
extra : convert_revision : xtraeme%40gmail.com-20100121021019-onbsivlrhdb7t3ou

lib/sortdeps.c

@@ -59,7 +59,7 @@ find_sorteddep_by_name(const char *pkgname)
 	return sdep;
 }
 
-int SYMEXPORT
+int HIDDEN
 xbps_sort_pkg_deps(prop_dictionary_t chaindeps)
 {
 	prop_array_t sorted, unsorted, rundeps;
@@ -149,7 +149,7 @@ again:
 				rv = EINVAL;
 				goto out;
 			}
-			pkgnamedep = xbps_get_pkgdep_name(str);
+			pkgnamedep = xbps_get_pkgpattern_name(str);
 			if (pkgnamedep == NULL) {
 				free(sdep);
 				rv = errno;