FPCDocs Tutorial

From Lazarus wiki
Revision as of 07:50, 18 May 2012 by Chronos (talk | contribs) (syntaxhighlight)
Jump to navigationJump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Overview

This tutorial will guide you through getting the latest FreePascal docs sources and generating documentation from it. Please see the official documentation [3] for more details.

November 2011: I'm having trouble generating docs, and finding documentation on it, so I decided to start this page to help me and others. Please feel free to update/add info (and remove this notice when it actually works ;) --BigChimp 05:11, 22 November 2011 (CET)

Prerequisites

  • A working FreePascal environment must be installed (e.g. a stable version from a Debian repository). See [1] for more details.
  • Having a working Lazarus installed may not hurt
  • As the documentation needs FPC source files, you will need the latest source from subversion. See [1] on how to get that.
  • Some tex programs: texlive, tex4ht, and dvi2tty if you want to generate plain-text documents (for DOS, mainly). The package names may differ depending on your distribution.

Assumptions

I'm assuming you're running on Linux; apparently generating docs on Windows is not supported. Also, this tutorial assumes you have a stable system-wide installation of FPC and Lazarus, and a working SVN version of FPC with proper fpc.cfg. Finally, you have your SVN FPC source and fpcdocs directories set up like this:

~/fpc/
~/fpc/bin/            #contains your installed compiler executables
~/fpc/source/         #contains SVN source code
~/fpc/source/fpcdocs/ #contains SVN fpcocs


Generating documentation

write me ;)

References