From 8cc10854903eef97a9c82a0e48c3ea791fb787e6 Mon Sep 17 00:00:00 2001
From: Frank Duncan <frank@consxy.com>
Date: Mon, 10 Jan 2022 14:44:15 -0600
Subject: [PATCH] Add documentation, scripts for releasing 0.1

---
 README.md           | 22 ++++++++++++++++++++++
 bin/buildRelease.sh | 13 +++++++++++++
 bin/generatedocs.sh |  8 ++++++++
 docs/Reference.md   | 24 ++++++++++++++++++++++++
 honey.asd           |  2 +-
 5 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 README.md
 create mode 100755 bin/buildRelease.sh
 create mode 100755 bin/generatedocs.sh
 create mode 100644 docs/Reference.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b9116db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# Honey - a simple markdown processor
+
+While it aims to target everything listed in the
+[Github Flavored Markdown Spec](https://github.github.com/gfm/), it currently
+does just a little bit of markdown that is actively used for consxy projects.
+
+It parser markdown into weave-html style objects which can then be turned into
+strings using the weave library.
+
+Right now it supports a basic version of:
+
+* lists of one indentation
+* headings of either ATX or underline style
+* links
+* codefences
+* emphasis and strength
+
+## Usage
+
+See [the reference page](https://consxy.com/honey/reference.html) for more information,
+but in general there is a ```honey:parse``` method that takes a string representing
+the markdown.
diff --git a/bin/buildRelease.sh b/bin/buildRelease.sh
new file mode 100755
index 0000000..897d733
--- /dev/null
+++ b/bin/buildRelease.sh
@@ -0,0 +1,13 @@
+#!/bin/bash
+
+version=$(sbcl --noinform --disable-ldb --lose-on-corruption --end-runtime-options --eval '(format t "~A" (asdf:component-version (asdf:find-system :honey)))' --eval "(quit)")
+
+echo -n "Building version $version, hit enter to continue"
+read
+
+mkdir honey_$version
+cp -ap src/main/* honey_$version/
+tar zcf honey_${version}.tar.gz honey_$version/
+rm -rf honey_$version
+
+echo "All done, it's in honey_${version}.tar.gz, you should tag it, push it up to consxy, and update the consxy releases"
diff --git a/bin/generatedocs.sh b/bin/generatedocs.sh
new file mode 100755
index 0000000..58585a2
--- /dev/null
+++ b/bin/generatedocs.sh
@@ -0,0 +1,8 @@
+#!/bin/bash
+
+sbcl \
+  --eval "(asdf:load-system :sheep)" \
+  --eval "(asdf:load-system :honey)" \
+  --eval "(format t \"----~%\")" \
+  --eval "(format t \"~A\" (sheep:export-package :honey))" \
+  --eval "(quit)" 2> /dev/null | sed -n '/^----$/,$p' | tail -n +2 > docs/Reference.md
diff --git a/docs/Reference.md b/docs/Reference.md
new file mode 100644
index 0000000..9781067
--- /dev/null
+++ b/docs/Reference.md
@@ -0,0 +1,24 @@
+# Package HONEY
+
+Main honey package.
+
+Honey is a simple markdown parse that translates to weave style html, which can then be inserted into pages.
+
+## Contents
+
+* **function [parse](#function-parse)** - Parses the actual markdown, returing the html.  This is the main function for the honey package.
+
+## Function **PARSE**
+
+#### Syntax:
+
+**parse** _str_ => _html_
+
+#### Arguments and Values:
+
+_str_---a string, representing the markdown  
+_html_---a weave style html form  
+
+#### Description:
+
+Parses the actual markdown, returing the html.  This is the main function for the honey package.
diff --git a/honey.asd b/honey.asd
index ec78242..7075c8f 100644
--- a/honey.asd
+++ b/honey.asd
@@ -1,6 +1,6 @@
 (asdf:defsystem honey
  :name "Markdown processor that exports to Weave html forms"
- :version "0.0"
+ :version "0.1"
  :maintainer "Frank Duncan (frank@consxy.com)"
  :author "Frank Duncan (frank@consxy.com)"
  :serial t
-- 
2.25.1