Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / fpc-pascal / 2009-02

Fwd: DOCUMENTATION INTEGRATION IN MAC XCODE 3.X

2 messages · 2 people ·

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

MICHAEL MCNEESE

Begin forwarded message:

Show quoted text 36 lines
From: MICHAEL MCNEESE Date: February 5, 2009 2:44:31 AM CST To: Subject: DOCUMENTATION INTEGRATION IN MAC XCODE 3.X Hi, All I am new to fpc pascal. But not new to Pascal, it is what I teethed on at my university. Unfortunately, it has been many years since I have programed seriously. Now, after looking at the various dialects of C, I have decided to pull Pascal out of the closet. C seems simply ugly to me. So here are the questions: Can anybody offer advise on books. I thought I saw a book by O'Reily but can't find it. The big question is about the integration of Free Pascal documentation into the documentation system of XCode 3.x. I have found that I can open the documents in XCode but cannot search or use the Assistant. Even though I have pointed the Pascal HTML's out to XCode in the prefs it does not seem to see it. Hoping for some advice and help. Michael Hardware: New Mac Pro 2.8 GHZ, 8 core Xeon processors, two 500 gig drives, 6 gigs of RAM, one DVD/CD drive. Old hardware: 9 year old Silver Mac with PPC processor and 1 gig of ram, 2 IDE drives.
Jonas Maebe
to MICHAEL MCNEESE
MICHAEL MCNEESE wrote 5 lines
The big question is about the integration of Free Pascal documentation into the documentation system of XCode 3.x. I have found that I can open the documents in XCode but cannot search or use the Assistant. Even though I have pointed the Pascal HTML's out to XCode in the prefs it does not seem to see it.

You'd have to create a docset out of the Free Pascal documentation (plain html does not cut it). I think this would require adding support for the docset format to the fpdoc utility. The format is documented here: http://developer.apple.com/documentation/DeveloperTools/Conceptual/Documentation_Sets/000-Introduction/chapter_1_section_1.html

The officially supported way to create a docset is to use doxygen, but FPC does not use doxygen for its documentation (fpdoc is a homegrown utility).

Jonas