[elpa] externals/m-buffer 1da2438bfb 105/115: Lentic doc update and generation

[ELPA Syncer]

branch: externals/m-buffer
commit 1da2438bfb0ee644cd3fcc5aed7594e71a07fd13
Author: Phillip Lord <phillip.lord@russet.org.uk>
Commit: Phillip Lord <phillip.lord@russet.org.uk>

    Lentic doc update and generation
---
 Cask             |   2 +
 Makefile         |  16 +-
 README.md        |   8 +-
 m-buffer-doc.css | 817 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 m-buffer-doc.org |   9 +-
 m-buffer.el      |   2 +
 6 files changed, 847 insertions(+), 7 deletions(-)

diff --git a/Cask b/Cask
index 45eec3810c..92ab5bc570 100644
--- a/Cask
+++ b/Cask
@@ -5,5 +5,7 @@
 (files "m-buffer*el" "m-buffer*els")
 
 (development
+ (depends-on "htmlize")
+ (depends-on "lentic")
  (depends-on "load-relative")
  (depends-on "assess"))
diff --git a/Makefile b/Makefile
index f915053a4e..2540a7c97e 100644
--- a/Makefile
+++ b/Makefile
@@ -23,7 +23,21 @@ test: install just-test
 
 
 doc-gen:
-       $(EMACS_ENV) $(CASK) exec $(EMACS) --debug --script dev/doc-gen.el -f 
doc-gen
+       $(EMACS_ENV) $(CASK) emacs \
+       --directory=. \
+       --script dev/doc-gen.el -f doc-gen
+
+publish-doc: ../m-buffer-pages/index.html ../m-buffer-pages/m-buffer-doc.css
+
+../m-buffer-pages/m-buffer-doc.css: m-buffer-doc.css
+       cp $< $@
+
+../m-buffer-pages/index.html: m-buffer-doc.html
+       perl -p -e 's#["]http://orgmode.org/org-info.js#"./org-info.js#' \
+       $< > $@
+
+m-buffer-doc.html: m-buffer-doc.org m-buffer.el m-buffer-at.el 
m-buffer-macro.el
+       $(MAKE) doc-gen
 
 clean:
        find . -name "m-buffer*org" -not -name "m-buffer-doc.org" \
diff --git a/README.md b/README.md
index f583ab6c02..368909c2c0 100644
--- a/README.md
+++ b/README.md
@@ -12,8 +12,8 @@ point locations so that it is possible, for example, to 
search for regexp
 matches and then replace them all without the early replacement invalidating
 the location of the later ones.
 
-m-buffer is now documented with
-[Lentic Server](https://github.com/phillord/lentic-server).
+m-buffer is now documented at http://phillord.github.io/m-buffer-el/ or live
+in Emacs with [Lentic Server](https://github.com/phillord/lentic-server).
 
 
 ## Status
@@ -21,6 +21,8 @@ m-buffer is now documented with
 The code is now in active use. APIs are open to change, but I am not intending
 to.
 
+Version 0.14 is the last version to support Emacs-24.
+
 ## Contributions
 
 Contributions are welcome. However, I would like to keep the option of hosting
@@ -31,6 +33,8 @@ with the FSF.
 
 ## Change Log
 
+### NEXT
+
 ### 0.14
 
 New function added `m-buffer-match-multi`
diff --git a/m-buffer-doc.css b/m-buffer-doc.css
new file mode 100644
index 0000000000..90b9ed7c7f
--- /dev/null
+++ b/m-buffer-doc.css
@@ -0,0 +1,817 @@
+body {
+   color: #000000;
+   background-color: #ffffff;
+}
+.org-bold {
+        /* bold */
+   font-weight: bold;
+}
+.org-bold-italic {
+        /* bold-italic */
+   font-weight: bold;
+   font-style: italic;
+}
+.org-border {
+}
+.org-buffer-menu-buffer {
+        /* buffer-menu-buffer */
+   font-weight: bold;
+}
+.org-builtin {
+        /* font-lock-builtin-face */
+   color: #483d8b;
+}
+.org-button {
+        /* button */
+   color: #3a5fcd;
+   text-decoration: underline;
+}
+.org-calendar-month-header {
+        /* calendar-month-header */
+   color: #0000ff;
+}
+.org-calendar-today {
+        /* calendar-today */
+   text-decoration: underline;
+}
+.org-calendar-weekday-header {
+        /* calendar-weekday-header */
+   color: #008b8b;
+}
+.org-calendar-weekend-header {
+        /* calendar-weekend-header */
+   color: #b22222;
+}
+.org-comint-highlight-input {
+        /* comint-highlight-input */
+   font-weight: bold;
+}
+.org-comint-highlight-prompt {
+        /* comint-highlight-prompt */
+   color: #0000cd;
+}
+.org-comment {
+        /* font-lock-comment-face */
+   color: #b22222;
+}
+.org-comment-delimiter {
+        /* font-lock-comment-delimiter-face */
+   color: #b22222;
+}
+.org-compilation-column-number {
+        /* compilation-column-number */
+   color: #8b2252;
+}
+.org-compilation-error {
+        /* compilation-error */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-compilation-info {
+        /* compilation-info */
+   color: #228b22;
+   font-weight: bold;
+}
+.org-compilation-line-number {
+        /* compilation-line-number */
+   color: #a020f0;
+}
+.org-compilation-mode-line-exit {
+        /* compilation-mode-line-exit */
+   color: #228b22;
+   font-weight: bold;
+}
+.org-compilation-mode-line-fail {
+        /* compilation-mode-line-fail */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-compilation-mode-line-run {
+        /* compilation-mode-line-run */
+   color: #ff8c00;
+   font-weight: bold;
+}
+.org-compilation-warning {
+        /* compilation-warning */
+   color: #ff8c00;
+   font-weight: bold;
+}
+.org-completions-annotations {
+        /* completions-annotations */
+   font-style: italic;
+}
+.org-completions-common-part {
+}
+.org-completions-first-difference {
+        /* completions-first-difference */
+   font-weight: bold;
+}
+.org-constant {
+        /* font-lock-constant-face */
+   color: #008b8b;
+}
+.org-cursor {
+        /* cursor */
+   background-color: #000000;
+}
+.org-diary {
+        /* diary */
+   color: #ff0000;
+}
+.org-doc {
+        /* font-lock-doc-face */
+   color: #8b2252;
+}
+.org-error {
+        /* error */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-escape-glyph {
+        /* escape-glyph */
+   color: #a52a2a;
+}
+.org-file-name-shadow {
+        /* file-name-shadow */
+   color: #7f7f7f;
+}
+.org-fixed-pitch {
+}
+.org-fringe {
+        /* fringe */
+   background-color: #f2f2f2;
+}
+.org-function-name {
+        /* font-lock-function-name-face */
+   color: #0000ff;
+}
+.org-glyphless-char {
+        /* glyphless-char */
+   font-size: 60%;
+}
+.org-header-line {
+        /* header-line */
+   color: #333333;
+   background-color: #e5e5e5;
+}
+.org-help-argument-name {
+        /* help-argument-name */
+   font-style: italic;
+}
+.org-highlight {
+        /* highlight */
+   background-color: #b4eeb4;
+}
+.org-holiday {
+        /* holiday */
+   background-color: #ffc0cb;
+}
+.org-info-header-node {
+        /* info-header-node */
+   color: #a52a2a;
+   font-weight: bold;
+   font-style: italic;
+}
+.org-info-header-xref {
+        /* info-header-xref */
+   color: #3a5fcd;
+   text-decoration: underline;
+}
+.org-info-index-match {
+        /* info-index-match */
+   background-color: #ffff00;
+}
+.org-info-menu-header {
+        /* info-menu-header */
+   font-weight: bold;
+}
+.org-info-menu-star {
+        /* info-menu-star */
+   color: #ff0000;
+}
+.org-info-node {
+        /* info-node */
+   color: #a52a2a;
+   font-weight: bold;
+   font-style: italic;
+}
+.org-info-title-1 {
+        /* info-title-1 */
+   font-size: 172%;
+   font-weight: bold;
+}
+.org-info-title-2 {
+        /* info-title-2 */
+   font-size: 144%;
+   font-weight: bold;
+}
+.org-info-title-3 {
+        /* info-title-3 */
+   font-size: 120%;
+   font-weight: bold;
+}
+.org-info-title-4 {
+        /* info-title-4 */
+   font-weight: bold;
+}
+.org-info-xref {
+        /* info-xref */
+   color: #3a5fcd;
+   text-decoration: underline;
+}
+.org-isearch {
+        /* isearch */
+   color: #b0e2ff;
+   background-color: #cd00cd;
+}
+.org-isearch-fail {
+        /* isearch-fail */
+   background-color: #ffc1c1;
+}
+.org-italic {
+        /* italic */
+   font-style: italic;
+}
+.org-keyword {
+        /* font-lock-keyword-face */
+   color: #a020f0;
+}
+.org-lazy-highlight {
+        /* lazy-highlight */
+   background-color: #afeeee;
+}
+.org-link {
+        /* link */
+   color: #3a5fcd;
+   text-decoration: underline;
+}
+.org-link-visited {
+        /* link-visited */
+   color: #8b008b;
+   text-decoration: underline;
+}
+.org-match {
+        /* match */
+   background-color: #ffff00;
+}
+.org-menu {
+}
+.org-message-cited-text {
+        /* message-cited-text */
+   color: #ff0000;
+}
+.org-message-header-cc {
+        /* message-header-cc */
+   color: #191970;
+}
+.org-message-header-name {
+        /* message-header-name */
+   color: #6495ed;
+}
+.org-message-header-newsgroups {
+        /* message-header-newsgroups */
+   color: #00008b;
+   font-weight: bold;
+   font-style: italic;
+}
+.org-message-header-other {
+        /* message-header-other */
+   color: #4682b4;
+}
+.org-message-header-subject {
+        /* message-header-subject */
+   color: #000080;
+   font-weight: bold;
+}
+.org-message-header-to {
+        /* message-header-to */
+   color: #191970;
+   font-weight: bold;
+}
+.org-message-header-xheader {
+        /* message-header-xheader */
+   color: #0000ff;
+}
+.org-message-mml {
+        /* message-mml */
+   color: #228b22;
+}
+.org-message-separator {
+        /* message-separator */
+   color: #a52a2a;
+}
+.org-minibuffer-prompt {
+        /* minibuffer-prompt */
+   color: #0000cd;
+}
+.org-mm-command-output {
+        /* mm-command-output */
+   color: #cd0000;
+}
+.org-mode-line {
+        /* mode-line */
+   color: #000000;
+   background-color: #bfbfbf;
+}
+.org-mode-line-buffer-id {
+        /* mode-line-buffer-id */
+   font-weight: bold;
+}
+.org-mode-line-emphasis {
+        /* mode-line-emphasis */
+   font-weight: bold;
+}
+.org-mode-line-highlight {
+}
+.org-mode-line-inactive {
+        /* mode-line-inactive */
+   color: #333333;
+   background-color: #e5e5e5;
+}
+.org-mouse {
+}
+.org-negation-char {
+}
+.org-next-error {
+        /* next-error */
+   background-color: #f07746;
+}
+.org-nobreak-space {
+        /* nobreak-space */
+   color: #a52a2a;
+   text-decoration: underline;
+}
+.org-org-agenda-calendar-event {
+        /* org-agenda-calendar-event */
+   color: #000000;
+   background-color: #ffffff;
+}
+.org-org-agenda-calendar-sexp {
+        /* org-agenda-calendar-sexp */
+   color: #000000;
+   background-color: #ffffff;
+}
+.org-org-agenda-clocking {
+        /* org-agenda-clocking */
+   background-color: #ffff00;
+}
+.org-org-agenda-column-dateline {
+        /* org-agenda-column-dateline */
+   background-color: #e5e5e5;
+}
+.org-org-agenda-current-time {
+        /* org-agenda-current-time */
+   color: #b8860b;
+}
+.org-org-agenda-date {
+        /* org-agenda-date */
+   color: #0000ff;
+}
+.org-org-agenda-date-today {
+        /* org-agenda-date-today */
+   color: #0000ff;
+   font-weight: bold;
+   font-style: italic;
+}
+.org-org-agenda-date-weekend {
+        /* org-agenda-date-weekend */
+   color: #0000ff;
+   font-weight: bold;
+}
+.org-org-agenda-diary {
+        /* org-agenda-diary */
+   color: #000000;
+   background-color: #ffffff;
+}
+.org-org-agenda-dimmed-todo {
+        /* org-agenda-dimmed-todo-face */
+   color: #7f7f7f;
+}
+.org-org-agenda-done {
+        /* org-agenda-done */
+   color: #228b22;
+}
+.org-org-agenda-filter-category {
+        /* org-agenda-filter-category */
+   color: #000000;
+   background-color: #bfbfbf;
+}
+.org-org-agenda-filter-regexp {
+        /* org-agenda-filter-regexp */
+   color: #000000;
+   background-color: #bfbfbf;
+}
+.org-org-agenda-filter-tags {
+        /* org-agenda-filter-tags */
+   color: #000000;
+   background-color: #bfbfbf;
+}
+.org-org-agenda-restriction-lock {
+        /* org-agenda-restriction-lock */
+   background-color: #eeeeee;
+}
+.org-org-agenda-structure {
+        /* org-agenda-structure */
+   color: #0000ff;
+}
+.org-org-archived {
+        /* org-archived */
+   color: #7f7f7f;
+}
+.org-org-block {
+        /* org-block */
+   color: #7f7f7f;
+}
+.org-org-block-background {
+}
+.org-org-block-begin-line {
+        /* org-block-begin-line */
+   color: #b22222;
+}
+.org-org-block-end-line {
+        /* org-block-end-line */
+   color: #b22222;
+}
+.org-org-checkbox {
+        /* org-checkbox */
+   font-weight: bold;
+}
+.org-org-checkbox-statistics-done {
+        /* org-checkbox-statistics-done */
+   color: #228b22;
+   font-weight: bold;
+}
+.org-org-checkbox-statistics-todo {
+        /* org-checkbox-statistics-todo */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-org-clock-overlay {
+        /* org-clock-overlay */
+   background-color: #ffff00;
+}
+.org-org-code {
+        /* org-code */
+   color: #7f7f7f;
+}
+.org-org-column {
+        /* org-column */
+   background-color: #e5e5e5;
+}
+.org-org-column-title {
+        /* org-column-title */
+   background-color: #e5e5e5;
+   font-weight: bold;
+   text-decoration: underline;
+}
+.org-org-date {
+        /* org-date */
+   color: #a020f0;
+   text-decoration: underline;
+}
+.org-org-date-selected {
+        /* org-date-selected */
+   color: #ff0000;
+}
+.org-org-default {
+        /* org-default */
+   color: #000000;
+   background-color: #ffffff;
+}
+.org-org-document-info {
+        /* org-document-info */
+   color: #191970;
+}
+.org-org-document-info-keyword {
+        /* org-document-info-keyword */
+   color: #7f7f7f;
+}
+.org-org-document-title {
+        /* org-document-title */
+   color: #191970;
+   font-weight: bold;
+}
+.org-org-done {
+        /* org-done */
+   color: #228b22;
+   font-weight: bold;
+}
+.org-org-drawer {
+        /* org-drawer */
+   color: #0000ff;
+}
+.org-org-ellipsis {
+        /* org-ellipsis */
+   color: #b8860b;
+   text-decoration: underline;
+}
+.org-org-footnote {
+        /* org-footnote */
+   color: #a020f0;
+   text-decoration: underline;
+}
+.org-org-formula {
+        /* org-formula */
+   color: #b22222;
+}
+.org-org-headline-done {
+        /* org-headline-done */
+   color: #bc8f8f;
+}
+.org-org-hide {
+        /* org-hide */
+   color: #ffffff;
+}
+.org-org-latex-and-related {
+        /* org-latex-and-related */
+   color: #8b4513;
+}
+.org-org-level-1 {
+        /* org-level-1 */
+   color: #0000ff;
+}
+.org-org-level-2 {
+        /* org-level-2 */
+   color: #a0522d;
+}
+.org-org-level-3 {
+        /* org-level-3 */
+   color: #a020f0;
+}
+.org-org-level-4 {
+        /* org-level-4 */
+   color: #b22222;
+}
+.org-org-level-5 {
+        /* org-level-5 */
+   color: #228b22;
+}
+.org-org-level-6 {
+        /* org-level-6 */
+   color: #008b8b;
+}
+.org-org-level-7 {
+        /* org-level-7 */
+   color: #483d8b;
+}
+.org-org-level-8 {
+        /* org-level-8 */
+   color: #8b2252;
+}
+.org-org-link {
+        /* org-link */
+   color: #3a5fcd;
+   text-decoration: underline;
+}
+.org-org-list-dt {
+        /* org-list-dt */
+   font-weight: bold;
+}
+.org-org-macro {
+        /* org-macro */
+   color: #8b4513;
+}
+.org-org-meta-line {
+        /* org-meta-line */
+   color: #b22222;
+}
+.org-org-mode-line-clock {
+        /* org-mode-line-clock */
+   color: #000000;
+   background-color: #bfbfbf;
+}
+.org-org-mode-line-clock-overrun {
+        /* org-mode-line-clock-overrun */
+   color: #000000;
+   background-color: #ff0000;
+}
+.org-org-priority {
+        /* org-priority */
+   color: #a020f0;
+}
+.org-org-property-value {
+}
+.org-org-quote {
+        /* org-quote */
+   color: #7f7f7f;
+}
+.org-org-scheduled {
+        /* org-scheduled */
+   color: #006400;
+}
+.org-org-scheduled-previously {
+        /* org-scheduled-previously */
+   color: #b22222;
+}
+.org-org-scheduled-today {
+        /* org-scheduled-today */
+   color: #006400;
+}
+.org-org-sexp-date {
+        /* org-sexp-date */
+   color: #a020f0;
+}
+.org-org-special-keyword {
+        /* org-special-keyword */
+   color: #a020f0;
+}
+.org-org-table {
+        /* org-table */
+   color: #0000ff;
+}
+.org-org-tag {
+        /* org-tag */
+   font-weight: bold;
+}
+.org-org-tag-group {
+        /* org-tag-group */
+   font-weight: bold;
+}
+.org-org-target {
+        /* org-target */
+   text-decoration: underline;
+}
+.org-org-time-grid {
+        /* org-time-grid */
+   color: #b8860b;
+}
+.org-org-todo {
+        /* org-todo */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-org-upcoming-deadline {
+        /* org-upcoming-deadline */
+   color: #b22222;
+}
+.org-org-verbatim {
+        /* org-verbatim */
+   color: #7f7f7f;
+}
+.org-org-verse {
+        /* org-verse */
+   color: #7f7f7f;
+}
+.org-org-warning {
+        /* org-warning */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-outline-1 {
+        /* outline-1 */
+   color: #0000ff;
+}
+.org-outline-2 {
+        /* outline-2 */
+   color: #a0522d;
+}
+.org-outline-3 {
+        /* outline-3 */
+   color: #a020f0;
+}
+.org-outline-4 {
+        /* outline-4 */
+   color: #b22222;
+}
+.org-outline-5 {
+        /* outline-5 */
+   color: #228b22;
+}
+.org-outline-6 {
+        /* outline-6 */
+   color: #008b8b;
+}
+.org-outline-7 {
+        /* outline-7 */
+   color: #483d8b;
+}
+.org-outline-8 {
+        /* outline-8 */
+   color: #8b2252;
+}
+.org-preprocessor {
+        /* font-lock-preprocessor-face */
+   color: #483d8b;
+}
+.org-query-replace {
+        /* query-replace */
+   color: #b0e2ff;
+   background-color: #cd00cd;
+}
+.org-regexp-grouping-backslash {
+        /* font-lock-regexp-grouping-backslash */
+   font-weight: bold;
+}
+.org-regexp-grouping-construct {
+        /* font-lock-regexp-grouping-construct */
+   font-weight: bold;
+}
+.org-region {
+        /* region */
+   background-color: #f07746;
+}
+.org-scroll-bar {
+}
+.org-secondary-selection {
+        /* secondary-selection */
+   background-color: #ffff00;
+}
+.org-shadow {
+        /* shadow */
+   color: #7f7f7f;
+}
+.org-show-paren-match {
+        /* show-paren-match */
+   background-color: #40e0d0;
+}
+.org-show-paren-mismatch {
+        /* show-paren-mismatch */
+   color: #ffffff;
+   background-color: #a020f0;
+}
+.org-string {
+        /* font-lock-string-face */
+   color: #8b2252;
+}
+.org-success {
+        /* success */
+   color: #228b22;
+   font-weight: bold;
+}
+.org-tool-bar {
+        /* tool-bar */
+   color: #000000;
+   background-color: #bfbfbf;
+}
+.org-tooltip {
+        /* tooltip */
+   color: #000000;
+   background-color: #ffffe0;
+}
+.org-trailing-whitespace {
+        /* trailing-whitespace */
+   background-color: #ff0000;
+}
+.org-tty-menu-disabled {
+        /* tty-menu-disabled-face */
+   color: #d3d3d3;
+   background-color: #0000ff;
+}
+.org-tty-menu-enabled {
+        /* tty-menu-enabled-face */
+   color: #ffff00;
+   background-color: #0000ff;
+   font-weight: bold;
+}
+.org-tty-menu-selected {
+        /* tty-menu-selected-face */
+   background-color: #ff0000;
+}
+.org-type {
+        /* font-lock-type-face */
+   color: #228b22;
+}
+.org-underline {
+        /* underline */
+   text-decoration: underline;
+}
+.org-variable-name {
+        /* font-lock-variable-name-face */
+   color: #a0522d;
+}
+.org-variable-pitch {
+}
+.org-vertical-border {
+}
+.org-warning {
+        /* warning */
+   color: #ff8c00;
+   font-weight: bold;
+}
+.org-warning-1 {
+        /* font-lock-warning-face */
+   color: #ff0000;
+   font-weight: bold;
+}
+.org-window-divider {
+        /* window-divider */
+   color: #999999;
+}
+.org-window-divider-first-pixel {
+        /* window-divider-first-pixel */
+   color: #cccccc;
+}
+.org-window-divider-last-pixel {
+        /* window-divider-last-pixel */
+   color: #666666;
+}
+
+a {
+   color: inherit;
+   background-color: inherit;
+   font: inherit;
+   text-decoration: inherit;
+}
+a:hover {
+   text-decoration: underline;
+}
diff --git a/m-buffer-doc.org b/m-buffer-doc.org
index d461567669..7365723998 100644
--- a/m-buffer-doc.org
+++ b/m-buffer-doc.org
@@ -1,9 +1,8 @@
-
 #+TITLE: Manipulate the Contents of Emacs Buffers
 #+AUTHOR: Phillip Lord
 
 #+INFOJS_OPT: view:info toc:nil
-
+#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="m-buffer-doc.css" />
 
 * Introduction
 
@@ -25,7 +24,9 @@ The individual files have statements about their stability.
 ** Caveat to Documentation
 
 This is the first version of m-buffer with full 
[[http://github.com/phillord/lentic][lenticular]] documentation. Both
-lentic and this documentation are a work in progress. They will improve.
+lentic and this documentation are a work in progress. In particular, the
+"Header" sections a) look terrible and b) are pointless. I just have not
+worked out how to remove them yet.
 
 
 * m-buffer
@@ -37,7 +38,6 @@ matches.
 
 #+include: "m-buffer.org" :minlevel 2
 
-
 * m-buffer-at
 
 m-buffer-at.el provides a set of stateless functions which for accessing data
@@ -63,6 +63,7 @@ give some idea of how much overhead various m-buffer 
functions entail.
 
 #+include: "m-buffer-benchmark.org" :minlevel 2
 
+
 * Roadmap
 
 ** 0.11
diff --git a/m-buffer.el b/m-buffer.el
index 7eefc1a361..3b01fc7edc 100644
--- a/m-buffer.el
+++ b/m-buffer.el
@@ -65,6 +65,8 @@
 ;; #+begin_src emacs-lisp
 (require 'seq)
 (require 'm-buffer-macro)
+
+(defvar m-buffer-doc-html-files '("m-buffer-doc.css"))
 ;; #+end_src
 
 ;; ** Regexp Matching