iconcatalog(1)

NAME
     iconcatalog, iconbook - pages on which to store any type of icon

SYNOPSIS
     iconcatalog [iconcatalogfile]

DESCRIPTION
     The iconcatalog (or iconbook) contains named pages which can store any
     type of icon, including files, folders, programs, printers, people,
     hosts, and tape and disk drives.

     Icons are stored in the catalog as references to the actual entities. If
     an icon is dragged onto an iconcatalog page, only a reference to the
     actual entity is kept on the page.  With the default IndigoMagic color
     scheme, blue iconcatalog pages can be distinguished easily from green
     icon views.

     The "Make Reference" operation on icons in the icon catalog will create
     new reference icons in the icon catalog.  To remove a reference icon, the
     user can click on the icon, then select the right-mouse menu Remove item;
     only the reference icon will be deleted--the original file will remain
     safely on the system.

     Any references (also called symbolic links) will be created in
     subdirectories under the user's local iconcatalog pages directory,
     $HOME/.desktop-<hostname>/iconcatalog/pages.

     An iconcatalog page can be a system page or an user page or a combination
     of the two.

     The files in /usr/lib/desktop/iconcatalog/pages/C define the contents of
     each default system page, such as Applications and Demos.  Icons in the
     default system pages can not be removed by the general user, because the
     reference icons (symbolic links) are installed on the system and owned by
     the special root user.  In this way, icons on the default system pages
     are protected from accidental removal.

     New blank pages can be created in the iconcatalog for storing user-chosen
     icons.  These new, user pages can be renamed, though the system's default
     pages (ex., Applications, Demos) can not be renamed.  The iconcatalog
     checks automatically to ensure that no two pages have the same name.

     The user can drag icons onto or delete reference icons from any page.
     Here, a combination of user and system page icons are presented. The user
     can remove unwanted icons straightforwardly, however, using the right-
     mouse or Selected menu "remove" operation.

     This application has the ``run-once'' feature, meaning only one instance
     of the application will run at one time.  Attempting to launch the
     application a second time will have the effect of deiconifying the
     application window or popping it to the top on the current desk.
     For more information about the entire IRIX Interactive Desktop
     environment, see the IID(1) man page.


FILES
     The iconcatalog remembers each page's layout--that is, each page's
     contents and mode of display. There are files named after the page and
     are located in the user's subdirectory $HOME/.desktop-
     <hostname>/iconcatalog/layouts.  These files record the current layout of
     each page.

     Upon upgrade from previous IRIX releases to IRIX 6.5, the old page
     information will be translated to the new formats and placed in the
     following new locations.  The old information will then be removed.

     In IRIX 6.5, the following locations are used by iconcatalog:
     $HOME/.desktop-<hostname>/iconcatalog/pages/<page name>
     $HOME/.desktop-<hostname>/iconcatalog/layouts/<page name>
     /usr/lib/desktop/iconcatalog/pages/<page name>
     /usr/lib/X11/app-defaults/IconCatalog

     The internal formats of all these files are not guaranteed to remain
     constant between releases.


SEE ALSO
     iconcatalogedit(1), IID(1)


KNOWN BUGS
     After removing or renaming a page, the ordering of pages in the Goto menu
     will be wrong, and the separator line between system and user pages will
     be lost.

     The captions under the icons cannot be displayed in languages other than
     English.