Fix docstyle comments

lib/logic/cubit/forms/factories/field_cubit_factory.dart

@@ -7,14 +7,14 @@ import 'package:selfprivacy/logic/cubit/users/users_cubit.dart';
 class FieldCubitFactory {
   FieldCubitFactory(this.context);
 
-  /* A common user login field.
+  /// A common user login field.
-   * - Available characters are lowercase a-z, digits and underscore _
+  ///
-   * - Must start with either a-z or underscore
+  /// - Available characters are lowercase a-z, digits and underscore _
-   * - Must be no longer than 'userMaxLength' characters
+  /// - Must start with either a-z or underscore
-   * - Must not be empty
+  /// - Must be no longer than 'userMaxLength' characters
-   * - Must not be a reserved root login
+  /// - Must not be empty
-   * - Must be unique
+  /// - Must not be a reserved root login
-   */
+  /// - Must be unique
   FieldCubit<String> createUserLoginField() {
     final userAllowedRegExp = RegExp(r"^[a-z_][a-z0-9_]+$");
     const userMaxLength = 31;
@@ -35,10 +35,10 @@ class FieldCubitFactory {
     );
   }
 
-  /* A common user password field.
+  /// A common user password field.
-   * - Must fail on the regural expression of invalid matches: [\n\r\s]+
+  ///
-   * - Must not be empty
+  /// - Must fail on the regural expression of invalid matches: [\n\r\s]+
-   */
+  /// - Must not be empty
   FieldCubit<String> createUserPasswordField() {
     var passwordForbiddenRegExp = RegExp(r"[\n\r\s]+");
     return FieldCubit(

lib/logic/cubit/forms/validations/validations.dart

@@ -13,15 +13,15 @@ abstract class LengthStringValidation extends ValidationModel<String> {
   }
 }
 
-// String must be equal to [length]
 class LengthStringNotEqualValidation extends LengthStringValidation {
+  /// String must be equal to [length]
   LengthStringNotEqualValidation(int length)
       : super((n) => n.length != length,
             'validations.length_not_equal'.tr(args: [length.toString()]));
 }
 
-// String must be shorter than or equal to [length]
 class LengthStringLongerValidation extends LengthStringValidation {
+  /// String must be shorter than or equal to [length]
   LengthStringLongerValidation(int length)
       : super((n) => n.length > length,
             'validations.length_longer'.tr(args: [length.toString()]));

lib/main.dart

@@ -22,8 +22,8 @@ void main() async {
   await SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]);
 
   try {
-    /* Wakelock support for Linux
+    /// Wakelock support for Linux
-     * desktop is not yet implemented */
+    /// desktop is not yet implemented
     await Wakelock.enable();
   } on PlatformException catch (e) {
     print(e);