150 lines
6.8 KiB
HTML
150 lines
6.8 KiB
HTML
<!-- Common Lisp HyperSpec (TM), version 7.0 generated by Kent M. Pitman on Mon, 11-Apr-2005 2:31am EDT -->
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>CLHS: Issue PRINT-READABLY-BEHAVIOR Writeup</TITLE>
|
|
<LINK HREF="../Data/clhs.css" REL="stylesheet" TYPE="text/css" />
|
|
<META HTTP-EQUIV="Author" CONTENT="Kent M. Pitman">
|
|
<META HTTP-EQUIV="Organization" CONTENT="LispWorks Ltd.">
|
|
<LINK REL=TOP HREF="../Front/index.htm">
|
|
<LINK REL=COPYRIGHT HREF="../Front/Help.htm#Legal">
|
|
<LINK REL=DISCLAIMER HREF="../Front/Help.htm#Disclaimer">
|
|
<LINK REL=PREV HREF="../Issues/iss275_w.htm">
|
|
<LINK REL=UP HREF="../Issues/iss276.htm">
|
|
<LINK REL=NEXT HREF="../Issues/iss277_w.htm">
|
|
</HEAD>
|
|
<BODY>
|
|
<H1><A REV=MADE HREF="http://www.lispworks.com/"><IMG WIDTH=80 HEIGHT=65 ALT="[LISPWORKS]" SRC="../Graphics/LWSmall.gif" ALIGN=Bottom></A><A REL=TOP HREF="../Front/index.htm"><IMG WIDTH=237 HEIGHT=65 ALT="[Common Lisp HyperSpec (TM)]" SRC="../Graphics/CLHS_Sm.gif" ALIGN=Bottom></A> <A REL=PREV HREF="../Issues/iss275_w.htm"><IMG WIDTH=40 HEIGHT=40 ALT="[Previous]" SRC="../Graphics/Prev.gif" ALIGN=Bottom></A><A REL=UP HREF="../Issues/iss276.htm"><IMG WIDTH=40 HEIGHT=40 ALT="[Up]" SRC="../Graphics/Up.gif" ALIGN=Bottom></A><A REL=NEXT HREF="../Issues/iss277_w.htm"><IMG WIDTH=40 HEIGHT=40 ALT="[Next]" SRC="../Graphics/Next.gif" ALIGN=Bottom></A></H1>
|
|
|
|
<HR>
|
|
|
|
|
|
|
|
<H2>Issue PRINT-READABLY-BEHAVIOR Writeup</H2>
|
|
|
|
<PRE><B>Issue:</B> <A HREF="iss276.htm">PRINT-READABLY-BEHAVIOR</A><P>
|
|
<B>Forum:</B> X3J13 Letter Ballot<P>
|
|
<B>References:</B> <A REL=DEFINITION HREF="../Body/v_pr_rda.htm#STprint-readablyST"><B>*PRINT-READABLY*</B></A> (X3J13/92-102, p22-74)<P>
|
|
Public review comment Loosemore-24<P>
|
|
<B>Category:</B> CLARIFICATION<P>
|
|
<B>Edit history:</B> 21-Jun-93, Version 1 by Steele (based on text by Loosemore)<P>
|
|
<B>Status:</B> Proposal CLARIFY passed (9+2)-0 on letter ballot 93-304.<P>
|
|
<P>
|
|
<B>Problem Description:<P>
|
|
</B><P>
|
|
In E-mail amongst the public review committee, we had agreed that this<P>
|
|
was another case of a previous cleanup vote that had not been adequately<P>
|
|
integrated with the rest of the document. Supposedly, there are no<P>
|
|
technical changes being recommended here.<P>
|
|
<P>
|
|
The proposal <A HREF="iss089.htm">DATA-IO:ADD-SUPPORT</A> that was the basis for adding<P>
|
|
<A REL=DEFINITION HREF="../Body/v_pr_rda.htm#STprint-readablyST"><B>*PRINT-READABLY*</B></A> to the language is clear on this issue. However,<P>
|
|
the document as it now stands does not accurately reflect<P>
|
|
the proposal, or contain adequate cross-references.<P>
|
|
<P>
|
|
<B>Proposal (PRINT-READABLY-BEHAVIOR:CLARIFY):<P>
|
|
</B><P>
|
|
Make the following changes to the dpANS:<P>
|
|
<P>
|
|
(1) Remove this inaccurate statement from the "Notes" section for<P>
|
|
*PRINT-READABLY*:<P>
|
|
<P>
|
|
The printing of interned \term{symbols}, of \term{strings}, <P>
|
|
and of \term{bit vectors} is not affected by \varref{*print-readably*}.<P>
|
|
<P>
|
|
(2) In the "Description" section for <A REL=DEFINITION HREF="../Body/v_pr_rda.htm#STprint-readablyST"><B>*PRINT-READABLY*</B></A>, add after the<P>
|
|
first paragraph:<P>
|
|
<P>
|
|
Specifically, if \varref{*print-readably*} is \term{true}, printing<P>
|
|
proceeds as if \varref{*print-escape*}, \varref{*print-array*}, and<P>
|
|
\varref{*print-gensym*} were also \term{true}, and as if <P>
|
|
\varref{*print-length*}, \varref{*print-level*}, and <P>
|
|
\varref{*print-lines*} were \term{false}.<P>
|
|
<P>
|
|
(3) In section 22.1.3, change numerous references to <A REL=DEFINITION HREF="../Body/v_pr_esc.htm#STprint-escapeST"><B>*PRINT-ESCAPE*</B></A><P>
|
|
to include both <A REL=DEFINITION HREF="../Body/v_pr_esc.htm#STprint-escapeST"><B>*PRINT-ESCAPE*</B></A> and <A REL=DEFINITION HREF="../Body/v_pr_rda.htm#STprint-readablyST"><B>*PRINT-READABLY*</B></A>.<P>
|
|
<P>
|
|
(4) Rewrite section 22.1.3.10 as follows. Prefix the first paragraph<P>
|
|
with:<P>
|
|
<P>
|
|
If \varref{*print-array*} is \term{true} and \varref{*print-readably*}<P>
|
|
is \term{false}, any \term{vector} ....<P>
|
|
<P>
|
|
Change the beginning of the next-to-last paragraph to:<P>
|
|
<P>
|
|
If both \varref{*print-array*} and \varref{*print-readably*} are <P>
|
|
\term{false}, the \term{vector} is not printed ...<P>
|
|
<P>
|
|
Add a new paragraph before the last paragraph:<P>
|
|
<P>
|
|
If \varref{*print-readably*} is true, the \term{vector} prints in an<P>
|
|
\term{implementation-defined} manner. See \varref{*print-readably*}.<P>
|
|
<P>
|
|
<P>
|
|
(5) Rewrite section 22.1.3.11 as follows. Prefix the first paragraph<P>
|
|
with:<P>
|
|
<P>
|
|
If \varref{*print-array*} is \term{true} and \varref{*print-readably*}<P>
|
|
is \term{false}, any \term{array} ...<P>
|
|
<P>
|
|
Change the beginning of the next-to-last paragraph to:<P>
|
|
<P>
|
|
If both \varref{*print-array*} and \varref{*print-readably*} are <P>
|
|
\term{false}, the \term{array} is printed ...<P>
|
|
<P>
|
|
Add a new paragraph before the last paragraph:<P>
|
|
<P>
|
|
If \varref{*print-readably*} is true, the \term{array} prints in an<P>
|
|
\term{implementation-defined} manner. See \varref{*print-readably*}.<P>
|
|
<P>
|
|
<B>Test Case:<P>
|
|
</B><P>
|
|
Not provided.<P>
|
|
<P>
|
|
<B>Rationale:<P>
|
|
</B><P>
|
|
We should better document the relationship between <A REL=DEFINITION HREF="../Body/v_pr_rda.htm#STprint-readablyST"><B>*PRINT-READABLY*</B></A> and<P>
|
|
other printer control variables such as <A REL=DEFINITION HREF="../Body/v_pr_esc.htm#STprint-escapeST"><B>*PRINT-ESCAPE*</B></A>.<P>
|
|
<P>
|
|
<B>Current Practice:<P>
|
|
</B><P>
|
|
Not provided.<P>
|
|
<P>
|
|
<B>Cost to Implementors:<P>
|
|
</B><P>
|
|
Probably relatively small.<P>
|
|
<P>
|
|
<B>Cost to Users:<P>
|
|
</B><P>
|
|
None. This change doesn't affect anything already guaranteed to the user.<P>
|
|
<P>
|
|
<B>Cost of Non-Adoption:<P>
|
|
</B><P>
|
|
Vagueness in the language specification.<P>
|
|
<P>
|
|
<B>Benefits:<P>
|
|
</B><P>
|
|
Better program portability.<P>
|
|
<P>
|
|
<B>Editorial Impact:<P>
|
|
</B><P>
|
|
Small. A few small, localized edits.<P>
|
|
<P>
|
|
<B>Aesthetics:<P>
|
|
</B><P>
|
|
Mostly neutral.<P>
|
|
<P>
|
|
<B>Discussion:<P>
|
|
</B> <P>
|
|
This addresses comment Loosemore #24.<P>
|
|
<P>
|
|
<P>
|
|
<P>
|
|
<P>
|
|
</PRE>
|
|
<HR>
|
|
|
|
<A REL=NAVIGATOR HREF="../Front/StartPts.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Starting Points]" SRC="../Graphics/StartPts.gif" ALIGN=Bottom></A><A REL=TOC HREF="../Front/Contents.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Contents]" SRC="../Graphics/Contents.gif" ALIGN=Bottom></A><A REL=INDEX HREF="../Front/X_Master.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Index]" SRC="../Graphics/Index.gif" ALIGN=Bottom></A><A REL=INDEX HREF="../Front/X_Symbol.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Symbols]" SRC="../Graphics/Symbols.gif" ALIGN=Bottom></A><A REL=GLOSSARY HREF="../Body/26_a.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Glossary]" SRC="../Graphics/Glossary.gif" ALIGN=Bottom></A><A HREF="../Front/X3J13Iss.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Issues]" SRC="../Graphics/Issues.gif" ALIGN=Bottom></A><BR>
|
|
|
|
<A REL=COPYRIGHT HREF="../Front/Help.htm#Legal"><I>Copyright 1996-2005, LispWorks Ltd. All rights reserved.</I></A><P>
|
|
</BODY>
|
|
</HTML>
|