;/*
; *                      Microsoft Confidential
; *                      Copyright (C) Microsoft Corporation 1991
; *                      All Rights Reserved.
; */


                        SETVER Command overview
			MS-DOS 5.00
			05/13/90

SETVER is an external MS-DOS command which allows the user to
determine the MS-DOS version number will be reported by MS-DOS
to a specified user application. This will allow applications
which check for a specific version of MS-DOS to run under
MS-DOS 5.0.

A version table has been included as part of the MS-DOS system
files on the user's boot disk. SETVER will update the system
files so that next time and times thereafter, that MS-DOS is
booted, the updated version table will be in effect. NOTE: The
changes to the version table will not take effect until the
user reboots using the updated version of the table.


NOTE:
	Currently there is 512 bytes set aside for entries in the
	table but Ericst may want to up it in the near future so
	for right now I wouldn't mention the number of entries
	which the table will hold. Right now it will hold a minimum
	of 34 entries.

==========================================================================

USEAGE:
		List table:	SETVER [D:]
		Add entry:	SETVER [D:] name.ext N.NN
		Delete entry:	SETVER [D:] name.ext /DELETE
		Display help	SETVER /?

WHERE:
		D: is the drive containing MSDOS.SYS
		name.ext is the executable file name
		N.NN is the major and minor version numbers
		/DELETE is any combination of /D - /DELETE

==========================================================================

MESSAGES:

	If the table is being updated and there are no errors detected
	this message will be displayed.

	"Version table successfully updated"

	If the version table is only being displayed it will listed
	on the screen in the format:

	WIN200.BIN     3.30
	EXCEL.EXE      4.01
	MYPROG.EXE     3.20
	DELNODE.EXE    4.01
	

==========================================================================

EXAMPLE 1:

	SETVER a: excel.exe 4.01

	This example will add a new entry in the table for EXCEL.EXE
	to the version table on drive A: and will tell DOS to always
	report the MS-DOS version number 4.01 to this application.

EXAMPLE 2:

	SETVER	a: excel.exe /DELETE

	This example will delete the EXCEL.EXE entry from the version
	table on drive A:.

EXAMPLE 3:

	SETVER

	This example will list the contents of the version table
	on the current drive.

EXAMPLE 4:

	SETVER /?

	This example will cause the SETVER command to display
	help in using the command.

==========================================================================

RETURN CODES:
	0  Successful completion
	1  Invalid command switch
	2  Invalid file name specified
	3  Insuffient memory
	4  Invalid version number format
	5  Specified entry was not found in table
	6  MS-DOS system files not found
	7  Invalid drive specifier
	8  Too many command line parameters
	9  Missing parameters
	10 Error reading MS-DOS system files
	11 Version table is corrupt in system files
	12 Specifed MS-DOS system files do not support a version table
	13 Insuffient space in version table for new entry
	14 Error writing MS-DOS system files


==========================================================================

ERROR MESSAGES:

ERROR:  Invalid switch

	The user specified an invalid command line switch.

ERROR:  Invalid file name

	The user specified an invalid file name for a new
        version table entry. Possible causes are the specified
        file name did not follow standard MS-DOS file naming
	conventions or was a reserved MS-DOS file name

ERROR:  Insuffient memory

	There is insuffient memory for the program to run.

ERROR:  Invalid version number format must be 2.11 - 9.99

	An invalid version number was specified. Possible causes
	of this are that the specified version number was not in
	the proper format or it was less than 2.11 or greater than
	9.99.

ERROR:  Specified entry was not found in the version table

	The tried to delete an entry which was not in the existing
	version table.

ERROR:  File MSDOS.SYS not found on specified drive

	The user specified a drive which does not contain MS-DOS
	system files.

ERROR:  Invalid drive specifier

	The user specified a drive that does not exist.

ERROR:  Too many command line parameters

	The user specifed too many command line parameters such as
	by specifing both a version number and the /DELETE switch.

ERROR:  Missing parameter

	The user entered a file name but forgot to include either
	a version number or the /DELETE switch.

ERROR:  Reading MS-DOS system file

	There was an error trying to read the system files on the
	specified drive. Possible cause is that the specified drive
	does not contain system files.

ERROR:  Version table is corrupt

	An error was detected in the version table and it is not
	useable. The user should replace the system files on that
	disk and try again.

ERROR:	System files on the specifed drive do not support a version table

	The user specified a drive which contains MS-DOS system files
	which at not version 5.0 or above.

ERROR:  Insuffient space in version table for new entry

	The version table on the specified drive is full. The user can
	delete some entries from the table and try again.
	NOTE:	To be sure of room for the new entry the user should be
		sure that the entry that is deleted has a file name
		at least as long as the new entry.

ERROR:  Writing MS-DOS system file
	
	There was an error while trying to write the updated version
	version table. This would be caused by a bad disk.