Skip to content

Commit cb5632f

Browse files
EddieGarmonisaacs
authored andcommitted
Improve BNF grammar
Better names, more intuitive ordering.
1 parent 375b063 commit cb5632f

File tree

1 file changed

+41
-26
lines changed

1 file changed

+41
-26
lines changed

semver.md

Lines changed: 41 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -130,55 +130,70 @@ Example: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta <
130130
Backus–Naur Form Grammar for Valid SemVer Versions
131131
--------------------------------------------------
132132

133-
<version> ::= <major> "." <minor> "." <patch>
134-
| <major> "." <minor> "." <patch> "-" <pre-release>
135-
| <major> "." <minor> "." <patch> "+" <build>
136-
| <major> "." <minor> "." <patch> "-" <pre-release> "+" <build>
133+
<valid semver> ::= <version core>
134+
| <version core> "-" <pre-release>
135+
| <version core> "+" <build>
136+
| <version core> "-" <pre-release> "+" <build>
137137

138-
<major> ::= <non-negative integer>
138+
<version core> ::= <major> "." <minor> "." <patch>
139139

140-
<minor> ::= <non-negative integer>
140+
<major> ::= <numeric identifier>
141141

142-
<patch> ::= <non-negative integer>
142+
<minor> ::= <numeric identifier>
143143

144-
<pre-release> ::= <dot-separated identifiers>
144+
<patch> ::= <numeric identifier>
145145

146-
<build> ::= <dot-separated build identifiers>
146+
<pre-release> ::= <dot-separated pre-release identifiers>
147+
148+
<dot-separated pre-release identifiers> ::= <pre-release identifier>
149+
| <pre-release identifier> "." <dot-separated pre-release identifiers>
147150

148-
<dot-separated identifiers> ::= <identifier>
149-
| <identifier> "." <dot-separated identifiers>
151+
<build> ::= <dot-separated build identifiers>
150152

151153
<dot-separated build identifiers> ::= <build identifier>
152154
| <build identifier> "." <dot-separated build identifiers>
153155

154-
<identifier> ::= <non-negative integer>
155-
| <non-numeric identifier>
156+
<pre-release identifier> ::= <alphanumeric identifier>
157+
| <numeric identifier>
156158

157-
<build identifier> ::= <identifier character>
158-
| <identifier character> <build identifier>
159+
<build identifier> ::= <alphanumeric identifier>
160+
| <digits>
159161

160-
<non-numeric identifier> ::= <non-digit character>
161-
| <non-digit character> <build identifier>
162-
| <build identifier> <non-digit character>
163-
| <build identifier> <non-digit character> <build identifier>
162+
<alphanumeric identifier> ::= <letters>
163+
| <letters> <identifier characters>
164+
| <digits> <non-digits>
165+
| <digits> <non-digits> <identifier characters>
166+
| <digits> <identifier characters> <non-digits>
167+
| <digits> <identifier characters> <non-digits> <identifier characters>
168+
| "-" <identifier characters>
164169

165-
<non-digit character> ::= <letter> | "-"
170+
<numeric identifier> ::= "0"
171+
| <positive digit>
172+
| <positive digit> <digits>
166173

167-
<identifier character> ::= <non-digit character> | <digit>
174+
<identifier characters> ::= <identifier character>
175+
| <identifier character> <identifier characters>
168176

169-
<non-negative integer> ::= "0"
170-
| <positive integer>
177+
<identifier character> ::= <digit>
178+
| <non-digit>
179+
180+
<non-digits> ::= <non-digit>
181+
| <non-digit> <non-digits>
171182

172-
<positive integer> ::= <positive digit>
173-
| <positive digit> <digits>
183+
<non-digit> ::= <letter>
184+
| "-"
174185

175186
<digits> ::= <digit>
176187
| <digit> <digits>
177188

178-
<digit> ::= "0" | <positive digit>
189+
<digit> ::= "0"
190+
| <positive digit>
179191

180192
<positive digit> ::= "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"
181193

194+
<letters> ::= <letter>
195+
| <letter> <letters>
196+
182197
<letter> ::= "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "J"
183198
| "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" | "S" | "T"
184199
| "U" | "V" | "W" | "X" | "Y" | "Z" | "a" | "b" | "c" | "d"

0 commit comments

Comments
 (0)