The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

Zharf (1)
  • >> Zharf (1) ( Solaris man: Команды и прикладные программы пользовательского уровня )
  • 
    NAME
         Zharf - the AfterStep button panel module
    
    
    SYNOPSIS
         Zharf [-f config_file] [-v | --version] [-h | --help]
    
         Although Zharf can be run from the command line, it is  nor-
         mally spawned by afterstep in the autoexec file, in the fol-
         lowing manner:
    
              Module    "I"  Zharf
              Wait      "I"  Zharf
    
         Wait is used to allow Zharf to swallow the apps specified in
         the  zharf file prior to afterstep starting other apps which
         use the same name.
    
         or from within an afterstep menu file by 'Zharf':
    
         % cat "~/GNUstep/Library/AfterStep/start/Modules/Zharf"
              Module "Zharf" Zharf
              MiniPixmap "mini-as.xpm"
    
         To stop the Zharf module, a menu item can be used:
    
         % cat "~/GNUstep/Library/AfterStep/start/Modules/Zharf_Stop"
              KillModuleByName "Stop Zharf" Zharf
              MiniPixmap "mini-as.xpm"
    
    
    DESCRIPTION
         The  Zharf   module   is   a   free   floating   application
         loader/button  panel  similar  to the Wharf that can execute
         programs or "Swallow" running programs,  but also displays a
         label  under  the icon (if specified).  Zwharf could also be
         used as simply a text version of  Wharf.   Folders  are  not
         supported.
    
         All mouse buttons  are  captured  to  initiate  the  command
         specified,  however some swallowed apps might capure certain
         mouse buttons for its use.
    
    
    OPTIONS
         -f config_file
              Use config_file instead of  the  default  configuration
              file.
    
    
         -h | --help
              Print a usage message and exit successfully.
    
         -v | --version
              Print version information and exit successfully.
    
    
    INITIALIZATION
         During initialization, Zharf will search for a configuration
         file  which  describes  the  button  panel  geometry, color,
         icons, and actions. This file will be the one  specified  by
         the      -f     option     (if     given).     Else,     the
         ~/GNUstep/Library/AfterStep/zharf file will be  used  if  it
         exists.    Else,  /usr/local/share/afterstep/zharf  will  be
         used.
    
         If the Zharf executable is linked to another name, ie 'ln -s
         Zharf OtherZharf', then another module called OtherZharf can
         be started, with a completely different  set  of  configura-
         tions  than  Zharf,  simply  by adding configuration options
         with the keywords *OtherZharf.  This way multiple Zharf pro-
         grams can be used. Note that the symlinked module can not be
         called Zharf<something>,  as  aftrestep  will  pressume  the
         standard Zharf binary.
    
    
    INVOCATION
         Zharf can be invoked from the autoexec file or from  a  menu
         item as shown in the Synopsis section above.
    
         AfterStep will search through the directories  specified  in
         the  ModulePath  configuration  in the base.#bpp (where # is
         your colordepth) to attempt to  locate  Wharf;  as  well  as
         searching  through the PixmapPath for the pixmaps & IconPath
         for the bitmaps supplied in the configuration options.
    
    
    CONFIGURATION OPTIONS
         Zharf reads the zharf file when it starts up and  looks  for
         it's configuration options:
    
    
         *ZharfGeometry geometry
              Specifies the Zharf window location and/or size. If the
              size is not specified, Zharf will auto-size itself in a
              reasonable manner.  The geometry is a standard X11 win-
              dow geometry specification.
    
    
         *ZharfFont font
              Specifies the font to be used for labeling the buttons.
    
    
         *ZharfRows rows
              Specifies the number of rows of buttons to be  created.
              If unspecified, 2 rows will be used.
    
    
         *ZharfColumns columns
              Specifies the  number  of  columns  of  buttons  to  be
              created.  If unspecified, the number of columns will be
              set to the number of buttons requested, divided by  the
              number  of *ZharfRows rows. If both *ZharfRows rows and
              *ZharfRows columns are specified, but do not specify as
              many  buttons  as  are  defined, then the users columns
              specification will be ignored.
    
    
         *ZharfFore color
              Specifies the color for button  label  text  and  mono-
              chrome icons.
    
    
         *ZharfBack color
              Specifies the color for the buttons.
    
    
         *Zharf[(WxH)] label icon command
              If the optional (WxH) is specified,  then  this  button
              will be W times the normal button width and H times the
              normal button height. NOTE: The entire  Zharf  will  be
              resized to W if vertically priented; or H if vertically
              oriented.
    
              The label field is what appears on the button  bar,  or
              below an icon; if an icon is used. If label is "-" then
              the button label will not be displayed.
    
              The icon field specifies an X11 bitmap file, XPM, JPEG,
              or  PNG  color icon file to display on the button. This
              icon will be  displayed  over  the  ZharfBackColor  and
              above the label.  Transparent icons are allowed.
    
              The command specifies an AfterStep built-in command (as
              described  in the afterstep man page). If command is an
              AfterStep Exec command, then  the  button  will  remain
              pushed  in  until  a window whose name or class matches
              the qouted portion of the command. This is intended  to
              provide  visual  feedback  to  the user that the action
              requested will be performed. If the quoted portion con-
              tains  no  characters,  then  the  button  will pop out
              immediately.  Note that user can continue pressing  the
              button,  and  re-executing  the  command,  even when it
              looks "pressed in."
    
    
    
              The following Zharf commands are available:
    
    
              Swallow "window-name" command
                   Causes Zharf to run  command,  capture  the  first
                   window  whose name or resource is window-name, and
                   display it in the associated button. The  applica-
                   tion  window will be shrunk to fit the size of the
                   button.
    
    
              MaxSwallow "window-name" command
                   Like Swallow, except the button will be resized to
                   fit the application.
    
    
              SwallowModule "window-name" command
                   Like Swallow, except the command is  an  AfterStep
                   module.
    
    
              MaxSwallowModule "window-name" command
                   Like MaxSwallow, except the command is  an  After-
                   Step module.
    
    
    FILES
         /usr/local/share/afterstep/zharf
              The global configuration file for system wide  defaults
              of all users.
    
    
         $HOME/GNUstep/Library/AfterStep/zharf
              This    file    should    be    copied     from     the
              /usr/local/share/afterstep/zharf and edited to suit the
              user's specific requirements.  This  file,  if  exists,
              will override the system wide default file.
    
    
         /usr/local/share/afterstep/base.[8|15|16|24|32]bpp
              Contains the IconPath & PixmapPath global settings  for
              the Zharf.
    
    
         $HOME/GNUstep/Library/AfterStep/base.[8|15|16|24|32]bpp
              This     file      should      be      copied      from
              the/usr/local/share/afterstep/base.[8|15|16|24|32]bpp
              and edited to suit the user's specific requirements for
              the IconPath & PixmapPath settings of the Wharf.
    
    
    
    EXAMPLES
         The zharf file shipped contains many examples, refer to  the
         CONFIGURATION  OPTIONS  section  above for its configuration
         options.
    
         To swallow the Pager module into the Zharf:
    
              *Zharf(4x1) - - SwallowModule "Pager" Pager 0 3
    
         This will captures the Pager into button that is 4 times the
         width of the other buttons. Since "-" is used for the button
         label and icon, the Pager will be resized to  fit  into  the
         button's borders.
    
         To have a button with a pixmap:
    
              *Zharf Doc AfterStep3.xpm Exec "-" afterstepdoc &
    
         Or with a bitmap and a label:
    
              *Zharf Raise Up Raise
    
         The "Up" is an X11 standard bitmap.
    
    
    
    AUTHORS
         Guylhem Aznar
         Robert Nation
         David Mihm <dmihm@swbell.net> [Man page]
    
    
    SEE ALSO
         afterstep(1), Wharf(1), Pager(1)
    
    
    
    


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру