X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkappchooser.c;h=e4037d2c1e0fde5e9772b19c2218012dfa36c2e1;hb=c1218f964a8c541f8e82d42463be02a25eb36be9;hp=a517002cc69d145cadfb71348f95e4a51c819659;hpb=52711beba57239aadde460d49d492ef6951f9335;p=~andy%2Fgtk

diff --git a/gtk/gtkappchooser.c b/gtk/gtkappchooser.c
index a517002cc..e4037d2c1 100644
--- a/gtk/gtkappchooser.c
+++ b/gtk/gtkappchooser.c
@@ -14,9 +14,7 @@
  * Library General Public License for more details.
  *
  * You should have received a copy of the GNU Library General Public
- * License along with the Gnome Library; see the file COPYING.LIB.  If not,
- * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
  *
  * Authors: Cosimo Cecchi <ccecchi@redhat.com>
  */
@@ -25,11 +23,25 @@
  * SECTION:gtkappchooser
  * @Title: GtkAppChooser
  * @Short_description: Interface implemented by widgets for choosing an application
+ * @See_also: #GAppInfo
  *
  * #GtkAppChooser is an interface that can be implemented by widgets which
  * allow the user to choose an application (typically for the purpose of
  * opening a file). The main objects that implement this interface are
  * #GtkAppChooserWidget, #GtkAppChooserDialog and #GtkAppChooserButton.
+ *
+ * Applications are represented by GIO #GAppInfo objects here.
+ * GIO has a concept of recommended and fallback applications for a
+ * given content type. Recommended applications are those that claim
+ * to handle the content type itself, while fallback also includes
+ * applications that handle a more generic content type. GIO also
+ * knows the default and last-used application for a given content
+ * type. The #GtkAppChooserWidget provides detailed control over
+ * whether the shown list of applications should include default,
+ * recommended or fallback applications.
+ *
+ * To obtain the application that has been selected in a #GtkAppChooser,
+ * use gtk_app_chooser_get_app_info().
  */
 
 #include "config.h"