$CTSMROOT/bld/README                            Jun/08/2018 

CLM build and configure directory and scripts. Scripts to help
you prepare to build CLM as a component within CESM, and setup
a namelist for it.

This is a lower level script called from with CESM/CIME.

Important files/directories:

--------- Namelist build scripts

config_files/clm_phys_vers.pm ------------- Perl module to handle different CLM versions
config_files/config_definition_ctsm.xml --- XML file defining CTSM configuration items (mainly physics version)

--------- Scripts to build the namelists
build-namelist --- Build the namelists needed


env_run.xml --- Sample case runtime environment variables, so build-namelist can run outside of a case directory.

--------- Test scripts directory
unit_testers --- Directory of scripts to test scipts in this directory
                 (most notably build-namelist)

---------- XML Files describing namelists in namelist_files
namelist_files/namelist_defaults_ctsm.xml --------- List of default values for the ctsm namelist
namelist_files/namelist_defaults_overall.xml ------ List of default values for overall settings
namelist_files/namelist_defaults_usr_files.xml ---- List of default values for the user-files (deprecated)
namelist_files/namelist_definition_ctsm.xml ------- Definition of all namelist items for ctsm
namelist_files/namelist_definition.xsl ------------ Describes how to view the xml file as html
namelist_files/use_cases -------------------------- Specific configurations that build-namelist uses
namelist_files/use_cases/README ------------------- File explaining the naming convention for use_cases

---------- Driver namelist files, duplicated information from cime/driver/cime_config
namelist_files/namelist_defaults_drv.xml ---------- List of default values for driver namelist defaults
namelist_files/namelist_defaults_drydep.xml ------- List of default values for dry deposition and MEGAN fields 
namelist_files/namelist_defaults_fire_emis.xml ---- List of default values for fire emission fields
namelist_files/namelist_defaults_dust_emis.xml ---- List of default values for the dust emissions module.
namelist_files/namelist_definition_drv.xml -------- Definition of all driver namelist items
namelist_files/namelist_definition_drv_flds.xml --- Definition of add driver fieldsnamelist items


---------- XML helper files
namelist_files/LogMessages.pm  ---- Perl module to handle log output
namelist_files/history_fields.xsl - Style sheet for history fields as created by script that lists all of the
                                    history fields from the source files (../src/main/findHistFields.pl)