SBDoc Comment - nonkit/ProgramDB GitHub Wiki

SBDoc Comment Specification

Version 0.4b

SBDoc is a project for a tool to generate document from Small Basic source code, like JSDoc or CppDoc. SBDoc will parse keywords in comments in Small Basic source. Some of keywords are used in Program Database (this project).

Keywords

These keywords are case insensitive.

Version
Copyright
Repository
Challenge
Program ID
Last update
param
return

Document Comment

Document comments start with three single quotes.

Sample Comments

''' Program Database
''' Version 0.5b
''' Copyright © 2014-2015 Nonki Takahashi.  The MIT License.
''' Repository https://programdbsb.codeplex.com
''' Program ID HMK932
''' Last update 2015-12-14
Sub Compare
  ''' param text1, text2
  ''' return eq = "True" if text1 = text2
EndSub
Sub UnselectLine
  ''' param lOp - left operation "", "AND" or "OR"
  ''' param i - index of line array
  ''' return line[i](i) - "" if unselected
EndSub

Sample Output


.\ProgramDB.sb

Version 0.5b
Copyright © 2014-2015 Nonki Takahashi. The MIT License.
Repository https://programdbsb.codeplex.com
Program ID HMK932-1
Last update 2015-12-14

Main

Calls

  • Compare()
  • UnselectLine()

Subroutines Summary

subroutine description
Compare()
UnselectLine()

Subroutines Detail

Compare()

(description for Compare)

Parameters
text1
(description)
text2
(description)
Returns
eq
"True" if text1 = text2

UnselectLine()

(description for UnselectLine)

Parameters
lOp
left operation "", "AND" or "OR"
i
index of line array
Returns
line[i]
"" if unselected

⚠️ **GitHub.com Fallback** ⚠️