FPCDocs Tutorial: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ## Overview | |
| 2 | 2 | ||
| 3 | 3 | 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. | |
| 4 | 4 | ||
| 5 | 5 | 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) | |
| 6 | 6 | ||
| 7 | 7 | ## Prerequisites | |
| 8 | 8 | ||
| 9 | 9 | - A working FreePascal environment must be installed (e.g. a stable version from a Debian repository). See \[1\] for more details. | |
| 10 | 10 | - Having a working Lazarus installed may not hurt | |
| 11 | 11 | - As the documentation needs FPC source files, you will need the latest source from git. See \[1\] on how to get that. | |
| 12 | 12 | - The fpcdocs: | |
| 13 | 13 | ||
| 14 | 14 | ``` bash | |
| 15 | 15 | svn co http://svn.freepascal.org/svn/fpcdocs/trunk fpcdocs | |
| 16 | 16 | ``` | |
| 17 | 17 | ||
| 18 | 18 | - 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. The files a4.sty and moveverb.sty. | |
| 19 | 19 | - Ubuntu 12: | |
| 20 | 20 | ``` bash | |
| 21 | 21 | apt-get install tex4ht texlive-binaries texlive-latex-base texlive-latex-recommended texlive-latex-extra | |
| 22 | 22 | ``` | |
| 23 | 23 | ||
| 24 | 24 | ### Assumptions | |
| 25 | 25 | ||
| 26 | 26 | 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: | |
| 27 | 27 | ||
| 28 | 28 | ``` bash | |
| 29 | 29 | ~/fpc/ | |
| 30 | 30 | ~/fpc/fpcdocs #contains SVN http://svn.freepascal.org/svn/fpcdocs/trunk | |
| 31 | 31 | ~/fpc/fpcsrc #contains FPC sources, e.g. http://svn.freepascal.org/svn/fpc/branches/fixes_2_6 | |
| 32 | 32 | ~/fpc/fpcsrc/compiler/utils/msg2inc.pp #contains FPC msg2inc tool | |
| 33 | 33 | ``` | |
| 34 | 34 | ||
| 35 | 35 | ## Generating documentation | |
| 36 | 36 | ||
| 37 | - | ||
| 38 | - | ||
| 37 | + | ```text | |
| 38 | + | make clean | |
| 39 | + | sh fixdocs.sh | |
| 40 | + | ``` | |
| 39 | 41 | ||
| 40 | 42 | write me ;) | |
| 41 | 43 | ||
| 42 | 44 | ## References | |
| 43 | 45 | ||
| 44 | 46 | - \[1\] [[Installing Lazarus]] | |
| 45 | 47 | - \[2\] Build FAQ | |
| 46 | 48 | - \[3\] FPDoc manual | |
| 47 | 49 | ||
| 48 | 50 | --- | |
| 49 | 51 | *From the Free Pascal wiki, page "FPCDocs Tutorial", as it stood on 2023-11-10 after a change by Bart, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 50 | 52 | Category: Help and Docs | |
| 51 | 53 | Category: Tutorials |