Getting error for `@undefined` tag about dgeni-packages HOT 10 CLOSED

If I'm getting this right, there seems to be a conflict with the defaultFn and the transformFn. Here, we can see, that a @method doc actually requires a @memberof tag. https://github.com/angular/dgeni-packages/blob/master/jsdoc/tag-defs/index.js#L12-L22

from dgeni-packages.

So what this is saying is that @memberOf must and can only appear on docs that have docType of property, method or event. In your example, providing the @method tag does not set the docType.

Arguably this is an ngdoc specific thing. So we should move this check into that package

from dgeni-packages.

So how do one set a doctype?

from dgeni-packages.

With @ngdoc :-(
On 9 Apr 2014 09:36, "Pascal Precht" [email protected] wrote:

So how do one set a doctype?

Reply to this email directly or view it on GitHubhttps://github.com//issues/26#issuecomment-39940380
.

from dgeni-packages.

m( ... okay. So does that also mean that the docType is an ngdoc specific thing in general? I mean the entire mechanism that works with docType.

from dgeni-packages.

Sorry man, I was confused. I think I can close this now.

from dgeni-packages.

Okay, I think I have to get back to this issue. So, setting the docType happens through annotations like:

/**
 * @ngdoc service // or module, class, method etc.
 *
**/

This seems to be possible, because in the ngdoc package, the tag definition for @ngdoc tags looks like this:

{
  name: 'ngdoc',
  required: true,
  docProperty: 'docType'
}

Now, if I wanna have a custom tag that behaves the same, my tag definition has to look like this right? Is there anything else that has to be done, so that the error doesn't occur?

The reason why I'm asking is, that I wanna make our @sofadoc tag behave the same. It should set the docType like @sofadoc method, or @sofadoc class. I don't understand why, but in cases where the docType is class everything works fine. When I say @sofadoc method in combination with @memberof sofa, I still get the error. It turns out that docType is undefined.

Any idea @petebacondarwin ?

from dgeni-packages.

The order of the typedefs is important
On 11 Apr 2014 14:18, "Pascal Precht" [email protected] wrote:

Okay, I think I have to get back to this issue. So, setting the docTypehappens through annotations like:

/** * @ngdoc service // or module, class, method etc. ***/

This seems to be possible, because in the ngdoc package, the tag
definition for @ngdoc tags looks like this:

{
name: 'ngdoc',
required: true,
docProperty: 'docType'}

Now, if I wanna have a custom tag that behaves the same, my tag definition
has to look like this right? Is there anything else that has to be done, so
that the error doesn't occur?

The reason why I'm asking is, that I wanna make our @sofadoc tag behave
the same. It should set the docType like @sofadoc method, or @sofadoc
class. I don't understand why, but in cases where the docType is classeverything works fine. When I say @sofadoc
method in combination with @memberof sofa, I still get the error. It
turns out that docType is undefined.

Any idea @petebacondarwin https://github.com/petebacondarwin ?

Reply to this email directly or view it on GitHubhttps://github.com//issues/26#issuecomment-40202068
.

from dgeni-packages.

Typedefs? Or do you mean tag defs, if so, how does the order have to be? Sorry, I don't wanna annoy you with this topic, but I really try to get my head around it.

from dgeni-packages.

TagDefs!
The tag-extractor processor just runs through each tagDef one at a time and processes them. If you need one tagDef to provide a property that is checked in a later tag def then they need to be in the right order

This is one of the reasons for the separation of tag-parsing from tag-extracting. Tags appear in a doc in an undefined order, when they are parsed, but they need to be extracted in a well defined order.

from dgeni-packages.