#
# README for CfgEd
#
# $Id: readme,v 1.3 1992/07/19 19:03:02 gruen Exp $
#
# $Log: readme,v $
# Revision 1.3 1992/07/19 19:03:02 gruen
# *** empty log message ***
#
# Revision 1.2 1992/07/18 01:39:46 gruen
# appended 'Building form source'
#
# Revision 1.1 1992/07/16 23:56:47 gruen
# Initial revision
#
#

Introduction
~~~~~~~~~~~~
CfgEd stands for 'OS/2 Configuration Editor'. CfgEd is a
PM Application for OS/2 2.0 (32 Bit Code) which gives
the user easy access to the OS/2 configuration file
CONFIG.SYS. This document describes the version 1.0 alpha
of the software and should be considered as a RFC-Version,
a request for comment. Comments on this software are welcome
and should be e-mailed to the author:
[email protected]

CfgEd was developed using the GCC2.1 (C++-mode) compiler from
hobbes.nmsu.edu (I don't know the supplier, but thanks to him),
the Programmers Toolkit for OS/2 2.0 from IBM (thanks to their
special offer), and various tools from the GNU project. Thanks
to Eberhard Mattes and Kai Uwe Rommel for porting and adapting.

The software is distributed to the well known sites:

rusmv1.rus.uni-stuttgart.de
hobbes.nmsu.edu

and too to
ftp.rrzn.uni-hannover.de


I will download more actual version to theese sites.
Additional anouncements will be posted to the OS/2 NEWS-Groups.

Motivation
~~~~~~~~~~
I was angry every time editing my CONFIG.SYS with the usual
editors. Espacially the long PATH and LIBPATH statements and a
look to the NeXT gave motivation to change things. A first OS/2
1.3 version of CfgEd in C was not very stable and so I decided to
rewrite the Tool for 2.0 using C++. I have had some problems, but
at least C++ is much easier for PM programming then C.

Install
~~~~~~~
Just unzip or unzoo the package and move or copy the exectuable
CFGED.EXE to your favaorite directory. That's all, no DLL's are
required.

Usage
~~~~~
Call CfgEd from the command line. If you have more then one
Drive >= C: with a CONFIG.SYS, the tool will present you a
list box for selecting the right one.

Now you see a large list box, containing the contents of
your CONFIG.SYS. Also you see buttons for manupulating
the contents. Double clicking on the list box invokes the
line editor. Play around. The changed file can be saved
via the menu item File/Save.

Building CfgEd from Source
~~~~~~~~~~~~~~~~~~~~~~~~~~

As stated before, several tools are required for building
the software from source:

- GCC 2.1, not EMX
- libg++ for OS/2, I used V2.1
- NMAKE from IBM or MS, other makes should work with little
editing.

Also included in this package is the PMviews library,
a C++ interface library to the PM in very early version.
You'll need to compile this library too. The design of the
library will change in the next time. No documentation now.

To build the CfgEd form source, unpack the archives 'source' and
'pmviews' to subdirectories and nmake.



Last but not least: Copyright
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/*
* Copyright (c) 1992 Lutz Grueneberg
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version. This software is
* distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR
* A PARTICULAR PURPOSE. See the GNU General Public License for
* more details. You should have received a copy of the GNU
* General Public License along with this software; if not, write to the
* Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
*/

Have fun!

Lutz Gr"uneberg
[email protected]