Unit PasDoc_Gen

Description
Uses
Classes, Interfaces, Objects and Records
Types
Constants

Description

Base generator class TDocGenerator, to be specialized for specific output formats.

PasDoc_Gen contains the basic documentation generator object TDocGenerator. It is not sufficient by itself but the basis for all generators that produce documentation in a specific format like HTML or LaTex. They override TDocGenerator's virtual methods.

Source: source/component/PasDoc_Gen.pas (line 43).

Uses

Overview

Classes, Interfaces, Objects and Records

Name Description
Record TOverviewFileInfo  
Class TListItemData Collected information about @xxxList item.
Class TListData Collected information about @xxxList content.
Class TRowData Collected information about @row (or @rowHead).
Class TTableData Collected information about @table.
Class TDocGenerator Base generator class, to be specialized for specific output formats.

Types

TOverviewFile = (...);
TCreatedOverviewFile = Low(TOverviewFile) .. ofIdentifiers;
TLinkLook = (...);
TLinkNotFoundAction = (...);
TLinkContext = (...);
TListType = (...);
TListItemSpacing = (...);

Constants

OverviewFilesInfo: array[TOverviewFile] of TOverviewFileInfo = ( (BaseFileName: 'AllUnits' ; TranslationId: trUnits ; TranslationHeadlineId: trHeadlineUnits ; NoItemsTranslationId: trNone ; ), (BaseFileName: 'ClassHierarchy'; TranslationId: trClassHierarchy ; TranslationHeadlineId: trClassHierarchy ; NoItemsTranslationId: trNoCIOs ; ), (BaseFileName: 'AllClasses' ; TranslationId: trCio ; TranslationHeadlineId: trHeadlineCio ; NoItemsTranslationId: trNoCIOs ; ), (BaseFileName: 'AllTypes' ; TranslationId: trTypes ; TranslationHeadlineId: trHeadlineTypes ; NoItemsTranslationId: trNoTypes ; ), (BaseFileName: 'AllVariables' ; TranslationId: trVariables ; TranslationHeadlineId: trHeadlineVariables ; NoItemsTranslationId: trNoVariables ; ), (BaseFileName: 'AllConstants' ; TranslationId: trConstants ; TranslationHeadlineId: trHeadlineConstants ; NoItemsTranslationId: trNoConstants ; ), (BaseFileName: 'AllFunctions' ; TranslationId: trFunctionsAndProcedures; TranslationHeadlineId: trHeadlineFunctionsAndProcedures; NoItemsTranslationId: trNoFunctions ; ), (BaseFileName: 'AllIdentifiers'; TranslationId: trIdentifiers ; TranslationHeadlineId: trHeadlineIdentifiers ; NoItemsTranslationId: trNoIdentifiers ; ), (BaseFileName: 'GVUses' ; TranslationId: trGvUses ; TranslationHeadlineId: trGvUses ; NoItemsTranslationId: trNone ; ), (BaseFileName: 'GVClasses' ; TranslationId: trGvClasses ; TranslationHeadlineId: trGvClasses ; NoItemsTranslationId: trNoCIOs ; ) );
LowCreatedOverviewFile = Low(TCreatedOverviewFile);
HighCreatedOverviewFile = High(TCreatedOverviewFile);

Description

Types

TOverviewFile = (...);

Overview files that pasdoc generates for multiple-document-formats like HTML (see TGenericHTMLDocGenerator).

But not all of them are supposed to be generated by pasdoc, some must be generated by external programs by user, e.g. uses and class diagrams must be made by user using programs such as GraphViz. See type TCreatedOverviewFile for subrange type of TOverviewFile that specifies only overview files that are really supposed to be made by pasdoc.

Values
  • ofUnits
  • ofClassHierarchy
  • ofCios
  • ofTypes
  • ofVariables
  • ofConstants
  • ofFunctionsAndProcedures
  • ofIdentifiers
  • ofGraphVizUses
  • ofGraphVizClasses

Source: source/component/PasDoc_Gen.pas (line 72).

TCreatedOverviewFile = Low(TOverviewFile) .. ofIdentifiers;

This item has no description.

Source: source/component/PasDoc_Gen.pas (line 84).

TLinkLook = (...);

This item has no description.

Values
  • llDefault
  • llFull
  • llStripped

Source: source/component/PasDoc_Gen.pas (line 119).

TLinkNotFoundAction = (...);

This item has no description.

Values
  • lnfIgnore
  • lnfWarn
  • lnfWarnIfNotInternal

Source: source/component/PasDoc_Gen.pas (line 121).

TLinkContext = (...);

This is used by TDocGenerator.MakeItemLink

Values
  • lcCode: This means that link is inside some larger code piece, e.g. within FullDeclaration of some item etc. This means that we may be inside a context where used font has constant width.
  • lcNormal: This means that link is inside some "normal" description text.

Source: source/component/PasDoc_Gen.pas (line 124).

TListType = (...);

This item has no description.

Values
  • ltUnordered
  • ltOrdered
  • ltDefinition

Source: source/component/PasDoc_Gen.pas (line 133).

TListItemSpacing = (...);

This item has no description.

Values
  • lisCompact
  • lisParagraph

Source: source/component/PasDoc_Gen.pas (line 135).

Constants

OverviewFilesInfo: array[TOverviewFile] of TOverviewFileInfo = ( (BaseFileName: 'AllUnits' ; TranslationId: trUnits ; TranslationHeadlineId: trHeadlineUnits ; NoItemsTranslationId: trNone ; ), (BaseFileName: 'ClassHierarchy'; TranslationId: trClassHierarchy ; TranslationHeadlineId: trClassHierarchy ; NoItemsTranslationId: trNoCIOs ; ), (BaseFileName: 'AllClasses' ; TranslationId: trCio ; TranslationHeadlineId: trHeadlineCio ; NoItemsTranslationId: trNoCIOs ; ), (BaseFileName: 'AllTypes' ; TranslationId: trTypes ; TranslationHeadlineId: trHeadlineTypes ; NoItemsTranslationId: trNoTypes ; ), (BaseFileName: 'AllVariables' ; TranslationId: trVariables ; TranslationHeadlineId: trHeadlineVariables ; NoItemsTranslationId: trNoVariables ; ), (BaseFileName: 'AllConstants' ; TranslationId: trConstants ; TranslationHeadlineId: trHeadlineConstants ; NoItemsTranslationId: trNoConstants ; ), (BaseFileName: 'AllFunctions' ; TranslationId: trFunctionsAndProcedures; TranslationHeadlineId: trHeadlineFunctionsAndProcedures; NoItemsTranslationId: trNoFunctions ; ), (BaseFileName: 'AllIdentifiers'; TranslationId: trIdentifiers ; TranslationHeadlineId: trHeadlineIdentifiers ; NoItemsTranslationId: trNoIdentifiers ; ), (BaseFileName: 'GVUses' ; TranslationId: trGvUses ; TranslationHeadlineId: trGvUses ; NoItemsTranslationId: trNone ; ), (BaseFileName: 'GVClasses' ; TranslationId: trGvClasses ; TranslationHeadlineId: trGvClasses ; NoItemsTranslationId: trNoCIOs ; ) );

This item has no description.

Source: source/component/PasDoc_Gen.pas (line 94).

LowCreatedOverviewFile = Low(TCreatedOverviewFile);

Using High(TCreatedOverviewFile) or High(Overview) where Overview: TCreatedOverviewFile in PasDoc_GenHtml produces internal error in FPC 2.0.0. Same for Low(TCreatedOverviewFile).

This is submitted as FPC bug 4140, FPC bug 4140. Fixed in FPC 2.0.1 and FPC 2.1.1.

Source: source/component/PasDoc_Gen.pas (line 115).

HighCreatedOverviewFile = High(TCreatedOverviewFile);

This item has no description.

Source: source/component/PasDoc_Gen.pas (line 116).

Authors

Created

30 Aug 1998

Generated by PasDoc 0.17.0.snapshot.