[Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Rodrigo Rosenfeld Rosas]

Hi Jan,

When compiling svn xenomai I noticed the following error with --enable-dox-doc 
switch:

CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef

Best Regards,

Rodrigo.

		
_______________________________________________________
Yahoo! Acesso Grátis - Internet rápida e grátis. Instale o discador agora!
http://br.acesso.yahoo.com

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Jan Kiszka]

[-- Attachment #1: Type: text/plain, Size: 461 bytes --]

Rodrigo Rosenfeld Rosas wrote:
> Hi Jan,
> 
> When compiling svn xenomai I noticed the following error with --enable-dox-doc 
> switch:
> 
> CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
> kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
> 

I just passed this stage with trunk revision 671 without problems
(doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
stuff in the latest drvlib.c at line 1513.

Jan


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Rodrigo Rosenfeld Rosas]

Em Quarta 08 Mar=E7o 2006 14:35, Jan Kiszka escreveu:

>Rodrigo Rosenfeld Rosas wrote:
>> Hi Jan,
>>
>> When compiling svn xenomai I noticed the following error with
>> --enable-dox-doc switch:
>>
>> CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
>> kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
>
>I just passed this stage with trunk revision 671 without problems
>(doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
>stuff in the latest drvlib.c at line 1513.

I think I still didn't learn how to use the svn tool. I downloaded xenomai=
=20
today with (xenomai dir already existed)
   svn co http://svn.gna.org/svn/xenomai/trunk xenomai
And I got 670 revision.
Then I renamed xenomai to xenomai.old and did the same command again. Then =
I=20
got the 671 revision and that is working fine with --enable-dox-doc.

Thanks,

Rodrigo.

		
_______________________________________________________
Yahoo! Acesso Grátis - Internet rápida e grátis. Instale o discador agora!
http://br.acesso.yahoo.com

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Jan Kiszka]

[-- Attachment #1: Type: text/plain, Size: 1123 bytes --]

Rodrigo Rosenfeld Rosas wrote:
> Em Quarta 08 Março 2006 14:35, Jan Kiszka escreveu:
> 
>> Rodrigo Rosenfeld Rosas wrote:
>>> Hi Jan,
>>>
>>> When compiling svn xenomai I noticed the following error with
>>> --enable-dox-doc switch:
>>>
>>> CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
>>> kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
>> I just passed this stage with trunk revision 671 without problems
>> (doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
>> stuff in the latest drvlib.c at line 1513.
> 
> I think I still didn't learn how to use the svn tool. I downloaded xenomai 
> today with (xenomai dir already existed)
>    svn co http://svn.gna.org/svn/xenomai/trunk xenomai

"svn update" should already be enough, no need for yet another checkout.
"svn status" can show you if you have local differences or even conflicts.

> And I got 670 revision.
> Then I renamed xenomai to xenomai.old and did the same command again. Then I 
> got the 671 revision and that is working fine with --enable-dox-doc.
> 
> Thanks,
> 
> Rodrigo.
> 

Jan


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Gilles Chanteperdrix]

Jan Kiszka wrote:
 > Rodrigo Rosenfeld Rosas wrote:
 > > Hi Jan,
 > > 
 > > When compiling svn xenomai I noticed the following error with --enable-dox-doc 
 > > switch:
 > > 
 > > CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
 > > kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
 > > 
 > 
 > I just passed this stage with trunk revision 671 without problems
 > (doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
 > stuff in the latest drvlib.c at line 1513.

I have a few warnings with doxygen 1.4.2:

ksrc/skins/rtdm/drvlib.c:151: Warning: Member rtdm_task_destroy found in multiple @defgroup groups! The member will be put in group rtdmtask, and not in group rtdmtask

But the --enable-dox-doc flag should not have any influence on kernel
compilation.

-- 


					    Gilles Chanteperdrix.

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Jan Kiszka]

[-- Attachment #1: Type: text/plain, Size: 1227 bytes --]

Gilles Chanteperdrix wrote:
> Jan Kiszka wrote:
>  > Rodrigo Rosenfeld Rosas wrote:
>  > > Hi Jan,
>  > > 
>  > > When compiling svn xenomai I noticed the following error with --enable-dox-doc 
>  > > switch:
>  > > 
>  > > CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
>  > > kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
>  > > 
>  > 
>  > I just passed this stage with trunk revision 671 without problems
>  > (doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
>  > stuff in the latest drvlib.c at line 1513.
> 
> I have a few warnings with doxygen 1.4.2:
> 
> ksrc/skins/rtdm/drvlib.c:151: Warning: Member rtdm_task_destroy found in multiple @defgroup groups! The member will be put in group rtdmtask, and not in group rtdmtask

That's totally weird: "You are in rtdmtask, and not in rtdmtask!?" Even
more confusing, there is only a single "@defgroup rtdmtask" in the code.

I think I said this before: doxygen's error reporting sucks! I'm not
excluding that something is broken here, but I don't know where to look.
Could anyone of you try some older revisions of drvlib.c and
rtdm.h/rtdm_driver.h to check where the regression(?) may come from?

Jan


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Gilles Chanteperdrix]

Jan Kiszka wrote:
 > Gilles Chanteperdrix wrote:
 > > Jan Kiszka wrote:
 > >  > Rodrigo Rosenfeld Rosas wrote:
 > >  > > Hi Jan,
 > >  > > 
 > >  > > When compiling svn xenomai I noticed the following error with --enable-dox-doc 
 > >  > > switch:
 > >  > > 
 > >  > > CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
 > >  > > kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
 > >  > > 
 > >  > 
 > >  > I just passed this stage with trunk revision 671 without problems
 > >  > (doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
 > >  > stuff in the latest drvlib.c at line 1513.
 > > 
 > > I have a few warnings with doxygen 1.4.2:
 > > 
 > > ksrc/skins/rtdm/drvlib.c:151: Warning: Member rtdm_task_destroy found in multiple @defgroup groups! The member will be put in group rtdmtask, and not in group rtdmtask
 > 
 > That's totally weird: "You are in rtdmtask, and not in rtdmtask!?" Even
 > more confusing, there is only a single "@defgroup rtdmtask" in the code.
 > 
 > I think I said this before: doxygen's error reporting sucks! I'm not
 > excluding that something is broken here, but I don't know where to look.
 > Could anyone of you try some older revisions of drvlib.c and
 > rtdm.h/rtdm_driver.h to check where the regression(?) may come from?

I have just checked, the error appears with revision 121, an old
one. EXPORT_SYMBOL may be the culprit, again...

-- 


					    Gilles Chanteperdrix.

Re: [Xenomai-core] Error on rtdm skin with --enable-dox-doc

[Jan Kiszka]

[-- Attachment #1: Type: text/plain, Size: 1942 bytes --]

Gilles Chanteperdrix wrote:
> Jan Kiszka wrote:
>  > Gilles Chanteperdrix wrote:
>  > > Jan Kiszka wrote:
>  > >  > Rodrigo Rosenfeld Rosas wrote:
>  > >  > > Hi Jan,
>  > >  > > 
>  > >  > > When compiling svn xenomai I noticed the following error with --enable-dox-doc 
>  > >  > > switch:
>  > >  > > 
>  > >  > > CC [M]  kernel/xenomai/skins/rtdm/drvlib.o
>  > >  > > kernel/xenomai/skins/rtdm/drvlib.c:1513:1: error: unterminated #ifdef
>  > >  > > 
>  > >  > 
>  > >  > I just passed this stage with trunk revision 671 without problems
>  > >  > (doxygen 1.4.4). Moreover, there is no #ifdef or related preprocessor
>  > >  > stuff in the latest drvlib.c at line 1513.
>  > > 
>  > > I have a few warnings with doxygen 1.4.2:
>  > > 
>  > > ksrc/skins/rtdm/drvlib.c:151: Warning: Member rtdm_task_destroy found in multiple @defgroup groups! The member will be put in group rtdmtask, and not in group rtdmtask
>  > 
>  > That's totally weird: "You are in rtdmtask, and not in rtdmtask!?" Even
>  > more confusing, there is only a single "@defgroup rtdmtask" in the code.
>  > 
>  > I think I said this before: doxygen's error reporting sucks! I'm not
>  > excluding that something is broken here, but I don't know where to look.
>  > Could anyone of you try some older revisions of drvlib.c and
>  > rtdm.h/rtdm_driver.h to check where the regression(?) may come from?
> 
> I have just checked, the error appears with revision 121, an old
> one. EXPORT_SYMBOL may be the culprit, again...
> 

It seems so. Doxygen 1.4.6, e.g., is messing up the RTDM groups.

I just played with a few workarounds, this one here seems to have the
effect we need:

PREDEFINED             = DOXYGEN_CPP \
        "EXPORT_SYMBOL(symbol)=struct {}"

Alternatively, I could move EXPORT_SYMBOL in drvlib.c out of all doxygen
groups, giving up the locality of function definition and symbol export
again. :(

Jan


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 250 bytes --]