[mpich-discuss] man mpich-3.0.4

[Jeff Hammond]

You're right, I downloaded the 3.1b1 tarball specifically so I could
get the man pages.

However, since my doctext business is in the default path, I fail to
see why it is not found, nor why setting TEXTFILTER_PATH has no
effect.

Jeffs-MacBook-Pro:build-clang jhammond$ ll /usr/local/share/doctext/nroff.def
-rw-r--r--  1 root  wheel   1.3K Dec  4  2012 /usr/local/share/doctext/nroff.def

Jeffs-MacBook-Pro:build-clang jhammond$ export TEXTFILTER_PATH=/usr/local
Jeffs-MacBook-Pro:build-clang jhammond$ make mandoc
test -d /Users/jhammond/eclipse/MPICH/git/build-clang/man/man1 ||
mkdir -p /Users/jhammond/eclipse/MPICH/git/build-clang/man/man1
test -d /Users/jhammond/eclipse/MPICH/git/build-clang/man/man3 ||
mkdir -p /Users/jhammond/eclipse/MPICH/git/build-clang/man/man3
make  mandoc-local
   DOCTEXTMAN   src/mpi/attr/attr_delete.man-phony
Error: Error reading nroff.def in path .:NONE/share or
TEXTFILTER_PATH environment variable:-1
make[1]: *** [src/mpi/attr/attr_delete.man-phony] Error 1
make: *** [mandoc] Error 2

Jeffs-MacBook-Pro:build-clang jhammond$ TEXTFILTER_PATH=/usr/local make mandoc
test -d /Users/jhammond/eclipse/MPICH/git/build-clang/man/man1 ||
mkdir -p /Users/jhammond/eclipse/MPICH/git/build-clang/man/man1
test -d /Users/jhammond/eclipse/MPICH/git/build-clang/man/man3 ||
mkdir -p /Users/jhammond/eclipse/MPICH/git/build-clang/man/man3
make  mandoc-local
   DOCTEXTMAN   src/mpi/attr/attr_delete.man-phony
Error: Error reading nroff.def in path .:NONE/share or
TEXTFILTER_PATH environment variable:-1
make[1]: *** [src/mpi/attr/attr_delete.man-phony] Error 1
make: *** [mandoc] Error 2

Jeff

On Sun, Sep 29, 2013 at 6:05 PM, Ken Raffenetti <raffenet at mcs.anl.gov> wrote:
> I'm surprised there were man pages to be copied. Did you build from a tarball? The make target uses the doctext and sowing packages to build man pages from comments in the mpich source. If your manpages are already built, you could use "make install-man-local" to copy them in place. The configure option to change their location is --mandir.
>
> ----- Original Message -----
>> From: "Jeff Hammond" <jeff.science at gmail.com>
>> To: discuss at mpich.org
>> Sent: Sunday, September 29, 2013 5:42:22 PM
>> Subject: Re: [mpich-discuss] man mpich-3.0.4
>>
>> Why is any of that required?  I was able to install the man pages by
>> hand with "/bin/cp -r".  Why do I need doctext for "make mandoc" to
>> work?  Shouldn't "make mandoc" just do that?
>>
>> Jeff
>>
>> On Sun, Sep 29, 2013 at 5:17 PM, Ken Raffenetti
>> <raffenet at mcs.anl.gov> wrote:
>> > You need to set that environment variable relative to your doctext
>> > installation. The default location is /usr/local/share/doctext.
>> >
>> > ----- Original Message -----
>> >> From: "Jeff Hammond" <jeff.science at gmail.com>
>> >> To: discuss at mpich.org
>> >> Sent: Sunday, September 29, 2013 1:51:37 PM
>> >> Subject: Re: [mpich-discuss] man mpich-3.0.4
>> >>
>> >> > The target is "make mandoc".  And yes, if you don't specify
>> >> > --manpage, it'll put it in your prefix path by default.  You
>> >> > only
>> >> > need to provide the additional --manpage information if you want
>> >> > to install it in a different location.  You never have to copy
>> >> > it
>> >> > manually.
>> >>
>> >> What does this mean?
>> >>
>> >> Jeffs-MacBook-Pro:build-clang jhammond$ make mandoc
>> >> test -d /Users/jhammond/eclipse/MPICH/git/build-clang/man/man1 ||
>> >> mkdir -p /Users/jhammond/eclipse/MPICH/git/build-clang/man/man1
>> >> test -d /Users/jhammond/eclipse/MPICH/git/build-clang/man/man3 ||
>> >> mkdir -p /Users/jhammond/eclipse/MPICH/git/build-clang/man/man3
>> >> make  mandoc-local
>> >>    DOCTEXTMAN   src/mpi/attr/attr_delete.man-phony
>> >> Error: Error reading nroff.def in path .:NONE/share or
>> >> TEXTFILTER_PATH environment variable:-1
>> >> make[1]: *** [src/mpi/attr/attr_delete.man-phony] Error 1
>> >> make: *** [mandoc] Error 2
>> >>
>> >> Thanks,
>> >>
>> >> Jeff
>> >>
>> >> --
>> >> Jeff Hammond
>> >> jeff.science at gmail.com
>> >> _______________________________________________
>> >> discuss mailing list     discuss at mpich.org
>> >> To manage subscription options or unsubscribe:
>> >> https://lists.mpich.org/mailman/listinfo/discuss
>> >>
>> > _______________________________________________
>> > discuss mailing list     discuss at mpich.org
>> > To manage subscription options or unsubscribe:
>> > https://lists.mpich.org/mailman/listinfo/discuss
>>
>>
>>
>> --
>> Jeff Hammond
>> jeff.science at gmail.com
>> _______________________________________________
>> discuss mailing list     discuss at mpich.org
>> To manage subscription options or unsubscribe:
>> https://lists.mpich.org/mailman/listinfo/discuss
>>
> _______________________________________________
> discuss mailing list     discuss at mpich.org
> To manage subscription options or unsubscribe:
> https://lists.mpich.org/mailman/listinfo/discuss



-- 
Jeff Hammond
jeff.science at gmail.com