.TH enter "" "" "/rdb Command"
.PC "Add rows to a table or list file without an editor"
\fBenter [\-\fIlimit\fB] \fItableorlist\fR
.PP
.II "row^append"
.II "table^add row"
.II "table^append row"
.II "append row"
.II "add row"
The command
.B enter
is a simple way to append one or more rows to the end of
.IR tableorlist .
It displays each column name and waits for you to type each item.
.PP
.B enter
is a substitute for the form-editor
.BR ve .
It is easier to use, but very limited.
.PP
Note that this is one of the few
.B /rdb
commands that does not use the less-than symbol `<'
to input a table,
but requires the name of a table to which it is to append data.
.PP
If you make an error in entering a record, you can return to the last
line by typing a caret `^';
.B enter
then prompts you with the previous line.
If you return two lines, keep typing carets
until you are prompted for the line you wish to reenter.
.SH Options
The option \fB\-\fIlimit\fR
lets you limit the number of rows to be entered.
For example, \fB\-1\fR prompts for one row and then exits.
Thus, it can be used in a shell script.
.SH Rules
To set up and enter a file in list format instead of table format, there
are several rules and suggestions.
.PP
First, let's discuss terminology.
A list is like a table that is turned sideways.
For example, a wide table looks like this:
.DM
Number  Name    Company Street  City    State   ZIP
Phone
------  ----    ------- ------  ----    -----   ---
-----
1       Ronald McDonald McDonald's      123 Mac Attack
Memphis TENN    30000   (111) 222-3333
.DE
.PP
Note that the row is so long that it wrapped around to the next line.
Also, the column names and column data do not line up.
.IR Names ,
.IR Companies ,
and
.I "Street Addresses"
are usually too long to fit nicely into such a table.
Therefore, we need a list format like this:
.DM
Number  1
Name    Ronald McDonald
Company McDonald's
Street  123 Mac Attack
City    Memphis
State   TENN
ZIP     30000
Phone   (111) 222-3333
.DE
.PP
These two formats (table and list) are made interchangeable by using two
programs:
.B listtotable
and
.BR tabletolist .
You can enter and keep a file in list format.
When you want to use several commands,
you can convert it to table format and pipe it into the regular
commands for faster execution.
For example, the command
.DM
	listtotable < maillist | column Name Phone | justify
.DE
.PP
produces the following output:
.DM
Name            Phone         
--------------- --------------
Ronald McDonald (111) 222-3333
.DE
.PP
It is best, therefore, to remember that
.B Name
and
.B Phone
are column names.
The information that follows them in the list
is the first row of a table (that can be created by the command
.BR listtotable ).
.IP "\fB1.\fR"
First use an editor to create the list file.
Type each column name followed by one, and only one, tab.
Also enter the information for the first row (record).
.IP "\fB2.\fR"
Be sure to put a newline (blank line)
as the first line of the file.
.IP "\fB3.\fR"
Be sure to put a blank line at the end of each row (record).
In the previous example, it should appear after the row
.BR Phone .
This tells the program that it has reached the end of the row.
.sp \n(pDu
You can then save the file and use the
.B enter
program.
Type:
.DM
enter maillist
.sp
Name    _
.DE
.sp \n(pDu
.B enter
responds with the first column name and
a tab, and waits for you to enter whatever you wish for
.BR Name .
The underscore `_' shows where the cursor
of your terminal will be waiting for you to input data.
.IP "\fB4.\fR"
Type in your data for the item.
Use the return key to end the information for this item.
If you type more than 80 characters or so, your terminal will wrap around.
You can continue to type and wrap around until
you reach your editor's line limit or press \fB<Return>\fR.
Then
.B enter
gives you the name of the next column head,
a tab, and waits for your entry.
.IP "\fB5.\fR"
When
.B enter
has given you the first
column name of a new record and is waiting for a response,
exit from it by typing \fB<ctrl-D>\fR.
.B enter
then returns you to the COHERENT shell.
.sp \n(pDu
For list-formatted files, it is better to use the
.B enter
command than an editor.
If you do your entry with a text editor,
you must include all of the column names,
in the same order and spelled correctly.
.SH Example
To add a line to file
.BR maillist ,
type the following:
.DM
	enter maillist
.DE
.PP
The editing session may go as follows:
.DM
Number  2
Name    Chiquita  Banana
Company Standard Brands
Street  ^
Company United Brands
Street  Uno Avenido de la Reforma
City    San Jose
State   Costa Rica
ZIP     123456789
Phone   1234
.sp
Name    \fB<ctrl-D>\fP
.DE
.PP
Note we made an error entering
.B Company
and did not realize it until we were at
.B Street.
We typed a caret `^' that reprompted us for
.BR Company ,
which we then reentered.
.B enter
then went on to prompt us for
.B Company
again.
.PP
The entered file now appears as follows:
.DM
Number  1
Name    Ronald McDonald
Company McDonald's
Street  123 Mac Attack
City    Memphis
State   TENN
ZIP     30000
Phone   (111) 222-3333
.sp
Number  2
Name    Chiquita  Banana
Company United Brands
Street  Uno Avenido de la Reforma
City    San Jose
State   Costa Rica
ZIP     123456789
Phone   1234
.DE
.PP
Note that the last row (actually eight lines and the bottom
newline) is the one we entered.
Just press \fB<Return>\fR if you have no data to enter after a prompt.
.PP
Now for an example of \fBenter\fRing a table.
If you want to add a line to
.BR inventory ,
type:
.DM
enter inventory
.sp
Item#   Amount   Cost    Value  Description   
------- ------- ------- ------- ---------------
.DE
.PP
Then start typing your rows.
Remember to insert tabs between columns:
.DM
8       123     5.98    0       widget
9       29      15.50   0       another widget
\fB<ctrl-D>\fP
.DE
.PP
The inventory file now looks like this:
.DM
Item#   Amount   Cost    Value  Description   
------- ------- ------- ------- ---------------
1       3       5.00    0       rubber gloves
2       100     0.50    0       test tubes
3       5       8.00    0       clamps
4       23      1.98    0       plates
5       99      2.45    0       cleaning cloth
6       89      14.75   0       bunsen burners
7       5       175     0       scales
8       123     5.98    0       widget
9       29      15.50   0       another widget
.DE
.PP
Note that the last two lines are the ones we entered.
.SH "See Also"
.B
listtotable,
tabletolist,
ve
.R