Lazarus Documentation Editor

From Free Pascal wiki
Jump to navigationJump to search

Introduction

This is work in progress.

An important part of Lazarus still missing is the documentation. To aid in the making of this documentation a tool has been developed. This page will describe the workings of this tool. To denote the Lazarus base directory in this document I use [$LazDir]. So when you read this replace this with the directory lazarus is installed in.

How to start

To keep the documentation platform independent XML is used. The current documentation can be found in [$LazDir]/docs/xml/. So far there are only skeleton files in the lcl directory. The XML files you find in this directory are auto generated and need to be adapted to be usable. So now we know where to find the files, lets look at the tool to create / adapt them.

The Lazarus Documentation Editor

"lazde" is a tool to edit the xml files, but can also be used to generate the basic files from source files and by means of an external tool to generate a HTML version of the documentation. An example of the results of the last tool can be seen here, a part of the documentation sofar. As there is no compiled version of lazde, you have to make one yourself. The sources for "lazde" can be found in [$LazDir]/doceditor/. When you run this program you will be presented with this screen

Lazdemain.png

Let us start documenting