2 V3_01_03  25.03.91
 The following version numbers apply to this version of Mn_Fit:

 Mn_Fit  3.01/03
 Mn_Util 1.02/05
 MINUIT  1.00/09 (C. Rippich),  90.10 or 89.12j (CERN)
 TYPSCN  1.00/12
 L3_DSP  1.00/06

 This section lists the changes made since Mn_Fit version 2.05/13.

 +++ Known Bugs or Problems:
 ___________________________

 You should  not try to  rename histograms  which have  the same primary
 identifier as an Ntuple which is stored with the disk option.

 The user  function  number  sometimes does not  get passed  properly to
 COMIS functions. Be careful using it.

 If you  get an  error when  adding a  COMIS  function, you  get several
 questions asking you whether you want to abort this command.

 If you  get an  error in  some `SET'  commands,  you again  get several
 questions asking you whether you want to abort this command.

 Not all `SET' commands have a `SHOW' equivalent. Therefore sometimes if
 you give  `SHOW parameter'  you will get  into `SET'.  Just hit <CR> to
 exit.

 SET X|Y LIMITS do not work for lego/surface plots - use PARTITION.

 Sometimes you only get one big tick on an axis.

 +++ New Features:
 _________________

 The latest CERN  version of MINUIT has been  added (89.12j). This seems
 to be  significantly better  than the old  version. The  old version is
 still available,  but must be  compiled at your  site. NOTE: You should
 check that  you get the  same or better  results from  fitting compared
 with the previous  MINUIT version. This is the  first release using the
 CERN MINUIT.

 New possibilities in fitting include constraints on parameters, contour
 plots and  graphical  contour plots. It  is also  possible to integrate
 functions across  each bin to  improve precision, as  well as including
 and excluding regions  from the fit (see HELP FIT and HELP SET FIT for
 details). The DISPLAY and FIT_INFO output has been modified to give the
 MINUIT  and  Mn_Fit   parameter  numbers  and  also to   indicate which
 parameters are constrained (a # sign).

 There  has  been a lot  of   development and  new  commands  for Ntuple
 manipulation. In  addition the  `CUT' mechanism has  been substantially
 improved  and cuts can  now  include  arithmetic  expressions and COMIS
 functions. You can use  `>,<' etc. instead of  `.GT.,.LT.' etc. in cuts
 and `&' and `|' instead of `.AND.'  and `.OR.' in `CUT USE'. It is also
 possible to project into arithmetic expressions. Ntuples can be merged.
 It is  possible to  plot  projections  of Ntuples  directly  and to use
 automatic  binning  for the   projections. You  can also  specify if an
 Ntuple variable  should be used as  the weight or  error on the weight.
 See HELP NTUPLE for full details.

 If you store  tables in Ntuples,  you can plot them  directly using the
 PLOT/NTUPLE command.

 It is  possible to  define user  variables and  use them  in arithmetic
 expressions.

 It is possible to define aliases for character strings.

 The COMIS  interface  has been  expanded to  include cuts,  scanning of
 Ntuples and calling a  COMIS subroutine.  Information on histograms and
 Ntuples  is  now  available  inside  the  functions or   subroutine and
 skeleton  subroutines get made  automatically if the  filename does not
 exist. All the Cernlib  routines that are  available inside PAW are now
 also  available, plus  Mn_Fit functions  and some extra  useful Cernlib
 routines (see HELP Using_COMIS for full details).

 You can now access the  overall normalization,  Ntuple contents and 2-D
 histogram  contents when you are  allowed to use  registers, parameters
 etc. You can also `DEPOSIT' into the same places. Deposit on parameters
 when fitting now  updates the MINUIT parameter  values also, so this is
 an  alternative to  the  `MODIFY'  command
 (see HELP Numbers and HELP DEPOSIT for  details). You can also use the
 MINUIT   parameter number  rather  than the  Mn_Fit  ones  when you are
 fitting.

 Default  symbols  now depend  on the  type of  plot being  made and new
 symbols for scatter plots are available.

 This is  the  first  release that  almost  works  fully on  the Apollo.
 However `SMOOTH' and `SPLINE' do not work on the Apollo at present.

 New command `SET FONT' which makes changing fonts much easier.

 New command MDIRECTORY to make a new HBOOK directory in memory. This is
 most useful in connection with STORE.

 You  can  now   store   histograms  in  an   existing   HBOOK RZ  file,
 `STORE/UPDATE'.  In  addition you can  store histograms  in directories
 other than the top level using the CDIR and MDIR commands.

 Automatic logging of all commands typed is available (`SET LOG').

 A debug flag is  available in  common for COMIS and  user functions and
 can be set using the command `SET DEBUG'.

 Device  `None' has been  added. This  enables Mn_Fit to  go through the
 motions of  making a  picture without  actually doing  so. Useful to do
 `FUNCTION HIST' for example if you do not want to look at the plot.

 Landscape and  Encapsulated  Postscript devices are  available for most
 graphics packages.

 New line  modes 5,6,7,8  corresponding to  HIGZ line  modes 12,13,14,15
 added.

 When you get  asked to hit <CR>  for the next plot  you can type `q' to
 quit the macro  altogether. Typing  any other  character will skip that
 plot command.

 You can now use `?' instead of `HELP' to get help. Indeed when you want
 help in the  middle of a  command (CUT  for example),  you must use `?'
 instead of `Help'. This is indicated in the prompt.

 +++ New Commands:
 _________________

 ?                 Replacement or alternative for HELP.
 ALIAS             Defines an alias for a string.
 UNALIAS           Undefines one or all aliases.
 NTUPLE MERGE      Merges several Ntuples into one.
 NTUPLE PLOT       Projects and plot an Ntuple or n-dimensional histogram.
 NTUPLE PROJECT    Projects an Ntuple or n-dimensional histogram.
 NTUPLE SCAN       Calls a subroutine for every Ntuple event.
 CUT FILE          Defines a COMIS function as a cut.
 CUT COMPILE       Compiles a COMIS function which is defined as a cut.
 CUT EDIT          Edits and compiles a COMIS cut function.
 STORE/NEW         Stores plots in a new HBOOK RZ file.
 STORE/UPDATE      Stores plots in an existing HBOOK RZ file.
 HB_MN_FIT         Converts HBOOK to Mn_Fit histograms.
 REMOVE            Deletes a user variable.
 CALL_COMIS        Calls a COMIS subroutine.
 MDIRECTORY        Makes a new HBOOK directory in memory.
 SET ALIAS         Turns on or off alias translation.
 SET DEBUG         Turns on or off the debug flag for COMIS and user
                   functions.
 SET FIT           Sets parameters for fitting.
 SET FONT          Changes the fonts for various parts of the picture.
 SET LOG           Turns on or off automatic logging of commands.
 SET NTUPLE        Specifies the Ntuple variables to plot with PLOT/NTUPLE.
 SET SHELL         Specifies the shell command on the Apollo.
 SET STATISTICS    Specifies whether to use HBOOK or Mn_Fit means and sigmas.
 SHOW ALIAS        Shows the definitions of one or all aliases.
 SHOW FIT          Shows flags and parameters used when fitting.
 SHOW CONSTRAIN    Shows the current constraints on fit parameters.
 SHOW VARIABLE     Shows the values of one or all user variables.
 INQUIRE           Gets the value of a macro parameter.
 CONSTRAIN         Constrains a parameter being fitted.
 UNCONSTRAIN       Removes a constraint on a parameter.
 INCLUDE           Include a region in a fit.
 SCAN              Scan the fitting function with one or all parameters.
 MNCONTOUR         Make a graphical contour.
 MAX_CALLS         Replaces the CALLS command.
 HELP EXPRESSION   New help on arithmetic expressions.
 HELP Using_COMIS  New help on COMIS interface to Mn_Fit.

 +++ Modified Commands:
 ______________________

 DEPOSIT           Can create user variables and deposit into Ntuples
                   and 2-d histograms.
 UNDEFINE          Can now undefine all defined commands.
 PROJECT           Alias for `NTUPLE PROJECT' - many new possibilities.
 CUT NEW           Only 1 cut per line is now allowed.
 CUT CHANGE        Keeping current condition now needs ==.
 CUT USE           Allow `&' and `|' and COMIS function cuts.
 SET COLOUR REPRESENT  Changes the colour representation.
 SET FONT          Can now be used to set fonts for all parts of a picture.
                   Precision can also be given - this means font numbers
                   are not necessarily backwards compatible.
 SET HATCH         Portable HIGZ hatches are available.
 SET SYMBOL        Symbol 0 is plot type dependent.
                   New symbols for scatter plots.
 SHOW REGISTER     Can now show a range or all user registers.
 CALLS             Renamed to `MAX_CALLS'.
 FIT_INFO          Shows the Mn_Fit and MINUIT parameter numbers.
                   Indicates which parameters are constrained.
 DISPLAY           Same changes as in FIT_INFO.
 HARDCOPY TEKFILE  Replaces HARDCOPY TEKTRONIX.
 HELP MINUIT       Substantially updated.

 +++ Improvements and Bug Fixes:
 _______________________________

 `CUT NEW' can only define one cut  per line. `CUT CHANGE' needs `==' on
 the condition instead  of `=' to keep the  current condition. It is not
 possible to use the  form `=*5' to change the  value of a cut. Cuts are
 now parsed when  they are used,  not when they are  defined. This means
 that  if a cut   includes a  register  for  example,  the  value of the
 register at the time the cut is used will be taken.

 `SET SYMBOL 0' now  defines a default symbol  which depends on the plot
 type. Symbols -1 -> -4 exist for  scatter plots and join the dots using
 lines 1 -> 4.

 HBOOK statistics  rather than Mn_Fit ones are  now available on request
 (`SET STATISTICS HBOOK|MN_FIT').

 `CUT, COMMENT, SET'  and `DRAW' exit after the  completion of the first
 command if you include  something on the line  with the command. If you
 do not you must give an `END' (or `<CR>' when not in a macro or defined
 command). This  behaviour should  now be consistent.  It was not always
 before.

 On the VAX the edit commands  `EDIT/TPU' and `EDF' now use CALLABLE_TPU
 instead of spawning a subprocess.

 Background subtraction works properly for variable sized binning plots.

 2-D functions were not declared `DOUBLE PRECISION'.

 If you are  plotting with error  bars and the point,  but not the point
 +/- error is outside the plot, the error bar will now be drawn.

 The command  sequence `FETCH  filename id; CDIR  dirname; FETCH id' did
 not work. That is now fixed.

 The Vax  condition  handler has  been  improved. There is  no condition
 handler on the Apollo at present.

 `SHOW ORDER' and `SHOW ORTHOGONAL' have been fixed.

 `SET Z OPT_ZERO' now works.

 The y axis label  is now at the  correct angle for  lego/surface plots.
 The offset of lego/surface plots  from the bottom left corner of a plot
 has been reduced to 0, so the scales are now in the margins as they are
 for all other sorts of plots.

 PARTITION Only worked  properly for  monotonically increasing x values.
 It now works for monotonically increasing or decreasing values.

 Tektronix  devices now  work for GKSGRAL  if they are  the same device.
 They also now work for DECGKS and DEC GKS3D.

 Registers, parameters etc. can now  be used for overlay symbols hatches
 and patterns and  also for  lego/surface plot  angles. They can also be
 used for secondary identifiers in `PROJECT' etc.

 If the prompt  indicates you can  get extra help  when giving a command
 (terminates in `or ?:'), this should now always work.

 The  direct  access  file  length is  checked  using  RZFILE  for HBOOK
 histogram files. This should avoid  Mn_Fit bombing if the record length
 is wrong.

 Occasionally  _ was no  longer  recognized in  commands.  This has been
 fixed.

 You have  to type at  least `EXI'  to exit  otherwise the  command gets
 passed onto the standard command list without further checking.

 All code and  files needed for  linking, running and  testing Mn_Fit as
 well as  producing the  manual is now in  4 CMZ files  (5 for L3). This
 makes  keeping  up-to-date much  easier and  will enable  me to produce
 updates to the manual.  The HELP Changes has been modified somewhat and
 is now  keyed on  version  number  rather than  date. All  institutions
 should now be able to produce a working version of Mn_Fit directly from
 these files  without introducing  any local fixes  except to define the
 necessary logical names or links.  See the deck //mn_util/docs/code for
 details.

 The  number of  entries and  underflows  and  overflows  were not being
 fetched properly for M_BOOK histograms.

 There were a couple of bugs if you switched many times between hardcopy
 and screen devices. These have hopefully been fixed.

 The `SET X|Y|Z OPT_ZERO' command  also changed whether the fit function
 was shown on excluded regions of a display.

 Ntuples were not  read in properly  in `DAT_FETCH'.  There was a format
 error in one of the error messages in `DAT_FETCH'.

 Bug fixed in recovery from failure to open a hardcopy file.

 Empty command lines are now echoed properly.

 Number  of  plots  fetched  when  secondary   identifiers were  used in
 `DAT_FETCH' was wrong.

 The news system  now reads the  file  `mn_fit_dir:mn_news.fil' which is
 made from  the deck //mn_util/news/news every time a  final  version of
 Mn_Fit is linked.

 The help library has been renamed to mn_fit.hlb.

 The  demonstration and  manual files  (including  symbol.mnf) have been
 moved to the mn_fit_help: directory.

 The flag `$GTSGRAL' has been renamed to `$GKSGRAL' in all the code.
