Features

Files
file	gnc-features.h
	Utility functions for file access.

Functions
gchar *	gnc_features_test_unknown (QofBook *book)
void	gnc_features_set_used (QofBook *book, const gchar *feature)

Defined features
#define	GNC_FEATURE_CREDIT_NOTES   "Credit Notes"
#define	GNC_FEATURE_NUM_FIELD_SOURCE   "Number Field Source"
#define	GNC_FEATURE_KVP_EXTRA_DATA   "Extra data in addresses, jobs or invoice entries"

Detailed Description

Function Documentation

void gnc_features_set_used	(	QofBook *	book,
		const gchar *	feature
	)

Indicate that the current book uses the given feature. This will prevent older versions of GnuCash that don't support this feature to refuse to load this book.

Definition at line 131 of file gnc-features.c.

{
    const gchar *description;

    g_return_if_fail (book);
    g_return_if_fail (feature);

    gnc_features_init();

    /* Can't set an unknown feature */
    description = g_hash_table_lookup (features_table, feature);
    if (!description)
    {
        PWARN("Tried to set unknown feature as used.");
        return;
    }

    qof_book_set_feature (book, feature, description);


}

gchar* gnc_features_test_unknown

(

QofBook *

book

)

Test if the current book relies on features only introduced in a more recent version of GnuCash.

Returns a message to display if we found unknown features, NULL if we're okay.

Definition at line 96 of file gnc-features.c.

{

    GList* features_list = NULL;
    GHashTable *features_used = qof_book_get_features (book);

    /* Setup the known_features hash table */
    gnc_features_init();

    /* Iterate over the members of this frame for unknown features */
    g_hash_table_foreach (features_used, &gnc_features_test_one,
                          &features_list);
    if (features_list)
    {
        GList *i;
        char* msg = g_strdup(_("This Dataset contains features not supported "
                               "by this version of GnuCash. You must use a "
                               "newer version of GnuCash in order to support "
                               "the following features:"
                             ));

        for (i = features_list; i; i = i->next)
        {
            char *tmp = g_strconcat(msg, "\n* ", i->data, NULL);
            g_free (msg);
            msg = tmp;
        }

        g_list_free(features_list);
        return msg;
    }

    return NULL;
}