docsonnet/doc-util/docs/d.md

package d

local d = import "github.com/sh0rez/docsonnet/doc-util"

doc-util provides a Jsonnet interface for docsonnet, a Jsonnet API doc generator that uses structured data instead of comments.

Index

• fn arg(name, type, default)
• fn fn(help, args)
• fn obj(help, fields)
• fn pkg(name, url, help)
• obj argument
  • fn new(name, type, default)
• obj func
  • fn new(help, args)
  • fn withHelp(help)
• obj object
  • fn new(help, fields)
  • fn withFields(fields)
• obj package
  • fn new(name, url, help)

Fields

fn arg

arg(name, type, default)

arg is a shorthand for argument.new

fn fn

fn(help, args)

fn is a shorthand for func.new

fn obj

obj(help, fields)

obj is a shorthand for object.new

fn pkg

pkg(name, url, help)

new is a shorthand for package.new

obj argument

Utilities for creating function arguments

fn argument.new

new(name, type, default)

new creates a new function argument, taking the name, the type and optionally a default value

obj func

Utilities for documenting Jsonnet methods (functions of objects)

fn func.new

new(help, args)

new creates a new function, optionally with description and arguments

fn func.withHelp

withHelp(help)

The withHelp modifier overrides the help text of that function

obj object

Utilities for documenting Jsonnet objects ({ }).

fn object.new

new(help, fields)

new creates a new object, optionally with description and fields

fn object.withFields

withFields(fields)

The withFields modifier overrides the fields property of an already created object

obj package

fn package.new

new(name, url, help)

new creates a new package with given name, import URL and help text