Difference between revisions of "FPDoc Updater"

From Lazarus wiki
Jump to navigationJump to search
 
Line 37: Line 37:
 
The Updater does not interface well with LazDe.
 
The Updater does not interface well with LazDe.
  
ToDo: Add feature or instructions for creating packages for processing with LazDe.
+
ToDo: Add feature or instructions for creating packages for processing with the [[Lazarus Documentation Editor]].
  
 
[[Category:Help and Docs]]
 
[[Category:Help and Docs]]

Latest revision as of 10:32, 28 September 2014

English (en)

Introduction

FPDoc Updater is a GUI tool for updating FPDoc files. You can find it in lazarus/doceditor/fpdocupdater/ directory.

Features

  • uses FPC Makeskel tool for generating FPDoc skeletons
  • mass update of FPDoc files for selected Pascal units
  • preserves written description in FPDoc elements
  • content of removed elements can be moved to different element
  • can backup processed FPDoc files
  • handles multiple elements with same name
  • can show update summary

Usage

Set correct paths for FPDoc files, Pascal units, include files and Makeskel tool.

Hint: The Makeskel tool is in you FPC/bin directory.

Hint: Terminate the application after setting up the paths, to save your changes. The tool tends to crash :-(

FPDocUpdater.png

Beware: Uncheck "Show summary" before creating skeletons from multiple files, or you have to click away the summary dialog for every processed file.

Select from the list which FPDoc files should be updated and push Update button, or

Refresh refreshes the file list(?)

Update updates the selected file(s)

Update New updates all new files (marked red)

Update All updates all files.

Usage with other tools

The Updater does not interface well with LazDe.

ToDo: Add feature or instructions for creating packages for processing with the Lazarus Documentation Editor.