qulogic/libgnt

Deprecate several internal structs/functions.
release-2.x.y
2019-05-14, Elliott Sales de Andrade
f8b0df9a1ddf
Parents ee2ed7d0e332
Children bdffa2282280
Deprecate several internal structs/functions.

These should not have been in the public API.
5 files changed, 85 insertions(+), 7 deletions(-)
  • +18 -0
    gntbindable.h
  • +12 -2
    gntentry.h
  • +29 -5
    gntfilesel.h
  • +12 -0
    gnttree.h
  • +14 -0
    gntwm.h
    • --- a/gntbindable.h Tue May 14 00:26:21 2019 -0400
    +++ b/gntbindable.h Tue May 14 00:46:55 2019 -0400
    @@ -82,8 +82,20 @@
    typedef gboolean (*GntBindableActionCallback) (GntBindable *bindable, GList *params);
    typedef gboolean (*GntBindableActionCallbackNoParam)(GntBindable *bindable);
    +#ifndef GNT_DISABLE_DEPRECATED
    +/**
    + * GntBindableAction:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    typedef struct _GntBindableAction GntBindableAction;
    +/**
    + * GntBindableActionParam:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    typedef struct _GntBindableActionParam GntBindableActionParam;
    +#endif
    struct _GntBindableAction
    {
    @@ -100,6 +112,7 @@
    GList *list;
    };
    +#ifndef GNT_DISABLE_DEPRECATED
    /*GntBindableAction *gnt_bindable_action_parse(const char *name);*/
    /**
    @@ -107,6 +120,8 @@
    * @action: The bindable action.
    *
    * Free a bindable action.
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    void gnt_bindable_action_free(GntBindableAction *action);
    @@ -115,8 +130,11 @@
    * @param: The GntBindableActionParam to free.
    *
    * Free a GntBindableActionParam.
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    void gnt_bindable_action_param_free(GntBindableActionParam *param);
    +#endif
    /**
    * gnt_bindable_class_register_action:
    --- a/gntentry.h Tue May 14 00:26:21 2019 -0400
    +++ b/gntentry.h Tue May 14 00:46:55 2019 -0400
    @@ -49,8 +49,6 @@
    typedef struct _GntEntry GntEntry;
    typedef struct _GntEntryClass GntEntryClass;
    -typedef struct _GntEntryKillRing GntEntryKillRing;
    -typedef struct _GntEntrySearch GntEntrySearch;
    #ifndef GNT_DISABLE_DEPRECATED
    /**
    * GntEntryPriv:
    @@ -58,6 +56,18 @@
    * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    typedef struct _GntEntryPriv GntEntryPriv;
    +/**
    + * GntEntryKillRing:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    +typedef struct _GntEntryKillRing GntEntryKillRing;
    +/**
    + * GntEntrySearch:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    +typedef struct _GntEntrySearch GntEntrySearch;
    #endif
    typedef enum
    --- a/gntfilesel.h Tue May 14 00:26:21 2019 -0400
    +++ b/gntfilesel.h Tue May 14 00:46:55 2019 -0400
    @@ -47,7 +47,6 @@
    typedef struct _GntFileSel GntFileSel;
    typedef struct _GntFileSelClass GntFileSelClass;
    -typedef struct _GntFile GntFile;
    #ifndef GNT_DISABLE_DEPRECATED
    /**
    * GntFileSelPriv:
    @@ -55,6 +54,13 @@
    * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    typedef struct _GntFileSelPriv GntFileSelPriv;
    +/**
    + * GntFile:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail. Use #GFile
    + * from GIO for a similar abstraction.
    + */
    +typedef struct _GntFile GntFile;
    #endif
    /**
    @@ -97,6 +103,13 @@
    void (*gnt_reserved3)(void);
    };
    +#ifndef GNT_DISABLE_DEPRECATED
    +/**
    + * GntFileType:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail. Use #GFile
    + * from GIO for a similar abstraction.
    + */
    typedef enum _GntFileType
    {
    GNT_FILE_REGULAR,
    @@ -105,20 +118,25 @@
    struct _GntFile
    {
    - char *fullpath;
    - char *basename;
    - GntFileType type;
    - unsigned long size;
    + char *GNTSEAL(fullpath);
    + char *GNTSEAL(basename);
    + GntFileType GNTSEAL(type);
    + unsigned long GNTSEAL(size);
    };
    +#endif
    G_BEGIN_DECLS
    +#ifndef GNT_DISABLE_DEPRECATED
    /**
    * gnt_file_sel_get_gtype:
    *
    * Returns: GType for GntFileSel.
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    GType gnt_file_sel_get_gtype(void);
    +#endif
    /**
    * gnt_file_sel_new:
    @@ -230,6 +248,7 @@
    */
    void gnt_file_sel_set_read_fn(GntFileSel *sel, gboolean (*read_fn)(const char *path, GList **files, GError **error));
    +#ifndef GNT_DISABLE_DEPRECATED
    /**
    * gnt_file_new:
    * @name: The name of the file.
    @@ -238,6 +257,8 @@
    * Create a new GntFile.
    *
    * Returns: The newly created GntFile.
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    GntFile* gnt_file_new(const char *name, unsigned long size);
    @@ -248,8 +269,11 @@
    * Create a new GntFile for a directory.
    *
    * Returns: The newly created GntFile.
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    */
    GntFile* gnt_file_new_dir(const char *name);
    +#endif
    G_END_DECLS
    --- a/gnttree.h Tue May 14 00:26:21 2019 -0400
    +++ b/gnttree.h Tue May 14 00:46:55 2019 -0400
    @@ -54,14 +54,26 @@
    #endif
    typedef struct _GntTreeRow GntTreeRow;
    +#ifndef GNT_DISABLE_DEPRECATED
    +/**
    + * GntTreeCol:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    typedef struct _GntTreeCol GntTreeCol;
    +/**
    + * GntTreeColumnFlag:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    typedef enum _GntTreeColumnFlag {
    GNT_TREE_COLUMN_INVISIBLE = 1 << 0,
    GNT_TREE_COLUMN_FIXED_SIZE = 1 << 1,
    GNT_TREE_COLUMN_BINARY_DATA = 1 << 2,
    GNT_TREE_COLUMN_RIGHT_ALIGNED = 1 << 3,
    } GntTreeColumnFlag;
    +#endif
    /**
    * GntTree:
    --- a/gntwm.h Tue May 14 00:26:21 2019 -0400
    +++ b/gntwm.h Tue May 14 00:46:55 2019 -0400
    @@ -44,6 +44,12 @@
    #define GNT_IS_WM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GNT_TYPE_WM))
    #define GNT_WM_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GNT_TYPE_WM, GntWMClass))
    +#ifndef GNT_DISABLE_DEPRECATED
    +/**
    + * GntKeyPressMode:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    typedef enum _GntKeyPressMode
    {
    GNT_KP_MODE_NORMAL,
    @@ -51,6 +57,7 @@
    GNT_KP_MODE_MOVE,
    GNT_KP_MODE_WAIT_ON_CHILD
    } GntKeyPressMode;
    +#endif
    typedef struct _GntNode
    {
    @@ -64,11 +71,18 @@
    typedef struct _GntWM GntWM;
    +#ifndef GNT_DISABLE_DEPRECATED
    +/**
    + * GntPosition:
    + *
    + * Deprecated: 2.14.0: This is an internal implementation detail.
    + */
    typedef struct _GntPosition
    {
    int x;
    int y;
    } GntPosition;
    +#endif
    /**
    * GntAction: