iconcatalogedit(1)					    iconcatalogedit(1)

NAME    [Toc]    [Back]

     iconcatalogedit, iconbookedit - alter contents of icon catalog pages

SYNOPSIS    [Toc]    [Back]

     /usr/sbin/iconcatalogedit (-add | -remove)	iconstring (-syspage |
     -userpage)	pagename

DESCRIPTION    [Toc]    [Back]

     iconcatalogedit modifies the contents of an existing iconcatalog(1) page
     by	adding icons to	it or removing icons from it.  The icon	to be added or
     removed is	specified by the iconstring.  Here is an example of a "File"
     iconstring:

     "Category:File Name:/usr/sbin/jot"

     The pagename is the string	seen on	the tabs at the	bottom of the
     iconcatalog(1) window.  For example, "Applications", "Collaboration", and
     "Demos" are all pagenames.	 A page	is either a -syspage shared by all
     users or a	-userpage local	to a user.  If an icon is added	to a nonexistent
 page, a new page will be created.

     For more information about	the entire IRIX	Interactive Desktop
     environment, see the IID(1) man page.

EXAMPLES    [Toc]    [Back]

     iconcatalogedit -add "Category:File Name:/usr/local/bin/myapp" -syspage
     Applications

NOTES    [Toc]    [Back]

     You must have write permission to the directories where the page files
     are kept.

     The internal format of the	iconcatalog(1) files has changed since IRIX
     6.2 and is	not guaranteed to remain constant between releases.

FILES    [Toc]    [Back]

     /usr/lib/desktop/iconcatalog/pages/C/<page>	 sys  pages
     $HOME/.desktop-<hostname>/iconcatalog/pages/<page>	 user pages

     /usr/lib/desktop/iconbook/syspages/<page>		 obsolete sys  pages
     $HOME/.desktop-<hostname>/iconbook/<page>		 obsolete user pages

SEE ALSO    [Toc]    [Back]

     iconcatalog(1), IID(1)

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, iconcatalogedit will return a value of	0,
     otherwise a value of -1 will be returned.






									Page 1






iconcatalogedit(1)					    iconcatalogedit(1)



     If	the -remove option is specified	and the	page or	icon does not exist,
     iconcatalogedit will return as if successful.

     Removing icons from the new format	pages will attempt to remove every
     icon that references iconstring for that page.  If	at least one reference
     icon can not be successfully removed, a value of -1 will be returned,
     otherwise it will return a	value of 0.


									PPPPaaaaggggeeee 2222