version 2.26 date Tue Jun 3 13:44:57 EDT 2025 archive http://kinzler.com/ftp/faces/picons/src/apps-2.26.tar.Z APPS Scripts for the Picons Databases Steve Kinzler steve@kinzler.com http://kinzler.com/me/ This directory contains some application programs for using the picons databases with "faces", "xfaces" or other software that can invoke and display faces application interface programs. It also contains some system and personal customization and invocation front-ends to "faces" and "xfaces" which can more easily integrate the application programs and enhance the maintenance and functionality of "faces" and "xfaces". The applications include monitors for multiple print queues, the system mail queue, news and newsgroups, and weather forecasts and the display of picons databases or lists of mail addresses or newsgroups. This directory also contains some utilities for maintaining picons databases, scripts for generating an HTML weather report with picons, and web server extensions for providing a picons search service via HTTP, which can be used by "JavaFaces" and other web applicatons. At the top of each script, you'll find a short description of the program. Running most scripts with only a "-h" argument will produce a usage message. Any configuration you might want to change is also at the top of each script above the short description. For X11, "xfaces" is probably preferable over "faces" for most uses. Unlike "faces", it supports the color XPM picons and is more configurable. However, "faces" also supports SunView, XView and NeWS windowing systems and provides built-in print queue and login monitoring applications, where "xfaces" does not. To use these scripts: 1) Install this directory someplace on your system, such as /l/picons/apps. 2) If desired, install "faces" on your system. It can be found at http://kinzler.com/ftp/faces/faces/faces-*.tar.Z. The faces binary need not be installed in a directory in your PATH if you plan to use the faces front-end script provided here instead. Note that you can disregard the scripts subdirectory in the faces sources -- this apps directory entirely supersedes it. 3) If desired, install "xfaces" on your system. It can be found at http://kinzler.com/ftp/faces/xfaces/xfaces-*.tar.Z, with supporting software in the same directory. The xfaces binary need not be installed in a directory in your PATH if you plan to use the faces front-end script provided here instead. Append the XFaces file from this directory to the XFaces.ad app-defaults file installed for xfaces. 4) Install the picons databases you wish to use, for example, in /l/picons/db/{domains,misc,unknown,...}. They can be found in http://kinzler.com/ftp/faces/picons/db. Some of these applications expect the misc database in particular. 5) As needed, edit the configuration options at the top of each script in this directory for your needs and preferences. Be sure to correctly reference the installation locations you selected during the above steps. If your perl binary is not correctly referenced on the first line of the perl scripts, edit the Makefile with the proper path and run "make perl" in this directory. Sample script usage directly with "faces" and "xfaces" is given near the top of each *-faces application script, or, even better, you can invoke them via the faces front-end script. 6) Include this directory in your PATH or install the faces front-end script here somewhere in your PATH (eg, /usr/bin/X11/faces), or create a link somewhere in your PATH pointing to it here. See the faces script for more details and the options to use to invoke the various applications. You can also install/link the faces front-end script in your PATH under the name "xfaces" for a version that invokes xfaces by default. You may also wish to install/link the facesaddr and facesall scripts in your PATH for viewing address/newsgroup lists and picons databases. Again, they can be installed/linked as "xfacesaddr" and "xfacesall" for a different default. Front-end man pages for faces and xfaces are provided here as faces.1 and xfaces.1 if you wish to install these in place of the regular man pages. Make sure to edit them at the end to reference the correct path to the full man pages. 7) If you're not including this directory in your PATH, you might wish to install the lpqall, mailqto and wx scripts elsewhere, since they can be useful outside of faces usage. Also, the wx-html script here can be used to pregenerate weather forecast HTML pages for use on a web server. With the weather picons database also available on the server, the page can include a summary of the forecast using a table of picons. 8) If you wish to personally customize how you run faces, you can take a look at the facemon script here. It's what I use to invoke faces and xfaces in my personal environment and can be used as a template for your own version. It allows me to specify more custom applications with specific geometries all indexed by a simple keyword. You'll probably want to install your personalized facemon in your HOME bin. 9) If you're running a Plexus web server, the piconsearch.pl package here can be configured and installed as a module within it to provide a picons lookup service on the web like the one at , appropriate for use with "JavaFaces". Alternately but less efficiently, you can use the piconsearch CGI script here with most any web server. It still requires the piconsearch.pl package. Install these according to your web server's instructions and configuration. Note that certain functions of the service require a .index file at the root of each picons database. Official picons databases come with these files, and you can use the mkpiconsindex script here to create ones for your own databases. -------------------------------------------------------------------------- Unless otherwise noted within a file, the files in this directory are Copyright (c) 2025 Stephen B Kinzler. All rights reserved. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name Stephen B Kinzler not be used in advertising or publicity pertaining to distribution of this software without specific, written prior permission. THIS SOFTWARE IS PROVIDED `AS-IS'. STEPHEN B KINZLER DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT SHALL STEPHEN B KINZLER BE LIABLE FOR ANY DAMAGES WHATSOEVER, INCLUDING SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING LOSS OF USE, DATA, OR PROFITS, EVEN IF ADVISED OF THE POSSIBILITY THEREOF, AND REGARDLESS OF WHETHER IN AN ACTION IN CONTRACT, TORT OR NEGLIGENCE, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.