
QEF RELEASE NOTES for Windows NT - 07 13, 2000
===================================================================

QEF Release info: (46) Qtree(8.4) 2000/07/12 10:09:21 Windows_NT-5.0-pentium

INTRODUCTION

This file contains information specific to this release of QEF for
Windows NT.

INTERIX

As part of the QEF product, a subset of Microsoft's Interix
product has been installed on your machine. The Interix
product provides Unix-like tools and functionality under
NT. The subset included with QEF contains, among other things,
the Korn shell (ksh). During the install process, a
shortcut that will start a ksh session has been added
to the QEF item in the Start menu.

For more information about Interix, go to www.interix.com.

THE QEF USER INTERFACE

In this release, the QEF graphical user interface tools
(qgdiff, qefgui, qefinfo) are provided as X11 programs.
This means that to use the GUI, you must be running a
PC X server such as Hummingbird on your machine. If there
is no X server running, the GUI tools will not start.
You can still use all of the command line tools without
an X server.

A portion of the QEF on-line help has also been provided in
the form of a Windows help file accessible through the
Start menu.

CONFIGURING QEF

During the install process certain files were configured to reflect
how your system is set up. You may wish to review these files
to  verify that the system is setup properly. The important files
are:

	$QTREE/lib/traits.vrs
	$QTREE/lib/sysvrs/winnt.vrs

(The QTREE environment variable was created by the installation
program.)

The traits.vrs file contains information that is specific
to a particular machine's configuration. New in this release,
this file is now a qvrs file. See qvrs(1) for information on the
syntax for this file. If you make changes to the default files,
you must run
	mktraits -u
This will compile the file and place the compiled result into
	$QTREE/data/traits/<hostname>.tab
Refer to mktraits(1) for more information.

Attributes you may wish to change include
	BuildPath
which defines the PATH used when performing a build.
	STD_PATH
the normal path used, and
	ManPath
the path used to search for manual (man) pages.

By default, the installer will have configured these files
based on the settings in the NT registry. If you have an
unconventional configuration, you may need to edit these
files. You can do so with any standard text editor.

The second file "$QTREE/lib/sysvrs/winnt.vrs" is also a qvrs source
file. This file contains information that is intended to be platform
specific rather than machine (host) specific so you shouldn't
to change this file.

Special Support for the Microsoft WIN32 Environment

More support for Microsoft-specific build procedures has
been added to this release. This support includes extensions
to program(x-qsg) to handle building IDL/ODL files, special
support for automatically generating VERSIONINFO resources
and for registering DLLs. See MicrosoftConsiderations(x-qmisc)
for details.

This release also contains an updated wcci. The new version uses
the following qvrs configuration variables. These new variables
let you to change the defaults used by wcci so you can, for example,
accommodate new compilers.

WcciInclDirs    - standard include paths, defaults to CCDIR/Include
WcciLibDirs     - standard lib paths, defaults to CCDIR/Lib
WcciCcDebug     - standard debug for compiler, defaults to /ZI /Yd /GZ
WcciLdDebug     - standard debug options to linker, defaults to /debug
WcciOptimize    - standard optimize options, defaults to /O2 /op
WcciCompiler    - names the compiler, defaults to CL.EXE
WcciLinker      - names the linker, defaults to LINK.EXE

WcciCompiler and WcciLinker can specify an absolute path, or a file
name that will be searched for along the path.

CCDIR is the directory where the compiler is stored.

The -T has been enhanced to echo the LIB setting before running
the compile so you will get output like:

wcci -o hello.exe  -T -T -b console -g hello.c
cl=//C/msdev/VC98/Bin/CL.EXE
ld=//C/msdev/VC98/Bin/LINK.EXE
COMPILERDIR=//C/msdev/VC98;
LIB=c:/msdev/VC98/Lib;c:/msdev/VC98/MFC/Lib
+ //C/msdev/VC98/Bin/CL.EXE /c /Ic:/msdev/VC98/Include \
        /Ic:/msdev/VC98/MFC/Include /Ze /nologo /ZI /Yd /GZ /Fohello.obj \
        hello.c
hello.c
+ //C/msdev/VC98/Bin/LINK.EXE /nologo /ignore:4078 /debug /heap:8388608,32768 \
        /heap:4194304,65536 /PDB:NONE -subsystem:console /out:hello.exe \
        hello.obj

(Note the 2 -T options in the above...)

Finally, some new utilities have been included with this release:
	detox	- a utility for converting between Unix and Windows
		text files.
The next two are not formally part of the QEF product, but have been
included as a convenience:
	elvis	- a freely available implementation of the VI editor.
	start	- a utility for starting Windows programs from
		the Interix command line. It uses the file
		associations in the registry to figure out how to start
		a program.
	wmode	- write-protect files
	qenv	- output environment variables in sorted usable form
