Design documentation is absent
Bug #580058 reported by
Dino Chiesa
This bug affects 1 person
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
nXhtml |
In Progress
|
Wishlist
|
Unassigned |
Bug Description
I like the idea of mumamo, but the design documentation is completely absent.
how does it work?
how does it determine where a chunk starts and where it ends?
WHEN does it do those checks? with every change? every cursor movement? once?
How is it possible to add a new mode? (for jsp, or ruby, or whatever). Why and When should that be done?
Which are available now?
and so on.
Open source is great idea, but to make it real, the stuff has to be usable.
"Figure it out, read the source code" is a really poor answer.
Changed in nxhtml: | |
importance: | Medium → Wishlist |
To post a comment you must log in.
Also, the comments in mumamo.el say,
;; The dividing into chunk is not that simple as I first thought. I get-chunk- at' and `mumamo- find-possible- chunk'. (Some find-possible- chunk' chunk-attr= ' and `mumamo- quick-static- chunk'. )
;; have not gone through the logic of this very carefully. Perhaps
;; that is needed. The current logic is mainly in
;; `mumamo-
;; other routines tries to behave like `mumamo-
;; too: `mumamo-
;;
Why? Why was there a need to have these four separate defuns? find-possible- chunk, and
Why do the defuns "try to behave like" mumamo-
exactly what does that mean, anyway?
Also, why is mumamo part of nxhtml? Should it be?
Design docs would describe that depencency, as well.