Re: [avr-libc-dev] odd man pages when building docs from cvs source tarball

[Joerg Wunsch]

As Galen Seitz wrote:

> I've encountered another problem while building the docs.  There are
> some man pages being generated with odd looking file names.

> _home_galens_src_avr-libc-1.3.0.20051105_doc_examples_.3
> _home_galens_src_avr-libc-1.3.0.20051105_doc_examples_demo_.3
> _home_galens_src_avr-libc-1.3.0.20051105_doc_examples_twitest_.3
> _home_galens_src_avr-libc-1.3.0.20051105_include_.3
> _home_galens_src_avr-libc-1.3.0.20051105_include_avr_.3
> _home_galens_src_avr-libc-1.3.0.20051105_include_compat_.3
> _home_galens_src_avr-libc-1.3.0.20051105_include_util_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libc_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libc_misc_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libc_pmstring_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libc_stdio_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libc_stdlib_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libc_string_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libm_.3
> _home_galens_src_avr-libc-1.3.0.20051105_libm_fplib_.3

I can see them here, too.

This appears to be a doxygen bug.  That kind of files already gave me
major headaches with my FreeBSD port, as they arrive or disappear
based on the doxygen version.  Currently, I've got the following hooks
in the Makefile of my FreeBSD port to delete them:

.if defined(MAINTAINER_DEBUG)
ECHO_EXTRA_RM=  ${ECHO_CMD} "Removing " $${to_be_rm_ed} "..."
.else
ECHO_EXTRA_RM=  ${ECHO_CMD} "Removing extraneous man page files..."
.endif

do-install:
                # ...
.if !defined(NOPORTDOCS)
                @( \
                tmpname=$${TMPDIR:-/tmp}/avr-libc-inst.$$$$ ; \
                cd ${PREFIX}/share/doc/avr-libc/man/man3 ; \
                ${GREP} '^share/doc/.*man3/' ${PLIST_DOC} | \
                        ${SED} -e 's,.*/,,' | \
                        ${SORT} > $${tmpname}.1 ; \
                ${LS} -1  | \
                        ${SED} -e 's,.*/,,' | \
                        ${SORT} > $${tmpname}.2 ; \
                to_be_rm_ed=$$(${COMM} -13 $${tmpname}.1 $${tmpname}.2) ; \
                ${RM} -f $${tmpname}.1 $${tmpname}.2 ; \
                ${ECHO_EXTRA_RM} ; \
                ${RM} -f $${to_be_rm_ed} \
                )
.endif

Quite terrible, I know...

-- 
cheers, J"org               .-.-.   --... ...--   -.. .  DL8DTL

http://www.sax.de/~joerg/                        NIC: JW11-RIPE
Never trust an operating system you don't have sources for. ;-)