Experimental Physics and
Industrial Control System

"J. Lewis Muir" <[email protected]> · Thu, 02 Oct 2008 11:56:11 -0400

On 9/29/08 6:38 PM, Andrew Johnson wrote:

snip

> Comments, bug reports, questions and thanks should go to tech-talk; monetary 
> expressions of gratitude to the Core Developer's Beer/Wine Fund at the INFN 
> meeting.

Hi, Andrew.

Thanks for all your work toward the 3.14.10 release!

A few comments.

Platform: darwin-x86 (Mac OS X 10.5.5); gcc 4.0.1

1. I noticed the distribution contains .cvsignore files.  These can
trivially be removed before packaging on a modern UNIX environment with
something like:

  $ find . -name '.cvsignore' -print0 | xargs -0 rm

2. I get various compiler warnings when building.  This is not new, but
if you want to see them, search for "warning" in my build log at

  http://www.imca.aps.anl.gov/~jlmuir/epics-3.14.10-build.txt

3. The host platforms list in the README at

  http://www.aps.anl.gov/epics/base/R3-14/10-docs/README.html

does not match the list in configure/CONFIG_SITE.  For example,
darwin-x86 and others are not listed in the README.

4. I was hoping for an easy way to run all tests for my platform (such
as "make test" from the EPICS base root directory), but I couldn't find
it.  I ended up doing the following:

  $ cd src/libCom/O.darwin-x86
  $ for each in `ls -1 *.t`; do perl $each; done

Is there a better way?

All the libCom tests seemed to pass.  A log, if you're interested, is at

  http://www.imca.aps.anl.gov/~jlmuir/epics-3.14.10-libCom-test.txt

5. It would be nice if the EPICS Application Developer's Guide used
links (hyper-references?) in the table of contents.  This would make it
easy to jump to a section of interest.  Delta Tau does this with most of
their documentation and I've found it to be pretty convenient.  Here's
an example:

  http://www.deltatau.com/fmenu/ACC-26A.PDF

If your PDF viewer supports it, you can click on a section in the table
of contents and jump right to it.

It looks like you're using Adobe FrameMaker 6.0 to create the
Application Developer's Guide.  Does FrameMaker support making the table
of contents with links like this?

Thanks,

Lewis

-- 
J. Lewis Muir
Software Engineer
IMCA-CAT/CARS

Experimental Physics and Industrial Control System

Experimental Physics and
Industrial Control System