v.sdts.meta.cp(1)	      Grass User's Manual	     v.sdts.meta.cp(1)



NNAAMMEE
       vv..ssddttss..mmeettaa..ccpp	-  installs supplementary metadata file preparatory to
       creation of an SDTS export dataset.
       _(_G_R_A_S_S _V_e_c_t_o_r _D_a_t_a _E_x_p_o_r_t_/_P_r_o_c_e_s_s_i_n_g _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..ssddttss..mmeettaa..ccpp
       vv..ssddttss..mmeettaa..ccpp hheellpp
       vv..ssddttss..mmeettaa..ccpp [--ff] mmeettaaffiillee=_n_a_m_e mmaapp=nnaammee

DDEESSCCRRIIPPTTIIOONN
       The program provides assistance for  the  preparation  of  supplemental
       metadata for an SDTS export dataset.  The user specifies a map layer in
       his current mapset, and then a file of metadata information  pertaining
       to  the named map.  The program copies the specified metadata file to a
       standard location (in the user's mapset, under the _d_i_g___m_i_s_c directory).
       Later,  when _v_._o_u_t_._s_d_t_s is run for the same map layer, the items in the
       metadata file will be incorporated in  various  places  in  the	export
       dataset.


       While  the  metadata  file can be prepared by the user, it's format and
       contents are strictly defined.  An alternative is to use the  interface
       program,  _v_._s_d_t_s_._m_e_t_a,  with  which  the user can prepare and install a
       correctly formatted metadata file.

CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
   FFllaaggss::
       --ff     force overwriting of pre-exisiting metadata file.




   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      name of vector map layer to which the  specified	metadata  file
	      applies.

       mmeettaaffiillee==_n_a_m_e
	      name  of	file to be installed as a metadata file for the speci-
	      fied map.




NNOOTTEESS
       The format of the metadata source file is rather highly specified. Fol-
       lowing  is  a  list of the items that can be included in the file. Note
       that each item is preceded by a particular code. The code, and the fol-
       lowing ':' must be entered intact for each included metadata item.  The
       colon is then immediately followed by the user-supplied information:


       IDEN_MPDT:(creation date of original source map; YYYY or YYMMDD format)


       IDEN_TITL:(general  TITLE  for  contents of transfer, for TITL field in
       IDEN module. If not specified, vector header "map_name" will be used)


       IDEN_COMT:(general comment on transfer, for IDEN module's COMT field)


       XREF_HDAT:(name of geodetic datum to which export data are  referenced,
       for HDAT fieid in XREF module.)


       DDSH_ENT_NAME:(for  Dictionary/Schema  module;  name  of kind of entity
       that _d_i_g___a_t_t and _d_i_g___c_a_t_s values represent. If not specified, map  name
       will be used.)


       DDDF_GRASS_ENT:(definition  for	entity in "DDSH_ENT_NAME", for Dictio-
       nary/ Definition module. if not supplied, simple default is used.)


       DDDF_ATTR_NUM:(definition for _d_i_g___a_t_t values, for Dictionary/Definition
       module; if not specified, simple default is used.)


       DDDF_ATTR_LABEL:(definition for _d_i_g___c_a_t_s values, for Dictionary/Defini-
       tion module; if not specified, simple default is used.)


       As noted above, the metadata file can be prepared, and installed, with-
       out the user having to worry about format details, with _v_._s_d_t_s_._m_e_t_a.

SSEEEE AALLSSOO
       _m_._s_d_t_s_._r_e_a_d_,   _v_._i_n_._s_d_t_s_,   _v_._o_u_t_._s_d_t_s_,	_v_._s_d_t_s_._d_p_._c_p_,  _v_._s_d_t_s_._m_e_t_a_._c_p_,
       _v_._s_d_t_s_._m_e_t_a

AAUUTTHHOORRSS
       David Stigberg, U.S.Army Construction Engineering Research Laboratory
       Tin Qian, University of Illinois

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0						     v.sdts.meta.cp(1)
