diff --git a/deps.edn b/deps.edn index 28ca76a2..85c3129e 100644 --- a/deps.edn +++ b/deps.edn @@ -5,7 +5,7 @@ :aliases {;; we use babashka/neil for project attributes ;; publish workflow references these values (and automatically bumps patch component of version) - :neil {:project {:version "1.1.49" ;; describes last release and is template for next release + :neil {:project {:version "1.2.49" ;; describes last release and is template for next release :name rewrite-clj/rewrite-clj ;; not neilisms - could potentially conflict with new neilisms :github-coords clj-commons/rewrite-clj}} diff --git a/doc/01-user-guide.adoc b/doc/01-user-guide.adoc index e4001adf..264385cb 100644 --- a/doc/01-user-guide.adoc +++ b/doc/01-user-guide.adoc @@ -688,7 +688,9 @@ Finally, there are a handful of node whitespace creation convenience functions s === Paredit API Structured editing was introduce by rewrite-cljs and carried over to rewrite-clj v1. -We might expand this section if there is interest, but the docstrings should get you started. +We have plans to expand this section but the docstrings should get you started. + +WARNING: The paredit API is experimental, under development, and subject to change. See link:{cljdoc-api-url}/rewrite-clj.paredit[current paredit API docs]. diff --git a/doc/design/namespaced-elements.adoc b/doc/design/namespaced-elements.adoc index 5931d53c..242a4350 100644 --- a/doc/design/namespaced-elements.adoc +++ b/doc/design/namespaced-elements.adoc @@ -281,7 +281,9 @@ Previously the prefix was stored as a keyword. This should return `true` for any source we throw at rewrite-clj v1: + -// {:test-doc-blocks/reader-cond :clj} +// GitHub has started rate limiting and returning 429s for githubusercontent. +// This code block is covered by unit tests, so will have test-doc-blocks skip it. +// :test-doc-blocks/skip [source,Clojure] ---- (require '[rewrite-clj.zip :as z]) diff --git a/src/rewrite_clj/paredit.cljc b/src/rewrite_clj/paredit.cljc index 543b52a4..f963f94d 100644 --- a/src/rewrite_clj/paredit.cljc +++ b/src/rewrite_clj/paredit.cljc @@ -1,6 +1,9 @@ (ns rewrite-clj.paredit "Paredit zipper operations for Clojure/ClojureScript/EDN. + > [!WARNING] + > This API is experimental, under development, and subject to change. + You might find inspiration from examples here: https://pub.gajendra.net/src/paredit-refcard.pdf" (:require [clojure.string :as str] [rewrite-clj.custom-zipper.core :as zraw] @@ -351,7 +354,7 @@ (z/append-child (z/node slurpee-loc)) ;; slurp in slurpee (nav-via route))))))) -(defn ^{:deprecated "1.1.49"} slurp-forward +(defn ^{:deprecated "1.2.50"} slurp-forward "DEPRECATED: we recommend [[slurp-forward-into]] instead for more control. Return `zloc` with node to the right of nearest eligible sequence slurped into that sequence else `zloc` unchanged. @@ -415,7 +418,7 @@ (take (inc n-slurps)) last)))))) -(defn ^{:deprecated "1.1.49"} slurp-forward-fully +(defn ^{:deprecated "1.2.50"} slurp-forward-fully "DEPRECATED: We recommend [[slurp-forward-fully-into]]] for more control. Return `zloc` with all right sibling nodes of nearest eligible sequence slurped into that sequence else `zloc` unchanged. @@ -478,7 +481,7 @@ (z/insert-child (z/node slurpee-loc)) (nav-via route))))))) -(defn ^{:deprecated "1.1.49"} slurp-backward +(defn ^{:deprecated "1.2.50"} slurp-backward "DEPRECATED: we recommend [[slurp-backward-into]] for more control. Returns `zloc` with node to the left of nearest eligible sequence slurped into that sequence else `zloc` unchanged. @@ -543,7 +546,7 @@ (take (inc n-slurps)) last)))))) -(defn ^{:deprecated "1.1.49"} slurp-backward-fully +(defn ^{:deprecated "1.2.50"} slurp-backward-fully "DEPRECATED: We recommend instead [[slurp-backward-fully-into]] for more control. Returns `zloc` with all left sibling nodes of nearest eligible sequnece slurped into that sequence else `zloc`.