documentation-generation

Anything better than PHPDoc out there?

Does anybody use anything else to document their PHP code than PHPDoc? Are there any tools that read the same documentation syntax but give richer output? ...

Automatic PHP Documentation Generation?

For ActionScript 2, I've used NaturalDocs. However it has pretty poor support for PHP. I've looked so far at Doxygen and phpDocumentor, but their output is pretty ugly in my opinion. Does anyone have any experience with automatic documentation generation for PHP? I'd prefer to be able to use javadoc-style tags, they are short to write an...

Are there documented, organized collections of libraries for Common Lisp?

I am a college student at a school that teaches mainly in Java. One of the strong points of Java, which I quite enjoy, is the large collection of libraries. What makes these libraries especially useful is the extensive documentation and organization presented via JavaDoc. Are there any library collections for Common Lisp which also have ...

Need a good way to share iPhone source code on the Web.

Hi, I'm looking for a way to share some iPhone SDK source code I have with others. Goals: Share iPhone SDK source code, Objective C written in XCode. I have a good bit of source code I want to share. I'd like for it to be easy. I'd like for it to have syntax highlighting, by this I mean coloring and formatting Ideally it would allow m...

Is there a way to use inline comments to document members in .NET?

Is there a way to document a member inline in .Net? Let me explain. Most tools that extract documentation from comments support some kind of inline documentation where you can add a brief after the member declaration. Something like: public static string MyField; /// <summary>Information about MyField.</summary> Is there a way to do t...

Graphviz for documentation.

I noticed that doxygen uses the graphviz library for creating diagrams. Have you ever used graphviz for generating documentation? Is it worth learning the graphviz for documentation purposes outside the scope of doxygen? Or am I better off to sticking with a standard data modeling package like Visio? I understand the merits of it as a g...

XML Commenting tips for C# programming

Good morning, afternoon, evening or night (depending on your timezone). This is just a general question about XML commenting within C#. I have never been very big into commenting my programs, I've always been more of a verbose variable/property/method namer and letting the code speak for itself. I do write comments if I'm coding somethi...

Program for documenting a C struct?

If you have a binary file format (or packet format) which is described as a C structure, are there any programs which will parse the structure and turn it into neat documentation on your protocol? The struct would of course contain arrays, other structures, etc., as necessary to describe the format. The documentation would probably nee...

What is your preferred document format for documenting databases

I am in the process of writing an application which, among other functionality, generates MediaWiki documentation of an MSSQL database (objects, tables, table data). My question is which document formats you prefer, or are required to produce. I have too many ideas to follow, so your answers should set my priorities ;) (I know there ar...

Open source tool to generate diagrams from XML Schema documents?

I'm looking for an open source tool to generate diagrams from XML Schema documents, similar to the Logical Model View in oXygen or the diagrams in XML Spy's Schema Editor. ...

Recommendations for Documentation with an Open Source Project?

We are looking at documenting a fledgling open source project, and I was hoping for some suggestions on good methods and or tools that worked well for you. Further, as a developer, do you prefer online docs, wiki based docs, help files, or some other? ...

Can LaTeX be used for producing any documentation that accompanies software?

Although related to this question about LaTeX being used outside mathematics and academia, I'm specifically wondering if anyone uses or is familiar with anyone that uses LaTeX for generating any type of documentation relating to software. If so, could you say whether or not you like LaTeX and the purposes for which you use it? Thanks. ...

Documentation tools which integrate with Sharepoint?

Are there any documentation tools that easily integrate with Sharepoint 2007? With integrate I mean, that the tool provides means of publishing documentation to Sharepoint 2007 which are indexed and searchable from within Sharepoint. BTW: We use currently use HelpStudio. ...

How to document C code in Eclipse (intellisense/javadoc like tooltips)

Is it possible to document C code in Eclipse (3.4 w/ CDT) in such a way that JavaDoc/Intellisense like documentation is auto generated and displayed? E.g. On typing a function name followed by a '(' you get the first param with a tooltip explaining the meaning of that parameter? Thanks. ...

How to customize an existing LaTeX environment without interfering with other environments

I'm using Sphinx for documenting a project. It produces LaTeX files from restructured text. I would like to set a gray background color to the tips and notes, so I customized the notice environment after creating a graybox environment: \definecolor{MyGray}{rgb}{0.80,0.80,0.80} \makeatletter\newenvironment{graybox}{% \begin{lrbox}{\...

code documentation for python

What is out there on conventions and tools for documenting python source code? ...

Tracking header dependencies in Ada?

Is there a tool that will track/graph header dependencies from Ada source code? ...

C# documentation generator?

Is there any kind of documentation generator for C#? Like something that would put the xml-ish documentation right above the method/class declarations? Is there a tool or is it tucked away somewhere in VS 2008? ...

Looking for a Document Comparer that can generate difference reports.

I've been using an application called "WinMerge" lately for document comparisons, but one of the requirements of my teams script files (for auditing purposes) is that when we release a revision of a script we highlight the changes in red (RTF format I believe, it's through Lotus Notes) To that end, is there any software that can automat...

how to organize documentation

We are maintaining a legacy application written by Delphi, and there are lots of complex function in it. So far we collect parts of the document(of cause, the part we coding..), and other are missing(or not even been written..) we build a big word XX.doc file, and its structure is like this: 1 function A 1.1 description 1.2 work...