[M3devel] Getting ready for new users (Re: HEADS UP: Release engineering)

[hendrik at topoi.pooq.com]

On Thu, Jun 25, 2009 at 06:52:06PM +0200, Olaf Wagner wrote:
> Quoting hendrik at topoi.pooq.com:
> 
> >On Thu, Jun 18, 2009 at 01:43:34PM +0200, Olaf Wagner wrote:
> >>
> >>I've now put some initial release engineering documentation onto
> >>birch, available at
> >>
> >>  http://www.opencm3.net/releng
> >
> >Well, I started with that page, assuming that it will be the one Google
> >finds when the release is finally out.  I'm continuing to act like a
> >naive user (but I'm probably not naive enough to give the instructions a
> >real test).
> >
> >It seems to have installed, but I'm not sure, because the installer
> >ended with an error message.  Here are the gory details.
> >
> >Started from http://www.opencm3.net/releng/
> >
> >I found the description quite clear.  It's still not clear just what
> >packages are in cm3-core and not in cm3-min or why I would want them,
> >but it was clear I wanted to start with cm3-core.  For example, is there
> >a UI library in cm3-core?
> >
> >(Oh why is it so hard to cut and paste from the web page to this emacs
> >buffer on my laptop?)
> 
> >cm3-bin-core-LINUXLIBC6-d5.8.1-RC1.tgz dowwnloaded without a problem.  A
> >beginner with Linux might have difficulty knowing whether to use the
> >.lzma version.
> 
> LINUXLIBC6 along with all lmza archives were created by Jay;
> I'd rather have limited the available formats. Of course this needs
> to be documented if we provide .lzma files.
> 
> >Ah! I clicked on the "standard, recommended" link (I hadn't realised it
> >was a link) and found the list of what packages are in the .tgz file.
> >One layout comment -- it consists of a series of sections, each starting
> >with a title and ending with a browse-sources link.  Each title needs to
> >look more prominent than the text or the link.  At the moment, the link
> >is what stands out.  More blank lines between the entries then within
> >them would make them group better.
> >
> >Next: do  tar -xzvf cm3-bin-core-TARGET-VERSION.tgz
> >
> >Again, that worked.  I do find myseelf wondering it that would be the
> >correct command line if I were uzinng Winzip on Windows, though.
> >(that's wha tthe insstruction seems to say)
> 
> No, Winzip of course is a GUI application where you are supposed to
> point and click with the mouse...

Probably needs rewording.

> 
> >Next I run ./cminstall /usr/local/cm3
> >
> >It asks mme whether /home.hendrik/cm3 is to be the root directory for
> >cm3.  The naive user doesn't know what that means.  Nor do I, for that
> 
> This is strange. cminstall shouldn't ask any questions by default.

Looking back, it didn't actually ask;  it just told me to restart if it 
was wrong.

> But as mentioned before, I only built the archives for FreeBSD4 and
> AMD64_LINUX (and later PPC_DARWIN). Jay, what exactly did you package
> there? Or am I misunderstanding something here?
> 
> >matter.  I'm guessing that it's where to unpack and work during
> >installation, but that it won't be needed later.  That I can even
> >deleete the entire /home/hendrik/cm3 directory tree after installation.
> >That in fact when I instll packages later I can download them to, say,
> >/anywhere and install them from /anywhere and they'll still get
> >installed in the proper place.  But I don't know.  For now, I'll just
> >accept the defaults.
> >
> >Next problem:
> >
> >>Installing CM3 in: /usr/local/cm3
> >>This may take a few minutes...
> >>
> >>Unexpected problem: cannot list current directory: errno=2
> 
> I've never seen that. Can you provide the complete installation log?
> We may also need a system call trace to track this down...
> 
> >>Please feel free to contact m3-support at elego.de to troubleshoot this
> >problem.
> >
> >Current directory?  That's an uninformative message.  Possibly it refers
> >to /usr/local/cm3?  Which really doesn't exit yet?  Should your
> >instructions say to create it and make sure it has the right write
> >permissions?
> >
> >Noooo.  that's not the reason. /usr/local/cm3 has been created.  And
> >populated with lots of subdirectories.  /usr/local/cm3/bin contains a
> >few executables and lots of other files.  It turns out I did have
> >permission to write on /usr/local.  I don't know what directory it's
> >referring to.
> 
> Strange. I tried an installation on FreeBSD which succeeded without
> any problems.

Evidently there's some directory on FreeBSD that's not so readable in 
Debian squeeze.  What directories is it likely to want to read or write?  
I could go through them and see if any are missing here.

> 
> >What next?
> 
> Let's have a look at Install.log and hear what Jay has to say about
> LINUXLIBC6.

cat, cut, and paste into the mailer:

hendrik at notlookedfor:~$ cat /usr/local/cm3/Install.log 

Thank you for using Critical Mass CM3.  This program
will configure and install the system.

cminstall_root is set to /home/hendrik/cm3
If this is not correct, please restart the installer with
-root <directory-of-installer-and-system-archive>

If the installer runs interactively, it will ask you some questions
about the locations of programs and libraries.
Usually it will display a default inside [], which can be
accepted with <Enter>.
If the installer has found several choices, you may cycle through them
with `+' or `.' for the next and `-' for the previous one.
You may of course also enter a completely different value.



Installing CM3 in: /usr/local/cm3
This may take a few minutes...

Unexpected problem: cannot list current directory: errno=2

Please feel free to contact m3-support at elego.de to troubleshoot this 
problem.

hendrik at notlookedfor:~$ 

> 
> Thanks for the feedback.

You're very welcome.

For the record, here are a few ls's showing what there *is* now.

hendrik at notlookedfor:~$ ls /usr/local
bin  cm3  etc  games  include  lib  man  sbin  share  src  stow
hendrik at notlookedfor:~$ ls /usr/local/cm3
bin  doc  elisp  examples  Install.log  lib  man  pkg
hendrik at notlookedfor:~$ ls /usr/local/cm3/*/
/usr/local/cm3/bin/:
AMD64_DARWIN   Darwin.common  m3bundle        NT386MINGNU     SOLsun
AMD64_FREEBSD  FreeBSD4       m3cgcat         PA32_HPUX       
SPARC32_LINUX
AMD64_LINUX    gnuld.common   m3cggen         PA64_HPUX       
SPARC64_LINUX
ARM_DARWIN     HPUX.common    MIPS64_OPENBSD  PPC32_OPENBSD   
SPARC64_OPENBSD
cm3            I386_DARWIN    NetBSD2_i386    PPC_DARWIN      
SPARC64_SOLARIS
cm3.cfg        I386_INTERIX   NT386           PPC_LINUX       
Unix.common
cm3cfg.common  I386_OPENBSD   NT386.common    Solaris.common
cm3cg          LINUXLIBC6     NT386GNU        SOLgnu

/usr/local/cm3/doc/:

/usr/local/cm3/elisp/:

/usr/local/cm3/examples/:

/usr/local/cm3/lib/:
libBitVector.so        libm3slisp.so            libset.so
libBitVector.so.5      libm3slisp.so.5          libset.so.5
libDiGraph.so          libm3.so                 libSortedTableExtras.so
libDiGraph.so.5        libm3.so.5               
libSortedTableExtras.so.5
libGeometry.so         libm3tcp.so              libsysutils.so
libGeometry.so.5       libm3tcp.so.5            libsysutils.so.5
libm3core.so           libm3unit.so             libtable-list.so
libm3core.so.5         libm3unit.so.5           libtable-list.so.5
libm3parseparams.so    libpatternmatching.so    libTempFiles.so
libm3parseparams.so.5  libpatternmatching.so.5  libTempFiles.so.5

/usr/local/cm3/man/:
man1

/usr/local/cm3/pkg/:
bitvector  m3bundle  m3linker   m3tools          slisp              
tempfiles
cm3        m3cgcat   m3middle   parseparams      sortedtableextras  
unittest
digraph    m3cggen   m3objfile  patternmatching  sysutils
libm3      m3core    m3quake    realgeometry     table-list
m3back     m3front   m3scanner  set              tcp
hendrik at notlookedfor:~$