This directory (bin/unix/freedesktop) provides configuration files for
FreeDesktop-compliant user interfaces like Gnome.  The files establish
several mime types for Renew drawings and provide a launcher to be
integrated into menus or the desktop.

The files are provided without any warranty.

The files have been created by an ambitious user within the Gnome 2.14
desktop.

Installation of these files has to be done according to the guidelines from
the Gnome System administration guide, Sections "Desktop Files" and "Mime
Types".

The basic steps are listed here for your convenience, but without warranty:

1. Copy the file renew.xml to the packages folder of your MIME database.
  For a system-wide installation, this might be either
  /usr/local/share/mime/packages or /usr/share/mime/packages,
  for a user-local installation, this is probably
  ~/.local/share/mime/packages.

2. Copy the icon file application-x-renew.png to the icon database:
  /usr/local/share/icons, /usr/share/icons or ~/.local/share/icons,
  respectively.  You should choose an appropriate subdirectory
  like  .../icons/<theme-name>/48x48/mimetypes/ .
  The default theme name is "hicolor".

3. Initiate an update of the mime database, for example
  # update-mime-database /usr/share/mime
  or
  % update-mime-database ~/.local/share/mime

4. Copy the file Renew.desktop to the desktop applications database:
  /usr/local/share/applications, /usr/share/applications or
  ~/.local/share/applications, respectively.

  Probably the line starting with "Exec=" in the Renew.desktop file has to
  be edited to include the full path to the renew application start script
  in the uplevel directory (bin/unix).

5. Copy the icon file renew.png from the uplevel directory (bin/unix) to
  the icon database (see above).

6. Initiate an update of the desktop database (no path needed):
  % update-desktop-database

Steps 1 to 3 make Renew drawing files known to the file manager and other
Gnome applications.  Steps 4 to 5 integrate the Renew application to the
application launch menu.  In combination with step 6 they allow to open
drawing files in the Renew application by double clicking the file in the
file manager.
However, each drawing file will be opened in an individual Renew instance.

Quick command line
------------------
Install for a user-local configuration (to be executed from the
.../bin/unix/freedesktop directory):

# Step 1.
mkdir -p ~/.local/share/mime/packages
cp -i renew.xml ~/.local/share/mime/packages

# Steps 2. and 5.
mkdir -p ~/.local/share/icons/hicolor/48x48/mimetypes
cp -i application-x-renew.png ~/.local/share/icons/hicolor/48x48/mimetypes/

cp -i ../renew.png ~/.local/share/icons/hicolor/

# Step 4.
mkdir -p ~/.local/share/applications
cp -i Renew.desktop ~/.local/share/applications/

# Step 3. and 6.
update-mime-database ~/.local/share/mime
update-desktop-database

# Link renew script to ~/bin, since most distributions include this path automatically.
cd ..
bash installrenew
mkdir -p ~/bin
ln -s `pwd`/renew ~/bin/
