Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Commits on Feb 23, 2011
Commits on Feb 22, 2011
  1. Fixed cross references embedded within code spans.

    Using back tick Markdown syntax for code span, prevents Markdown from processing embedded text. This is fine from Markdown point of view (i.e. create HTML examples and similar), it creates issues with appledoc as any Markdown link generated from known object, embedded inside back ticks isn't converted properly. To overcome this, we need to embed back tick inside description manually after parsing. In the same time we need to take only handle links we generate while leaving any user entered ones unchanged!
  2. Updated documentation set method declaration to text instead of html.

    Tried this to see if Xcode3 would delimit next section with new line, but doesn't help. Will leave it as text for now - declaration formatting isn't preserved anyway.
  3. Fixed docsetutil `Entity '' not defined` error.

    This error was reported during indexing for any unknown HTML code symbol (for example `–`). Markdown processor converted plain chars into these symbols as part of the conversion and obviously docsetutil has some issues with it. The workaround was to use plain text for abstract when generating tokens files. This commit is partial fix, the following will also handle some cleaning up of the text to make it more suitable for display.
Commits on Feb 21, 2011
Commits on Feb 11, 2011
  1. Implemented possibility to add arbitrary documentation. Closes #7.

    This was one of much requested features. It allows adding arbitrary files to generated documentation. It's enabled with one or more `--include` switches. All files and directories specified are simply copied to `docs` subfolder within generated HTML files. So basically, you're free to write any HTML or whatever you want included with the generated documentation.
    But the power lies in special "template" files. These are just normal text files which names end with `-template` (for example `document1-template.html). Extension of these files is not important - they will always be converted to .html! The files can reside on any subpath - the path will be preserved. All such files are processed using the same logic as any other comment, so you can use appledoc comment syntax, including cross referencing any object or member. You can also cross reference these files from "normal" comments (or other documents) by simply writing the filename without `-template` and extension. You don't have to deal with subpaths either, these will be automatically picked up for you! [Online documentation]( is not yet updated, will do it shortly.
    At this point, it's basic stuff only. As such it has much potential for future (like adding markdown syntax for headings, images and similar - for now just use HTML tags). But at least it's a start and get's work done for the moment.
    Enjoy and let me know if you find something not working as expected :)
Commits on Feb 3, 2011
  1. Fixed short description for comments with single paragraph containing…

    … special blocks. Closes #62.
    The issue was with comments like this one:
    	/** Some text
    	@warning Description
    	- (void)method;
    Although all special blocks (warnings, bugs, examples and lists) are delimited with empty lines from preceding text, they are conceptually part of the same paragraph - they are converted to a paragraph item object and added to the same paragraph as preceding text. The reason for such handling is so that we can add such items to whatever paragraph - like @param or @return description etc. However when creating short description and tooltips for methods, the whole first paragraph (including all special blocks) was used. As from the users point of view, these are clearly delimited with empty line, the resulting documentation contained unexpected tooltips and short descriptions.
    These situations are properly handled now and only the text part of the first paragraph up to the first special block is used for short description and tooltip! Thanks to "BloodDragon" for pointing it out!
    *NOTE:* after implementing this part I noticed that special blocks were not rendered to the documentation in such cases if `--no-repeat-first-par` option was used. A bit more logic was required in such case, so appledoc now properly repeats omitted parts as a first paragraph of the description paragraphs of a comment!
    *IMPORTANT:* This commit requires updating template files!
Commits on Jan 31, 2011
  1. Added table of contents and jump to button to object template. Closes #…

    This feature was implemented by "BloodDragon"!
  2. Implemented proper handling of methods and properties in HTML section…

    …s. Closes #60. Closes #61.
    IMPORTANT: This commit requires updating template files!
Commits on Jan 28, 2011
  1. Added full method declaration to documentation set method token.

    In Xcode 3.2.5 quick help window, declaration doesn't end the line, next item is simply drawn right after the declaration. Tried inserting <br /> and similar, but didn't help.
  2. Fixed Xcode quick help window not displaying documentation. Closes #46.

    The problem was in doc set info.plist containing empty keys for unused values. Apparently Xcode requires keys not being present at all in such case. Haven't noticed this in documentation. Thanks to "BloodDragon" for pointing it out.
    Note that at this point only quick description and related API is shown, while parameters, declaration and the rest aren't - will need to look into that.
    IMPORTANT: template files need to be updated in order for this fix to work!
  3. Changed doc set info.plist to XML format.

    Don't know where ASCII format came - I copied Apple's info.plist from their documentation and using Property List Editor might have changed the format (of course Apple might be using ASCII format in docs I've checked).
Commits on Jan 26, 2011
Commits on Jan 17, 2011
  1. Implemented appledoc build number to make it simpler to check which v…

    …ersion was used for generation.
  2. Updated templates to use user's whitespace. Closes #34 and #37.

    Note that this commit is only the last one in series which started at 214c662 that ultimately fixed above issues.
Commits on Jan 5, 2011
  1. Fixed HTML tags escaping when generating HTML. Closes #40.

    This allows writting stuff like <br/> or <tt>something</tt> and be converted to HTML tags instead of being escaped by template engine.
    Note that escaped strings may still pop up in other places not covered by this commit. Perhaps it wouldn't hurt to simply use unescaped strings all the time? It should even make template engine operations faster as it wouldn't run escaping all the time.
Commits on Jan 3, 2011
  1. Implemented optional disabling of first paragraph repeat for members.…

    … Closes #29.
    By default appledoc repeats first paragraph in members documentation. This can be optionally disabled with command line switch now.
  2. Refactored moving HTML files to DocSet by moving the exact location f…

    …rom being hardcoded in source code to being changable within docset template structure itself.
    Doesn't change actual handling a bit though.
Commits on Dec 23, 2010
  1. Implemented appledoc version printout to generated HTML and unified a…

    …ppledoc related information handling.
    Printing version makes it easier to diagnose problems in documentation generation related to specific versions or just determine if someone is using latest version.
Commits on Dec 22, 2010
  1. Prepared ground for HTML hierarchy file generation.

    At this stage, hierarchy file is generated but it only contains categories and protocols.
Commits on Dec 9, 2010
  1. Implemented better support for declared in info.

    Instead of displaying all entries (.h and .m files for example), first the file from comment is tried. If no comment, or missing source file information, the first header file from the object's sourceInfos list is returned. If no header file is found, the first file from the list is returned. Finally if no source information is found, nil is returned.
Commits on Dec 7, 2010
  1. Fixed object specifications vertical alignment to top.

    This renders labels for elements with multiple values at the top of the row instead of the middle.
  2. Fixed delimiters handling for declared in object specifications.

    As we use <br /> for delimiter, we don't want to have it HTML escaped by mustache, so we need to specify that in the template.
  3. If only one paragraph is found in a comment, method discussion is omm…

    Repeating single paragraph resulted in strange looking documentation.
Commits on Dec 2, 2010
Commits on Nov 30, 2010
  1. Fixed Nodes.xml NodeRef refid parameters.

    The problem was docsetutil issued an error due to not embedding the refid attribute value within quotes.
Something went wrong with that request. Please try again.