Re: Doxygen + Autotools integration

2008-10-03 Thread Stefano D'Angelo
Just to let you know, I updated that stuff to Doxygen 1.5.7, added
support for Qt Help Project output and fixed some little things. It
currently doesn't work well because of a bad doxygen bug
(http://bugzilla.gnome.org/show_bug.cgi?id=554379), but it should have
worked.

Since it's likely I will make other changes, I leave you the address
of the hg repo: http://hg.atheme.org/naspro/

Best regards,

Stefano




Re: Doxygen + Autotools integration

2008-10-03 Thread Stefano D'Angelo
2008/10/3 John Calcote <[EMAIL PROTECTED]>:
> I apologize for my lack of communication here. I didn't mean to ever
> imply that my solution was the best one out there. I was simply giving
> you some more resources to look at for building your generic doxygen
> solution. I only hope it was helpful.

No problem, don't worry. Plus, my solution cannot be considered just
"generic" (yet?).

Ah, and your manual reminded me of $EXEEXT :-P

Ciao,

Stefano




Re: Doxygen + Autotools integration

2008-10-03 Thread John Calcote
Stefano D'Angelo wrote:
> 2008/10/3 Stefano D'Angelo <[EMAIL PROTECTED]>:
>   
>> 2008/10/2 John Calcote <[EMAIL PROTECTED]>:
>> 
>>> You may wish to check out my book on Autotools, hosted by Free Software
>>> Magazine. In there, I make several references to doxygen, and use code
>>> snippets to implement doxygen targets within the sample projects and
>>> examples provided in the book.
>>>
>>> http://www.freesoftwaremagazine.com/books/autotools_a_guide_to_autoconf_automake_libtool
>>>   
>> Well... at first sight the whole thing seems a bit "simplicistic" to
>> me, maybe also because I'm generating html, ps, pdf, dvi and man
>> output with Doxygen. I'll give it a better look tomorrow maybe.
>> 
>
> Ok, read it. I have to congratulate with you for the manual, which
> looks way better than the "autobook" (and less outdated of course),
> but as said, the proposed solution wouldn't satisfy my needs.
>
> Other than that, I think you could have used AC_CHECK_PROG instead of
> AC_CHECK_PROGS to look for the doxygen binary, since it already does
> the -z test on the variable used to store its path, thus you wouldn't
> need the AC_PROG_TRY_DOXYGEN macro.
Stefano,

I apologize for my lack of communication here. I didn't mean to ever
imply that my solution was the best one out there. I was simply giving
you some more resources to look at for building your generic doxygen
solution. I only hope it was helpful.

Cheers,
John




Re: Doxygen + Autotools integration

2008-10-03 Thread Stefano D'Angelo
2008/10/3 Stefano D'Angelo <[EMAIL PROTECTED]>:
> 2008/10/2 John Calcote <[EMAIL PROTECTED]>:
>> You may wish to check out my book on Autotools, hosted by Free Software
>> Magazine. In there, I make several references to doxygen, and use code
>> snippets to implement doxygen targets within the sample projects and
>> examples provided in the book.
>>
>> http://www.freesoftwaremagazine.com/books/autotools_a_guide_to_autoconf_automake_libtool
>
> Well... at first sight the whole thing seems a bit "simplicistic" to
> me, maybe also because I'm generating html, ps, pdf, dvi and man
> output with Doxygen. I'll give it a better look tomorrow maybe.

Ok, read it. I have to congratulate with you for the manual, which
looks way better than the "autobook" (and less outdated of course),
but as said, the proposed solution wouldn't satisfy my needs.

Other than that, I think you could have used AC_CHECK_PROG instead of
AC_CHECK_PROGS to look for the doxygen binary, since it already does
the -z test on the variable used to store its path, thus you wouldn't
need the AC_PROG_TRY_DOXYGEN macro.

Stefano




Re: Doxygen + Autotools integration

2008-10-02 Thread Stefano D'Angelo
2008/10/2 John Calcote <[EMAIL PROTECTED]>:
> You may wish to check out my book on Autotools, hosted by Free Software
> Magazine. In there, I make several references to doxygen, and use code
> snippets to implement doxygen targets within the sample projects and
> examples provided in the book.
>
> http://www.freesoftwaremagazine.com/books/autotools_a_guide_to_autoconf_automake_libtool

Well... at first sight the whole thing seems a bit "simplicistic" to
me, maybe also because I'm generating html, ps, pdf, dvi and man
output with Doxygen. I'll give it a better look tomorrow maybe.

Anyway, I just wanted to share what I did and see whether someone else
would like to take the challenge, otherwise I'm perfectly happy with
what I've already done. I do, honestly, have more important things to
work on at the moment.

Stefano




Re: Doxygen + Autotools integration

2008-10-02 Thread John Calcote
You may wish to check out my book on Autotools, hosted by Free Software
Magazine. In there, I make several references to doxygen, and use code
snippets to implement doxygen targets within the sample projects and
examples provided in the book.

http://www.freesoftwaremagazine.com/books/autotools_a_guide_to_autoconf_automake_libtool

I throw these references out into the list sometimes because people come
and go, and every few months, I noticed an increasing number of
questions regarding topics that are mentioned in detail in the book.

Regards,
John

Peter Johansson wrote:
> Hi Stefano,
>
> Stefano D'Angelo wrote:
>> 2008/10/2 Peter Johansson <[EMAIL PROTECTED]>:
>>  
>>> Hi Stefano,
>>> 
>>
>> Hi Peter,
>>
>>  
>>> Have you checked the macro written by Oren Ben-Kiki that is
>>> available from
>>> the Autoconf Macro Archive:
>>> 
>>
>> Yes (I also named that in my prevoius e-mail -
>> http://www.ben-kiki.org/oren/doxample)
> Sorry, I missed that.
>
>> , and I'm not the only one to
>> think that it sucks on many fronts.
>>   
> Well, I have to admit that when I looked at it a couple of years ago,
> I chose to not use it.
>
> Looks like what I instead created is similar to your example. Will
> have a closer look at your Makefile.am to see if I can pick up any
> improvements. Thanks.
>
>
> Cheers,
> Peter
>
>
>
> ___
> Autoconf mailing list
> [EMAIL PROTECTED]
> http://lists.gnu.org/mailman/listinfo/autoconf
>





Re: Doxygen + Autotools integration

2008-10-02 Thread Peter Johansson

Hi Stefano,

Stefano D'Angelo wrote:

2008/10/2 Peter Johansson <[EMAIL PROTECTED]>:
  

Hi Stefano,



Hi Peter,

  

Have you checked the macro written by Oren Ben-Kiki that is available from
the Autoconf Macro Archive:



Yes (I also named that in my prevoius e-mail -
http://www.ben-kiki.org/oren/doxample)

Sorry, I missed that.


, and I'm not the only one to
think that it sucks on many fronts.
  
Well, I have to admit that when I looked at it a couple of years ago, I 
chose to not use it.


Looks like what I instead created is similar to your example. Will have 
a closer look at your Makefile.am to see if I can pick up any 
improvements. Thanks.



Cheers,
Peter





Re: Doxygen + Autotools integration

2008-10-02 Thread Stefano D'Angelo
2008/10/2 Peter Johansson <[EMAIL PROTECTED]>:
> Hi Stefano,

Hi Peter,

> Have you checked the macro written by Oren Ben-Kiki that is available from
> the Autoconf Macro Archive:

Yes (I also named that in my prevoius e-mail -
http://www.ben-kiki.org/oren/doxample), and I'm not the only one to
think that it sucks on many fronts.

Stefano




Re: Doxygen + Autotools integration

2008-10-02 Thread Peter Johansson

Hi Stefano,

Stefano D'Angelo wrote:

Hi all,

My name is Stefano and I'm the author of NASPRO (http://naspro.atheme.org).

I've been playing a bit lately trying to write support for Doxygen on
Autoconf/Automake and here I am to give you the results of my work.

  
Have you checked the macro written by Oren Ben-Kiki that is available 
from the Autoconf Macro Archive:


http://autoconf-archive.cryp.to/ax_prog_doxygen.html


Cheers,
Peter