Update of /project/mcclim/cvsroot/mcclim/Doc
In directory common-lisp.net:/tmp/cvs-serv27680/Doc
Modified Files:
manual.tex spec-macros.tex
Log Message:
Bring command table inheritence in line with the 2.2 spec described in
the Franz User Manual. All command tables must inherit, one way or
another, from global-command-table.
Change add-command-to-command-table so that command table designators
work too.
Date: Mon Dec 13 13:18:06 2004
Author: tmoore
Index: mcclim/Doc/manual.tex
diff -u mcclim/Doc/manual.tex:1.21 mcclim/Doc/manual.tex:1.22
--- mcclim/Doc/manual.tex:1.21 Thu Jul 22 21:46:23 2004
+++ mcclim/Doc/manual.tex Mon Dec 13 13:18:06 2004
@@ -41,6 +41,7 @@
\newcommand{\longref}[1]{(See \ref{#1})}
\newcommand{\var}[1]{\textit{#1}}
+\newcommand{\nil}[0]{\cl{nil}}
\title{McCLIM 0.01 user's manual}
\author{Robert Strandh \\ strandh(a)labri.fr}
@@ -73,8 +74,20 @@
protocols, classes, functions, macros, etc. that are part of the
specification.
-This manual documents McCLIM 0.01 which is a partial implementation of
-the CLIM 2.0 specification.
+\section{Standards}
+This manual documents McCLIM 0.01 which is a mostly complete implementation of
+the CLIM~2.0 specification and its revision~2.2. To our knowledge
+version~2.2 of the CLIM specification is only documented in the ``CLIM~2
+User's Guide'' by Franz. While that document is not a formal
+specification, it does contain many cleanups and is often clearer than
+the official specification; on the other hand, the original
+specification is a useful reference. This manual will note where
+McCLIM has followed the 2.2 API.
+
+Also, some protocols mentioned in the 2.0 specification, such as parts
+of the incremental redisplay protocol, are clearly internal to CLIM
+and not well described. It will be noted here when they are partially
+implemented in McCLIM or not implemented at all.
\part{Getting Started}
@@ -169,7 +182,6 @@
The following programs are currently \textbf{known not to work}:
\begin{itemize}
-\item \texttt{Apps/Scigraph}
\item \texttt{Examples/fire.lisp}
\item \texttt{Examples/gadget-test-kr.lisp}
\item \texttt{Examples/gadget-test.lisp}
@@ -1261,6 +1273,19 @@
\arg{record-type} is evaluated.
+\chapter{Command Processing}
+
+\defmacro {define-command-table} {name \key inherit-from menu
+ inherit-menu}
+\defun {make-command-table} {name \key inherit-from inherit-menu
+ (errorp t)}
+
+By default command tables inherit from
+\cl{global-command-table}. According to the CLIM~2.0 specification, a
+command table inherits from no command table if \nil\ is passed as an
+explicit argument to \arg{inherit-from}. In revision~2.2 all command
+tables must inherit from \cl{global-command-table}. McCLIM treats a
+\nil\ value of \arg{inherit-from} as specifying \cl{'(global-command-table)}.
\part{Extensions}
Index: mcclim/Doc/spec-macros.tex
diff -u mcclim/Doc/spec-macros.tex:1.1 mcclim/Doc/spec-macros.tex:1.2
--- mcclim/Doc/spec-macros.tex:1.1 Tue Jul 3 09:20:34 2001
+++ mcclim/Doc/spec-macros.tex Mon Dec 13 13:18:06 2004
@@ -55,7 +55,7 @@
\gdef\cl{\bgroup
\catcode`\-=\active \def-{{\tt \char`\-}\penalty\exhyphenpenalty}%
\@cl}}
-\def\@cl#1{\tt#1\egroup}
+\def\@cl#1{\texttt{#1}\egroup}
%% Use \concept when you are introducing a term for the first time, and
%% want it in the index. Use \term after that.