fix "No page-level DocBlock"

lib/public/api.php

@@ -20,6 +20,14 @@
 *
 */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * API Class
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/app.php

@@ -22,7 +22,7 @@
 
 /**
  * Public interface of ownCloud for apps to use.
- * App Class.
+ * App Class
  *
  */
 

lib/public/defaults.php

@@ -20,12 +20,19 @@
 *
 */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Defaults Class
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /*
  * public api to access default strings and urls for your templates
  */
-
 class Defaults {
 
 	private $defaults;

lib/public/groupinterface.php

@@ -26,6 +26,8 @@
  *
  */
 
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 interface GroupInterface extends \OC_Group_Interface {}

lib/public/icache.php

@@ -5,6 +5,15 @@
  * later.
  * See the COPYING-README file.
  */
+
+/**
+ * Public interface of ownCloud for apps to use.
+ * Cache interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/iconfig.php

@@ -4,9 +4,17 @@
  * This file is licensed under the Affero General Public License version 3 or
  * later.
  * See the COPYING-README file.
- * 
+ *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Config interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/icontainer.php

@@ -20,6 +20,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Container interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/idbconnection.php

@@ -7,6 +7,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * DBConnection interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/ihelper.php

@@ -7,6 +7,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Helper interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/il10n.php

@@ -7,6 +7,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * L10n interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/image.php

@@ -20,6 +20,14 @@
 *
 */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Image class
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/inavigationmanager.php

@@ -4,9 +4,17 @@
  * This file is licensed under the Affero General Public License version 3 or
  * later.
  * See the COPYING-README file.
- * 
+ *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Navigation manager interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/ipreview.php

@@ -6,6 +6,15 @@
  * later.
  * See the COPYING-README file.
  */
+
+/**
+ * Public interface of ownCloud for apps to use.
+ * Preview interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/irequest.php

@@ -20,6 +20,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Request interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/iservercontainer.php

@@ -20,6 +20,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Server container interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 

lib/public/isession.php

@@ -8,6 +8,14 @@
  * See the COPYING-README file.
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Session interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/itagmanager.php

@@ -20,6 +20,16 @@
 *
 */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Tag manager interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
+namespace OCP;
+
 /**
  * Factory class creating instances of \OCP\ITags
  *
@@ -30,9 +40,6 @@
  * are entered in. If a user already has a tag 'family' for a type, and
  * tries to add a tag named 'Family' it will be silently ignored.
  */
-
-namespace OCP;
-
 interface ITagManager {
 
 	/**

lib/public/itags.php

@@ -20,6 +20,14 @@
 *
 */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * Tags interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 // FIXME: Where should I put this? Or should it be implemented as a Listener?

lib/public/iurlgenerator.php

@@ -7,6 +7,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * URL generator interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**

lib/public/iusersession.php

@@ -7,6 +7,14 @@
  *
  */
 
+/**
+ * Public interface of ownCloud for apps to use.
+ * User session interface
+ *
+ */
+
+// use OCP namespace for all classes that are considered public.
+// This means that they should be used by apps instead of the internal ownCloud classes
 namespace OCP;
 
 /**