Openwindows Reference Manual
Total Page:16
File Type:pdf, Size:1020Kb
OpenWindows Reference Manual Sun Microsystems, Inc. 2550 Garcia Avenue Mountain View, CA 94043 U.S.A. 1994 Sun Microsystems, Inc. All rights reserved. 2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A. This product and related documentation are protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or related documentation may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Portions of this product may be derived from the UNIX and Berkeley 4.3 BSD systems, licensed from UNIX Systems Laboratories, Inc., a wholly owned subsidiary of Novell, Inc., and the University of California, respectively. Third-party software, including font technology, in this product is protected by copyright and licensed from Sun's Suppliers. RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and FAR 52.227-19. This product or the products described herein may be protected by one or more U.S., foreign patents, or pending applications. TRADEMARKS Sun, Sun Microsystems, the Sun Logo, SunSoft, Sun Microsystems Computer Corporation and Solaris, are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and certain other countries. UNIX is a registered trademark of Novell, Inc., in the United States and other countries; X/Open Company, Ltd., is the exclusive licensor of such trademark. OPEN LOOK is a registered trademark of Novell, Inc. All other product names mentioned herein are the trademarks of their respective owners. All SPARC trademarks, including the SCD Compliant Logo, are trademarks or registered trademarks of SPARC International, Inc. SPARCstation, SPARCserver, SPARCengine, SPARCstorage, SPARCware, SPARCcenter, SPARCclassic, SPARCcluster, SPARCdesign, SPARC811, SPARCprinter, UltraSPARC, microSPARC, SPARCworks, and SPARCompiler are licensed exclusively to Sun Microsystems, Inc. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun Graphical User Interfaces were developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license agreements. X Window System is a product of the Massachusetts Institute of Technology. THIS PUBLICATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THE PUBLICATION. SUN MICROSYSTEMS, INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANY TIME. Portions AT&T 1983-1990 and reproduced with permission from AT&T. OpenWindows 3.4 Misc. Reference Manual Pages Intro ( 1OW ) NAME Intro − introduction to the OpenWindows Reference Manual OVERVIEW The Solaris computing environment can be functionally divided into two large sub- components: the operating system and the windowing system. This Reference Manual describes the commands and utility programs which make up OpenWindows 3.4, the windowing system included with Solaris 2.4. The Solaris operating system commands are described in the SunOS Reference Manual. The OpenWindows Reference Manual consists of all the OpenWindows man pages included with the SUNWaman software package, other than those from Section 3. There are 187 man pages in this manual, most of which belong to Section 1 and describe general-purpose User commands. There are a few man pages which describe System Administration commands (Section 1M), and 28 man pages from Section 6, Games & Demonstration Programs. The SVR4 classi®cation system for on-line man pages differs slightly from the BSD system, and so a few commands that used to belong in Section 5 have been moved to Section 4, which describes ®le formats. Not included in this manual are 764 man pages from Section 3, pages that describe functions and libraries. They can be accessed on systems with the SUNWaman package by using the man(1) command. For information on how to add a package see pkgadd(1). Since OpenWindows is based on the X11 display system, many of these man pages come directly from those included with X11R5 and have been modi®ed only to correct path- name changes. For example, the pathname for /usr/lib/X11/Xinitrc has been changed to /usr/openwin/lib/Xinitrc. Several man pages in this manual come from Adobe Systems; they too have been edited only to correct for pathnames changes. The original formatting has been modi®ed in order to give all pages a consistant appearance but no wording changes have been made except where strictly necessary. In addition to man pages which describe the X server (which include the DPS pages from Adobe Systems), this manual includes man pages about the DeskSet utility programs such as Calendar Manager and Printtool, as well as pages about AnswerBook, the Class- ing Engine, and ToolTalk. Name Command Description 24to8(1) convert a 24- or 32-bit raster®le to an 8-bit raster®le suitable for X11 ab_admin(1) administer AnswerBook card catalog database(s) ab_cardcatalog(4) directory of available AnswerBooks ab_library(4) collection of AnswerBooks browsed and searched as a unit accessx(1) graphical interface to the accessx keyboard enhancements. answerbook(1) browse, search, and view on-line documentation modi®ed 10 June 1994 1 Intro ( 1OW ) Misc. Reference Manual Pages OpenWindows 3.4 appres(1) list application resource database atobm(1) See bitmap(1) audiocontrol(1) audio control panel audiotool(1) audio play/record tool bdftopcf(1) convert font from Bitmap Distribution Format to Portable Com- piled Format bdftosnf(1) BDF to SNF font compiler for X11 binder(1) modify deskset bindings database bitmap(1) bitmap editor and converter utilities for the X Window System bldrgb(1) simple interface to the rgb(1) utility bmtoa(1) See bitmap(1) calctool(1) a desktop calculator ce_db_build(1) build a Classing Engine database from an ASCII description of the database or generate an ASCII description ®le of a CE database ce_db_merge(1) merge new information into a Classing Engine database from an ASCII description of the new information clock(1) display the time in an icon or window cm(1) calendar manager, appointment and resource scheduling tool cmap_alloc(1) allocate default colormaps for non-default visuals cmap_compact(1) colormap con®guration utility to reduce colormap ¯ashing. cmdtool(1) run a shell (or other program) in an OpenWindows enhanced ter- minal window cm_delete(1) delete appointments from Calendar Manager database cm_insert(1) insert appointments into Calendar Manager database cm_lookup(1) look up appointments from Calendar Manager database CoEd(6) a ToolTalk-based shared editor colorchooser(1) change icon colors in deskset tools constype(1) print type of Sun console convert_to_Xdefaults(1) convert SunView1 defaults into equivalent Xdefaults convert_to_xview(1) convert a SunView1 source program to XView source digestp(1) See mailp(1) docviewer(1) OpenWindows viewer for AnswerBook on-line documentation dps(7) Display PostScript imaging for the X Window System dpsexec(6) Display PostScript Executive dsdm(1) Drop Site Database Manager 2 modi®ed 10 June 1994 OpenWindows 3.4 Misc. Reference Manual Pages Intro ( 1OW ) ds_server_init(1) store a property in the X11 server to reduce colormap ¯ashing within the DeskSet applications editres(1) a dynamic resource editor for X Toolkit applications edit_demo(6) ToolTalk client/server demonstration programs ®lemgr(1) a GUI-based ®le management application ®lep(1) See mailp(1) ®lofaxp(1) See mailp(1) ®sh_props(6) See realx®shdb(6) ®xframe(1) convert FrameMaker 2.0 PostScript ®les to conform to the PostScript structuring conventions ®xinterleaf(1) convert Interleaf PostScript ®les to conform to the PostScript struc- turing conventions fmgc(1) a program to garbage collect a users Ä/.fm directory hierarchy format_¯oppy(1) diskette formatting program used by FileManager franklinp(1) See mailp(1) helpopen(1) utility for programmatically controlling helpviewer helpviewer(1) OpenWindows viewer for on-line help handbooks ico(6) animate an icosahedron ico2(6) animate an icosahedron or other polyhedron iconedit(1) create and edit images for OpenWindows icons, cursors, and panel items imagetool(1) Image viewer for OpenWindows imake(1) C preprocessor interface to the make utility kbd_mode(1) change the keyboard translation mode keytable.map(4) maps keyboard type and layout to keytable listres(1) list resources in widgets locale_env(1) locale_env - program for openwin-sys mailp(1) frontends to the mp PostScript pretty printer mailprint(1) ®lter to strip out mail message attachments mailtool(1) OpenWindows interface for the mail program makebdf(1) create bitmap ®les from scalable F3 or X11/NeWS font ®les makedepend(1) create