rfc:docblockparser

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
Next revisionBoth sides next revision
rfc:docblockparser [2010/09/16 20:56] – Fixed example 1 (again) cfultonrfc:docblockparser [2010/09/17 16:01] – Formatted EBNF cfulton
Line 57: Line 57:
  
 <code> <code>
-docblock := "\/**" , [whitespace] , [short_description] , [long_description] , [tag , { tag | ignored }*] , { emptyline }* , linebreak , "*/" ;+docblock          := "/**" , [whitespace] , [short_description] , [long_description] , [tag , { tag | ignored }*] , { emptyline }* , linebreak , "*/" ;
 short_description := line , { emptyline }+ ; short_description := line , { emptyline }+ ;
-long_description := line , { line | emptyline }* ; +long_description  := line , { line | emptyline }* ; 
-line := [space] , "* " , [space] , character-"@" , string , [space] , linebreak ; +line              := [space] , "* " , [space] , character-"@" , string , [space] , linebreak ; 
-emptyline := [space] , "*" , [space] , linebreak ; +emptyline         := [space] , "*" , [space] , linebreak ; 
-tag := [space] , "* " , "@" , tagname , space , { string | string , linebreak }* , linebreak ; +tag               := [space] , "* " , "@" , tagname , space , { string | string , linebreak }* , linebreak ; 
-ignored := emptyline , { line | emptyline }+ ; +ignored           := emptyline , { line | emptyline }+ ; 
-string := { character } ; +string            := { character } ; 
-tagname := { character - " " } ; +tagname           := { character - " " } ; 
-space := " " | "\t"+space             := " " | "\t"
-linebreak := "\n" | "\r" | "\r\n"+linebreak         := "\n" | "\r" | "\r\n"
-character := ? any ASCII character with code >= 32 and <= 126 ? ;+character         := ? any ASCII character with code >= 32 and <= 126 ? ;
 </code> </code>
  
Line 174: Line 174:
      */      */
 } }
 +</code>
  
  
Line 191: Line 192:
  
 None. None.
- 
 ===== Changelog ===== ===== Changelog =====
  
 +2010-09-16 cfulton Initial RFC creation.
rfc/docblockparser.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1