This page consists of comments submitted by users of PERCEPS from the current PERCEPS page. I also have the comments from when Mark Peskin maintained the code if you want to see more comments.
Welcome to the new site! I'll try to peek at this board every week or so to see what people are saying about PERCEPS. You can post feature requests and such to this board, but the better forum for such things is the new PERCEPS mailinglist. Bascially, this forum exists so that PERCEPS users can say how great the program is and make others interested enough to download it. Enjoy. :)
Matthew Hannigan
Tue Jun 29 07:06:54 1999
Have you heard of c2man? This tool sounds like it would have significant overlap. I haven't used it myself but I know that has been actively used and developed for many years. I found a brief description thru altavista at: http://www.idiom.com/free-compilers/TOOL/C-43.html
Jan Babst
Chair for Optics, University of Erlangen
Tue Jun 29 23:27:45 1999
Congratulations! Finally I found a freely available documentation tool that works . And I'm glad to hear that it's being actively mainained. I know it's on your TODO, but let me encourage you that namespace support would be desparately ne eded. Grouping of overloaded global/namespace functions would be nice too. Unfortunately, PERCEPS doesn't ignore namespaces right now, but swallows the brief and detailed description of a class when a namespace declaration is present. I also ran into trouble with template arguments in a cla ss declaration when they continue across more than one line. Experiments with templated nested cl asses failed, too, but I doubt I'll need them in my project. Thanks for the good work so far, please keep it up!
Noel Welsh
Acis
Thu Jul 1 09:15:44 1999
The only auto-documentation program I could find that works with C. I hope to contribute my templates Real Soon Now!
John Young
Young Associates
Fri Jul 9 01:03:52 1999
Bryan Murphy
Fri Jul 9 06:57:55 1999
Perceps is pretty nifty so far. A small little request though, how about an {if variable} tag that lets you loop through member variables? (right now I use {if !func} and {if !enum} but it's a bit clunky and doesn't work right with {if first} and {if last} statements). Thanks! Bryan
Tracy
The Bristol Group
Thu Jul 15 22:55:37 1999
Hi all - Have been using perceps to document my code for the past week and've been having trouble tracking down a problem with a couple of functions (not member functions, just regular C global functions) not showing up in my foreach loop. Like they are not even recognized as functions at all. Does anybody have any suggestions how I can figure out what is causing this shy of debugging perceps.pl. Thanx Tracy
cs thomas
Webtrends Corp.
Tue Jul 20 00:29:51 1999
Daniel Kern
Biomedicom
Tue Jul 20 07:49:45 1999
The program looks great.
Marc Lamoureux
Wed Jul 21 07:24:22 1999
Thanks a lot for your work. This tools is very powerful and helps a lot. I used it to capture the existing classes from our C++ project (other 2000 classes) to help new comers to get into it. Knowing nothing about perl, it is still quiet easy to go into the sample templates and adapt them. I'll try to give my contribution to this community. Best whishes to you all.
Oliver Brandt
TU Braunschweig
Mon Jul 26 09:04:48 1999
Great tool, but as it is a PERL-Script, it's somewhat slow ... at least on my computer ;). For me (and i think for others, too) "CCDOC" (http://www.joelinoff.com/ccdoc/index.html) is the better choice: it's fast, as it is a c-prog; namespaces are supported and you'll get all information of your progs in a text-database. So you can use your own documentation-generator in order to get rtf, html, tex, ...
Ross J. Micheals
Lehigh University
Thu Aug 5 20:04:08 1999
Overall, I really like PERCEPS; but I spend the day tracking down an esoteric bug. It seems that when you include something like "\<b\>Note\</b\>:" in your comments, sometimes it really throws off the rest of your documentation. It also doesn't seem to happen in every source file, but after a long day, I've finally traced it down to this specific problem in one specific file. Tom; I can provide the source if you like. We eagerly await the next version!
Ross J. Micheals
Lehigh University
Thu Aug 5 20:05:57 1999
Quick follow up: the previous post reads \<b\>Note<\b\>: but should read <b>Note</b>:
Martin Neumann
ProCom (www.procom.de)
Wed Sep 8 15:20:45 1999
PERCEPS is simply great!
steve jaffe
cibc
Wed Oct 13 22:43:13 1999
a brillian program!
J. P. Abelanet
Lockheed-Martin Tactical Aircraft Systems
Wed Oct 27 15:41:00 1999
interested in seeing PERCEPS (or something similar) being made robust - PERCEPS is OK for now, but it's parsing of the source code could be better
Stefano Ghezzi
ICTeam S.P.A.
Mon Nov 1 11:25:26 1999
Stefano Ghezzi
ICTeam S.P.A.
Mon Nov 1 11:41:43 1999
I like very much the tool but unfortunately i'm using widely namespaces I read that you will support in the future namespace and i will wait. But for the moment isn't possible just to skip the namespace definition? Right now i'm getting, because of the namespace, 2 files for every class with strange stuff in them. Clearly the namespace is confusing the parser. If i comment out the namespace evething work great. best regards stefano
Jeremy Siek
University of Notre Dame
Wed Nov 24 22:36:30 1999
PERCEPS is great! (if a little rough around the edges) We've documented several of our libraries using PERCEPS, creating "templates" that mimic the SGI STL web pages. See MTL and GGCL under http://www.lsc.nd.edu/
Steve Vranyes
Veritas Software
Wed Dec 1 15:07:22 1999
Karl Nelson
Gtk--
Sat Jan 8 22:47:06 2000
J. P. Abelanet
Lockheed Martin
Tue Jan 11 16:33:47 2000
PERCEPS is pretty nice, but it needs a lot of work - I think it is a good enough framework that it has a lot of promise. I have heavily customized my version to do several things: > MUCH greater support for all the "C" options (typedefs, enums, structs, etc) > added ability to output a cross reference table for the hotlinks to allow hotlinking sample source code Please let me know of any significant changes to the PERCEPS distribution.
Amy Knowles
Eastman Kodak Company
Tue Jan 18 18:52:37 2000
We are investigating the use of Perceps to document a large, existing framework. I have made some changes to the Perceps script itself. The most significant of which is the ability to place the generated html files in the same directory as the corresponding header files and create the autolinks to incorporate this directory structure. This was necessary because our existing documentation is split across different directories to make it easier to manage our source code and html files. I also disabled the autolink to self, so that an html file would not contain links to itself. However, my biggest problem remains the detection and subsequent documentation of global functions that pertain to a specific class. For example, operator functions, like operator<< or operator>>, that are not friends. These functions are prototyped in the same header file as the corresponding class definition. Perceps will classify the function as a global function only if the function body is contained in the header file. It does not appear to be picking up a global function prototype. My string parsing skills are not up to the task of figuring out why these global function prototypes are not being detected as I would expect. Help!! This could be a show stopper for us!!!!
Brian
ResoX
Tue Jan 25 05:29:53 2000
Karl Nelson from the GTK-- project is rewriting PERCEPS. He's calling it pce2, it's still in Perl and it supports namespaces (woo hoo!). I don't think he's done yet, but you can see some sample output (the GTK-- class reference) at http://gtkmm.sourceforge.net/docs/gtk/class_index.html The script can currently be found in the GTK-- CVS tree.
James Yu
Solipsys Corp.
Wed May 10 16:42:59 2000
Bug report and fixes attached: in PROCARGS function for functions like this: void func (const A& a, const B& b); will generate a arglist of "constconst" What it really should do is generate a arglist of "A&B&". So the fix is quite easy, to remove all occurance of "const" from $element first. foreach $element (@elements) { $element=~s/const//g; $element=~/^\s*(\w+[\s\&\*]*)/; ... }
Pierre BARTHE
PBASoft
Sat May 13 17:20:25 2000
Murray Cumming
Fri Jun 23 10:26:21 2000
GtkExtra-- is now using the Gtk-- version of PERCEPS. Also, the Gtk-- link in the FAQ is outdated. Here are the correct links: http://gtkmm.sourceforge.net/docs/gtk/class_index.html http://gtkextramm.sourceforge.net/reference/GtkExtra.html
Denis Serebro
DINS
Mon Aug 7 08:34:10 2000
Bhavini Patel
Boeing
Tue May 1 17:48:23 2001
Nice scripts. Wish it has simple commands to add to script files to automatically generated authors, parameters.
Debra Repella
SWIFT
Tue Aug 7 19:11:16 2001
I need to contact the individual who is presently responsible for the PERCEPS product. I sent an e-mail to tbryant@python.net, but it was returned as undeliverable. Is there a current point of contact? Please send me a return e-mail at debra.repella@swift.com. Thanks!
Giang Tran
Philip Medical North America
Thu Sep 6 19:14:12 2001
A very useful and time-saving tool for generating documentation from C++ code. Perceps offers a very flexible way for generating and tailoring output file.
david oppenheim
Pingtel
Tue Feb 12 23:45:33 2002
Is there an "interest group" where I can get questions answered? I don't see any documentation & there are some things I'd like to learn how to do.
Thane Norton
Wacom Technology Corp.
Mon Nov 18 14:43:46 2002
Sannasi Nehru
Bearing Point
Wed Apr 21 14:00:35 2004
Johnny Blaze
Sun Dec 19 06:59:39 2004
Oh man, this program is great. I'm really happy that Tom took over from Mark. It's took bad Mark wasn't updating anymore but I'm glad we have Tom. :)
Last modified Fri Jun 9 04:14:09 2006