[Casa-framework] another svn query
Kumar Golap
kgolap at nrao.edu
Sat Oct 28 15:23:20 EDT 2006
I don't know much about the doxygen markup syntax or doxygen
switches...but is it going to be difficult to write a script that
convert the cxx2html tags to doxygen tags.
Kumar
On 10/28/06, Raymond Rusk <Raymond.Rusk at nrc-cnrc.gc.ca> wrote:
> On Sat, 28 Oct 2006, Wim.Brouw at csiro.au wrote:
>
> >
> > Raymond,
> >
> > Ger produced a full tree of aips++ in early 2002, by just adding a
> > script to a doxygen run.
>
> Hi Wim,
>
> I think that I have roughly the same thing for the latest framework code
> at http://shiraz.drao.nrc.ca:8080/casadoc/. Doxygen has quite a few
> switches but I probably have the most important ones toggled correctly in
> the configuration file. The main page looks like the ATM doxygen output
> because it is the only code that has doxygen markup. However, links to
> everything else are at the top of the page.
>
> Raymond
>
> > It created a full tree etc. Your address is part of that, see:
> > http://www.astron.nl/~gvd/aips++/docxxhtml/index.html
> >
> > For the full story (as of that date).
> >
> > Wim
> >
> >
> >
> > ------------------------------------------------------------------
> > Contact details: www.astro.rug.nl/~brouw/wbrouw.html
> > ------------------------------------------------------------------
> >
> >
> >
> > > -----Original Message-----
> > > From: casa-framework-bounces at donar.cv.nrao.edu
> > > [mailto:casa-framework-bounces at donar.cv.nrao.edu] On Behalf
> > > Of Raymond Rusk
> > > Sent: 27 October 2006 22:49
> > > To: jaeger at cpsc.ucalgary.ca
> > > Cc: casa-framework at nrao.edu
> > > Subject: Re: [Casa-framework] another svn query
> > >
> > > Hi Shannon,
> > >
> > > ASTRON is further along with Doxygen than we are. If you go
> > > to
> > > http://www.astron.nl/~gvd/aips++/docxxhtml/classQuantumHolder.
> > > html, for instance, you get a nice class hierarchy diagram.
> > > It is the non-framework
> > > AIPS++, of course, but the basic libraries haven't changed
> > > that much.
> > > AIPS++It
> > > will be nice when we have this level of documentation as well.
> > >
> > > Raymond
> > >
> > > On Fri, 27 Oct 2006, jaeger at cpsc.ucalgary.ca wrote:
> > >
> > > > au contraire!
> > > >
> > > > Doxygen provides a much richer document set the latex
> > > generated from
> > > > the xml, from what I can see. At least from a programmers point of
> > > > vies.
> > > >
> > > > Based on what I've seen the xml generated documentation is
> > > a lot like
> > > > reading a book, not really a website. There are also a lot of
> > > > comments there that are more about how to use casapy then about the
> > > > software design. In fact there is very little to no
> > > information about
> > > > software design.
> > > >
> > > > Doxygen produces a hierarchical set of webpages that even includes
> > > > class hierarchy diagrams. A much more useful tool to the developer
> > > > then stripping out the software design stuff in amongst the
> > > software
> > > > usage stuff.
> > > >
> > > > Shannon
> > > >
> > > > > Documentation should be in the XML, the headers are generated.
> > > > > Doxygen on generated headers makes little sense, it could be done
> > > > > though if there is demand, just not right now.
> > > > >
> > > > > wes
> > > > > wyoung at aoc.nrao.edu
> > > > >
> > > > >
> > > > > On 27 Oct 2006, at 17:06, Raymond Rusk wrote:
> > > > >
> > > > >> Hi Wes/David,
> > > > >>
> > > > >> Chiming in on David's comment about preserving programmer's
> > > > >> statement of intent from the past, one issue I see with our
> > > > >> auto-generated headers is that it makes in-line
> > > documentation more
> > > > >> of a challenge. Much of the documentation in the old
> > > DOs appears
> > > > >> in the headers. That is where Doxygen markup would normally
> > > > >> appear. Our new framework makes it easier to lose this
> > > information
> > > > >> than to retain it.
> > > > >>
> > > > >> Raymond
> > > > >>
> > > > >> On Fri, 27 Oct 2006, Wes Young wrote:
> > > > >>
> > > > >>> In a word, no. It's a clean break. Yes we could have but we
> > > > >>> chose to leave the past behind. So you want cvs history
> > > use cvs commands.
> > > > >>>
> > > > >>> wes
> > > > >>> wyoung at aoc.nrao.edu
> > > > >>>
> > > > >>>
> > > > >>> On 27 Oct 2006, at 16:11, David King wrote:
> > > > >>>
> > > > >>>> Hi all:
> > > > >>>>
> > > > >>>> One thing I'd wanted to ask: what about retaining the
> > > revision
> > > > >>>> history from cvs? My perusal of the svn doc seemed to
> > > indicate
> > > > >>>> they considered it valuable (I agree), and I think they worked
> > > > >>>> hard to allow it to be preserved on import from cvs,
> > > but I dont
> > > > >>>> see it in the svn repository. (Is it already too late)?
> > > > >>>>
> > > > >>>> dk
> > > > >>>
> > > > >>> _______________________________________________
> > > > >>> Casa-framework mailing list
> > > > >>> Casa-framework at donar.cv.nrao.edu
> > > > >>> http://listmgr.cv.nrao.edu/mailman/listinfo/casa-framework
> > > > >>>
> > > > >>
> > > > >> --
> > > > >> Dr. Raymond Rusk
> > > Dr. Raymond
> > > > >> Rusk
> > > > >> ALMA Software Engineer
> > > Ingenieur Logiciel
> > > > >> ALMA
> > > > >> National Research Council Canada Conseil national de recherches
> > > > >> Canada
> > > > >> Herzberg Institute of Astrophysics L'Institut Herzberg
> > > > >> d'Astrophysique
> > > > >> DRAO, P.O. Box 248 OFRA, B.P.
> > > > >> Box 248
> > > > >> Penticton, BC V2A 6J9 |\^/| Penticton, (C.-B.)
> > > > >> V2A 6J9
> > > > >> Government of Canada _|\| |/|_ Gouvernement du
> > > > >> Canada
> > > > >> Tel: (250)490-4347 > < Tel: (250)
> > > > >> 490-4347
> > > > >> Fax: (250)493-7767 >_./|\._< Fax: (250)
> > > > >> 493-7767
> > > > >> Raymond.Rusk at nrc-cnrc.gc.ca Raymond.Rusk at nrc-
> > > > >> cnrc.gc.ca
> > > > >
> > > > > _______________________________________________
> > > > > Casa-framework mailing list
> > > > > Casa-framework at donar.cv.nrao.edu
> > > > > http://listmgr.cv.nrao.edu/mailman/listinfo/casa-framework
> > > > >
> > > >
> > > >
> > >
> > > --
> > > Dr. Raymond Rusk Dr.
> > > Raymond Rusk
> > > ALMA Software Engineer Ingenieur
> > > Logiciel ALMA
> > > National Research Council Canada Conseil national de
> > > recherches Canada
> > > Herzberg Institute of Astrophysics L'Institut Herzberg
> > > d'Astrophysique
> > > DRAO, P.O. Box 248 OFRA,
> > > B.P. Box 248
> > > Penticton, BC V2A 6J9 |\^/| Penticton,
> > > (C.-B.) V2A 6J9
> > > Government of Canada _|\| |/|_
> > > Gouvernement du Canada
> > > Tel: (250)490-4347 > < Tel:
> > > (250)490-4347
> > > Fax: (250)493-7767 >_./|\._< Fax:
> > > (250)493-7767
> > > Raymond.Rusk at nrc-cnrc.gc.ca
> > > Raymond.Rusk at nrc-cnrc.gc.ca
> > > _______________________________________________
> > > Casa-framework mailing list
> > > Casa-framework at donar.cv.nrao.edu
> > > http://listmgr.cv.nrao.edu/mailman/listinfo/casa-framework
> > >
> >
>
> --
> Dr. Raymond Rusk Dr. Raymond Rusk
> ALMA Software Engineer Ingenieur Logiciel ALMA
> National Research Council Canada Conseil national de recherches Canada
> Herzberg Institute of Astrophysics L'Institut Herzberg d'Astrophysique
> DRAO, P.O. Box 248 OFRA, B.P. Box 248
> Penticton, BC V2A 6J9 |\^/| Penticton, (C.-B.) V2A 6J9
> Government of Canada _|\| |/|_ Gouvernement du Canada
> Tel: (250)490-4347 > < Tel: (250)490-4347
> Fax: (250)493-7767 >_./|\._< Fax: (250)493-7767
> Raymond.Rusk at nrc-cnrc.gc.ca Raymond.Rusk at nrc-cnrc.gc.ca
> _______________________________________________
> Casa-framework mailing list
> Casa-framework at donar.cv.nrao.edu
> http://listmgr.cv.nrao.edu/mailman/listinfo/casa-framework
>
More information about the Casa-framework
mailing list