ftp.nice.ch/peanuts/GeneralData/Documents/developer/lisp/clman.README

This is the README for clman.tar.gz [Download] [Browse] [Up]

The following files, which implement and document CLMAN (Franz Inc's
CL Manual), on the NeXT machine, are now available by anonymous FTP
(file ~ftp/pub/franzinc/next/clman.tar.Z on hosts uunet.uu.net and
ucbvax.berkeley.edu).
	
	clman.el	(generic CLMAN code)
	next-clman.el	(next-specific CLMAN code)
	next-cook-data.el (code for generating tables used by CLMAN)
	README 		(this document)
	spec.next.n	(the user guide to CLMAN)

This message tells you how to install CLMAN (Franz Inc's CL Manual) on
your NeXT machine.  This is essentially the same CLMAN that is
available on most platforms that support Franz's Allegro CL.

The first time you start up emacs with this code, the system takes
about 5 minutes to build the table that it will use for all future use
of CLMAN.  This will only happen once.

If you set the value of next:save-clman-pages to T, then manual pages
will automatically be written out to a file in a subdirectory of
next-clman-code-directory.  (Thus, you should have write-permission in
the directory that is the value of next-clman-code-directory.)
Subsequent lookups will run much faster, because the system does not
have to perform the extra step of nroffing the manual page.  If you do
not want this feature, set the value of next:save-clman-pages to NIL.


;;  
;;  STEP 1: Place the following three files in some directory.
;;	

;; clman.el
;; next-clman.el
;; next-cook-data.el

;;  STEP 2: Place the following code in your .emacs file.

;; If the following  variable is T, then CLMAN pages will be saved 
;;  (in subdirectories under the code directory).  Thus, CLMAN
;;  will get faster through use.

(setq next:save-clman-pages t)

;;    Lets assume you put the CLMAN CODE FILES files in a directory called 
;;    /usr/local/clman.

(setq next-clman-code-directory "/usr/local/clman/")

;; bind the key ESC-m to the top-level CLMAN lookup function

(global-set-key "\em" 'fi:clman)

;; bind the key ESC-a to the top-level manual CLMAN apropos function
(global-set-key "\ea" 'fi:clman-apropos)

;;  We load the two files that implement the lookup facility of 
;;  CLMAN.

(load-file (concat next-clman-code-directory "clman.el"))
(load-file (concat next-clman-code-directory "next-clman.el"))

;;  Now type ESC-a for fi:clman-apropos or ESC-m for fi:clman
;;  Refer to the user guide for further instructions on using CLMAN.

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.