#1 2015-09-14 21:27:04

EMartin
Member
From: Buenos Aires - Argentina
Registered: 2013-01-09
Posts: 332

Classes and methods documentation not generated

Hi @ab, I have units with documentation on classes and methods but SynProject not generated that detailed info, only the unit description, the class description, the units used and the class hierarchy.

What am I doing wrong ?

Thanks in advance.


Esteban

Offline

#2 2015-09-15 06:24:02

ab
Administrator
From: France
Registered: 2010-06-21
Posts: 13,490
Website

Re: Classes and methods documentation not generated

What does the log parsing say?
(there is a SAD.log file in the output folder)

The parser only handle Delphi 7 syntax: if you use generics, it may fail.
I would need to update the integrated parser.

Also ensure that the comments start with three slashes /// not two //.

Offline

#3 2015-09-15 10:37:55

EMartin
Member
From: Buenos Aires - Argentina
Registered: 2013-01-09
Posts: 332

Re: Classes and methods documentation not generated

SAD.log:


9/14/2015 6:59:56 PM
Info[0]:    Cache file = D:\DevVM\D7\Projects\ARIS\Docs\ARIS\Approach RIS\Approach RIS.sad
Info[0]:    [SAD].Source = Main

FillUnits(SAD-Main) -> ARIS_Svc.dpr;ARIS_Intf.pas;ARIS_Server.pas;ARIS_Server_Config.pas;ARIS_Utils.pas;ARISCallbacks_Intf.pas;ARISCallbacks_Impl.pas;DBService_Intf.pas;DBService_Impl.pas;MiscService_Intf.pas;MiscService_Impl.pas;MySynDB.pas
Info[0]:    DefaultPath = D:\DEVVM\D7\PROJECTS\ARIS\
Info[0]:    IncludePath = D:\DevVM\D7\Projects\ARIS
Info[0]:    Directives =
Info[2]:    ARIS_Svc.dpr from cache
Info[2]:    ARIS_Intf.pas from cache
Info[2]:    ARIS_Server.pas from cache
Info[2]:    ARIS_Server_Config.pas from cache
Info[2]:    ARIS_Utils.pas from cache
Info[2]:    ARISCallbacks_Intf.pas from cache
Info[2]:    ARISCallbacks_Impl.pas from cache
Info[2]:    DBService_Intf.pas from cache
Info[2]:    DBService_Impl.pas from cache
Info[2]:    MiscService_Intf.pas from cache
Info[2]:    MiscService_Impl.pas from cache
Info[2]:    MySynDB.pas from cache
Info[2]:    CP_Impl.pas from cache
Info[2]:    SMA_Impl.pas from cache

Info[2]:    Files not found during process:
ADODB.pas,Classes.pas,DB.pas,DBClient.pas,FastMM4.pas,IdAttachmentFile.pas,IdExplicitTLSClientServerBase.pas,IdIOHandler.pas,IdMessage.pas,IdSASL_NTLM.pas,IdSASLLogin.pas,IdSMTP.pas,IdSSLOpenSSL.pas,IdSSLOpenSSLHeaders.pas,IdUserPassProvider.pas,JCLSecurity.pas,JCLStrings.pas,JvCipher.pas,MidasSpeedFix.pas,mORMot.pas,mORMotDB.pas,mORMotHttpClient.pas,mORMotHttpServer.pas,mORMotMidasVCL.pas,mORMotService.pas,mORMotSQLite3.pas,StrUtils.pas,SuperObject.pas,SuperXMLParser.pas,SyncObjs.pas,SynCommons.pas,SynCrtSock.pas,SynDB.pas,SynDBMidasVCL.pas,SynDBZeos.pas,SynLog.pas,SynSQLite3Static.pas,SynTests.pas,SynVirtualDataset.pas,SysUtils.pas,Types.pas,Variants.pas,Windows.pas,WinSvc.pas,ZAbstractRODataset.pas,ZConnection.pas,ZDataset.pas,ZDbcInterbase6Utils.pas,ZDbcIntfs.pas,ZStoredProcedure.pas,ZURL.pas

I use Delphi 7.

The first line of comments start with three slashes "///" and then "// -..." (without quotes) of the procedures and functions.

I use @!unit.pas@ when added the unique references to the units.

Thanks.


Esteban

Offline

#4 2015-09-15 12:38:15

ab
Administrator
From: France
Registered: 2010-06-21
Posts: 13,490
Website

Re: Classes and methods documentation not generated

Flush the cache and check immediately the .log by running "SAD / Parse all source code again" from the menu.

I guess you may find an error. Perhaps a missing conditional.

Also ensure you put the .pas files as reference in the SourceFile=... entry of the [SAD-*] entries marked as Source= in the [SAD] entry.

Offline

#5 2015-09-15 14:31:49

EMartin
Member
From: Buenos Aires - Argentina
Registered: 2013-01-09
Posts: 332

Re: Classes and methods documentation not generated

Solved, my SAD-Main section had not the input WithAllfields=Yes, why ? I don't know.

Thanks.


Esteban

Offline

Board footer

Powered by FluxBB