Build system

[Onno Kortmann]

Hello,
[Chad, I'm digging through the archives... thanks for your information!]
In order to get into Common C++, here are some build system complains and 
fixes :)

1. The configure-scripts looks for doc/html to build some bsd package list 
but then builds it using the doc/man3 directory. This leads to a cosmetic 
configure error 

ls: doc/man3/*.3cc: No such file or directory

if one removes the man3/ directory but leaves the html/ dir in order to save 
some space.

A Patch is appended. I hope I made it right since I'm on Debian GNU/Linux, 
not FreeBSD.

2. Another thing:

I noticed the files "Doxyfile" and "Doxyman" in doc/. As the first line in 
each file states, Doxyfile is for html/latex generation and Doxyman for 
manual generation. Diffiing these two files, I found some interesting things:

commoncpp2/doc$ diff Doxyfile Doxyman
2c2
< # Generate doxy documentation in html and latex format.
---
> # Generate doxy documentation in man format.
18c18
< PROJECT_NAME         ="GNU CommonC++"
---
> PROJECT_NAME         =CommonC++
140c140
< CASE_SENSE_NAMES     = NO
---
> CASE_SENSE_NAMES     = YES
211c211
< EXAMPLE_PATH         = ../demo ../tests
---
> EXAMPLE_PATH         =
242c242
< GENERATE_HTML        = YES
---
> GENERATE_HTML        = NO
280c280
< GENERATE_HTMLHELP    = YES
---
> GENERATE_HTMLHELP    = NO
301c301
< GENERATE_LATEX       = YES
---
> GENERATE_LATEX       = NO
347c347
< GENERATE_MAN         = NO
---
> GENERATE_MAN         = YES
353c353
< MAN_OUTPUT           =
---
> MAN_OUTPUT           = .
358c358
< MAN_EXTENSION        = .3
---
> MAN_EXTENSION        = .3cc
commoncpp2/doc$

I suppose, these differences shouldn't be there?
And, I think it would be better to put the common things into Doxyfile and 
create "Doxyhtml" "Doxylatex" and a new "Doxyman3" with the specific things.
The Makefile can then handle the concatenation of these files.
That would be a more OO approach, having some kind of configuration file 
inheritance ;))

I have made these changes, another patch for that is appended. Please also 
add the two files Doxyhtml and Doxylatex into the doc/ directory, cvs diff 
doesn't diff them because they have to be added first...

To create documentation then, go into doc/ and execute either

make html, make latex, make man or make alldoc.



Regards,

Onno

commoncpp-configure-freebsd-pkgplist.diff
Description: Text Data

commoncpp-doxygen-makefile.diff
Description: Text Data

Doxylatex
Description: Text document

Doxyhtml
Description: Text document