Request: Add AUTO output file format (fort.8) documentation to the official manual

[auto-07p]

Request: Add AUTO output file format (fort.8) documentation to the official manual

[bartoldeman]

that's a good idea. Note it's also here:

auto-07p/src/bvp.f90

Lines 1626 to 1670 in 00e9b3c

	! Writes plotting and restart data on unit 8, viz.:
	! (1) data identifying the corresponding point on unit 7,
	! (2) the complete solution,
	! (3) the direction of the branch.
	!
	! Specifically the following is written:
	!
	! IBR : The index of the branch.
	! NTOT : The index of the point.
	! ITP : The type of point (see STPLBV above).
	! LAB : The label of the point.
	! NFPR : The number of free parameters used in the computation.
	! ISW : The value of ISW used in the computation.
	! NTPL : The number of points in the time interval [0,1] for which
	! solution values are written.
	! NAR : The number of values written per point.
	! (NAR=NDIM+1, since T and U(i), i=1,..,NDIM are written).
	! NROWPR: The number of lines printed following the identifying line
	! and before the next data set or the end of the file.
	! (Used for quickly skipping a data set when searching).
	! NTST : The number of time intervals used in the discretization.
	! NCOL : The number of collocation points used.
	! NPAR : The dimension of the array PAR.
	! NPARI : Number of internal parameters, at the end of the array PAR.
	! NDIMU : The user-specified dimension.
	! IPS : The problem type.
	! IPRIV : Private field for use by toolboxes.
	!
	! Following the above described identifying line there are NTPL lines
	! containing :
	! T , U-1(T) , U-2(T) , ... , U-NDIM(T),
	! where NDIM is the dimension of the system of differential equations.
	!
	! Following this is a line containing the indices of the free parameters
	! ICP(I),I=1,NFPR,
	!
	! followed by a line containing the values
	! RL-dot(i) , i=1,NFPR,
	!
	! and following this are NTPL lines each containing
	! U-dot-1(T), U-dot-2(T), ... , U-dot-NDIM(T).
	!
	! Finally the parameter values PAR(i) , i=1,NPAR, are written.
	!
	! Above, RL-dot(.) and U-dot(.) specify the direction of the branch.

This is more up-to-date since a few fields were added to the header line some years ago.