Click above to get retro games delivered to your door ever month!

##############################################################################
###+-------------+############################################################
#+-| APPEND FROM |--------------------------------------------------+#########
#| +-------------+ The APPEND FROM command adds records from        |#########
#|                 <Append-alias> to the current or specified alias |#########
#+------------------------------------------------------------------+#########
##############################################################################
##############################################################################
#+--| Syntax |-----------------------------------------+######################
#|     [!<Alias>] APPEND FROM <Alias-alias> [Scope]    |######################
#|     [FIELDS <Field-list>]                           |######################
#+-----------------------------------------------------+######################
##############################################################################
##############################################################################
######+---| Description |----------------------------------------------+######
######| If <Field-list> is specified, it is inclusive: only the fields |######
######| found in the list will be copied.  FORCE attempts to match a   |######
######| source field name with a destination field name.  If a match   |######
######| is found, then FORCE will verify that the data types are       |######
######| similar and copy the data from the source field to the         |######
######| destination field.  Character fields of any length will match. |######
######| Any numeric types constitute matching fields.  All fields      |######
######| other than character and numeric must be of the same type to   |######
######| match.  For example, CHAR(20) matches CHAR(10) and INT matches |######
######| DBL.                                                           |######
######| -------------------------------------------------------------- |######
######| The default scope for APPEND FROM is ALL.                      |######
######+----------------------------------------------------------------+######
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Copy the entire database from alias old_database    |#########
#########| *    to the currently selected database.                 |#########
#########|                                                          |#########
#########| APPEND FROM old_database                                 |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Append to several databases without having to       |#########
#########| *    adjust the current work area with the select        |#########
#########| *    command.                                            |#########
#########|                                                          |#########
#########| DO WHILE taxable()                                       |#########
#########|     !fixed_assets APPEND FROM tax_database               |#########
#########|     !airplane     APPEND FROM tax_database               |#########
#########|     !condo        APPEND FROM tax_database               |#########
#########| ENDDO                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 3 |-------------------------------------------+#########
#########| *    Append only these specific fields.                  |#########
#########|                                                          |#########
#########| APPEND FROM athletics FIELDS equ->shoes,;                |#########
#########|     equ->gloves,equ->socks                               |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 4 |-------------------------------------------+#########
#########| *    Append only one record, only one field.             |#########
#########|                                                          |#########
#########| APPEND FROM parts NEXT 1 FIELDS inventory->clutch        |#########
#########+----------------------------------------------------------+#########
##############################################################################