User Tools

Site Tools


documentation:tiny

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
documentation:tiny [2023/09/16 14:09] – Put field counter before method one nebelnidasdocumentation:tiny [2024/03/25 18:10] (current) – Remove incorrect standard property nebelnidas
Line 3: Line 3:
 :!: //This write-up isn't finalized yet and may contain errors!// :!: //This write-up isn't finalized yet and may contain errors!//
  
-Tiny v1 consists of a list of flat (non-hierarchical) mapping entries. Every line in the body corresponds to a new entry. Supported elements are classes, fields and methods; for parameters, variables, comments and a generally more space-efficient format, it's recommended to use its successor, [[documentation:tiny2|Tiny v2]].+Tiny v1 consists of a list of flat (non-hierarchical) mapping entries. Every line in the content section corresponds to a new entry. Supported elements are classes, fields and methods; for parameters, variables, comments and a generally more space-efficient format, it's recommended to use its successor, [[documentation:tiny2|Tiny v2]].
  
 **Example:** **Example:**
Line 11: Line 11:
 # INTERMEDIARY-COUNTER field 945 # INTERMEDIARY-COUNTER field 945
 # INTERMEDIARY-COUNTER method 1204 # INTERMEDIARY-COUNTER method 1204
-# SORTED-HIERARCHY 
 CLASS a class_123 pkg/SomeClass CLASS a class_123 pkg/SomeClass
 FIELD a [I a field_789 someField FIELD a [I a field_789 someField
Line 24: Line 23:
 ===== Grammar ===== ===== Grammar =====
 <code> <code>
-<file>                  ::= <header> | <header> <entries>+<file>                  ::= <header> | <header> <content>
  
 <header>                ::= 'v1' <tab> <namespace-a> <tab> <namespace-b> <extra-namespaces> <eol> <properties> <header>                ::= 'v1' <tab> <namespace-a> <tab> <namespace-b> <extra-namespaces> <eol> <properties>
Line 37: Line 36:
 <property-value>        ::= <spaceless-safe-string> <property-value>        ::= <spaceless-safe-string>
  
-<entries>               ::= '' | <mapping-entry> <entries> <properties>+<content>               ::= '' | <mapping-entry> <content> <properties>
 <mapping-entry>         ::= <class-entry> | <field-entry> | <method-entry> <mapping-entry>         ::= <class-entry> | <field-entry> | <method-entry>
  
Line 73: Line 72:
   * ''%%<safe-string>%%'' is a non-empty string that must not contain:   * ''%%<safe-string>%%'' is a non-empty string that must not contain:
     * ''\'',     * ''\'',
-    * ''"\n"'', +    * ''\n'', 
-    * ''"\r"'', +    * ''\r'', 
-    * ''"\t"'' or +    * ''\t'' or 
-    * ''"\0"''.+    * ''\0''.
   * ''%%<spaceless-safe-string>%%'' is the same as ''%%<safe-string>%%'', but in addition mustn't contain ''%%<space>%%'' as well.   * ''%%<spaceless-safe-string>%%'' is the same as ''%%<safe-string>%%'', but in addition mustn't contain ''%%<space>%%'' as well.
   * ''%%<properties>%%'' are either in the ''%%<header>%%'' or at the bottom of the file, //not// scattered across both locations.   * ''%%<properties>%%'' are either in the ''%%<header>%%'' or at the bottom of the file, //not// scattered across both locations.
Line 93: Line 92:
   * Mappings without any (useful) names should be omitted.   * Mappings without any (useful) names should be omitted.
   * Entries without any (useful) mappings should be omitted.   * Entries without any (useful) mappings should be omitted.
- 
- 
-===== Standard Properties ===== 
-These are required to be in the header. 
-  * ''SORTED-HIERARCHY'': all member entries are directly beneath their parent class entries, and fields are before methods 
documentation/tiny.1694873378.txt.gz · Last modified: 2023/09/16 14:09 by nebelnidas