FiveTech Support Forums

FiveWin / Harbour / xBase community
Board index FiveWin for Harbour/xHarbour xBase documentor
Posts: 723
Joined: Tue Sep 04, 2007 08:45 AM
xBase documentor
Posted: Thu Feb 12, 2009 07:08 AM

In the early 1990s there was a DOS program called Snap Ver. 5.02 that displayed program flow through graphics lines, symbols (vars) used, where they were read, written, control structures, etc. Is there a program that documents xBase/FiveWin programs ?

Posts: 1096
Joined: Fri Oct 28, 2005 02:27 AM
Re: xBase documentor
Posted: Thu Feb 12, 2009 12:43 PM
I've been looking for one too and came across RoboDoc but can't give you any feedback on it yet as I haven't started to play around with it.
FWH 11.08/FWH 19.12

BCC5.82/BCC7.3

xHarbour/Harbour
Posts: 4840
Joined: Fri Nov 18, 2005 04:52 PM
Re: xBase documentor
Posted: Thu Feb 12, 2009 05:23 PM
You will find Snap here:

http://www.the-oasis.net/ftpmaster.php3?content=ftputils.htm

It is near the end of the page.

Regards,
James
FWH 18.05/xHarbour 1.2.3/BCC7/Windows 10
Posts: 723
Joined: Tue Sep 04, 2007 08:45 AM
Re: xBase documentor
Posted: Tue Mar 31, 2009 04:30 PM

James:

Thank you for your help and link. However, what I'm looking is a software that performs the same functions as the old SNAP but can recognize the extra keywords and new language syntax used with FiveWin / xHarbour / Harbour. Any suggestions ?

Posts: 4840
Joined: Fri Nov 18, 2005 04:52 PM
Re: xBase documentor
Posted: Tue Mar 31, 2009 04:39 PM

Hunter,

It has been a long time since I used it, but Snap does have keyword files for lots of libraries. I suspect you can create a new one for FWH/Harbour.

Regards,
James

FWH 18.05/xHarbour 1.2.3/BCC7/Windows 10
Posts: 464
Joined: Tue May 16, 2006 07:47 AM
Re: xBase documentor
Posted: Wed Apr 01, 2009 10:37 AM

Hi James and all

I downloaded SNAP from the link given but it was a DOS/Windows(?) executable with no source so not much use for a Linux environment. I don't know if it was written in Clipper or some other language. I don't know if source was ever / is now available.

Maybe we could work on a (x)Harbour version of the bits people really feel that they need? I've only just glanced at the SNAP documentation. It seems to have a lot of functions and produce voluminous documentation much of which may not be required by most people.

What do others think?

Regards

Doug

Posts: 4043
Joined: Wed Dec 19, 2007 06:40 PM
Re: xBase documentor
Posted: Wed Apr 01, 2009 11:16 AM

Hello

I own the source for a program, to do this.
I used it during clipper-times.
It draws vertical lines between DO WHILE - ENDDO, IF - ENDIF and so on and does the needed spaces.
Is there a need to use it as a basic ?
If YES, I can put it in the Forum.

Regards
Uwe :lol:

Since 1995 ( the first release of FW 1.9 )

i work with FW.

If you have any questions about special functions, maybe i can help.
Posts: 464
Joined: Tue May 16, 2006 07:47 AM
Re: xBase documentor
Posted: Wed Apr 01, 2009 12:03 PM

Hi Uwe

I can remember writing one back in the dBase III days (pre Clipper) which used the IBM extended character graphics to draw vertical lines with little horizontal bits at keywords such as IF ELSE ENDIF.

Good for finding bugs when one was starting out and running as an interpreter. Clipper arrived and the compiler complained about unmatched control statements so its usefulness to me declined.

However whilst I indent my code as I write I do find occasions when assembling some code from several parts, or modifying / extending code there are massive sections that should be re-indented so an auto indenter would be nice. I guess that one should write such a piece of code as a macro to run inside of one's favourite code editor. But having said that I do like the idea of doing things in xBase code as that is ultimately pretty transportable wherever one may be taken writing xBase code.

Regards

Doug

Posts: 723
Joined: Tue Sep 04, 2007 08:45 AM
Re: xBase documentor
Posted: Thu Apr 02, 2009 07:38 AM

Guys:

Thank you all for your thoughts. That's the idea, a program that should do at least:
1. Draw vertical lines to show control / flow structures
2. Documents where we use our variables / fields per procedure / function / whole system.
3. Where our vars and fields are read and where their value changes
4. Which procedure / function call others.
5. Variables summary: help to get least frequently used vars.
6. etc.

That's part of what the old SNAP used to give us.

Posts: 464
Joined: Tue May 16, 2006 07:47 AM
Re: xBase documentor
Posted: Thu Apr 02, 2009 10:54 AM

> 1. Draw vertical lines to show control / flow structures

I started thinking about how one might best do this in a nice structured, flexible way. If I was to write it my primary focus would be Linux and postscript printing but it wouldn't be too hard to do a Windows version.

Just thinking about what one might wish for in the way of options:

Include / exclude line numbers?

Optionally pass the source through the pre-processor prior to analysis?

Flag errors as found / at the end?

Print and/or output formatted source?

Context sensitive highlighting / color?

With postscript it would be easy to have different line types for different control structures. IBM extended graphics set only gave single or double lines.

Don't know what capabilities Uwe's program has / had.

Regards

Doug

Posts: 6983
Joined: Fri Oct 07, 2005 07:07 PM
Re: xBase documentor
Posted: Thu Apr 02, 2009 11:41 AM

Hello Doug,

I don’t know which editor you use for programming.

I use UEStudio and MultiEdit and have nearly all the features you mention:

formatted source I get with MultiEdit (Reindent function and Evolve: Align MemVar ) and the rest is included in UEStudio.

Best regards,
Otto

Posts: 723
Joined: Tue Sep 04, 2007 08:45 AM
Re: xBase documentor
Posted: Thu Apr 02, 2009 01:29 PM

I use as editor Multi-Edit Ver. 9.10.04. Does UEStudio prints source code with vertical lines, cross references variables & fields ? Thank you.

Continue the discussion