Skip to content

Repository files navigation

ArkDoc release

licencecode size

A documentation generator for ArkScript.

Dependencies

  • Python >= 3.9

Usage

git clone https://github.com/ArkScript-lang/ArkDoc.git
python3 -m venv venv
source ./venv/bin/activate
pip3 install -r requirements.txt
# set the log level# if not given, defaults to INFOexport ARKDOC_LOGLEVEL=DEBUG
python3 -m arkdoc --help

Syntax

  • @brief <description>: a single brief declaration is expected
  • @param <name> <description>: multiple @param declarations can be written
  • @details <description>: a single detailed declaration is expected
  • @require <version> <description>: ArkScript version required to use a function
  • @deprecated <description>: an optional deprecation notice
  • @changed <version> <description>: multiple @changed declarations can be written. Creates an optional change list to document when and how a function changed
  • =begin / code block / =end: a single code block (it can contain multiple lines) is expected
  • @author <url>,<url>,...: the url to the profiles of the authors must be separated by commas, spaces can be added
  • any line not starting with a @<keyword> will be ignored, unless it is enclosed in a =begin/=end block

Example

# @brief Iterate over a given listand run a given function on every element.
# @param _L the list to iterate over
# @param _func the function to call on each element
# @details The original list is left unmodified.
# =begin
# (import"List.ark")
# (let collection [1 25 12])
# (list:forEach collection (fun (element) {
# (print element) }))
# =end
# @author https://github.com/SuperFola
(letlist:forEach (fun (_L _func) {
(mut _index 0)
(while (< _index (len _L)) {
(mut _element (@ _L _index))
(_func _element)
(set _index (+1 _index)) })}))

About

Doxygen like generator for ArkScript and its modules

Topics

Resources

Stars

2 stars

Watchers

3 watching

Forks

Releases

Used by

Contributors

Languages