From: "Adam J. Richter" <adam@yggdrasil.com>
Date: Mon, 29 Mar 1999 05:31:11 -0800
To: freeqt@modeemi.cs.tut.fi
Subject: [freeqt] Information on getting started in Harmony development

	First of all, let me say thanks to all of you who emailed me
with encouragement and offers to help.  I especially appreaciate the
offers to get involved, although the positive feedback is nice too.

	From trying the Qt examples under Harmony and other work on
the source code, I get the impression that while Harmony does not yet
have full coverage, the emulation is near to the point where people
will start using Harmony for practical application in running certain
programs.  With all of the offers of help that have come in, I think
we will turn that corner pretty quickly.  I put up the CVS access and
web page thinking that there would probably be a significant taxi
period before take off where development would slowly trickle in, but
now I think things are going move more quickly than I had expected.  I
am very glad I did it.

	The number of people who have stepped forward and offered to
help has been especially encouraging.  The volume of mail has been
enough so that I have fallen behind in answering some of it, for which
I apologize.  So that we can get an idea of the current size and
composition of the group, I have included here my list of the peple
who have expresed a desire to help:

WEB TEAM:
Matt Perry              matt@primefactor.com    Web automation and graphics
Shawn Tolivar           shawn@wwgv.com          Basic text and documentation

DEVELOPERS:
Harry Morgan            hm233@cam.ac.uk         Has changes to incorporate: added missing\ declarations, some Qt 2.x declarations
Robert Brady            rwb197@ecs.soton.ac.uk  Has changes to incorporate, may not have much time after that
Mark Davidson           davidson@rocketmail.com experienced Windows C/C++, will work on non-Intel architecture
Richard Betel           mto@rim.net             some experience, no X
Robert Middleswarth     rmiddle@eros.com        CS student

OTHER ASSISTANCE AND OFFERS OF ASSISTANCE:

Joerg Brunsmann		Joerg.Brunsmann@FernUni-Hagen.de	Submitted fixes, I hope he'll get involved in development
Antoine Fourie          kim-ant@iafrica.com     testing, uses wxGTK
Joerg Bornschein	core@disorder.ruhr.de	web mirroring

	I especially hope that Harry Morgan and Robert Brady will be
able to integrate their changes shortly so that the cvs tree will be a
reflection of all of the latest improvements.  I was happliy surprised
to hear that were was at least a bit of Harmony hacking going on
during the development hiatus of the past few months.

	So, how do you get write access to the CVS repository?  I need
from anybody who wants cvs write access is an encrypted password in
the form that is used in /etc/passwd (or /etc/shadow).

	With your encrypted password, I would also like an
acknowledgement that your contributions will be LGPL'ed or, if clearly
marked, covered by copying conditions that are never more restrictive
than the LGPL.  For example, you should just quote this text and say
"OK".  I want to keep the copyright status of Harmony more or less as
I found it unless and until some other concensus were to develop on
that subject among actual contributors.

	Then, I will make a cvs user id for you with write access.  If
that userid were "bob", then, once this cvs user id were created, you
would set your CVSROOT environment variable accordingly, and then
check out the source tree, like this:

	export CVSROOT=bob@ftp.yggdrasil.com:/home/harmony/cvs-repository
	cvs login
	Password: <type your password here>
	cvs checkout .
	cd freeqt
	./autogen.sh
	make all
	su -c 'make install' root

	Alternatively, you can also submit patches, and I will try to
integrate them if installing cvs on your system and using it is too
much of a pain, although I think you will quickly find that cvs makes
your life easier once you start using it.

	If you want a suggestion on where to get started, I would
suggest taking one of these two approaches once you have built and
installed harmony (although you're welcome to take any approach you
want, of course):

		(1) Look at the status documetation on the web site
		    and the Qt documentation on http://www.troll.no,
		    find something that is missing from Harmony, and
		    work on it,
		(2) Try to get some simple Qt programs to run under
		    Harmony and see what needs to be fixed.

	If you're not at a level where you expect to submit fixes,
you might just try building various Qt programs under Harmony and
tracking which, if any, build and run under Harmony.  Note that
you will probably need to add something like this to the Makefile
of any Qt program that you try to build under Harmony:

CXXFLAGS+= -I/usr/include/harmony
LIBS+= -lharmony -lImlib -ltiff -lttf -lXmu -lX11


	OK, that should be enough information for anybody who wants
to get started in Harmony development.  If you have any more questions,
please let me know or ask on this list as appropriate.

	I would again like thank those of you who have stepped forward
and offerred to help.  Your efforts ultimately are the ones that will
make Harmony successful.  Thank you.


Adam J. Richter     __     ______________   4880 Stevens Creek Blvd, Suite 104
adam@yggdrasil.com     \ /                  San Jose, California 95129-1034
+1 408 261-6630         | g g d r a s i l   United States of America
fax +1 408 261-6631      "Free Software For The Rest Of Us."


P.S.	Those of you to whom I did respond over the weekend know that
I was going to create a mailing list on yggdrasil.com for active
harmony developers.  I have done this, but it has since dawned on me
that is probably unnecessary complexity at this point, as that the
existing mailing list is not that heavily trafficked.  If anyone feels
would prefer the intimacy of a smaller list or wants less traffic on
this list, please let me know.