From kdevelop Wed Oct 27 03:47:59 1999 From: Richard Dale Date: Wed, 27 Oct 1999 03:47:59 +0000 To: kdevelop Subject: KDoc patch - Objective-C support added to document extraction tool X-MARC-Message: https://marc.info/?l=kdevelop&m=94099607907631 MIME-Version: 1 Content-Type: multipart/mixed; boundary="--Boundary-=_nWlrBbmQBhCDarzOwKkYHIDdqSCD" --Boundary-=_nWlrBbmQBhCDarzOwKkYHIDdqSCD Content-Type: text/plain Content-Transfer-Encoding: 8bit I've added Objective-C support to the KDOC utility. It allows javadoc style doc comments to be added to C++/Objective-C header files, and extracts them. I've changed the @ref and @see directives to support Objective-C references of the form '@see +[Array count]' or '@ref #-init:ForCoder:'. Other than that, everything is the same as for C++. I've added an example Objective-C header to to kdedoc/doc subdirectory called 'objcexample.h'. KDoc can be found on the KDevelop site http://www.kdevelop.org/ under the 'Tools & Doc' section (the patch for KDevelop Objective-C support is under the 'Plugins & Patches' section). Please find attached the patch 'kdocobjc.patch.gz' gunzip kdocobjc.patch.gz Copy kdocobjc.patch to the directory above the KDoc sources $ cd $ patch -p1 < ../kdocobjc.patch $ ./configure $ make $ make install To try it out, put a bunch of Objective-C headers in a temporary directory and type 'kdoc *.h'. Then have a look at the HTML it produces. To use it from within KDevelop you just select the Project->Make API-Doc menu option. Regards -- Richard --Boundary-=_nWlrBbmQBhCDarzOwKkYHIDdqSCD Content-Type: application/x-gzip; name="kdedocobjc.patch.gz" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="kdedocobjc.patch.gz" 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 --Boundary-=_nWlrBbmQBhCDarzOwKkYHIDdqSCD--