coolicon.1

具有IDE功能的编辑器

.TH coolicon 1 "27 October 2001"
.\"SKIP_SECTION"
.SH NAME
coolicon-3.17.5 \- Icon manager with graphical icon configuration 
and drag and drop support. Written under the Coolwidget library.
.\"SKIP_SECTION"
.SH USAGE
.B coolicon 
[options]
.SH DESCRIPTION
.LP
.B Coolicon 
displays pixmap (.XPM) files as icons on the desktop. Each icon presents 
a menu (right-click) from where the user can perform various operations. 
Each icon has two user configurable scripts which are executed on 
recieving a drop event or on running the icon with a double-click. 
The icons scripts' as well as other properties can be modified through 
a dialog box accessable through each icon's menu. The scripts can directly 
manipulate a recieved drop event making it easy to program Trash Cans, 
Printer icons and so on. Several useful example icons are given.
.\".\"DONT_SPLIT"
.SH OPTIONS
.TP
.I "-d, -display <display>"
The X server and display you would like to display to.
.TP
.I "-w, --wait-for-display"
Most X programs exit with an error if the specified server refuses a connection, 
or is unavailable. This option causes 
.B coolicon 
to retry the server once every second until a connection is established. You 
can use this to start 
.B coolicon 
before starting the server. You must however set the 
.B DISPLAY 
environment variable (eg. `setenv DISPLAY localhost:0.0' or 
`DISPLAY=localhost:0.0 ; export DISPLAY') before-hand. The 
advantage of this is that you can use 
.B coolicon 
out of your startup scripts if you don't have access to them or don't 
know how to find them.
.TP
.I -M, --mail-name
If you specify this option, 
.B Coolicon 
will poll your mailbox at the default interval of once every 30 
seconds. If it finds that the mailbox has grown more than 80 
characters, it will bring up a 3D image of an `e' (remember 
`Disclosure' with Demi Moore). The `e' can be double-clicked on to 
remove it.
.TP
.I -s, -shape, --shape
Without this option, the `e' appears in a managed window. With this option 
the `e' floats without a window above the desktop. On slow systems, this 
causes a lot of flicker and CPU hogging. It looks really nice on a fast 
system though.
.TP
.I -S, --mail-seconds <seconds>
Set the number of seconds between polls of the mail box file. 
.TP
.I -e, --e-data <file-name>
Specify the file name of the data used to draw the `e'. Default 
is 
.BR ".../lib/coolicon/e.data".
.TP
.I -X, --size <pixels>
Specify the size of the `e' window to appear. Default is 150 pixels.
.TP
.I "-f, -fn, -font <font-name>"
The font you would like to use.
.TP
.I -h, -H, -?, --help
Print out commandline options summary.
.TP
.I -V, -v, --version
Print out version number.
.PP
.SH USAGE
Example:
.PP
.nf
.B coolicon --mail-name /var/spool/mail/mdouglas &
.fi
.PP
Envoking \fBcoolicon\fP will present the default icons onto the desktop.
These will initially be  `raised', meaning that they will be printed
above the other windows on the  screen. This is why you should start
\fBcoolicon\fP before starting other applications. To lower the icons,
right-click on the `Icon manager' icon, and select `Lower icons' from
the menu (each icon has a menu). You can move icons around the desktop
by dragging them with the left mouse button, and then selecting `Save
icons' from any of the icon's menus, to save their current positions.
Each icon performs two functions. Firstly, it can be executed by double
clicking with the left button (this will usually run the application
described by the icon). Secondly it can recieve drag and drop events
(for example, dropping text onto the `Print...' icon will run `lpr' and
print that text). An icon's actions are defined by two scripts which you
can edit by selecting `Edit icon...' from the icon's menu. The fields in
the `Edit icon' dialog are mostly self explanatory. The field `Prompt
before executing' is the text to be displayed if the `Prompt on drop' or
`Prompt on double click' option is on. Similarly with `Confirmation
Prompt'. These options cause the user to be asked for some option before
the script is executed. This option is passed to the script as `%a'. See
the `Print...' icon for an example.
.PP
The first thing that is interesting to experiment with is the
`Launch...' icon. When you double click on `Launch...' you will be
prompted for a file to execute, and a nice browser to find it if you
need to. Now if you drop a file-name onto the `Launch...' icon, its
script will interpret the file type and launch the appropriate
application. For instance, I have coded most image file extensions into
the script, so \fBxv\fP will be executed for image files. The list of
file types (C files, dvi files etc.) was off the top of my head, so
please email me with additions to the script. This way the launch icon
will eventually support a large number of extensions. A good idea would
be to run the \fBfile\fP program on the dropped file-name from within
the script and then interpret the result.
.PP
.SH CREATING YOUR OWN ICONS
This is easy to do using the `New icon...' menu option - just fill in all 
the fields. You may want to create your own pictures with some image editing 
program; if so, 
.B pixmap 
is ideal for manipulating small color images and is recommended. Be 
sure that the format is `.xpm' and not some other format. Some places 
where default XPM files may be stored on your system are: 
.BR "/usr/local/icons", 
.BR "/usr/icons", 
.BR "/usr/include/X11/pixmaps". 
Other icon packages may also have databases of useful XPM files - take a look
under 
.BR "ftp://sunsite.unc.edu/pub/Linux/X11/icon/". 
If the 
file-name you specify in the `Edit Icon' dialog box is not a full path-name
then the path 
.B /usr/local/lib/coolicon 
(or whatever prefix 
.B Coolicon 
was installed under) is prepended to the file-name.
.PP
.SH SCRIPT FILE SUBSTITUTIONS
The following `percent substitutions' are available for convenience when
writing script files. Take a look through the example script files 
(especially the `Launch...' icon) on the use of some of these.
.PP
.TP
.I %d
The current directory as set from the 
.B Change directory... 
menu item.
.TP
.I %f
If the icon recieved a drop, and that drop was of the `file' type. Then
\fI%f\fP contains the full file name of that file, without the path. The
next three substitutions refer to this file name.
.TP
.I %n
The file-name without the extension.
.TP
.I %x
The file-name extension only.
.TP
.I %p
The full path of the file-name without the trailing slash. eg. %p/%f is
the full path and file name.
.TP
.I %a
The string typed in by the user if they where prompted.
.TP
.I %F
The current font, or 8x13bold if the current font is a 
proportionally spaced font - use for terminal apps.
.TP
.I %O
The current font regardless.
.TP
.I %%
Inserts a literal %.
.TP
.I %T
A text string representing the type of the data dropped onto the icon. 
This will be one of the \fBToplevel MIME Types\fP eg, \fBapplication\fP,
\fBaudio\fP, \fBimage\fP, \fBtext\fP or \fBvideo\fP. \fI%T\fP will evaluate
to one of the types comma-listed for the icon. (Click on \fBEdit Icon\fP
in the Icons menu.)
.TP
.I %s
This is the counterpart to \fI%T\fP, its sub-type. \fI%T/%s\fP forms the
full mime type of the drop. Examples are \fBapplication/postscript\fP,
\fBapplication/postscript\fP, \fBaudio/x-wav\fP, \fBimage/jpeg\fP,
\fBtext/html\fP or \fBvideo/mpeg\fP.
.TP
.I %A
\fI%A\fP is the name of a file containing the data that was dropped. This
will be a file in the /tmp directory.
.PP
.SH UTILITIES
.B Coolicon 
is useful for making point-and-click versions of standard text utilities. 
The problem with text utilities is that there output won't be seen under 
most X environemts. This is especially problematic if the output is an 
error message. To display error messages, you can pipe error data 
into the \fBcoolmessage\fP command. Run \fBcoolmessage -h\fP to see
how it works, and then look at the `Print...' icon's scripts for
example usage. The \fBcoolbrowse\fP command is also useful for getting
files from the user from within scripts, run \fBcoolbrowse\fP for more
info. There are several other utilities in the same vein: \fBcoolinput\fP,
\fBcoolinput\fP, \fBcoollistbox\fP and \fBcoolquery\fP. For fun, try
.nf
    ps | sed -e 's/^[ ]*//g' -e 's/[ ][ ]*/,/g' | coollistbox -delim ','
.fi
.PP
.SH LICENSE
This program is distributed under the terms of the GNU General Public
License as published by the Free Software Foundation. See the file
COPYING in the source distribution for details on the License and the
lack of warranty. Alternatively see the 'About' menu of the 
.B Cooledit 
program.
.PP
.SH AVAILABILITY
The latest public release of this program can be found at sunsite.unc.edu
in the directory /pub/Linux/Incoming, or /pub/Linux/apps/editors/X. The
latest development version can be found at 
.BR "lava.obsidian.co.za", 
in the directory 
.BR "/pub/unix/cooledit", 
all by anonymous ftp. 
.B Coolicon 
is packed with the 
.B Cooledit 
distribution.
.SH SEE ALSO
cooledit(1), smalledit(1), coolman(1), xinit(1), pixmap(1).
.PP
.SH AUTHORS
Paul Sheer (psheer /AT/ icon.co.za)