man.diff

来自「speech signal process tools」· DIFF 代码 · 共 413 行 · 第 1/2 页

"show header".  The former causes "play \-r1: " to be invoked on any
file whose file button is pressed; the latter causes "xtext psps -aD"
to be invoked (this results in a pop-up window with a full-history
header but no data).  If the default menu cannot be found,
\fIfbuttons\fP uses "play -r1:" and "xtext psps -aD" both as program
button labels and command strings.
.TP
.BI \-S " progmenu_file"
Specifies that program buttons be created from the file
\fIprogmenu_file\fP, with the button labels taken from the first
column in the file and the corresponding command strings taken from
the second column.  If blanks are needed in the button labels, use
quotes to surround the string in the first column (e.g., "Display
Header").  Do not use quotes in the command string unless they are
part of the command (you may have to escape them).  The
\fIprogmenu_file\fP format corresponds to a special case of \fIolwm\fP
and \fIsunview\fP menu files, namely single-level menus (no submenus).
Thus, a menu title line and certain other standard keywords can be
present, although they are ignored by \fIfbuttons\fP.  For more
information, see \fIolwm\fP(1) \- the manual page is included in the
ESPS distribution.
.TP
.BI \-M " mbuttons_file"
Specifies that a top panel be created with arbitrary screen buttons
defined by the menu file \fImbuttons_file\fP.  This ASCII file defines
button names and associated commands using the same format as menu
files for the OPEN LOOK window manager \fIolwm\fP (same as
\fIsunview\fP menu files).  If submenus are specified, they result in
menu buttons with pull-down menus.  The resulting button panel behaves
exactly the same as the independent button windows created by
\fImbuttons\fP (1\-\s-1ESPS\s+1).  For details, see the manual 
pages for \fImbuttons\fP (1\-\s-1ESPS\s+1) and \fIolwm\fP(1).  
.TP
.BI \-s " max_scroll_lines"
Specifies that a scrollable list be used in the bottom panel instead
of buttons, with \fImax_scroll_lines\fP being the number visible.  A
scrollable list cannot be used if a \fIfile_menu\fP is specified
(\fB-F\fP).
.TP
.B \-a 
Specifies that the file names obtained from the command line and from
the \fB-R\fP option be sorted in alphabetical order.  Sorting does not
apply to the button names derived from a \fIfile_menu\fP (\fB-F\fP
option).  
.TP
.BI \-b " but_per_row \fR[10]\fP"
Specifies the number of file buttons per row and is also used to
adjust the geometry of the program toggle buttons.  If
\fIbut_per_row\fP is set to 1, for example, a single column of buttons
will result.  
.TP
.BI \-q " quit_button \fR[1]\fP"
If zero, inhibits the "QUIT" button from the program panel.  If the
\fIunix\fP environment variable BBOX_QUIT_BUTTON is defined, this
results in a "QUIT" button being added to every panel even if
\fIquit_button\fP is 0.  The main reason for providing global control
via BBOX_QUIT_BUTTON is to facilitate usage on systems with window
managers that do not provide an independent means for killing windows.
.TP
.BI \-Q " quit_label" \fR[QUIT]\fP"
If a "QUIT" button is included (see \-\fBq\fP), the \fIQ\fP option
specifies the label shown on the button.  This option has no effect if
there there is not a quit button.  
.TP
.BI \-l " quit_command"
If a "QUIT" button is included, this option may be used to provide a
command that is to be executed prior to quitting.  Any Unix command
can be given as the argument of the \-\fBl\fP option.  This option has
no effect if there there is not a quit button.  
.TP
.B \-c
For the top panel, use a set of exclusive panel choice buttons for
each \fIolwm\fP submenu instead of a menu button with a pull-down
menu.  This option has no effect unless \-\fBM\fP is used.  
.TP
.B \-h
For the top panel, lay out each set of panel choice buttons
horizontally instead of vertically (this option has no effect unless
\-\fBM\fP and \-\fBc\fP are used).
.TP 
\fB\-w\fI window_title \fR["Run Program on File"]
Specifes a title for the \fIfbuttons\fP window.  
.TP 
.BI \-i " icon_title \fR[fbuttons]"
Specifies a title for the \fIfbuttons\fP icon.  
.TP 
.BI \-X " x_pos"
Specifies the x-position (in the root window) of the frame displayed
by \fIfbuttons\fP.  Both \fIx_pos\fP and \fIy_pos\fP must be specified
and be non-negative; otherwise, the positioning will be left up to the
window manager.  The standard XView \fB-Wp\fP and standard X11
\fB-geometry\fP options can also be used to position the window.  
.TP 
.BI \-Y " y_pos"
Specifies the y-position (in the root window) of the frame displayed
by \fIfbuttons\fP.  Both \fIx_pos\fP and \fIy_pos\fP must be specified
and be non-negative; otherwise, the positioning will be left up to the
window manager.  The standard XView \fB-Wp\fP and standard X11
\fB-geometry\fP options can also be used to position the window.  
.TP
.BI \-x " debug_level \fR[0]\fP"
If 
.I debug_level
is positive,
.I fbuttons
prints debugging messages and other information on the standard error
output.  The messages proliferate as the  
.I debug_level
increases.  If \fIdebug_level\fP is 0 (the default), no messages are
printed.  
.SH ESPS PARAMETERS
.PP
ESPS parameter files are not used by the current version of
\fIfbuttons\fP.  
.SH ESPS COMMON
.PP
ESPS Common is not processed by \fIfbuttons\fP.  
.SH FUTURE CHANGES
.PP
Add parameter file processing.  
.SH EXAMPLES
.PP
The command
.nf
	%fbuttons
	
is equivalent to 
   
	%fbuttons *.d *.sd    
		
.fi
Here's another example of exploiting the shell to expand wild cards 
in order to generate a file list for \fIfbuttons\fP:
.nf

	%fbuttons *.sd */*.sd dataCP??.sd

.fi
Here's an example of a program file (for use with \fB-L\fP);
.nf

.ta .5i 2.5i
	splay \-g.5 
	splay \-g.5 \-R2
	back_play
	xtext psps \-l
	xtext psps \-lD

.fi
Here, \fIback_play\fP is the name of a program on the user's path.  
A more "user friendly" approach would be to use the following 
menu file (with \fB-S\fP): 
.nf

.ta .5i 2.5i
	play	splay \-g.5 
	"play twice"	splay \-g.5 \-R2
	"play backwords"	back_play
	"show file"	xtext psps \-l
	"show header"	xtext psps \-lD

.fi
In fact, \fIback_play\fP is a one-line script containing:
.nf

.ta .5i 2.5i
	#!/bin/sh
	ereverse $1 \- | splay \-

.fi
For examples of \fIfbuttons\fP used with all three panels and 
with \fB-F\fP see the TIMIT and Sounds demos in $ESPS_BASE/demos.  
.SH ERRORS AND DIAGNOSTICS
.PP
\fIfbuttons\fP will exit with an error message if it can't connect 
to the specified X server (DISPLAY variable or standard -display
option).  
.PP
\fIfbuttons\fP will exit with error messages if it can't create the 
button window for various reasons (e.g., no valid list of files, 
invalid or empty file given to \fB-L\fP or \fB-S\fP, etc.)  
.SH BUGS
.PP
If the environment variable BBOX_QUIT_BUTTON is set, quit buttons
will appear in all panels (not just the panel containing program 
buttons).  This is a bit ugly and wastes space, but should not be
harmful. 
.PP
In a previous version, the quit button was always present in 
the program panel.  So as not to break existing scripts, the 
more recent \-\fBq\fP option defaults to the previous behavior (i.e., 
having the quit button).  Unfortunately, this means that fbuttons
and \fImbuttons\fP (3\-Eu) have opposite quit button defaults. 
.SH REFERENCES
.PP
.SH "SEE ALSO"
.PP
\fImbuttons\fP (1\-\s-1ESPS\s+1), \fIxtext\fP (1\-\s-1ESPS\s+1),
\fIexprompt\fP (1\-\s-1ESPS\s+1), \fIexv_bbox\fP (3\-\s-1ESPSxu\s+1)
.SH AUTHOR
.PP
Program and man page by John Shore.  Thanks to Stephen Marcus 
(AT&T Bell Laboratories, Napirville) for the \fB-s\fP code.