lazarus-ccr/components/fpspreadsheet/docs
2017-03-02 12:39:07 +00:00
..
api fpspreadsheet: Fix broken script for api chm file generation (possibly broken in r5282) 2017-02-09 18:51:17 +00:00
wiki fpspreadsheet: Add a new chm help file containing snapshots of the fpspreadsheet wiki articles. Move current fpspreadsheet.chm into a docs subfolder and rename it to fpspreadsheet-api.chm. Add/update scripts and tools for creation of these chm files. 2015-06-27 19:40:42 +00:00
fpspreadsheet-api.chm fpspreadsheet: Update chm help files for v1.8 2017-03-02 12:39:07 +00:00
fpspreadsheet-wiki.chm fpspreadsheet: Update chm help files for v1.8 2017-03-02 12:39:07 +00:00
README.txt fpspreadsheet: Fix broken script for api chm file generation (possibly broken in r5282) 2017-02-09 18:51:17 +00:00

--------------------------------------------------------------------------------
  Contents of this folder
--------------------------------------------------------------------------------

- fpsspreadsheet-wiki.chm is a snapshot of the wiki articles covering 
  fpspreadsheet.

- fpspreadsheet-api.chm contains the documentation of the most important
  procedures and functions of the library. It is extracted from the embedded
  comments in the source files.
  
  
--------------------------------------------------------------------------------
  How to create fpspreadsheet-wiki
--------------------------------------------------------------------------------
- Navigate to the folder components/wiki of the Lazarus installation.

- Compile the package "lazwiki" in the equally-named subfolder.

- Compile the programs "wikiget" and "wikiconvert".

- Add them to the system's search path (or copy the two executables to the
  folder docs/wiki of the fpspreadsheet installation.

- Run the script "make_docs.bat" (no Linux script at the moment)

- This script downloads the current fpspreadsheet wiki articles and creates
  a chm help file. 
  
  
--------------------------------------------------------------------------------
  How to create fpspreadsheet-api (Windows-only)
--------------------------------------------------------------------------------
- Download the program "Doc-o-matic Express" from the site
  http://www.doc-o-matic.com/download.shtml

- This is a source code documentation and help authoring tool which constructs
  a chm help file from comments embedded into the source code.

- Install the program

- Change the variable DOX_CMD in the batch file "builddoc.bat" to point to the 
  correct folder.

- Run the batch file "builddoc.bat" which extracts the documentation code from
  the sources and creates the chm file. It may take some time...
  
  
--------------------------------------------------------------------------------