Class TPasDoc

Description
Hierarchy
Methods
Properties

Unit

PasDoc_Base

Declaration

type TPasDoc = class(TComponent)

Description

Manages parsing and documentation generation.

Source: source/component/PasDoc_Base.pas (line 71).

Hierarchy

Overview

Methods

Protected procedure RemoveExcludedItems(const c: TPasItems);
Protected procedure Notification(AComponent: TComponent; Operation: TOperation); override;
Public constructor Create(AOwner: TComponent); override;
Public destructor Destroy; override;
Public procedure AddSourceFileNames(const AFileNames: TStringList);
Public procedure AddSourceFileNamesFromFile(const FileName: string; DashMeansStdin: boolean);
Public procedure DoError(const AMessage: string; const AArguments: array of const; const AExitCode: Word);
Public procedure DoMessage(const AVerbosity: Cardinal; const AMessageType: TPasDocMessageType; const AMessage: string; const AArguments: array of const);
Public procedure GenMessage(const MessageType: TPasDocMessageType; const AMessage: string; const AVerbosity: Cardinal);
Public procedure Execute;

Properties

Public property Units: TPasUnits read FUnits;
Public property Conclusion: TExternalItem read FConclusion;
Public property Introduction: TExternalItem read FIntroduction;
Public property AdditionalFiles: TExternalItemList read FAdditionalFiles;
Published property DescriptionFileNames: TStringVector read FDescriptionFileNames write SetDescriptionFileNames;
Published property Directives: TStringVector read FDirectives write SetDirectives;
Published property IncludeDirectories: TStringVector read FIncludeDirectories write SetIncludeDirectories;
Published property OnWarning: TPasDocMessageEvent read FOnMessage write FOnMessage stored false;
Published property OnMessage: TPasDocMessageEvent read FOnMessage write FOnMessage;
Published property ProjectName: string read FProjectName write FProjectName;
Published property SourceFileNames: TStringVector read FSourceFileNames write SetSourceFileNames;
Published property Title: string read FTitle write FTitle;
Published property Verbosity: Cardinal read FVerbosity write FVerbosity default DEFAULT_VERBOSITY_LEVEL;
Published property StarOnly: boolean read GetStarOnly write SetStarOnly stored false;
Published property CommentMarkers: TStringList read FCommentMarkers write SetCommentMarkers;
Published property IgnoreMarkers: TStringList read FIgnoreMarkers write SetIgnoreMarkers;
Published property MarkerOptional: boolean read FMarkerOptional write FMarkerOptional default false;
Published property IgnoreLeading: string read FIgnoreLeading write FIgnoreLeading;
Published property Generator: TDocGenerator read FGenerator write SetGenerator;
Published property ShowVisibilities: TVisibilities read FShowVisibilities write FShowVisibilities;
Published property CacheDir: string read FCacheDir write FCacheDir;
Published property SortSettings: TSortSettings read FSortSettings write FSortSettings default [];
Published property IntroductionFileName: string read FIntroductionFileName write FIntroductionFileName;
Published property ConclusionFileName: string read FConclusionFileName write FConclusionFileName;
Published property AdditionalFilesNames: TStringList read FAdditionalFilesNames;
Published property ImplicitVisibility: TImplicitVisibility read FImplicitVisibility write FImplicitVisibility default ivPublic;
Published property HandleMacros: boolean read FHandleMacros write FHandleMacros default true;
Published property AutoLink: boolean read FAutoLink write FAutoLink default false;
Published property AutoBackComments: boolean read FAutoBackComments write FAutoBackComments default false;
Published property InfoMergeType: TInfoMergeType read FInfoMergeType write FInfoMergeType;

Description

Methods

Protected procedure RemoveExcludedItems(const c: TPasItems);

Searches the description of each TPasUnit item in the collection for an excluded tag. If one is found, the item is removed from the collection. If not, the fields, methods and properties collections are called with RemoveExcludedItems If the collection is empty after removal of all items, it is disposed of and the variable is set to nil.

Source: source/component/PasDoc_Base.pas (line 134).

Protected procedure Notification(AComponent: TComponent; Operation: TOperation); override;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 136).

Public constructor Create(AOwner: TComponent); override;

Creates object and sets fields to default values.

Source: source/component/PasDoc_Base.pas (line 139).

Public destructor Destroy; override;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 141).

Public procedure AddSourceFileNames(const AFileNames: TStringList);

Adds source filenames from a stringlist

Source: source/component/PasDoc_Base.pas (line 144).

Public procedure AddSourceFileNamesFromFile(const FileName: string; DashMeansStdin: boolean);

Loads names of Pascal unit source code files from a text file. Adds all file names to SourceFileNames. If DashMeansStdin and AFileName = '-' then it will load filenames from stdin.

Source: source/component/PasDoc_Base.pas (line 149).

Public procedure DoError(const AMessage: string; const AArguments: array of const; const AExitCode: Word);

Raises an exception.

Source: source/component/PasDoc_Base.pas (line 152).

Public procedure DoMessage(const AVerbosity: Cardinal; const AMessageType: TPasDocMessageType; const AMessage: string; const AArguments: array of const);

Forwards a message to the OnMessage event.

Source: source/component/PasDoc_Base.pas (line 155).

Public procedure GenMessage(const MessageType: TPasDocMessageType; const AMessage: string; const AVerbosity: Cardinal);

for Generator messages

Source: source/component/PasDoc_Base.pas (line 158).

Public procedure Execute;

Starts creating the documentation.

Source: source/component/PasDoc_Base.pas (line 161).

Properties

Public property Units: TPasUnits read FUnits;

After Execute has been called, Units holds the units that have been parsed.

Source: source/component/PasDoc_Base.pas (line 164).

Public property Conclusion: TExternalItem read FConclusion;

After Execute has been called, Conclusion holds the conclusion.

Source: source/component/PasDoc_Base.pas (line 166).

Public property Introduction: TExternalItem read FIntroduction;

After Execute has been called, Introduction holds the introduction.

Source: source/component/PasDoc_Base.pas (line 168).

Public property AdditionalFiles: TExternalItemList read FAdditionalFiles;

After Execute has been called, AdditionalFiles holds the additional external files.

Source: source/component/PasDoc_Base.pas (line 170).

Published property DescriptionFileNames: TStringVector read FDescriptionFileNames write SetDescriptionFileNames;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 172).

Published property Directives: TStringVector read FDirectives write SetDirectives;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 174).

Published property IncludeDirectories: TStringVector read FIncludeDirectories write SetIncludeDirectories;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 175).

Published property OnWarning: TPasDocMessageEvent read FOnMessage write FOnMessage stored false;

This is deprecated name for OnMessage

Source: source/component/PasDoc_Base.pas (line 179).

Published property OnMessage: TPasDocMessageEvent read FOnMessage write FOnMessage;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 181).

Published property ProjectName: string read FProjectName write FProjectName;

The name PasDoc shall give to this documentation project, also used to name some of the output files.

Source: source/component/PasDoc_Base.pas (line 185).

Published property SourceFileNames: TStringVector read FSourceFileNames write SetSourceFileNames;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 186).

Published property Title: string read FTitle write FTitle;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 188).

Published property Verbosity: Cardinal read FVerbosity write FVerbosity default DEFAULT_VERBOSITY_LEVEL;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 189).

Published property StarOnly: boolean read GetStarOnly write SetStarOnly stored false;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 191).

Published property CommentMarkers: TStringList read FCommentMarkers write SetCommentMarkers;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 192).

Published property IgnoreMarkers: TStringList read FIgnoreMarkers write SetIgnoreMarkers;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 193).

Published property MarkerOptional: boolean read FMarkerOptional write FMarkerOptional default false;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 194).

Published property IgnoreLeading: string read FIgnoreLeading write FIgnoreLeading;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 196).

Published property Generator: TDocGenerator read FGenerator write SetGenerator;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 198).

Published property ShowVisibilities: TVisibilities read FShowVisibilities write FShowVisibilities;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 199).

Published property CacheDir: string read FCacheDir write FCacheDir;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 200).

Published property SortSettings: TSortSettings read FSortSettings write FSortSettings default [];

This determines how items inside will be sorted. See --sort documentation.

Source: source/component/PasDoc_Base.pas (line 204).

Published property IntroductionFileName: string read FIntroductionFileName write FIntroductionFileName;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 207).

Published property ConclusionFileName: string read FConclusionFileName write FConclusionFileName;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 210).

Published property AdditionalFilesNames: TStringList read FAdditionalFilesNames;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 213).

Published property ImplicitVisibility: TImplicitVisibility read FImplicitVisibility write FImplicitVisibility default ivPublic;

See command-line option --implicit-visibility documentation at --implicit-visibility documentation. This will be passed to parser instance.

Source: source/component/PasDoc_Base.pas (line 218).

Published property HandleMacros: boolean read FHandleMacros write FHandleMacros default true;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 221).

Published property AutoLink: boolean read FAutoLink write FAutoLink default false;

This controls auto-linking, see --auto-link documentation.

Source: source/component/PasDoc_Base.pas (line 226).

Published property AutoBackComments: boolean read FAutoBackComments write FAutoBackComments default false;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 228).

Published property InfoMergeType: TInfoMergeType read FInfoMergeType write FInfoMergeType;

This item has no description.

Source: source/component/PasDoc_Base.pas (line 230).

Generated by PasDoc 0.17.0.snapshot.