Re: PAS to HTML

From: John Kaster (Borland) (johnk_at_borland.com)
Date: 01/30/05


Date: 29 Jan 2005 23:12:49 -0800

Matthew Mead wrote:

> Any chance of releasing the source?

Hmm. The only reason I haven't is because I've never been happy enough
with the source to release it. Always wanted to do the code
reformatting part of it as well.

Martin (and others) have also provided tools that handle far more
languages than YAPP does, so it would be a bit of re-inventing the
wheel. I keep meaning to take a look at their code, but never get
around to it.

I wrote the original version at a time when no utility like it existed.
It was actually an early prototype for the Delphi-based version of
TechWriter I never wrote ...

The engine actually does a fair bit more than YAPP is set up to do
right now, like generate the help file entries for WinHelp. I used it
to produce the documentation for XPhiles way back when.

> I use this tool on a daily basis for C++.

I'm glad it's so useful to you!

> It doesn't handle preprocessor directives (e.g. #define) the
> way I'd like, and I don't see how to configure it for that.

Sorry!

> I know better than to ask you for a fix because I suspect that on
> your priorities list, this is the lowest member of the food chain
> (soon to be replaced by the rat.)

Actually, I use YAPP so often it's a pretty critical part of my
BDN-related work. Furthermore, I've discussed providing an updated
version of it to the pubs team to aid in writing our product
documentation.

I was planning on producing a .NET version of it so I could leverage it
for the ASP.NET version of CodeCentral. Let me think about the best way
to provide what you want, and what I need. I should take a look at the
code for an hour or so first to remember how bad it is ;)

-- 
John Kaster http://blogs.borland.com/johnk
Features and bugs: http://qc.borland.com 
Get source: http://cc.borland.com
What's going on? http://calendar.borland.com