~mdw
/
zone
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (from parent 1:
b23c65e
)
zone.lisp: Minor comment formatting.
author
Mark Wooding
<mdw@distorted.org.uk>
Sun, 29 Dec 2013 20:39:28 +0000
(20:39 +0000)
committer
Mark Wooding
<mdw@distorted.org.uk>
Sun, 29 Dec 2013 20:42:02 +0000
(20:42 +0000)
zone.lisp
patch
|
blob
|
blame
|
history
diff --git
a/zone.lisp
b/zone.lisp
index
eaa0e2d
..
b0e5582
100644
(file)
--- a/
zone.lisp
+++ b/
zone.lisp
@@
-61,9
+61,10
@@
(export 'timespec-seconds)
(defun timespec-seconds (ts)
(export 'timespec-seconds)
(defun timespec-seconds (ts)
- "Convert a timespec TS to seconds. A timespec may be a real count of
- seconds, or a list (COUNT UNIT): UNIT may be any of a number of obvious
- time units."
+ "Convert a timespec TS to seconds.
+
+ A timespec may be a real count of seconds, or a list (COUNT UNIT): UNIT
+ may be any of a number of obvious time units."
(cond ((null ts) 0)
((realp ts) (floor ts))
((atom ts)
(cond ((null ts) 0)
((realp ts) (floor ts))
((atom ts)
@@
-90,10
+91,11
@@
(maphash (lambda (key val) (declare (ignore val)) (collect key)) ht)))
(defun iso-date (&optional time &key datep timep (sep #\ ))
(maphash (lambda (key val) (declare (ignore val)) (collect key)) ht)))
(defun iso-date (&optional time &key datep timep (sep #\ ))
- "Construct a textual date or time in ISO format. The TIME is the universal
- time to convert, which defaults to now; DATEP is whether to emit the date;
- TIMEP is whether to emit the time, and SEP (default is space) is how to
- separate the two."
+ "Construct a textual date or time in ISO format.
+
+ The TIME is the universal time to convert, which defaults to now; DATEP is
+ whether to emit the date; TIMEP is whether to emit the time, and
+ SEP (default is space) is how to separate the two."
(multiple-value-bind
(sec min hr day mon yr dow dstp tz)
(decode-universal-time (if (or (null time) (eq time :now))
(multiple-value-bind
(sec min hr day mon yr dow dstp tz)
(decode-universal-time (if (or (null time) (eq time :now))
@@
-228,10
+230,11
@@
(export 'preferred-subnet-case)
(defmacro preferred-subnet-case (&body clauses)
(export 'preferred-subnet-case)
(defmacro preferred-subnet-case (&body clauses)
- "CLAUSES have the form (SUBNETS . FORMS) -- evaluate the first FORMS whose
- SUBNETS (a list or single symbol, not evaluated) are considered preferred
- by zone-preferred-subnet-p. If SUBNETS is the symbol t then the clause
- always matches."
+ "CLAUSES have the form (SUBNETS . FORMS).
+
+ Evaluate the first FORMS whose SUBNETS (a list or single symbol, not
+ evaluated) are considered preferred by zone-preferred-subnet-p. If
+ SUBNETS is the symbol t then the clause always matches."
`(cond
,@(mapcar (lambda (clause)
(let ((subnets (car clause)))
`(cond
,@(mapcar (lambda (clause)
(let ((subnets (car clause)))
@@
-248,8
+251,9
@@
clauses)))
(defun zone-process-records (rec ttl func)
clauses)))
(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."
+ "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."
(labels ((sift (rec ttl)
(collecting (top sub)
(loop
(labels ((sift (rec ttl)
(collecting (top sub)
(loop
@@
-378,8
+382,10
@@
(export 'make-zone-serial)
(defun make-zone-serial (name)
(export 'make-zone-serial)
(defun make-zone-serial (name)
- "Given a zone NAME, come up with a new serial number. This will (very
- carefully) update a file ZONE.serial in the current directory."
+ "Given a zone NAME, come up with a new serial number.
+
+ This will (very carefully) update a file ZONE.serial in the current
+ directory."
(let* ((file (zone-file-name name :serial))
(last (with-open-file (in file
:direction :input
(let* ((file (zone-file-name name :serial))
(last (with-open-file (in file
:direction :input
@@
-407,7
+413,9
@@
;;; Zone form parsing.
(defun zone-parse-head (head)
;;; Zone form parsing.
(defun zone-parse-head (head)
- "Parse the HEAD of a zone form. This has the form
+ "Parse the HEAD of a zone form.
+
+ This has the form
(NAME &key :source :admin :refresh :retry
:expire :min-ttl :ttl :serial)
(NAME &key :source :admin :refresh :retry
:expire :min-ttl :ttl :serial)
@@
-452,8
+460,9
@@
(zname (gensym "ZNAME"))
(ttl (gensym "TTL")))
&body body)
(zname (gensym "ZNAME"))
(ttl (gensym "TTL")))
&body body)
- "Define a new zone record type (or TYPES -- a list of synonyms is
- permitted). The arguments are as follows:
+ "Define a new zone record type.
+
+ The TYPES may be a list of synonyms. The other arguments are as follows:
NAME The name of the record to be added.
NAME The name of the record to be added.
@@
-526,7
+535,9
@@
(export 'zone-parse)
(defun zone-parse (zf)
(export 'zone-parse)
(defun zone-parse (zf)
- "Parse a ZONE form. The syntax of a zone form is as follows:
+ "Parse a ZONE form.
+
+ The syntax of a zone form is as follows:
ZONE-FORM:
ZONE-HEAD ZONE-RECORD*
ZONE-FORM:
ZONE-HEAD ZONE-RECORD*