docs(eventbuilder): Mention how to get the EventBuilder from DI

nickvergessen · nickvergessen · commit 42fa3abc3ef3 · 2025-01-08T11:14:30.000+01:00
Signed-off-by: Joas Schilling &lt;coding@schilljs.com&gt;
diff --git a/lib/public/Calendar/ICalendarEventBuilder.php b/lib/public/Calendar/ICalendarEventBuilder.php
@@ -16,7 +16,11 @@
 /**
  * The calendar event builder can be used to conveniently build a calendar event and then serialize
  * it to a ICS string. The ICS string can be submitted to calendar instances implementing the
- * \OCP\Calendar\ICreateFromString interface.
+ * {@see \OCP\Calendar\ICreateFromString} interface.
+ *
+ * Also note this class can not be injected directly with dependency injection.
+ * Instead, inject {@see \OCP\Calendar\IManager} and use
+ * {@see \OCP\Calendar\IManager::createEventBuilder()} afterwards.
  *
  * All setters return self to allow chaining method calls.
  *

Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,11 @@`
`16`	`16`	`/**`
`17`	`17`	`* The calendar event builder can be used to conveniently build a calendar event and then serialize`
`18`	`18`	`* it to a ICS string. The ICS string can be submitted to calendar instances implementing the`
`19`		`- * \OCP\Calendar\ICreateFromString interface.`
	`19`	`+ * {@see \OCP\Calendar\ICreateFromString} interface.`
	`20`	`+ *`
	`21`	`+ * Also note this class can not be injected directly with dependency injection.`
	`22`	`+ * Instead, inject {@see \OCP\Calendar\IManager} and use`
	`23`	`+ * {@see \OCP\Calendar\IManager::createEventBuilder()} afterwards.`
`20`	`24`	`*`
`21`	`25`	`* All setters return self to allow chaining method calls.`
`22`	`26`	`*`