Document default values in annotations

[apfelbox]

Hi,

I have found nothing in the documentation (and no test, but didn't search for too long).

Are there some docs about annotations that I can use without explicitly naming the parameters?
I guess it just injects an array with the key "value" but I am not to sure.

For reference, I mean code like this:

/**
 * @SomeAnnot("ohai")
 */

How is this unnamed parameter injected? It would be great if we could add a note about that on https://www.doctrine-project.org/projects/doctrine-annotations/en/latest/custom.html

[Ocramius]

I think it is called value and passed to the constructor of your annotation as such, but not sure about it either: would indeed need test and documentation additions.

[Majkl578]

There is a test here:

annotations/tests/Doctrine/Tests/Annotations/DocParserTest.php

Lines 103 to 123 in f173cdc

	public function testDefaultValueAnnotations()
	{
	$parser = $this->createTestParser();
	// Array as first value
	$result = $parser->parse('@Name({"key1"="value1"})');
	$annot = $result[0];
	self::assertInstanceOf(Name::class, $annot);
	self::assertInternalType('array', $annot->value);
	self::assertEquals('value1', $annot->value['key1']);
	// Array as first value and additional values
	$result = $parser->parse('@Name({"key1"="value1"}, foo="bar")');
	$annot = $result[0];
	self::assertInstanceOf(Name::class, $annot);
	self::assertInternalType('array', $annot->value);
	self::assertEquals('value1', $annot->value['key1']);
	self::assertEquals('bar', $annot->foo);
	}

But I agree it's a bit magic, maybe something to re-think in 2.0 (i.e. explciitly marking specific property as @Default).