The OpenNET Project / Index page

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

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

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

dialog (1)
  • >> dialog (1) ( Solaris man: Команды и прикладные программы пользовательского уровня )
  • dialog (1) ( FreeBSD man: Команды и прикладные программы пользовательского уровня )
  • dialog (1) ( Linux man: Команды и прикладные программы пользовательского уровня )
  • dialog (3) ( FreeBSD man: Библиотечные вызовы )
  • Ключ dialog обнаружен в базе ключевых слов.
  • 
    NAME
         dialog - display dialog boxes from shell scripts
    
    SYNOPSIS
         dialog --clear
         dialog --create-rc file
         dialog [ --title title ] [ --clear ] box-options
    
    DESCRIPTION
         Dialog is a program that will let you to present  a  variety
         of  questions  or display messages using dialog boxes from a
         shell script. Currently, these types  of  dialog  boxes  are
         implemented:
    
         yes/no box, menu box, input box, message box, text box, info
         box, and checklist box.
    
    OPTIONS
         --clear
              The screen will be cleared to the screen  attribute  on
              exit.
    
         --create-rc file
              Since dialog supports run-time configuration, this  can
              be used to dump a sample configuration file to the file
              specified by file.
    
         --title title
              Specifies a title string to be displayed at the top  of
              the dialog box.
    
         Box Options
    
         --yesno text height width
              A yes/no dialog  box  of  size  height  rows  by  width
              columns will be displayed. The string specified by text
              is displayed inside the dialog box. If this  string  is
              too long to be fitted in one line, it will be automati-
              cally  divided  into  multiple  lines  at   appropriate
              places. The text string may also contain the sub-string
              "\n" or newline characters `\n' to control line  break-
              ing  explicitly.   This dialog box is useful for asking
              questions that require the user to answer either yes or
              no.   The  dialog box has a Yes button and a No button,
              in which the user can switch between  by  pressing  the
              TAB key.
    
         --msgbox text height width
              A message box is very similar to  a  yes/no  box.   The
              only  difference between a message box and a yes/no box
              is that a message box has only a single OK button.  You
              can  use  this  dialog  box  to display any message you
              like.  After reading the message, the  user  can  press
              the  ENTER key so that dialog will exit and the calling
              shell script can continue its operation.
    
         --infobox text height width
              An info box is basically a message  box.   However,  in
              this  case, dialog will exit immediately after display-
              ing the message to the user. The screen is not  cleared
              when  dialog  exits, so that the message will remain on
              the screen until the calling  shell  script  clears  it
              later.  This is useful when you want to inform the user
              that some operations are carrying on that  may  require
              some time to finish.
    
         --inputbox text height width
              An input box is useful when you want to  ask  questions
              that  require the user to input a string as the answer.
              When inputing the string, the BACKSPACE key can be used
              to correct typing errors. If the input string is longer
              than can be fitted in the dialog box, the  input  field
              will  be  scrolled.  On  exit, the input string will be
              printed on stderr.
    
         --textbox file height width
              A text box lets you display the contents of a text file
              in  a dialog box. It is like a simple text file viewer.
              The user  can  move  through  the  file  by  using  the
              UP/DOWN,  PGUP/PGDN and HOME/END keys available on most
              keyboards.  If the lines are too long to  be  displayed
              in  the  box, the LEFT/RIGHT keys can be used to scroll
              the text region  horizontally.  For  more  convenience,
              forward  and backward searching functions are also pro-
              vided.
    
         --menu text height width menu-height [ tag item ] ...
              As its name suggests, a menu box is a dialog  box  that
              can be used to present a list of choices in the form of
              a menu for the user to choose. Each menu entry consists
              of  a  tag string and an item string. The tag gives the
              entry a name to distinguish it from the  other  entries
              in  the  menu.  The  item is a short description of the
              option that the entry represents.  The  user  can  move
              between  the menu entries by pressing the UP/DOWN keys,
              the first letter of the tag as a hot-key, or the number
              keys  1-9.  There  are menu-height entries displayed in
              the menu at one time, but the menu will be scrolled  if
              there  are  more  entries than that. When dialog exits,
              the tag of the chosen menu entry  will  be  printed  on
              stderr.
    
         --checklist text height width list-
              height [ tag item status ] ...
              A checklist box is similar to a menu box in that  there
              are  multiple  entries presented in the form of a menu.
              Instead of choosing one entry among the  entries,  each
              entry  can be turned on or off by the user. The initial
              on/off state of each entry is specified by status.   On
              exit,  a  list of the tag strings of those entries that
              are turned on will be printed on stderr.
    
    RUN-TIME CONFIGURATION
         1.  Create a sample configuration file by typing:
    
                   "dialog --create-rc <file>"
    
         2.  At start, dialog determines the settings to use as  fol-
             lows:
    
             a)  if environment variable DIALOGRC is set, it's  value
                 determines the name of the configuration file.
    
             b)  if the file in (a) can't  be  found,  use  the  file
                 $HOME/.dialogrc as the configuration file.
    
             c)  if the file in (b) can't be found, use  compiled  in
                 defaults.
    
         3.  Edit the sample configuration file and copy it  to  some
             place that dialog can find, as stated in step 2 above.
    
    ENVIROMENT
         DIALOGRC       Define this variable if you want  to  specify
                        the name of the configuration file to use.
    
    FILES
         $HOME/.dialogrc     default configuration file
    
    DIAGNOSTICS
         Exit status is 0 if dialog is exited by pressing the Yes  or
         OK button, and 1 if the No or Cancel button is pressed. Oth-
         erwise, if errors occur inside dialog or dialog is exited by
         pressing the ESC key, the exit status is -1.
    
    BUGS
         Text files containing tab characters may cause problems with
         text  box.   Tab  characters  in  text  files  must first be
         expanded to spaces before being displayed by text box.
    
         Screen update is too slow.
    
    AUTHOR
         Savio Lam (lam836@cs.cuhk.hk)
    
    
    


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




    Спонсоры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

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