Databases
StackOverflow2013
Postsdbo
PO
 

Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <p>I'm the author of appledoc, so this answer may be biased :) I tried all mentioned generators though (and more) but got frustrated as none produced results I wanted to have (similar goals as you).</p> <p>According your points (I only mention appledoc and doxygen, I don't recollect headerdoc that well):</p> <ol> <li><p>Consistent look: appledoc out of the box, other need to tweak css, but probably doable.</p></li> <li><p>Generation of documentation sets (for Xcode references): appledoc full support for searchable and option-clickable documentation out of the box, doxygen generates xml and makefile which you need to invoke yourself. Additionally appledoc supports <a href="http://gentlebytes.com/appledoc-docs-examples-advanced/" rel="noreferrer">published docsets</a> out of the box.</p></li> <li><p>Categories: appledoc allows you to <a href="http://gentlebytes.com/appledoc-docs-examples-advanced/index.html#merge-categories" rel="noreferrer">merge categories</a> to known classes or leave them separate, foundation &amp; other apple class categories are listed separately in <a href="http://gentlebytes.com/media/appledoc/examples/v2/latest/index.html" rel="noreferrer">index file</a>. doxygen: this wasn't working best when I tried it.</p></li> <li><p>Custom reference pages: appledoc <a href="http://gentlebytes.com/appledoc-docs-examples-documents/" rel="noreferrer">supports</a> out of the box using either markdown or custom html, doxygen: you can include custom documentation to main page, don't know if you can include more pages.</p></li> <li><p>Easy command line: depends how you look at it: appledoc can take all arguments through command line switches (but also supports optional global and project settings plist files) so it should be very easy to integrate with build scripts. doxygen requires usage of configuration file to setup all parameters.</p></li> <li><p>Large codebases: all tools should support this, although didn't compare timewise. Also not sure if any tool supports cached values (running over previously collected data in order to save some time) - I am looking into adding this for next major release.</p></li> </ol> <p>It's some time since I tried using other tools, so above mentioned issues with doxygen/headerdoc may have been addressed! appledoc itself also has disadvantages: like you mention there's no support for enums, structs, functions etc (there was some work done in this direction, <a href="https://github.com/pilky/appledoc" rel="noreferrer">check this fork</a>), and it has it's own <a href="https://github.com/tomaz/appledoc/issues" rel="noreferrer">set of issues</a> that may prevent you using it, depending your requirements.</p> <p>I am currently working on major update that will <a href="http://gentlebytes.com/2012/02/bringing-appledoc-to-next-level/" rel="noreferrer">cover most glaring issues</a>, including support for enums, structs etc. I'm regularly pushing new stuff to experimental branch as soon as I finish larger chunks and make it stable enough, so you can follow the progress. But it's still very early and progress depends on my time so it may take quite a while until working solution.</p>
    singulars
    1. This table or related slice is empty.
    1. POObjective-C Documentation Generators: HeaderDoc vs. Doxygen vs. AppleDoc
      singulars
      1. PTQuestion
    1. PTAnswer
    1. This table or related slice is empty.
    1. USTom
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. PO
      1. This table or related slice is empty.
      1. VTUpMod
    2. VO
      singulars
      1. PO
      1. This table or related slice is empty.
      1. VTUpMod
    3. VO
      singulars
      1. PO
      1. This table or related slice is empty.
      1. VTUpMod
    1. COGreat job on Appledoc! NB though, its very easy to tell Doxygen to install an Xcode docset. . . also Doxygen supports caching of eg Class Diagrams
      singulars
      1. PO
      1. USJasper Blues
    2. COUpdate: Actually just tried installing a docset in Xcode5 and its not working. A bug? filed one.
      singulars
      1. PO
      1. USJasper Blues
 

Querying!

 
Guidance
A row detail

Detail views are divided into sections. All the information in the data section comes from columns in the selected row. The other sections display data from other, related rows.

Related data can be related in a to-one or a to-many fashion. Captions of data related in a to-many fashion link to a list view showing a filtered view of the table.

Try moving around until you find a non-empty to-many entry and click on the label to get to one. You can move back to the root by clicking on the database name in the header.

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload