[comp.databases] FoxBase+ FoxDoc

SLORES@umiami.miami.edu (Stanislaw L. Olejniczak) (10/12/89)

FoxBase+ FOXDOC question:
Error:  (function in ?)

(I would be grateful for replies via e-mail.  Thank you in advance for
any help.)

I am trying to document, using FoxDoc, a system written in FoxBase+.
In the system I am using UDFs;  in this example I only discuss a UDF
FILENAME(), even though I have the same problem with all of them; all
comments refer to all UDFs in my system:

Whenever FoxDoc encounters a reference to the UDF, it documents it as
(function in ?).  The function FILENAME is in a .PRG file FILENAME.PRG.
It does not have  a PARAMETER statement, but it does have a RETURN
statement;  it returns a string.  The file FILENAME.PRG is located in
the same subdirectory as all .PRG files making up the system.

Studying the FoxBase+ _FoxView-FoxCode-FoxDoc_ manual, on pages 19-16
[3rd paragraph], 20-11 [SUBJECT.IDX section], and 20-19 [ADDRFILT()
and TIMEFORM() references], I think FoxDOC should document FILENAME()
as (function in FILENAME.PRG).  Yet, it does not.

I have tried SET PROCEDURE FILENAME, but the system then documents
FILENAME() as a procedure in procedure file FILENAME.PRG (procedure in
FILENAME.PRG) which is not (function in FILENAME.PRG).

FoxBase+ recognizes and uses the UDFs without a hitch.

I have spoken with FoxBAse+ technical support, and I was told that the
manual is in error, and that FoxDoc does _not_ document functions. Hmmm... 
The same FoxDoc is suppoused to be enclosed with FoxPro...  If you can
suggest how can I get it to do what the examples say and imply, or if you
encountered a cure for this problem by other means, please let me know.

I am using foxBase+ 2.10 [30-AUG-88], FoxDoc 1.0

=============================================================================

Tree and ACT samples, with non-substantial lines removed for sake of
brevity:

Tree diagram:

EXTRACT0.PRG
+----MAINMENU.PRG
     |----ADD_DATA.PRG
     +----TO_ASCII.PRG
          |    ABSTR.DBF (database)
          +----FILENAME() (function  in ?)
----------------------------------------------------------------------

ACT

    3  *:        Program: TO_ASCII.PRG
   10  *:      Called by: MAINMENU.PRG
   12  *:          Calls: FILENAME()     (function  in ?)
   14  *:           Uses: ABSTR.DBF
   20  *:        Indexes: ABSTR_AC.IDX
   25  *:      Documented 10/11/89 at 16:41    FoxDoc   version 1.0
   26
*:*********************************************************************
   88      STORE filename() TO extr_fn
---------------------------------------------------------------------
Thanks.
----
Stan Olejniczak               Internet:         slores@umiami.miami.edu
University of Miami, FL USA   UUCP: (temp void) gould!umbio!solejni
SLORES@UMIAMI.BITNET          UUCP: (?)         umigw!gables!slores
Voice: (305) 547-6571         FAX: (305) 548-4612  
My opinions cannot possibly represent the views of anyone else!