X-Git-Url: https://git.distorted.org.uk/~mdw/zone/blobdiff_plain/f38bc59e4fdc74fc56553b04b0e135f0ee438747..9d1d9739d9562bfdc59661c2256a0246ab113eae:/zone.lisp

diff --git a/zone.lisp b/zone.lisp
index b0e5582..909f755 100644
--- a/zone.lisp
+++ b/zone.lisp
@@ -253,7 +253,25 @@
 (defun zone-process-records (rec ttl func)
   "Sort out the list of records in REC, calling FUNC for each one.
 
-   TTL is the default time-to-live for records which don't specify one."
+   TTL is the default time-to-live for records which don't specify one.
+
+   The syntax is a little fiddly to describe.  It operates relative to a
+   subzone name NAME.
+
+   ZONE-RECORD: RR | TTL | SUBZONE
+	The body of a zone form is a sequence of these.
+
+   TTL: :ttl INTEGER
+	Sets the TTL for subsequent RRs in this zone or subzone.
+
+   RR: SYMBOL DATA
+	Adds a record for the current NAME; the SYMBOL denotes the record
+	type, and the DATA depends on the type.
+
+   SUBZONE: (LABELS ZONE-RECORD*)
+	Defines a subzone.  The LABELS is either a list of labels, or a
+	singleton label.  For each LABEL, evaluate the ZONE-RECORDs relative
+	to LABEL.NAME.  The special LABEL `@' is a no-op."
   (labels ((sift (rec ttl)
 	     (collecting (top sub)
 	       (loop
@@ -515,6 +533,9 @@
 	  ',type)))))
 
 (defun zone-parse-records (zone records)
+  "Parse the body of a zone form.
+
+   ZONE is the zone object; RECORDS is the body of the form."
   (let ((zname (zone-name zone)))
     (with-collection (rec)
 	(flet ((parse-record (zr)
@@ -765,6 +786,7 @@
   "Stream to write zone data on.")
 
 (defmethod zone-write :around (format zone stream)
+  (declare (ignore format))
   (let ((*writing-zone* zone)
 	(*zone-output-stream* stream))
     (call-next-method)))
@@ -873,6 +895,8 @@ $TTL ~2@*~D~2%"
   (:method ((type (eql :srv)) data)
     (destructuring-bind (prio weight port host) data
       (list "~2D ~5D ~5D ~A" prio weight port (bind-hostname host))))
-  (:method ((type (eql :txt)) data) (list "~S" (stringify data))))
+  (:method ((type (eql :txt)) data)
+    (cons "~#[\"\"~;~S~:;(~@{~%~8T~S~} )~]"
+	  (mapcar #'stringify (listify data)))))
 
 ;;;----- That's all, folks --------------------------------------------------