RE: [Doxygen-users] MSDN Style
Brought to you by:
dimitri
From: Adam T. <ad...@fi...> - 2001-11-09 15:25:52
|
For my two cents, I certainly see value in the MSDN look. The compnay I work for has adopted Doxygen as its documentation standard. It certainly would be nice if I could convince them to use the DevStudio help integrator: I'm lazy and F1 on internal classes and functions would be nice. MSDN look would go a long way towards that goal. The main problem I've have with doxygen and CHM, is that the index doesn't quite seem right. Maybe its just me, but in my index, I get: Classname, with a subitem of the destructor, and it was subitems of the rest of the functions. Has anyone else seen that? Adam > -----Original Message----- > From: Sten Darre [SMTP:sd...@ne...] > Sent: Friday, November 09, 2001 8:47 AM > To: dox...@li... > Subject: RE: [Doxygen-users] MSDN Style > > This might be a little out of thread, but I don't think MSDN-look-and-feel > is going to make the difference as to '..to convince people..'. > Since it might look allright - but it isn't a real Micro$oft-tool, hence > they won't trust doxygen anyway. > > They either just love it or hate it... no matter what layout is used - > just > my humble experince ;-) > > Personally I think either layout is nice. > > greets > > sten > > > As for Germar's political perspective, whatever! We are a > > Microsoft shop, > > and right now I just want to convince people to start auto generating > > documentation. The MSDN-style is my best chance to do that, > > since we are all > > familiar with that format. > > > > -----Original Message----- > > From: dox...@li... > > [mailto:dox...@li...]On Behalf Of Wagner, > > Victor > > Sent: 09 November 2001 14:48 > > To: 'Christian Ratliff'; 'dox...@li...' > > Subject: RE: [Doxygen-users] MSDN Style > > > > > > Poor management decisions on the part of your company is no > > reason to risk > > breaking what is a GREAT tool for the rest of us. If you're > > so proud of > > being a "Microsoft shop" ask THEN for THEIR automatic > > documentation tool. > > > > -----Original Message----- > > From: Christian Ratliff [mailto:cra...@de...] > > Sent: Friday, 2001 November 09 06:05 > > To: 'dox...@li...' > > Subject: RE: [Doxygen-users] MSDN Style > > > > > > Dimitri, > > > > What can I do to help get this patch in? If it is through > > some "style > > interface hook" mechanism, which Germar mentions, I am glad to offer > > whatever assistance I can. > > As for Germar's political perspective, whatever! We are a > > Microsoft shop, > > and right now I just want to convince people to start auto generating > > documentation. The MSDN-style is my best chance to do that, > > since we are all > > familiar with that format. > > > > christian > > > > +-----+ > > Christian Ratliff <cra...@de...> > > Sr. Technology Architect > > Core Libraries Group, DeLorme > > "This is the very perfection of man, > > to find out his own imperfections" - St. Augustine > > > > > > > > > > -----Original Message----- > > From: Dimitri van Heesch [mailto:di...@st...] > > Sent: Thursday, November 08, 2001 4:25 PM > > To: dox...@li... > > Subject: Re: [Doxygen-users] MSDN Style > > > > > > On Thu, Nov 08, 2001 at 08:25:21AM -0500, Christian Ratliff wrote: > > > Hello all, > > > > > > Has the MSDN style been merged into the code base in CVS > > yet? We use > > > that style for all of our auto-generated documentation now, but I > > > would prefer to move to a more recent release than 1.2.6. I > > have been > > > monitoring the recent change logs, but perhaps I overlooked its > > > mention. > > > > > > > I'm still investigating the impact of Alexandr Chelpanov's patch. > > It is quite huge, still has rough edges, and introduces a lot > > of conditional > > > > code (mostly only for html, and even some IE specific stuff), > > so from a > > test/maintenance point of view I am not overly enthousiastic yet. > > > > >From a user point of view I can understand the MSDN style > > feature is nice > > though. > > > > Regards, > > Dimitri > > > > > > _______________________________________________ > > Doxygen-users mailing list > > Dox...@li... > > https://lists.sourceforge.net/lists/listinfo/doxygen-users > > > > _______________________________________________ > > Doxygen-users mailing list > > Dox...@li... > > https://lists.sourceforge.net/lists/listinfo/doxygen-users > > > > _______________________________________________ > > Doxygen-users mailing list > > Dox...@li... > > https://lists.sourceforge.net/lists/listinfo/doxygen-users > > > > > _______________________________________________ > Doxygen-users mailing list > Dox...@li... > https://lists.sourceforge.net/lists/listinfo/doxygen-users |