
# **************************** LICENSE START ***********************************
#
# Copyright 2014 ECMWF and INPE. This software is distributed under the terms
# of the Apache License version 2.0. In applying this license, ECMWF does not
# waive the privileges and immunities granted to it by virtue of its status as
# an Intergovernmental Organization or submit itself to any jurisdiction.
#
# ***************************** LICENSE END ************************************

#

cat <<HEND
_________________________________________________________________________

  `cat $METVIEW_DIR_SHARE/app-defaults/MvTitleBarVersionText` @ `hostname`
_________________________________________________________________________

Environment variables that have an effect on Metview-Magics-MARS-Emoslib-GRIB_API:
[current value in brackets; empty brackets = internal default value used]


  EmosLib
  --------------------------------------------------------------------------
  BUFR_TABLES		BUFR tables directory
			[$BUFR_TABLES]
  PPDIR			path to Spectral-to-Grid conversion coefficients
			[$PPDIR]
  EMOS_CYCLE		change Emoslib version number - use with care!
			[$EMOS_CYCLE]

  MARS
  --------------------------------------------------------------------------
  MARS_LSM_PATH		path to Land-Sea-Mask files
			[$MARS_LSM_PATH]
  MARS_REFERENCE_DATE	set a custom reference date for relative dates
			[$MARS_REFERENCE_DATE]
  MARS_AUTO_RESOL	Spectral->Grid conversion auto resolution
			[$MARS_AUTO_RESOL]
  MARS_MAXFORKS		max nro of forked processes from a parent module
			[$MARS_MAXFORKS]
  MARS_PACK_BITS	number of bits to be used in encoding new GRIB messages
			[$MARS_PACK_BITS]
  MARS_COMPUTE_FLAG	assign 0 to conserve GRIB 'generating process' octet
			[$MARS_COMPUTE_FLAG]
  MARS_DEBUG		triggers all modules to print lots of extra debug info
			[$MARS_DEBUG]
  EC_USE_ECREGRID 	if set to 1 then Mars requests will use ecRegrid for interpolation
			[$EC_USE_ECREGRID]


  Grib-Api
  --------------------------------------------------------------------------
  METVIEW_GRIB_DUMP	path to the grib_dump utility program
			[$METVIEW_GRIB_DUMP]
  
  METVIEW_EXTRA_GRIB_DEFINITION_PATH   path to additional GRIB definitions to the
                        ones used internally by Metview. 
			[$METVIEW_EXTRA_GRIB_DEFINITION_PATH]

  Macro Editing
  --------------------------------------------------------------------------
  METVIEW_MACRO_EDITOR	primary Macro external editor candidate
			[$METVIEW_MACRO_EDITOR]
  EDITOR		secondary Macro external editor - for fallback only
			[$EDITOR]


  Inline Fortran/C
  --------------------------------------------------------------------------
  MACRO_EXTRA_LIBS	to provide extra linking flags for inlined programs
			[$MACRO_EXTRA_LIBS]
  MACRO_EXTRA_INCS      to provide extra include flags for inlined C/C++ programs
			[$MACRO_EXTRA_INCS]
  MACRO_EXTRA_F77_FLAGS to provide extra compiler flags for inlined F77 programs
			[$MACRO_EXTRA_F77_FLAGS]
  MACRO_EXTRA_F90_FLAGS to provide extra compiler flags for inlined F90 programs
			[$MACRO_EXTRA_F90_FLAGS]
  MACRO_EXTRA_CC_FLAGS  to provide extra compiler flags for inlined C/C++ programs
			[$MACRO_EXTRA_CC_FLAGS]

  MACRO_DELETE_TEMPORARIES to force deleting more temporary files than normally;
			use with care and only when your macro overflows the
			available cache file system quota; in some cases files
			that might be needed later will also be deleted!
			[$MACRO_DELETE_TEMPORARY_FILES]


  System
  --------------------------------------------------------------------------
  MV_BATCH_NOABORT	set to restore old behaviour not-to-signal-exit-status
			[$MV_BATCH_NOABORT]
  METVIEW_TIMEOUT	idle time for unused Metview modules before they exit
			[$METVIEW_TIMEOUT]
  METVIEW_LOCALHOST	helps to get Event started in some network config cases
			[$METVIEW_LOCALHOST]
  DISPLAY		X11 display that interactive Metview runs in
			[$DISPLAY]

  METVIEW_GRAPHICS_SYSTEM  set the default graphics backend for Qt-based applications
 			in Metview. The possible values are 'raster' and 'native'. 
			[$METVIEW_GRAPHICS_SYSTEM]

  METVIEW_WALL_URL	set the URL for the 'export to Weather Room' functionality.
			This will override the setting in Preferences.
			[$METVIEW_WALL_URL]

  METVIEW_WALL_TOKEN	set the token for the 'export to Weather Room' functionality.
			This will override the setting in Preferences.
			[$METVIEW_WALL_TOKEN]


  Viewers
  --------------------------------------------------------------------------
  MV_BROWSER_NAME	WEB browser to receive editor help button ("?") clicks
			[$MV_BROWSER_NAME]
  METVIEW_PS_VIEWER	external application to view PostScript icons
			[$METVIEW_PS_VIEWER]
  METVIEW_PDF_VIEWER	external application to view PDF icons
			[$METVIEW_PDF_VIEWER]
  METVIEW_PNG_VIEWER	external application to view PNG icons
			[$METVIEW_PNG_VIEWER]
  METVIEW_JPEG_VIEWER	external application to view JPEG icons
			[$METVIEW_JPEG_VIEWER]
  METVIEW_GIF_VIEWER	external application to view GIF icons
			[$METVIEW_GIF_VIEWER]
  METVIEW_KML_VIEWER	external application to view KML icons
			[$METVIEW_KML_VIEWER]
  METVIEW_RASTER_EDITOR	external application to edit raster images
			[$METVIEW_RASTER_EDITOR]


  FLEXTRA
  --------------------------------------------------------------------------
  MV_FLEXTRA_EXE	path to the executable of the FLEXTRA trajectory model
			[$MV_FLEXTRA_EXE]


  SCM
  --------------------------------------------------------------------------
  MV_SCM_EXE	        path to the executable of the Single Column Model
			[$MV_SCM_EXE]


  VAPOR
  --------------------------------------------------------------------------
  MV_VAPOR_BIN	        path to the bin directory of the VAPOR 3D visualisation system
			[$MV_VAPOR_BIN]

  Other
  --------------------------------------------------------------------------
  MV_GENERATING_PROCESS	custom value used when converting an LLMatrix to GRIB
			[$MV_GENERATING_PROCESS]
  METVIEW_TMPDIR	current Metview cache directory
			[$METVIEW_TMPDIR]
  MVNEWSMAIL		primary mail location for Metview News
			[$MVNEWSMAIL]
  MAIL			secondary mail location for Metview News
			[$MAIL]
  SCRATCH		interactive run-time working dir, batch job log dir
			[$SCRATCH]

  MV_DEBUG_PRINT        triggers all modules to print some more debug info
			[$MV_DEBUG_PRINT]
  MV_SCRIPT_DEBUG	triggers this script to print executed commands
			[$MV_SCRIPT_DEBUG]

_________________________________________________________________________

Metview command flags:
warn
 Common flags:
    -u dir		use/create 'dir' as Metview user directory (main Metview folder)
    -q			quiet - suppress warnings about other Metview runtime dirs found
    -v			print Metview version, last Metview update date, and current host
    -H			print this help text and start Metview
    -h			print this help text and exit

 Interactive usage specific flags:
    -display dis	set \$DISPLAY temporarily to 'dis'
    -F			use bigger fonts for big audience
    -mfdbg dbgr		run your external Macro Functions (Fortran/C/C++) under debugger 'dbgr'
    -wr			enable export of plots to the Weather Room screens (only at ECMWF)

 Data examiner flags:
    -e type path	examine the given file
			'type' can be grib, bufr or odb
			e.g. metview -e grib /path/to/grib

 Batch mode specific flags:
    -b mname		run macro mname in batch mode
			(-b must be the last Metview flag!)
    -b mname p1 p2...	as above, p1 p2... are parameters for the macro

 Log related flags:
    -slog		"Single Log" -  combines output from all modules into
			 standard output (longer log)
    -qlog		"Quiet Log" -  as -slog, but only error messages are
			 printed (shorter log)
    -mlog		"Mars Log" -  as -qlog, but all MARS retrieval messages
			 are printed (shortish log)
    Note: You can increase the amount of log information with environment variables
          MARS_DEBUG, MV_DEBUG_PRINT, MV_SCRIPT_DEBUG, JDCNDBG (see above)

 Old log related flags:
    -log		multiple log files into \$SCRATCH/default_log.<module>.log
			(longest logs)
    -log logid		multiple log files into \$SCRATCH/'logid'.<module>.log
			(longest logs)

 Development-only flag:
    -edbg dbgr		start debugger 'dbgr' instead of central module Event
			(for solving development/installation problems)

HEND
