Re: [boost] Synopsis Thoughts (was Re: Reference documentation)

From: David Abrahams (dave_at_[hidden])
Date: 2002-11-01 20:45:23

Larry Evans <jcampbell3_at_[hidden]> writes:

> David Abrahams wrote:
> 
> >I don't do an install. All I do is
> >
> >   autoconf
> >   ./configure
> >   make
> >   cd demo/Boost
> >   export PYTHONPATH=`cd ..\.. && pwd`
> >   make boostdemo

Err, whoops. I forgot. I also make a symbolic link to the root of my
boost tree in demo/Boost, called 'boost'.

> But I was hoping to use it to document any (including boost files),
> not just the demo files.  That's why I wanted to install it.

That's fine; just change the line in boost.synopsis that says:

        ['Base', 'boost/boost/python/', '*.hpp']

Appropriately. I confess I'm not certain what 'Base' means, but surely
the rest is obvious?

> >
> >>I think maybe changing the definition of make macro, SRC to:
> >>
> >>SRC    := $(basename $(wildcard *.py))
> >>
> >>in several of the Makefiles would help.
> >>
> >
> >Why? How?
> >
> Because on at least one of the Makefiles I downloaded
> the *.py and *.pyc file list was incomplete. The above
> suggested change would get all of them.

Ah. I don't really know make.

> I checked out the cvs version a few days ago; so, maybe it's
> uptodate now. Checking:
> 
> .../Synopsis/Linker/Makefile?rev=1.10
> 
> illustrates the problem I'm referring to. The 1.11 revision
> (changed 2hrs 20min ago) corrects the problem. But it
> wouldn't be there with the above suggested change.
> 
> >
> >>David, do you have a corrected version of the code that other
> >>boosters could use to avoid others stumbling over these problems?
> >>
> >
> >I'm not having any of these problems.
> >
> And you're using the cvs version?

Yup. Well, I haven't updated in a day or so...

-- 
                    David Abrahams
dave_at_[hidden] * http://www.boost-consulting.com
#################################################################
#################################################################
#################################################################
#####
#####
#####
#################################################################
#################################################################
#################################################################