From 15a340317fee4dacbaf474e4ca9ece347cd955d8 Mon Sep 17 00:00:00 2001 From: "5684185+vsariola@users.noreply.github.com" <5684185+vsariola@users.noreply.github.com> Date: Thu, 19 Oct 2023 10:52:52 +0300 Subject: [PATCH] docs: add go doc comments to 4klang conversion functions --- 4klang.go | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/4klang.go b/4klang.go index e298d3d..8754108 100644 --- a/4klang.go +++ b/4klang.go @@ -7,6 +7,10 @@ import ( "io" ) +// Read4klangPatch reads a 4klang patch (a file usually with .4kp extension) +// from r and returns a Patch, making best attempt to convert 4klang file to a +// sointu Patch. It returns an error if the file is malformed or if the 4kp file +// version is not supported. func Read4klangPatch(r io.Reader) (patch Patch, err error) { var versionTag uint32 var version int @@ -53,6 +57,10 @@ func Read4klangPatch(r io.Reader) (patch Patch, err error) { return } +// Read4klangInstrument reads a 4klang instrument (a file usually with .4ki +// extension) from r and returns an Instrument, making best attempt to convert +// 4ki file to a sointu Instrument. It returns an error if the file is malformed +// or if the 4ki file version is not supported. func Read4klangInstrument(r io.Reader) (instr Instrument, err error) { var versionTag uint32 var version int