making documentation on FreeBSD 6.2

bricolage users:

I am a FreeBSD and Bricolage newbie who is attempting to get
Bricolage working on
FreeBSD 6.2 using the ports tree.  I did a make and make
install at the top level
the other night, and am fumbling my way along trying to hook
up bricolage as a
named virtual host under Apache 1.3 with mod_perl.  I would
like to RTFM locally,
so I dug for documentation and came across an interesting
looking directory.
When I try to make the documentation using the default
FreeBSD make:

    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
    # make
    "Makefile", line 37: Need an operator
    Error expanding embedded variable.


Here are the relevant lines:

    37 define generate-manpage
    38 $ $^ >/tmp/$(notdir $^).man
    39 $ /tmp/$(notdir $^).man >$
    40 endef


Looking in the GNU Make manual -- I don't see any obvious
problems (but I'm very
rusty at Make).  Perhaps make isn't GNU make?  'man make'
and 'man gmake' are
different!  Try gmake:

    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
    # gmake
    ....
    /bin/gzip: not found
    gmake: *** [man/bricolage-dba.8.gz] Error 127


Looking for gzip:

    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
    # which gzip
    /usr/bin/gzip


Hacking up the Makefile and checking the other tools (Perl
was off as well):

    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
    # diff Makefile-orig Makefile
    10,11c10,11
    < GZIP = /bin/gzip
    < PERL = /usr/local/bin/perl
    ---
    > GZIP = /usr/bin/gzip
    > PERL = /usr/bin/perl


Try again:

    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
    # gmake
    /usr/local/bin/pod2man ../lib/Bric/Security.pod
>/tmp/Security.pod.man
    /usr/bin/gzip /tmp/Security.pod.man
>man/bricolage-security.8.gz
    ....
    /usr/bin/gzip /tmp/HTMLTemplate.pod.man
>man/bricolage-htmlTemplate.3.gz


HTH,

David

On Feb 5, 2007, at 9:58 PM, David Christensen wrote:

>     rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
>     # diff Makefile-orig Makefile
>     10,11c10,11
>     < GZIP = /bin/gzip
>     < PERL = /usr/local/bin/perl
>     ---
>> GZIP = /usr/bin/gzip
>> PERL = /usr/bin/perl
>
>
> Try again:
>
>     rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
>     # gmake
>     /usr/local/bin/pod2man ../lib/Bric/Security.pod
>/tmp/ 
> Security.pod.man
>     /usr/bin/gzip /tmp/Security.pod.man
>man/bricolage-security.8.gz
>     ....
>     /usr/bin/gzip /tmp/HTMLTemplate.pod.man
>man/bricolage- 
> htmlTemplate.3.gz

Ah. So is the issue that the makefile points to the wrong
location  
for those files?

Who maintains the FreeBSD port? He would need to know about
this.

Best,

David

On Tue, Feb 06, 2007 at 11:22:08AM -0800, David E. Wheeler
wrote:
> On Feb 5, 2007, at 9:58 PM, David Christensen wrote:
> 
> >    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
> >    # diff Makefile-orig Makefile
> >    10,11c10,11
> >    < GZIP = /bin/gzip
> >    < PERL = /usr/local/bin/perl
> >    ---
> >>GZIP = /usr/bin/gzip
> >>PERL = /usr/bin/perl
> >
> >
> >Try again:
> >
> >    rootp3800
/usr/ports/www/bricolage/work/bricolage-1.10.2/doc
> >    # gmake
> >    /usr/local/bin/pod2man ../lib/Bric/Security.pod
>/tmp/ 
> >Security.pod.man
> >    /usr/bin/gzip /tmp/Security.pod.man
>man/bricolage-security.8.gz
> >    ....
> >    /usr/bin/gzip /tmp/HTMLTemplate.pod.man
>man/bricolage- 
> >htmlTemplate.3.gz
> 
> Ah. So is the issue that the makefile points to the
wrong location  
> for those files?
> 
> Who maintains the FreeBSD port? He would need to know
about this.


That'd be our friend Rod Taylor -- I cc'd this to him.


> Best,
> 
> David

-- 

-bch