@BeginModule
@NewPage
@Name      = Setgatt
@Title     = Set global attribute
@Section   = Modification
@Class     = Modification
@Arguments = ifile ofile
@Operators = setgatt setgatts

@BeginDescription
This module sets global text attributes of a dataset. Depending on the chosen 
operator the attributes are read from a file or can be specified by a parameter.
@EndDescription
@EndModule


@BeginOperator_setgatt
@Title     = Set global attribute
@Parameter = attname attstring

@BeginDescription
Sets one user defined global text attribute.
@EndDescription
@EndOperator


@BeginOperator_setgatts
@Title     = Set global attributes
@Parameter = attfile

@BeginDescription
Sets user defined global text attributes. The name and text
of the global attributes are read from a file.
@EndDescription
@EndOperator


@BeginParameter
@Item = attname,attstring
STRING  Name and text of the global attribute (without spaces!)
@Item = attfile
STRING  File name which contains global text attributes
@EndParameter


@BeginNote
Besides netCDF none of the supported data formats supports global attributes.
@EndNote


@BeginExample
To set the global text attribute "myatt" to "myattcontents" in a netCDF file use:
@BeginVerbatim
   cdo setgatt,myatt,myattcontents ifile ofile
@EndVerbatim
Result of '{\tt ncdump -h ofile}':
@BeginListing
netcdf ofile {
dimensions: ...

variables: ...

// global attributes:
                :myatt = "myattcontents" ;
}
@EndListing
@EndExample
