Merge pull request #381 from vindarel/master

Discovering the Lispworks IDE

Author: vindarel

assets/lispworks/class-browser.png

@@ -173,3 +173,31 @@ ul ul{
 ul ul ul{
     margin-left:-26px;
 }
+
+// Alert / Info boxes
+
+.info-box {
+    // note: if element is inside a <p> then bootstrap adds 10px padding to the bottom.
+    padding: 17px;
+}
+
+.danger {
+  background-color: #ffdddd;
+  border-left: 6px solid #f44336;
+}
+
+.success {
+  background-color: #ddffdd;
+  border-left: 6px solid #4CAF50;
+}
+
+.info {
+  background-color: #e7f3fe;
+  border-left: 6px solid #2196F3;
+}
+
+
+.warning {
+  background-color: #ffffcc;
+  border-left: 6px solid #ffeb3b;
+}

assets/lispworks/function-call-browser.png

@@ -822,7 +822,45 @@ Hash Tables are created using the function
 has no required argument. Its most used optional keyword argument is
 `:test`, specifying the function used to test the equality of keys.
 
-_Note_: see shorter notations in the [Serapeum](https://github.com/ruricolist/serapeum/) or [Rutils](https://github.com/vseloved/rutils) libraries. For example, Serapeum has `dict`, and Rutils a `#h` reader macro.
+<div class="info-box info">
+<strong>Note:</strong> see shorter notations in the <a href="https://github.com/ruricolist/serapeum/">Serapeum</a> or <a href="https://github.com/vseloved/rutils">Rutils</a> libraries. For example, Serapeum has <code>dict</code>, and Rutils a <code>#h</code> reader macro.
+</div>
+
+<a name="add"></a>
+
+### Adding an Element to a Hash Table
+
+If you want to add an element to a hash table, you can use `gethash`,
+the function to retrieve elements from the hash table, in conjunction
+with
+[`setf`](http://www.lispworks.com/documentation/HyperSpec/Body/m_setf_.htm).
+
+~~~lisp
+CL-USER> (defparameter *my-hash* (make-hash-table))
+*MY-HASH*
+CL-USER> (setf (gethash 'one-entry *my-hash*) "one")
+"one"
+CL-USER> (setf (gethash 'another-entry *my-hash*) 2/4)
+1/2
+CL-USER> (gethash 'one-entry *my-hash*)
+"one"
+T
+CL-USER> (gethash 'another-entry *my-hash*)
+1/2
+T
+~~~
+
+With Serapeum's `dict`, we can create a hash-table and add elements to
+it in one go:
+
+~~~lisp
+(defparameter *my-hash* (dict :one-entry "one" :another-entry 2/4))
+;; =>
+ (dict
+  :ONE-ENTRY "one"
+  :ANOTHER-ENTRY 1/2
+ )
+~~~
 
 <a name="get"></a>
 
@@ -861,30 +899,6 @@ library (in Quicklisp) has the functions `hash-table-keys` and
 ;; => (BAR)
 ~~~
 
-<a name="add"></a>
-
-### Adding an Element to a Hash Table
-
-If you want to add an element to a hash table, you can use `gethash`,
-the function to retrieve elements from the hash table, in conjunction
-with
-[`setf`](http://www.lispworks.com/documentation/HyperSpec/Body/m_setf_.htm).
-
-~~~lisp
-CL-USER> (defparameter *my-hash* (make-hash-table))
-*MY-HASH*
-CL-USER> (setf (gethash 'one-entry *my-hash*) "one")
-"one"
-CL-USER> (setf (gethash 'another-entry *my-hash*) 2/4)
-1/2
-CL-USER> (gethash 'one-entry *my-hash*)
-"one"
-T
-CL-USER> (gethash 'another-entry *my-hash*)
-1/2
-T
-~~~
-
 
 <a name="test"></a>
 

assets/lispworks/process-browser.png

@@ -184,8 +184,12 @@ able to populate it with information to be consumed later:
 ;; #<MY-DIVISION-BY-ZERO {1005C18653}>
 ~~~
 
-Note: here's a quick reminder on classes, if you are not fully operational
-on the [Common Lisp Object System](clos.html):
+<div class="info-box info">
+<p>
+<strong>Note:</strong> here's a quick reminder on classes, if you are not fully operational
+on the <a href="clos.html">Common Lisp Object System</a>.
+</p>
+</div>
 
 ~~~lisp
 (make-condition 'my-division-by-zero :dividend 3)

assets/lispworks/stepper.gif

@@ -2,7 +2,9 @@
 title: Files and Directories
 ---
 
-Note: In this chapter, we use mainly
+We'll see here a handful of functions and libraries to operate on files and directories.
+
+In this chapter, we use mainly
 [namestrings](http://www.lispworks.com/documentation/HyperSpec/Body/19_aa.htm)
 to
 [specify filenames](http://www.lispworks.com/documentation/HyperSpec/Body/19_.htm). The
@@ -30,6 +32,9 @@ either `nil` if the file doesn't exists, or its
 [truename](http://www.lispworks.com/documentation/HyperSpec/Body/20_ac.htm)
 (which might be different from the argument you supplied).
 
+For more portability, use `uiop:probe-file*` or `uiop:file-exists-p`
+which will return the file pathname (if it exists).
+
 ~~~lisp
 $ ln -s /etc/passwd foo
 
@@ -43,9 +48,6 @@ $ ln -s /etc/passwd foo
 NIL
 ~~~
 
-For more portability, use `uiop:probe-file*` or `uiop:file-exists-p`
-which will return the file pathname (if it exists).
-
 ### Expanding a file or a directory name with a tilde (`~`)
 
 For portability, use `uiop:native-namestring`: