Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fixes, tweaks, functionality #53

Merged
merged 1 commit into from Aug 26, 2014
Merged

fixes, tweaks, functionality #53

merged 1 commit into from Aug 26, 2014

Conversation

boneskull
Copy link
Contributor

  • Fixes
    • fixed incorrect default behavior which was to use all symbols. now defaults to ignoring internal/private functions as before. respects @private tag.
    • fixed problem wherein function-level @description would be duplicated in a @returns tag having no description of its own
    • fixed invalid .jshintrc and removed unused jshint-config.json
    • fixed bad formatting (extra comma) when displaying a member or parameter w/o a @description
  • Enhancements
    • support for @example tag
    • support for @property tag
    • type support for both @property tag and members
  • Display tweaks
    • separated @author tag display from @license tag display in template
    • types now display in monospace
    • class displays as title "Class: " to differentiate from module

Example output

@psq
Copy link
Contributor

psq commented Aug 22, 2014

thanks for the PR, @boneskull. Looks good to me at first read. Since there's quite a bit to chew on, I'll leave a few days for other people to comment. Then I'll give it a try and merge it in.

@@ -65,6 +65,7 @@ function printHelp(){
console.log(' -v, --version\t\t Prints the current version and quits.');
console.log(' -o, --output\t\t Output directory.');
console.log(' -t, --templateDir\t Template directory to use instead of built-in ones.');
console.log(' -p, --private\t Ignore private members');
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesn't seem to be implemented. Please remove.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oops thought I zapped that. can fix.

@mrjoelkemp
Copy link
Contributor

Great work @boneskull! Thanks for this valuable contribution. @psq Looks good to me; tested locally and all is well.

Ideally, we'd have tests in analyze's suite for these changes, but we don't have example tests for contributors to go off of just yet. That'll get taken care of in #51.

I created a few issues of post-merge cleanup items, but those shouldn't stop this PR from being accepted.

@psq Feel free to merge when you're ready.

@boneskull
Copy link
Contributor Author

updated PR w/ fixes

@psq
Copy link
Contributor

psq commented Aug 25, 2014

regarding the last commit (boneskull@dfa50f6) we should really have the styling changes in separate PR so they can be discussed on their own (see the newly added https://github.com/sutoiku/jsdox/blob/master/Contributing.md)

@mrjoelkemp ok with it?

@mrjoelkemp
Copy link
Contributor

@psq Agreed.

@boneskull Please extract the template changes from your last commit into a separate PR. I'd like to have this merged in, but cosmetic changes of the templates should be done via using the templateDir option in the CLI.

- fixes:
  - `-A` option was ignored and became the default; fixed so it is no longer the default
  - fixed issue wherein description of `@return` would become `@description` of function (duplicated) if not set for `@return`
  - removed redundant `jshint-config.json`
  - fixed `.jshintrc`
  - fixed inability to find configuration file
- enhancements
  - added `.editorconfig` so my editor doesn't blast trailing spaces in `.mustache` files
  - `@example` tag support
  - `@property` tag support
  - `@private` tag support
  - added types for class members
  -
@boneskull
Copy link
Contributor Author

@mrjoelkemp done

@mrjoelkemp
Copy link
Contributor

👍

psq added a commit that referenced this pull request Aug 26, 2014
fixes, tweaks, functionality

merging, even though we could have included the template changes to benefit from `@example` and `@property`, and a new fixture to show an example of these 2 new tags.  We'll include these with #59.
@psq psq merged commit aa3a263 into sutoiku:master Aug 26, 2014
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants