ROX-Filer/src/appinfo.c

   1 /*
   2  * $Id$
   3  *
   4  * ROX-Filer, filer for the ROX desktop project
   5  * Copyright (C) 2005, the ROX-Filer team.
   6  *
   7  * This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU General Public License as published by the Free
   9  * Software Foundation; either version 2 of the License, or (at your option)
  10  * any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful, but WITHOUT
  13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  15  * more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along with
  18  * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
  19  * Place, Suite 330, Boston, MA  02111-1307  USA
  20  */
  21
  22 /* appinfo.c - querying the XMLwrapper.xml files */
  23
  24 /* Any valid application directory may contain a file called XMLwrapper.xml.
  25  * The format is:
  26  *
  27  * <?xml version="1.0"?>
  28  * <AppInfo>
  29  *   <Summary>Tooltip text</Summary>
  30  *   <About>
  31  *     <Purpose>...</Purpose>
  32  *     <Version>...</Version>
  33  *     <Authors>...</Authors>
  34  *     <License>...</License>
  35  *     <Homepage>...</Homepage>
  36  *     ...
  37  *   </About>
  38  *   <AppMenu>
  39  *     <Item option="...">
  40  *       <Label xml:lang='en'>...</Label>
  41  *     </Item>
  42  *     ...
  43  *   </AppMenu>
  44  *   <ROX:CanSetBackdrop/>
  45  * </AppInfo>
  46  */
  47
  48 #include "config.h"
  49
  50 #include <string.h>
  51
  52 #include "global.h"
  53
  54 #include "appinfo.h"
  55 #include "fscache.h"
  56 #include "type.h"
  57 #include "diritem.h"
  58 #include "support.h"
  59 #include "xml.h"
  60
  61 /****************************************************************
  62  *                      EXTERNAL INTERFACE                      *
  63  ****************************************************************/
  64
  65 /* Load the XMLwrapper file for this application.
  66  *
  67  * Returns a pointer to the XMLwrapper structure, or NULL if this isn't
  68  * an application with a valid XMLwrapper file.
  69  *
  70  * g_object_unref() the result.
  71  */
  72 XMLwrapper *appinfo_get(const gchar *app_dir, DirItem *item)
  73 {
  74         XMLwrapper      *ai;
  75         guchar  *tmp;
  76
  77         /* Is it even an application directory? */
  78         if (item->base_type != TYPE_DIRECTORY ||
  79                         !(item->flags & ITEM_FLAG_APPDIR))
  80                 return NULL;    /* Not an application */
  81
  82         tmp = g_strconcat(app_dir, "/" APPINFO_FILENAME, NULL);
  83         ai = xml_cache_load(tmp);
  84         g_free(tmp);
  85
  86         return ai;
  87 }