[Zope-CMF] Re: INSTALL.txt is incorrect and misleading.

[Tres Seaver]

Mukhsein Johari wrote:

> I recently downloaded CMF 1.1 and am using the latest Zope-2.4.2 for linux. I 
> tried to make sense of the INSTALL.txt that came with the CMF package and 
> installed it (the CMF-1.1 directory) into lib/python/Products. Of course, 
> this does not work.
> 
> Luckily, I remembered that there was a zope-cmf mailing list and trawled 
> through it to look for some clue. And there was, under the subject thread of 
> "Installing". I've got it up and running now.
> 
> Thing is all this confusion and frustration could have been prevented if only 
> the INSTALL.txt file was more accurate!!
> 
> I hope you or the package admin would correct the documentation.


I'm sorry you found the INSTALL.txt unhelpful.  I am a bit puzzled by
the problem you have, as the file clearly shows linking the CMF *packages*
into the Products directory, rather than the top-level "tarball" directory.

The current text says::

  2. Link (or copy/move) the CMF packages into
     $INSTANCE_HOME/Products.  For instance::

The example currentl reads::

     $ cd /var/zope/Products
     $ ln -s /usr/local/zope/CMF-1.1beta/CMF* .

Perhaps you could suggest alternate language or examples for step 2?

I have received feedback from Windows users that I should be providing

additional examples which don't presume a Unix-like shell (the 'ln -s'

part really confused them).


Tres.
-- 
===============================================================
Tres Seaver                                tseaver@zope.com
Zope Corporation      "Zope Dealers"       http://www.zope.com