3
<package name="fpdocmanager">
5
====================================================================
7
====================================================================
9
<module name="umakeskel">
10
<short>An extract from the FPC MakeSkel program, with some extensions.
12
<descr>TFPDocMaker extends FPDoc TFPDocCreator, with ability to update the XML files.
15
<!-- resource string Visibility: default -->
16
<element name="STitle">
21
<!-- resource string Visibility: default -->
22
<element name="SVersion">
27
<!-- resource string Visibility: default -->
28
<element name="SCopyright">
33
<!-- resource string Visibility: default -->
34
<element name="SCmdLineHelp">
39
<!-- resource string Visibility: default -->
40
<element name="SCmdLineInvalidOption">
45
<!-- resource string Visibility: default -->
46
<element name="SNoPackageNameProvided">
51
<!-- resource string Visibility: default -->
52
<element name="SOutputMustNotBeDescr">
57
<!-- resource string Visibility: default -->
58
<element name="SCreatingNewNode">
63
<!-- resource string Visibility: default -->
64
<element name="SNodeNotReferenced">
69
<!-- resource string Visibility: default -->
70
<element name="SDone">
75
<!-- resource string Visibility: default -->
76
<element name="SErrInvalidRootNode">
81
<!-- resource string Visibility: default -->
82
<element name="SErrNoPackagesNode">
87
<!-- enumeration type Visibility: default -->
88
<element name="TCmdLineAction">
93
<!-- enumeration value Visibility: default -->
94
<element name="TCmdLineAction.actionHelp">
97
<!-- enumeration value Visibility: default -->
98
<element name="TCmdLineAction.actionConvert">
101
<!-- class Visibility: default -->
102
<element name="TCmdOptions">
108
<!-- variable Visibility: public -->
109
<element name="TCmdOptions.WriteDeclaration">
110
<short>Emit declaration for elements (--emit-declaration).</short>
114
<!-- variable Visibility: public -->
115
<element name="TCmdOptions.UpdateMode">
116
<short>Specifies the MakeSkel engine mode (create skeleton or update file).</short>
120
<!-- variable Visibility: public -->
121
<element name="TCmdOptions.SortNodes">
122
<short>Sorts the Element nodes when True.</short>
126
<!-- variable Visibility: public -->
127
<element name="TCmdOptions.DisableOverride">
128
<short>Do not create nodes for override methods.</short>
132
<!-- variable Visibility: public -->
133
<element name="TCmdOptions.DisableErrors">
134
<short>Suppress Errors sections?</short>
138
<!-- variable Visibility: public -->
139
<element name="TCmdOptions.DisableSeealso">
140
<short>Suppress SeeAlso sections?</short>
144
<!-- variable Visibility: public -->
145
<element name="TCmdOptions.DisableArguments">
146
<short>Suppress subroutine parameter entries?</short>
150
<!-- variable Visibility: public -->
151
<element name="TCmdOptions.DisableProtected">
152
<short>Suppress Elements for protected class members?</short>
156
<!-- variable Visibility: public -->
157
<element name="TCmdOptions.DisablePrivate">
158
<short>Suppress Elements for private class members?</short>
162
<!-- variable Visibility: public -->
163
<element name="TCmdOptions.DisableFunctionResults">
164
<short>Suppress Elements for function results?</short>
168
<!-- variable Visibility: public -->
169
<element name="TCmdOptions.EmitClassSeparator">
170
<short>Generate class separator comment?</short>
174
<!-- class Visibility: default -->
175
<element name="TSkelEngine">
176
<short>The MakeSkel engine, used to create documentation skeleton or update files.</short>
177
<descr>It is based on TFPDocEngine, used by FPDoc.</descr>
181
<!-- variable Visibility: private -->
182
<element name="TSkelEngine.FEmittedList">
187
<!-- variable Visibility: private -->
188
<element name="TSkelEngine.FNodeList">
193
<!-- variable Visibility: private -->
194
<element name="TSkelEngine.FModules">
199
<!-- variable Visibility: private -->
200
<element name="TSkelEngine.FOptions">
205
<!-- procedure Visibility: private -->
206
<element name="TSkelEngine.DoWriteUnReferencedNodes">
212
<!-- argument Visibility: default -->
213
<element name="TSkelEngine.DoWriteUnReferencedNodes.N">
216
<!-- argument Visibility: default -->
217
<element name="TSkelEngine.DoWriteUnReferencedNodes.NodePath">
220
<!-- procedure Visibility: private -->
221
<element name="TSkelEngine.SetOptions">
227
<!-- argument Visibility: default -->
228
<element name="TSkelEngine.SetOptions.AValue">
231
<!-- destructor Visibility: public -->
232
<element name="TSkelEngine.Destroy">
238
<!-- function Visibility: public -->
239
<element name="TSkelEngine.MustWriteElement">
245
<!-- function result Visibility: default -->
246
<element name="TSkelEngine.MustWriteElement.Result">
249
<!-- argument Visibility: default -->
250
<element name="TSkelEngine.MustWriteElement.El">
253
<!-- argument Visibility: default -->
254
<element name="TSkelEngine.MustWriteElement.Full">
257
<!-- function Visibility: public -->
258
<element name="TSkelEngine.WriteElement">
264
<!-- function result Visibility: default -->
265
<element name="TSkelEngine.WriteElement.Result">
268
<!-- argument Visibility: default -->
269
<element name="TSkelEngine.WriteElement.F">
272
<!-- argument Visibility: default -->
273
<element name="TSkelEngine.WriteElement.El">
276
<!-- argument Visibility: default -->
277
<element name="TSkelEngine.WriteElement.ADocNode">
280
<!-- function Visibility: public -->
281
<element name="TSkelEngine.FindModule">
282
<short>Provides dummy modules for all external units.</short>
287
<!-- function result Visibility: default -->
288
<element name="TSkelEngine.FindModule.Result">
291
<!-- argument Visibility: default -->
292
<element name="TSkelEngine.FindModule.AName">
295
<!-- function Visibility: public -->
296
<element name="TSkelEngine.CreateElement">
302
<!-- function result Visibility: default -->
303
<element name="TSkelEngine.CreateElement.Result">
306
<!-- argument Visibility: default -->
307
<element name="TSkelEngine.CreateElement.AClass">
310
<!-- argument Visibility: default -->
311
<element name="TSkelEngine.CreateElement.AName">
314
<!-- argument Visibility: default -->
315
<element name="TSkelEngine.CreateElement.AParent">
318
<!-- argument Visibility: default -->
319
<element name="TSkelEngine.CreateElement.AVisibility">
322
<!-- argument Visibility: default -->
323
<element name="TSkelEngine.CreateElement.ASourceFilename">
326
<!-- argument Visibility: default -->
327
<element name="TSkelEngine.CreateElement.ASourceLinenumber">
330
<!-- procedure Visibility: public -->
331
<element name="TSkelEngine.WriteUnReferencedNodes">
337
<!-- procedure Visibility: public -->
338
<element name="TSkelEngine.WriteNodes">
344
<!-- argument Visibility: default -->
345
<element name="TSkelEngine.WriteNodes.F">
348
<!-- argument Visibility: default -->
349
<element name="TSkelEngine.WriteNodes.AModule">
352
<!-- argument Visibility: default -->
353
<element name="TSkelEngine.WriteNodes.List">
356
<!-- procedure Visibility: public -->
357
<element name="TSkelEngine.DocumentFile">
358
<short>Writes the skeleton or update elements for AFileName into the XML text file.</short>
363
<!-- argument Visibility: default -->
364
<element name="TSkelEngine.DocumentFile.F">
367
<!-- argument Visibility: default -->
368
<element name="TSkelEngine.DocumentFile.AFileName">
371
<!-- argument Visibility: default -->
372
<element name="TSkelEngine.DocumentFile.ATarget">
375
<!-- argument Visibility: default -->
376
<element name="TSkelEngine.DocumentFile.ACPU">
379
<!-- property Visibility: public -->
380
<element name="TSkelEngine.NodeList">
385
<!-- property Visibility: public -->
386
<element name="TSkelEngine.EmittedList">
391
<!-- property Visibility: public -->
392
<element name="TSkelEngine.Options">
393
<short>The general commandline options for MakeSkel.</short>
397
<!-- function type Visibility: default -->
398
<element name="THandleOption">
399
<short>Type of an OnOption handler for unknown commanline options.</short>
403
<!-- function result Visibility: default -->
404
<element name="THandleOption.Result">
407
<!-- argument Visibility: default -->
408
<element name="THandleOption.Cmd">
411
<!-- argument Visibility: default -->
412
<element name="THandleOption.Arg">
415
<!-- enumeration type Visibility: default -->
416
<element name="TCreatorAction">
417
<short>The action to perform after all FPDoc commandline options have been parsed.</short>
418
<descr>Values returned by the option parsers for every single option. In this case caInvalid indicates an unhandled option.</descr>
421
<!-- enumeration value Visibility: default -->
422
<element name="TCreatorAction.caDefault">
423
<short>Default processing, option parsed successfully.</short>
425
<!-- enumeration value Visibility: default -->
426
<element name="TCreatorAction.caDryRun">
427
<short>DryRun option (-n) found.</short>
429
<!-- enumeration value Visibility: default -->
430
<element name="TCreatorAction.caUsage">
431
<short>Show usage, after option errors.</short>
433
<!-- enumeration value Visibility: default -->
434
<element name="TCreatorAction.caInvalid">
435
<short>Unhandled option found.</short>
437
<!-- enumeration value Visibility: default -->
438
<element name="TCreatorAction.caWriteProject">
439
<short>Write project file instead of documents.</short>
441
<!-- class Visibility: default -->
442
<element name="TFPDocMaker">
443
<short>FPDoc and MakeSkel functionality as a class.</short>
448
<!-- variable Visibility: private -->
449
<element name="TFPDocMaker.FDescrDir">
454
<!-- variable Visibility: private -->
455
<element name="TFPDocMaker.FInputDir">
460
<!-- variable Visibility: private -->
461
<element name="TFPDocMaker.FOnOption">
466
<!-- variable Visibility: private -->
467
<element name="TFPDocMaker.FOptions">
472
<!-- function Visibility: private -->
473
<element name="TFPDocMaker.GetDescrDir">
479
<!-- function result Visibility: default -->
480
<element name="TFPDocMaker.GetDescrDir.Result">
483
<!-- function Visibility: private -->
484
<element name="TFPDocMaker.GetInputDir">
490
<!-- function result Visibility: default -->
491
<element name="TFPDocMaker.GetInputDir.Result">
494
<!-- procedure Visibility: private -->
495
<element name="TFPDocMaker.SetDescrDir">
501
<!-- argument Visibility: default -->
502
<element name="TFPDocMaker.SetDescrDir.AValue">
505
<!-- procedure Visibility: private -->
506
<element name="TFPDocMaker.SetInputDir">
512
<!-- argument Visibility: default -->
513
<element name="TFPDocMaker.SetInputDir.AValue">
516
<!-- procedure Visibility: private -->
517
<element name="TFPDocMaker.SetOnOption">
523
<!-- argument Visibility: default -->
524
<element name="TFPDocMaker.SetOnOption.AValue">
527
<!-- procedure Visibility: private -->
528
<element name="TFPDocMaker.SetOptions">
534
<!-- argument Visibility: default -->
535
<element name="TFPDocMaker.SetOptions.AValue">
538
<!-- variable Visibility: protected -->
539
<element name="TFPDocMaker.FCmdAction">
544
<!-- variable Visibility: protected -->
545
<element name="TFPDocMaker.FDryRun">
550
<!-- variable Visibility: protected -->
551
<element name="TFPDocMaker.FPackage">
556
<!-- variable Visibility: protected -->
557
<element name="TFPDocMaker.FProjectFile">
562
<!-- variable Visibility: protected -->
563
<element name="TFPDocMaker.FWriteProjectFile">
568
<!-- variable Visibility: protected -->
569
<element name="TFPDocMaker.FTranslated">
574
<!-- procedure Visibility: protected -->
575
<element name="TFPDocMaker.SetCmdAction">
581
<!-- argument Visibility: default -->
582
<element name="TFPDocMaker.SetCmdAction.AValue">
585
<!-- procedure Visibility: protected -->
586
<element name="TFPDocMaker.SetDryRun">
592
<!-- argument Visibility: default -->
593
<element name="TFPDocMaker.SetDryRun.AValue">
596
<!-- procedure Visibility: protected -->
597
<element name="TFPDocMaker.SetPackage">
603
<!-- argument Visibility: default -->
604
<element name="TFPDocMaker.SetPackage.AValue">
607
<!-- procedure Visibility: protected -->
608
<element name="TFPDocMaker.SetWriteProjectFile">
614
<!-- argument Visibility: default -->
615
<element name="TFPDocMaker.SetWriteProjectFile.AValue">
618
<!-- function Visibility: protected -->
619
<element name="TFPDocMaker.ParseCommon">
620
<short>Parses options common to FPDoc and MakeSkel. Returns caInvalid for unknown options.</short>
621
<descr>Raw options, where Cmd contains name=value, are splitted into Cmd and Arg. Quotes around/in Arg are removed, needed to process scripts.</descr>
625
<!-- function result Visibility: default -->
626
<element name="TFPDocMaker.ParseCommon.Result">
629
<!-- argument Visibility: default -->
630
<element name="TFPDocMaker.ParseCommon.Cmd">
633
<!-- argument Visibility: default -->
634
<element name="TFPDocMaker.ParseCommon.Arg">
637
<!-- function Visibility: public -->
638
<element name="TFPDocMaker.DocumentPackage">
639
<short>Creates or updates XML documentation sources (MakeSkel emulation)</short>
644
<!-- function result Visibility: default -->
645
<element name="TFPDocMaker.DocumentPackage.Result">
648
<!-- argument Visibility: default -->
649
<element name="TFPDocMaker.DocumentPackage.APackageName">
652
<!-- argument Visibility: default -->
653
<element name="TFPDocMaker.DocumentPackage.AOutputName">
656
<!-- argument Visibility: default -->
657
<element name="TFPDocMaker.DocumentPackage.InputFiles">
660
<!-- argument Visibility: default -->
661
<element name="TFPDocMaker.DocumentPackage.DescrFiles">
664
<!-- procedure Visibility: public -->
665
<element name="TFPDocMaker.CreateUnitDocumentation">
666
<short>Creates final documentation, for a package or a single unit (FPDoc emulation).</short>
667
<descr>When an description file exists already for a unit, an <rootdir/>/upd.<unit/>.xml file is created, containing all updates. Empty files are destroyed afterwards.
668
Otherwise a skeleton file is created in the descriptions directory.</descr>
672
<!-- argument Visibility: default -->
673
<element name="TFPDocMaker.CreateUnitDocumentation.APackage">
676
<!-- argument Visibility: default -->
677
<element name="TFPDocMaker.CreateUnitDocumentation.AUnit">
678
<short>Update only AUnit if not empty, else the entire package.</short>
680
<!-- argument Visibility: default -->
681
<element name="TFPDocMaker.CreateUnitDocumentation.ParseOnly">
684
<!-- variable Visibility: public -->
685
<element name="TFPDocMaker.ImportDir">
690
<!-- variable Visibility: public -->
691
<element name="TFPDocMaker.SelectedUnit">
696
<!-- constructor Visibility: public -->
697
<element name="TFPDocMaker.Create">
703
<!-- argument Visibility: default -->
704
<element name="TFPDocMaker.Create.AOwner">
707
<!-- destructor Visibility: public -->
708
<element name="TFPDocMaker.Destroy">
714
<!-- procedure Visibility: public -->
715
<element name="TFPDocMaker.AddDirToFileList">
716
<short>Adds files in a directory to a stringlist, using a filename mask.</short>
721
<!-- argument Visibility: default -->
722
<element name="TFPDocMaker.AddDirToFileList.List">
725
<!-- argument Visibility: default -->
726
<element name="TFPDocMaker.AddDirToFileList.ADirName">
729
<!-- argument Visibility: default -->
730
<element name="TFPDocMaker.AddDirToFileList.AMask">
733
<!-- procedure Visibility: public -->
734
<element name="TFPDocMaker.AddToFileList">
735
<short>Adds lines from an file to a stringlist.</short>
740
<!-- argument Visibility: default -->
741
<element name="TFPDocMaker.AddToFileList.List">
744
<!-- argument Visibility: default -->
745
<element name="TFPDocMaker.AddToFileList.FileName">
748
<!-- function Visibility: public -->
749
<element name="TFPDocMaker.UnitSpec">
750
<short>Returns the full input specification (command options) for a unit in the selected package.</short>
755
<!-- function result Visibility: default -->
756
<element name="TFPDocMaker.UnitSpec.Result">
759
<!-- argument Visibility: default -->
760
<element name="TFPDocMaker.UnitSpec.AUnit">
763
<!-- function Visibility: public -->
764
<element name="TFPDocMaker.ImportName">
765
<short>Returns the package name from an Imports specifier.</short>
770
<!-- function result Visibility: default -->
771
<element name="TFPDocMaker.ImportName.Result"/>
772
<!-- argument Visibility: default -->
773
<element name="TFPDocMaker.ImportName.AIndex">
776
<!-- procedure Visibility: public -->
777
<element name="TFPDocMaker.LogToStdOut">
778
<short>Standard OnLog handler, writing to stdout.</short>
783
<!-- argument Visibility: default -->
784
<element name="TFPDocMaker.LogToStdOut.Sender">
787
<!-- argument Visibility: default -->
788
<element name="TFPDocMaker.LogToStdOut.msg">
791
<!-- procedure Visibility: public -->
792
<element name="TFPDocMaker.LogToStdErr">
793
<short>Standard OnLog handler, writing to stderr.</short>
798
<!-- argument Visibility: default -->
799
<element name="TFPDocMaker.LogToStdErr.Sender">
802
<!-- argument Visibility: default -->
803
<element name="TFPDocMaker.LogToStdErr.msg">
806
<!-- function Visibility: public -->
807
<element name="TFPDocMaker.ParseFPDocOption">
808
<short>Parses and stores an FPDoc commanline option.</short>
813
<!-- function result Visibility: default -->
814
<element name="TFPDocMaker.ParseFPDocOption.Result">
817
<!-- argument Visibility: default -->
818
<element name="TFPDocMaker.ParseFPDocOption.S">
821
<!-- function Visibility: public -->
822
<element name="TFPDocMaker.ParseUpdateOption">
823
<short>Parses and stores an MakeSkel commanline option.</short>
828
<!-- function result Visibility: default -->
829
<element name="TFPDocMaker.ParseUpdateOption.Result">
832
<!-- argument Visibility: default -->
833
<element name="TFPDocMaker.ParseUpdateOption.S">
836
<!-- function Visibility: public -->
837
<element name="TFPDocMaker.CheckSkelOptions">
838
<short>Sanity check before starting a MakeSkel operation (DocumentPackage).</short>
843
<!-- function result Visibility: default -->
844
<element name="TFPDocMaker.CheckSkelOptions.Result">
847
<!-- function Visibility: public -->
848
<element name="TFPDocMaker.CleanXML">
849
<short>Return True and (try) kill file if no element tag found in it.</short>
850
<descr>Used to remove empty update files after DocumentPackage.</descr>
854
<!-- function result Visibility: default -->
855
<element name="TFPDocMaker.CleanXML.Result">
858
<!-- argument Visibility: default -->
859
<element name="TFPDocMaker.CleanXML.FileName">
862
<!-- function Visibility: public -->
863
<element name="TFPDocMaker.SelectedPackage">
864
<short>Returns the currently selected package.</short>
866
<errors>When no package was specified, a message is logged.</errors>
869
<!-- function result Visibility: default -->
870
<element name="TFPDocMaker.SelectedPackage.Result">
873
<!-- property Visibility: public -->
874
<element name="TFPDocMaker.Package">
875
<short>The currently selected package.</short>
879
<!-- property Visibility: public -->
880
<element name="TFPDocMaker.CmdAction">
881
<short>Action to perform after commandline arguments have been parsed.</short>
885
<!-- property Visibility: public -->
886
<element name="TFPDocMaker.DryRun">
887
<short>Allows to perform syntax checks of documentation source files, instead of creating final documentation.</short>
891
<!-- property Visibility: public -->
892
<element name="TFPDocMaker.ReadProject">
893
<short>True when a project file has been read (--project option)</short>
897
<!-- property Visibility: public -->
898
<element name="TFPDocMaker.WriteProjectFile">
899
<short>The name of an project file to create (--write-project argument)</short>
903
<!-- property Visibility: public -->
904
<element name="TFPDocMaker.OnOption">
905
<short>User supplied handler for unknown commandline options.</short>
909
<!-- property Visibility: public -->
910
<element name="TFPDocMaker.InputDir">
911
<short>The directory containing Inputs files. Writing adds all source files in the directory to Inputs[].</short>
912
<descr>Can be written more than once, to specify multiple input directories (cumulative).</descr>
915
<!-- property Visibility: public -->
916
<element name="TFPDocMaker.DescrDir">
917
<short>The directory containing Description files. Writing adds all XML files in the directory to Descriptions[].</short>
918
<descr>Can be written more than once, to specify multiple Description directories (cumulative). The first[?] directory is assumed the default directory, for creating and searching description files. [intended to merge files from multiple packages]</descr>
921
<!-- property Visibility: public -->
922
<element name="TFPDocMaker.Options">
923
<short>Holds all parsed FPDoc and MakeSkel commandline options.</short>
927
<!-- function Visibility: default -->
928
<element name="GetNextWord">
929
<short>Extracts next commandline option from an string.</short>
934
<!-- function result Visibility: default -->
935
<element name="GetNextWord.Result">
938
<!-- argument Visibility: default -->
939
<element name="GetNextWord.s">
942
<!-- function Visibility: default -->
943
<element name="ExtractImportName">
944
<short>Get package name from an Imports specifier.</short>
949
<!-- function result Visibility: default -->
950
<element name="ExtractImportName.Result">
953
<!-- argument Visibility: default -->
954
<element name="ExtractImportName.s">
957
<!-- function Visibility: default -->
958
<element name="UnitFile">
959
<short>Get an filename from an Inputs or Descriptions list.</short>
964
<!-- function result Visibility: default -->
965
<element name="UnitFile.Result">
968
<!-- argument Visibility: default -->
969
<element name="UnitFile.AList">
972
<!-- argument Visibility: default -->
973
<element name="UnitFile.AIndex">
976
<!-- function Visibility: default -->
977
<element name="ExtractUnitName">
978
<short>Get the unit name from Inputs or Descriptions, or from an string containing such an element.</short>
983
<!-- function result Visibility: default -->
984
<element name="ExtractUnitName.Result">
987
<!-- argument Visibility: default -->
988
<element name="ExtractUnitName.AList">
991
<!-- argument Visibility: default -->
992
<element name="ExtractUnitName.AIndex">
995
<!-- argument Visibility: default -->
996
<element name="ExtractUnitName.s">
999
<element name="TFPDocMaker.CmdOptions">
1000
<short>Combined FPDoc and MakeSkel options. Writing copies the given object into both option sets.</short>
1005
</fpdoc-descriptions>