From 07c086c1b9ea74996f20339d42ca91c3411966f5 Mon Sep 17 00:00:00 2001
From: Hans Bolinder <hasse@erlang.org>
Date: Fri, 1 Feb 2013 12:24:22 +0100
Subject: [stdlib] Add new SDTLIB application variable 'shell_strings'

Use the new function shell:strings/1 to toggle how the Erlang shell
outputs lists of integers.
---
 lib/stdlib/doc/src/shell.xml      | 22 ++++++++++++++++++----
 lib/stdlib/doc/src/stdlib_app.xml |  9 +++++++--
 2 files changed, 25 insertions(+), 6 deletions(-)

(limited to 'lib/stdlib/doc')

diff --git a/lib/stdlib/doc/src/shell.xml b/lib/stdlib/doc/src/shell.xml
index bc2120c37d..7f251c863e 100644
--- a/lib/stdlib/doc/src/shell.xml
+++ b/lib/stdlib/doc/src/shell.xml
@@ -4,7 +4,7 @@
 <erlref>
   <header>
     <copyright>
-      <year>1996</year><year>2011</year>
+      <year>1996</year><year>2013</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -781,7 +781,7 @@ loop(N) ->
       </desc>
     </func>
     <func>
-      <name>catch_exception(Bool) -> Bool</name>
+      <name>catch_exception(Bool) -> boolean()</name>
       <fsummary>Sets the exception handling of the shell</fsummary>
       <type>
         <v>Bool = boolean()</v>
@@ -801,8 +801,8 @@ loop(N) ->
       <name name="prompt_func" arity="1"/>
       <fsummary>Sets the shell prompt</fsummary>
       <desc>
-        <p>Sets the shell prompt function to <c>PromptFunc</c>. The
-          previous prompt function is returned.</p>
+        <p>Sets the shell prompt function to <c><anno>PromptFunc</anno></c>.
+          The previous prompt function is returned.</p>
       </desc>
     </func>
     <func>
@@ -827,6 +827,20 @@ loop(N) ->
           is meant to be called from the shell.</p>
       </desc>
     </func>
+    <func>
+      <name name="strings" arity="1"/>
+      <fsummary>Sets the shell's string recognition flag.</fsummary>
+      <desc>
+        <p>Sets pretty printing of lists to <c><anno>Strings</anno></c>.
+          The previous value of the flag is returned.</p>
+        <p>The flag can also be set by the STDLIB application variable
+          <c>shell_strings</c>. The default is
+          <c>true</c> which means that lists of integers will be
+          printed using the string syntax, when possible. The value
+          <c>false</c> means that no lists will be printed using the
+          string syntax.</p>
+      </desc>
+    </func>
   </funcs>
 </erlref>
 
diff --git a/lib/stdlib/doc/src/stdlib_app.xml b/lib/stdlib/doc/src/stdlib_app.xml
index a615c1bf88..2391bb6f03 100644
--- a/lib/stdlib/doc/src/stdlib_app.xml
+++ b/lib/stdlib/doc/src/stdlib_app.xml
@@ -4,7 +4,7 @@
 <appref>
   <header>
     <copyright>
-      <year>2005</year><year>2010</year>
+      <year>2005</year><year>2013</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -51,7 +51,7 @@
         <p>This parameter can be used to run the Erlang shell
           in restricted mode.</p>
       </item>
-      <tag><c>shell_catch_exception = bool()</c></tag>
+      <tag><c>shell_catch_exception = boolean()</c></tag>
       <item>
         <p>This parameter can be used to set the exception handling
 	  of the Erlang shell's evaluator process.</p>
@@ -76,6 +76,11 @@
         <p>This parameter can be used to determine how many 
           results are saved by the Erlang shell.</p>
       </item>
+      <tag><c>shell_strings = boolean()</c></tag>
+      <item>
+        <p>This parameter can be used to determine how the Erlang
+          shell outputs lists of integers.</p>
+      </item>
     </taglist>
   </section>
 
-- 
cgit v1.2.3