XdgUtils

The following 335 words could not be found in the dictionary of 15 words (including 15 LocalSpellingWords) and are highlighted below:

0install   3rd   about   About   absolutely   add   address   adjust   against   all   allow   allowing   allows   along   also   Although   an   And   and   any   application   applications   are   area   arguments   as   ascii   assist   assume   at   automatically   available   be   been   Best   breaks   broad   bug   bugreporting   bugs   bundle   but   by   can   causing   certain   cgi   Changelog   Changes   charge   chosen   co   code   come   command   commonly   complete   compliant   components   composer   configuration   consisting   consists   contains   control   copy   could   create   custom   customer   customers   descriptions   Desktop   desktop   details   developers   differences   directory   distributed   Do   documentation   down   download   Download   Ds   during   easily   easy   email   emial   en   end   enhance   enter   environment   Even   expect   experience   export   F8   failures   fallback   feed   Feedback   feedback   file   Finally   first   focus   focuses   following   For   for   force   Free   free   from   further   generally   give   half   handling   hard   has   have   html   icon   icons   if   If   improving   in   include   included   including   independent   information   initiative   Install   install   installation   installed   installer   instead   integrate   integration   into   Introduction   invoking   is   Is   issue   issues   it   It   items   joint   just   Let   let   license   License   licensed   like   limited   line   Linux   list   listinfo   lists   locales   look   mail   mailing   mailinglist   mailman   mailto   make   management   manual   may   mentioned   menu   method   mime   mktemp   more   myapp   mycompany   name   necessary   needs   net   new   News   Non   non   not   Note   now   obsolete   obtain   of   older   on   only   open   operating   or   original   other   output   Overview   package   pages   part   particular   party   path   place   platforms   please   Please   post   preferred   product   program   project   provide   provided   providers   provides   purpose   putting   query   questions   Questions   quickly   R9266   re   recommend   related   required   resource   resources   result   running   runtime   same   say   screensaver   script   scripts   See   send   set   Several   shell   shipped   simple   So   software   source   specific   Spurious   stable   stdout   still   stripped   strongly   suite   supported   syntax   system   systems   tasks   test   tgz   than   That   that   The   the   their   them   then   Then   these   this   This   through   to   tool   tools   tuned   type   types   Ubuntu   under   usage   use   used   useful   user   users   Using   using   util   variety   ve   vendors   version   versions   via   view   want   way   We   we   webcvs   when   while   wiki   wikipedia   will   wish   with   without   work   writing   xml   You   you   your   Zero  

Clear message

Introduction

Portland is a joint OSDL/Freedesktop.org initiative to provide independent software developers (ISDs) with stable APIs into Desktop Linux and other Free Desktop platforms. The first result of the Portland initiative is Xdg-utils, a free set of open source tools that allows applications to easily integrate with the desktop configuration your customer has chosen to work with.

News

xdg-utils-1.0.2 is now available.

Xdg-utils

Xdg-utils is a set of command line tools that assist applications with a variety of desktop integration tasks. About half of the tools focus on tasks commonly required during the installation of a desktop application and the other half focuses on integration with the desktop environment while the application is running. Even if the desktop components of your application are limited to an installer, configuration or management tool, Xdg-utils provides you with an easy way to enhance the usage experience of your customers by improving the integration of these components in the user's environment. Best of all, Xdg-utils is provided as open source and free of charge.

Overview

Xdg-utils consists of the following installation related tools:

It also contains the following runtime integration tools:

License

Xdg-utils is licensed under the open source MIT license. See the License file for details.

Download

A complete version of Xdg-utils, including documentation and test suite is available as xdg-utils-1.0.2.tgz in the download area.

A stripped down version consisting only of the tools and their manual pages is available as xdg-utils-1.0.2-scripts.tgz This version is useful if you want to include the tools along with your application.

The stripped-down version is also available as a Zero Install feed, allowing your program to download it automatically if required.

Using Xdg-utils

Although we expect that these scripts will generally come as part of the operating system, we recommend that you package the scripts that your application needs along with your product as a fallback. For this purpose please obtain the original version of the xdg-utils from http://portland.freedesktop.org. The xdg-utils scripts that are distributed by operating systems vendors may have been tuned for their particular operating system and may not work on the same broad variety of operating systems as the original version.

We recommend that you place these scripts in a directory, and then add that directory to the end of the PATH. So, let's say that you're writing your post installation script, and you want to create a menu on any xdg-util compliant environment. Let's further assume that you've just installed to $INSTALL_DIR, and that your menu desktop file is in $INSTALL_DIR/mycompany-myapp.desktop. Finally, let's say that you've included the xdg-utils package in your installation in $INSTALL_DIR/xdg-utils. 

  export PATH=$PATH:$INSTALL_DIR/xdg-utils/scripts
  xdg-desktop-menu install $INSTALL_DIR/mycompany-myapp.desktop

Note that we strongly recommend using this method - that is, putting your copy of the xdg-utils at the end of the path, and then invoking them without a specific path name.

That will allow your users and their system providers to use custom versions of the xdg-utils to adjust for system specific differences.

If you wish to absolutely force the issue and only use the versions you shipped, you could instead hard code the path to the version you bundle with your application. We strongly recommend against this, as it will make your product obsolete more quickly than is necessary.

Changelog

Changes in xdg-utils 1.0.2:

Changes in xdg-utils 1.0.1:

Feedback and Questions

You can give feedback on the Portland project through the freedesktop.org bugreporting system or via the Portland mailinglist Please use the mailing list for any questions you may have.