minor improvements in docblocks and comments

Author: HermanPeeren

src/administrator/components/com_ccm/src/Controller/CmsController.php

@@ -14,6 +14,8 @@
 // phpcs:enable PSR1.Files.SideEffects
 
 use Joomla\CMS\MVC\Controller\FormController;
+use Joomla\Component\CCM\Administrator\Model\CmsModel;
+
 class CmsController extends FormController
 {
     protected function getRedirectToListAppend()
@@ -38,6 +40,8 @@ public function migrate()
      * @param   string  $urlVar   The name of the URL variable if different from the primary key.
      *
      * @return  void
+     *
+     * @since 1.0.0
      */
     public function save($key = null, $urlVar = null)
     {

src/administrator/components/com_ccm/src/Controller/CmssController.php

@@ -18,7 +18,7 @@
 /**
  * CmssController class.
  *
- * @since  __DEV__
+ * @since 1.0.0
  */
 class CmssController extends ListController
 {

src/administrator/components/com_ccm/src/Controller/DisplayController.php

@@ -22,7 +22,7 @@ class DisplayController extends BaseController
      * The default view.
      *
      * @var    string
-     * @since  __DEV__
+     * @since 1.0.0
      */
     protected $default_view = 'Cmss';
 
@@ -34,7 +34,7 @@ class DisplayController extends BaseController
      *
      * @return  static  This object to support chaining.
      *
-     * @since   __DEV__
+     * @since 1.0.0
      */
     public function display($cachable = false, $urlparams = [])
     {

src/administrator/components/com_ccm/src/Extension/CCMComponent.php

@@ -29,7 +29,7 @@ public function boot(ContainerInterface $container) {
      *
      * @return  array
      *
-     * @since   __DEV__
+     * @since 1.0.0
      */
     public function getContexts(): array
     {

src/administrator/components/com_ccm/src/Fields/CcmField.php

@@ -20,7 +20,7 @@
 // what if data is null (e.g. image), then I can't get its type 
 
 class CcmField extends ListField {
-    // define a custom form field
+
     // the name of the type for our new field
     protected $type = 'ccm';
 

src/administrator/components/com_ccm/src/Fields/CmsField.php

@@ -16,7 +16,7 @@
 use Joomla\CMS\Form\Field\ListField;
 
 class CmsField extends ListField { // this should be named CmsNameField
-    // define a custom form field
+
     // the name of the type for our new field
     protected $type = 'cms';
 

src/administrator/components/com_ccm/src/Fields/CmsObjTypeField.php

@@ -16,7 +16,7 @@
 use Joomla\CMS\Form\Field\ListField;
 
 class CmsObjTypeField extends ListField {
-    // define a custom form field
+
     // the name of the type for our new field
     protected $type = 'cmsobjtype';
 

src/administrator/components/com_ccm/src/Helper/MigrationHelper.php

@@ -26,7 +26,10 @@ class MigrationHelper
      * Parse credentials for HTTP authentication headers.
      *
      * @param string $credentials Credentials string (token or username:password)
+     *
      * @return array Headers array for HTTP requests
+     *
+     * @since 1.0.0
      */
     public static function parseAuthentication($credentials)
     {