RE: [Doxygen-users] MSDN Style
Brought to you by:
dimitri
From: Sten D. <sd...@ne...> - 2001-11-09 17:43:53
|
well, ... > I'm lazy and F1 on internal classes and functions would be nice. ...I'm lazy too, so I've also used MSDNIntegrator to get doxygen generated docs into MSDN. > The main problem I've have with > doxygen and CHM, is that the index doesn't quite seem right. Mine works fine - and the above illustrates the point or concern: Getting MSDN looks may spin off 'funny' errors in doxygen, and that does not convince anybody - it just ruins a good tool, even for those *not* living in the M$-world. I *do* program on Windows and live in that world, but I don't need it to look like Microsoft if it dosn'e serve a distint purpose ?! - likewise we use make-systems and not 'F7' from DevStudio, because it make us happy, so if '..to convince..' is the *only* reason for MSDN-looks, I see a buggy future for doxygen with little to gain otherwise (no new features of doxygen). My primary focus is the documentation of the source and one's develop-environment - *not* the looks of the font-size !! (go on - flame me ;-) sten > -----Original Message----- > From: dox...@li... > [mailto:dox...@li...]On Behalf Of Adam > Tegen > Sent: 09 November 2001 16:25 > To: dox...@li... > Subject: RE: [Doxygen-users] MSDN Style > > > 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 > > _______________________________________________ > Doxygen-users mailing list > Dox...@li... > https://lists.sourceforge.net/lists/listinfo/doxygen-users > |