Menu
▾
▴
[Sbcl-commits] CVS: sbcl/contrib/sb-bsd-sockets api-reference.html,1.2,1.3 doc.lisp,1.2,1.3
|
From: William H. N. <wn...@us...> - 2003-06-02 22:12:25
|
Update of /cvsroot/sbcl/sbcl/contrib/sb-bsd-sockets
In directory sc8-pr-cvs1:/tmp/cvs-serv18079
Modified Files:
api-reference.html doc.lisp
Log Message:
0.8.0.27:
redid DESCRIBE and DESCRIBE-OBJECT newlining/freshlining to
be consistent with each other (so e.g. we don't get
multiple leading newlines when DESCRIBEing an instance
of STRUCTURE-OBJECT) and to conform to ANSI spec with
minimal surprise:
...DEFUN DESCRIBE now longer FRESH-LINEs.
...DEFUN DESCRIBE no longer does PPRINT-LOGICAL-BLOCK, either,
since FRESH-LINE inside PP-L-B can make a mess.
...DESCRIBE-OBJECT methods consistently do FRESH-LINEs, as in
the spec example, and if they use the prettyprinter,
they create their own PPRINT-LOGICAL-BLOCKs.
(No, this style -- coders paid by the line, mixing high level
CLOS dispatch with low-level physical output bypassing
the pretty-printer -- is not the way that I would have
specified the behavior, but I was still programming in C
and C++ when the spec was written, and no one asked me.)
deleted *DESCRIBE-METAOBJECTS-AS-OBJECTS-P*, since its output
is so messy I doubt people want to use it (and if I'm
wrong the implementation is trivial to restore, with
the only trickiness being figuring out a decent
interface to support)
added warning for the unwary/unwise in SB-BSD-SOCKETS docs
Index: api-reference.html
===================================================================
RCS file: /cvsroot/sbcl/sbcl/contrib/sb-bsd-sockets/api-reference.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- api-reference.html 28 May 2003 14:27:18 -0000 1.2
+++ api-reference.html 2 Jun 2003 22:12:20 -0000 1.3
@@ -1,4 +1,15 @@
<html><head><title>db-sockets API Reference</title></head><body>
+
+<!--
+ This is intended to be[**] a machine-generated file (from SB-BSD-SOCKETS
+ source code, massaged by doc.lisp), so do not edit it directly.
+
+ [**] As of sbcl-0.8.0.12, there's clearly been some divergence between
+ the text here and the original doc.lisp output, e.g. the way doc.lisp
+ says "<title>SBCL BSD-Sockets API Reference</title>" where this file
+ says "<title>db-sockets API Reference</title>". FIXME?
+ -->
+
<h1>Package SOCKETS</h1>
<P>
Index: doc.lisp
===================================================================
RCS file: /cvsroot/sbcl/sbcl/contrib/sb-bsd-sockets/doc.lisp,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- doc.lisp 9 Feb 2003 20:49:49 -0000 1.2
+++ doc.lisp 2 Jun 2003 22:12:21 -0000 1.3
@@ -219,7 +219,13 @@
(defun start ()
(with-open-file (*standard-output* "index.html" :direction :output)
(format t "<html><head><title>SBCL BSD-Sockets API Reference</title></head><body>~%")
- (asdf:operate 'asdf:load-op 'sb-bsd-sockets)
- (document-system 'sb-bsd-sockets :package :sb-bsd-sockets)))
+ (format t
+"<!--
+ This is a machine-generated file (from SB-BSD-SOCKETS source code, massaged
+ by doc.lisp), so do not edit it directly.
+ -->
+")
+ (asdf:operate 'asdf:load-op 'sb-bsd-sockets)
+ (document-system 'sb-bsd-sockets :package :sb-bsd-sockets)))
(start)
|