Skip to content

Commit

Permalink
Bump version 0.8.0
Browse files Browse the repository at this point in the history
  • Loading branch information
rottmann committed Nov 14, 2014
1 parent fa4cff1 commit b0ab060
Show file tree
Hide file tree
Showing 69 changed files with 2,219 additions and 1,719 deletions.
53 changes: 50 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,53 @@
# apiDoc Changelog


#### 0.8.0

* Parameter
* Add `@apiDefine`, `@apiUse` as replacement for all (now) deprecated define and structure methdos.
* __Mark as deprecated__:
* `@apiDefineErrorStructure`
* `@apiDefineHeaderStructure`
* `@apiDefinePermission`
* `@apiDefineStructure`
* `@apiDefineSuccessStructure`
* `apiErrorTitle`
* `apiErrorStructure`
* `apiHeaderStructure`
* `apiHeaderTitle`
* `apiParamTitle`
* `apiStructure`
* `apiSuccessTitle`
* `apiSuccessStructure`
* __Remove__ `@apiInfo`, `@apiInfoExample`, `@apiInfoTitle`. Not needed since success and error response can be grouped.
* __Add__
* `@apiHeaderExample`
* `@apiParamExample`
* __Change__
* `@apiPermission`, multiple permission usage in a block is allowed now. Permission names must be defined with @apiDefine.
* __Extend__
* `@apiParam` with size and allowed values.

* CLI
* Show deprecated message. Show details with `--debug` or `--verbose`.
* Improved error output.
* Turn off verbose output by default.
* Add debug output.

* Parser
* Correctly handle Erlang comments.
* Bugfix: Markdown error on Empty description.
* Revised worker preProcess / postProcess functions.
* Change parser export names.

* Template
* Change template sample request to handle custom named groups.
* Update template vendor files (handlebars 2, requirejs)
* Added support for using path-to-regexp in sample request.
* Add `jQueryAjaxSetup` to apidoc.json for setup ajax requests (http://apidocjs.com/#configuration-template-settings).
* Hide the ul for tabs if no content.


#### 0.7.2

Bugfix: Custom parsers not working. (https://github.com/apidoc/apidoc/issues/113)
Expand All @@ -25,7 +72,7 @@ Add rudimentary support for direct api calls (test requests) from within the doc

Added ability to have forward slash (/) in parameter field names.

Add parameter `--parse` for parse only the files and return the parsed data.
Add parameter `--parse` for parse only the files and return the parsed data.

Allow perl comments between "=pod" and "=cut".

Expand Down Expand Up @@ -84,7 +131,7 @@ Bugfix: Template IE8 compatibility. (https://github.com/apidoc/apidoc/issues/69)
Update node version to 0.10.x.

Add optional custom browser title with `apidoc.title` in `package.json`.

Add optional url endpoint with `apidoc.url` in `package.json`.

Bugfix: Template scrollbug. (https://github.com/apidoc/apidoc/issues/64)
Expand Down Expand Up @@ -129,7 +176,7 @@ Bugfix: Fix parsing of multiline string. (https://github.com/apidoc/apidoc/issue

#### 0.4.1

Add support for CoffeeScript comment-style.
Add support for CoffeeScript comment-style.


#### 0.4.0
Expand Down
15 changes: 15 additions & 0 deletions CONTRIBUTORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,21 @@

Thanks to all people that help to make apiDoc better!

* [Peter Wong](https://github.com/peterwongpp)
* Hide the ul for tabs if no content [#142] (https://github.com/apidoc/apidoc/pull/142))

* [Bip Thelin](https://github.com/bipthelin)
* Correctly handle Erlang comments [#135] (https://github.com/apidoc/apidoc/pull/135))

* [Michael Schnyder](https://github.com/michaelschnyder)
* Improvements to the Testclient [#132] (https://github.com/apidoc/apidoc/pull/132))

* [Peter Gfader](https://github.com/peitor)
* Show error "responseText" on displayError [#129] (https://github.com/apidoc/apidoc/pull/129))

* [cjbarth](https://github.com/cjbarth)
* Added support for using path-to-regexp in template [#119] (https://github.com/apidoc/apidoc/pull/119))

* [Brian Horakh](https://github.com/brianhorakh)
* Perl - allow =pod and =cut ([#103] (https://github.com/apidoc/apidoc/issues/103))

Expand Down
2 changes: 1 addition & 1 deletion Gruntfile.js
Original file line number Diff line number Diff line change
Expand Up @@ -84,5 +84,5 @@ module.exports = function(grunt)
grunt.registerTask("default", ["jshint"]);

// Task: test
grunt.registerTask("test", ["clean", "simplemocha"]);
grunt.registerTask("test", ["clean", "jshint", "simplemocha"]);
};
16 changes: 9 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
# apiDoc 0.7.x
# apiDoc 0.8.x

Generates a RESTful web API Documentation.

[![Build Status](https://travis-ci.org/apidoc/apidoc.svg?branch=master)](https://travis-ci.org/apidoc/apidoc)
[![NPM version](https://badge.fury.io/js/apidoc.svg)](http://badge.fury.io/js/apidoc)

apiDoc creates a documentation from API descriptions in your source code.

Documentation at [apidocjs.com](http://apidocjs.com).

[Example](http://apidocjs.com/example/) output.
Expand All @@ -15,6 +17,11 @@ Documentation at [apidocjs.com](http://apidocjs.com).
`npm install apidoc -g`


## Changelog

[CHANGELOG.md](https://github.com/apidoc/apidoc/blob/master/CHANGELOG.md)


## Example

```javascript
Expand Down Expand Up @@ -68,7 +75,7 @@ Creates from input files in `example/` a documentation in path `doc/`.
# This is a comment.
#*
```

```perl
=pod
This is a comment.
Expand Down Expand Up @@ -97,11 +104,6 @@ Creates from input files in `example/` a documentation in path `doc/`.
[grunt-apidoc](https://github.com/apidoc/grunt-apidoc) `npm install grunt-apidoc`.


## Changelog

[CHANGELOG.md](https://github.com/apidoc/apidoc/blob/master/CHANGELOG.md)


## Help

Please add [issues](https://github.com/apidoc/apidoc/issues) if you have a question or found a problem. Pull requests are welcome too!
Expand Down
Loading

0 comments on commit b0ab060

Please sign in to comment.