hoon: ~master-morzod comments on doccords
TODO items from a pairing session
+$ foot $% [%dry p=hoon] :: dry arm, geometric
[%wet p=hoon] :: wet arm, generic
== ::
+::TODO: only add %plan since otherwise we might need a migration
+::in the future. leave the others in another branch for future
+::recollection
+$ link :: lexical segment
$% [%chat p=term] :: |chapter
[%cone p=aura q=atom] :: %constant
$~ [%base %null] ::
$% [%base p=base] :: base type
[%dbug p=spot q=spec] :: set debug
+ ::TODO consider [%gist p=[%help p=help] q=spec]
[%gist p=help q=spec] :: formal comment
[%leaf p=term q=@] :: constant atom
[%like p=wing q=(list wing)] :: reference
+$ vair ?(%gold %iron %lead %zinc) :: in/contra/bi/co
+$ vein (list (unit axis)) :: search trace
+$ sect (list pica) :: paragraph
+::TODO cuff may be premature, maybe make it a term for now since its
+::easy to change
+$ whit :: doccords parse
$: bat=(map cuff (pair cord (list sect))) :: batch comments
use=(set cuff) :: defs used
^- hoon
:: process annotations outside construct, to catch default
::
+ ::TODO: try seeing if putting %gist in here fixes %brbc
?: ?=(%dbug -.mod) factory(mod q.mod, bug [p.mod bug])
?: ?=(%bcsg -.mod) factory(mod q.mod, def `[%kthp q.mod p.mod])
^- hoon
[%yell *] [%cncl [%limb %cain] [%zpgr [%cltr p.gen]] ~]
[%note *] q.gen
::
+ ::TODO: does %gist need to be special cased here?
[%brbc *] =- ?~ - !!
:+ %brtr
[%bccl -]
::
:: +apse: postfix comment.
++ apse
+ ::TODO consider an intermediate struture instead of $note
%+ knee *note |. ~+
;~ pose
%+ cook |=(a=cord `note`help+`[a]~)
::TODO: if there is a $link then interpret it as the start
::of a prefix comment instead of postfix
+ ::TODO consider special casing $%
::;~(less (exit ;~(plug (plus en-link) col ace)) (exit line))
(exit line)
::
%+ cook
|= [a=whit b=spec c=note]
=? b !=(c *note)
+ ::TODO: consider commenting see apse:docs
?> ?=([%help *] c)
[%gist p.c b]
=+ docs=~(tap by bat.a)
==
==
::
+ ::TODO: check parser performance
++ toad :: untrap parser expr
|* har=_expa
=+ dur=(ifix [pal par] $:har(tol |))
