.\" Man page for nsf
.\"
.\" Copyright (c) NAKAMURA Kazushi
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.
.de EX
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +.5i
..
.de EE
.fi
.in -.5i
.if n .sp 1
.if t .sp .5
..
.TH nsf 1 "1996/08/28"
.LO 1
.SH NAME
nsf \- murata version of 'Shell Form'
.SH SYNOPSIS
nsf [\-bu] [\-c #] [\-m message] [\-i file] [\-o file]
.SH DESCRIPTION
nsf enables 'form input' in a shell script.
nsf needs only
.B ncurses
library. No needs of X window, WWW(CGI),...
And nsf is very small.
nsf will be used efficiently with
.B here document
in a shell script. Don't forget
.B trap
, if need.

.SH OPTIONS
.TP
.B \-b
output is for bourne
.B sh
(defalt is
.B csh
).
.TP
.B \-c #
cursol initial position.
.TP
.B -m message
initial warning.
.TP
.B \-i infile
use infile instead of stdin.
.TP
.B \-o outfile
use outfile instead of stdout.
.TP
.B \-u
use underline for input field.
.SH Screen, field definition
For example:
.EX
screen saver	[~~~~~~~]
time out		[~~~~~]
^L
#v=saver#s=:green:blank:snake:star:#d=green#
#v=blanktime#a=fr#d=600#
.EE
.PP
The structure is below.
.EX
Screen definition
^L
#v=name#field attribute#...#
#...#
.EE
.PP
In the screen definition,
.B ~
means input field.
Screen definition is terminated by
.B ^L
or
.B @ .
And field definitions are:
.TP
.B v=name
set the name of shell variable at the field.
.\"Screen定義で現れた fieldに対応する shell変数の名前を設定する。
This must be needed always.
.PP
And optional attributes are defined as
.B a=attributes.
attributes are:
.TP
.B a
auto. If a field is filled,move to next field automatically.
.TP
.B d
only integer.
.TP
.B r
only real. (Not allow 'e' expression)
.TP
.B f
force.
.\"省略不可.
.TP
.B u
upper case.
.TP
.B l
lower case.
.PP
.B d=default
set the defalt value.
.TP
.B h=help
define help message.
.TP
.B s=:opt1:opt2:...:
style is selection form. User can select options by push space bar.
.SH "SEE ALSO"
ncurses(3), sh(1), csh(1).