diff lisp/psgml/README.psgml @ 2:ac2d302a0011 r19-15b2

Import from CVS: tag r19-15b2
author cvs
date Mon, 13 Aug 2007 08:46:35 +0200
parents 376386a54a3c
children bcdc7deadc19
line wrap: on
line diff
--- a/lisp/psgml/README.psgml	Mon Aug 13 08:45:53 2007 +0200
+++ b/lisp/psgml/README.psgml	Mon Aug 13 08:46:35 2007 +0200
@@ -1,7 +1,7 @@
-This is the READ ME file for psgml.el version 1a9.       -*- text -*-
+This is the READ ME file for psgml.el version 1a12.       -*- text -*-
 
    PSGML is a major mode for editing SGML documents.  It works with
-GNU Emacs 19.19 and later or with Lucid Emacs 19.9.
+GNU Emacs 19.19 and later or with XEmacs 19.13.
 
 This distribution should contain the following source files:
 	psgml.el
@@ -17,42 +17,86 @@
 	psgml-api.texi	-- internals documentation
 	psgml-api.el	-- Extra functions for the API
 	fs.el		-- Example use of psgml to format a SGML file
-	style.el	-- example style file for fs.el
+	style.fs	-- example style file for fs.el
 	catalog.sgml	-- example SGML-file for fs.el and style.el
 	iso88591.map
+	Makefile.in
 
 In addition the distribution contains the formatted versions of the
 documentation files (psgml.info, ...). But the compiled elisp code is
 no longer supplied. You will have to byte compile the files before
-PSGML will achive usable speed.
+PSGML will achieve usable speed.
 
-If you are not using Lucid Emacs or XEmacs you should compile:
-	psgml.el
-	psgml-other.el
-	psgml-edit.el
-	psgml-parse.el
-	psgml-dtd.el
-	psgml-info.el
-        psgml-charent.el
+PSGML now comes with autoconf support. See INSTALL for generic
+instructions. Run
+
+	sh configure
+	make
 
-If you on the other hand are using Lucid Emacs or XEmacs you should
-compile
-	psgml.el
-	psgml-lucid.el
-	psgml-edit.el
-	psgml-parse.el
-	psgml-dtd.el
-	psgml-info.el
-        psgml-charent.el
+and possibly
+
+	make install
 
-Additionally the following can be compiled, they are not normaly used
-by PSGML:
-	psgml-api.el	-- Extra functions for the API
-	fs.el		-- Example use of psgml to format a SGML file
-	psgml-debug.el	-- some functions used in development
+If you are using xemacs, you can run give the argument `--with-xemacs'
+to configure, or use `make xemacs'.
+
+Instead of using configure you can load the psgml-main.el file and run
+the command psgml-compile-files. Then you have to set load-path or
+move the .elc files.
 
 Send bug reports, comments and suggestions to lenst@lysator.liu.se.
 
+New in version 1.0a12
+
+See ChangeLog...
+
+
+New in version 1.0a11
+
+* Autoconf support
+
+Tanks to Karl Eichwalder.
+
+* Bugs fixed
+
+** after-change-function lost if text entity referenced
+
+** Mouse button 3, has wrong binding in XEmacs.
+
+
+New in version 1.0a10
+
+* Changed how fontification is done
+
+First the current line is parsed and fontified. If this would mean
+parsing more than 500 chars, wait 1 second first.
+
+Wait 6 seconds and then fontify rest of buffer.
+
+These waits and the parsing can be interrupted by any input event.
+
+This seems to work well with Emacs 19.29 and XEmacs 19.13 on Linux.
+
+* XEmacs menus made with easy-menu
+
+Now there is only one set of menu for both Emacs and XEmacs.
+
+* Tracing catalog lookup
+
+To help debug entity lookup there is a new option
+`sgml-trace-entity-lookup'. If this option is t messages will be
+logged in *SGML LOG* buffer when external entities are looked up.
+These messages shows entity, catalogs searched, and entry type in
+catalog where entity was found.
+
+
+
+* Renamed default style sheet for fs.el
+
+The default style sheet used by fs.el, style sheet formatter example
+is now "style.fs".
+
+
 New in version 1.0a9
 
 * XEmacs may have problem if sgml-set-face is t
@@ -60,7 +104,7 @@
 I tried with the latest version on a sun4 Solaris 2 machine and PSGML
 would always parse to the end of the buffer even if I typed something.
 There seem to be a problem with the input-pending-p function. I don't
-know if this is specific fo Solaris. Emacs on Solaris has problems
+know if this is specific for Solaris. Emacs on Solaris has problems
 with signal handling.
 
 
@@ -72,11 +116,11 @@
 ** sgml-map-content: new optional argument. If the argument ENTITY-FUN
 is specified it should be a function with one argument. The function
 will be called for data entity references instead of the entity text
-beeing passed to the DATA-FUN. The argument is the entity referenced.
+being passed to the DATA-FUN. The argument is the entity referenced.
 Use `sgml-entity-name', `sgml-entity-type' etc.
 
 
-Version 1.0a8 has only bugfixes.
+Version 1.0a8 has only bug-fixes.
 
 
 New in version 1.0a7
@@ -88,8 +132,8 @@
 ** New option: sgml-system-identifiers-are-preferred
 If nil PSGML will look up external entities by searching the catalogs
 in `sgml-local-catalogs' and `sgml-catalog-files'  and only if the entity
-is not found in will a given system identifer be used.  If the variable
-is non-nil and a system identifer is given, the system identifier will
+is not found in will a given system identifier be used.  If the variable
+is non-nil and a system identifier is given, the system identifier will
 be used for the entity. If no system identifier is given the catalogs
 will searched.
 
@@ -108,7 +152,7 @@
 
   (parent-file context-element* top-element (has-seen-element*)?)
 
-*** parent-file (string) is the name of the file contatining the
+*** parent-file (string) is the name of the file containing the
 document entity.
 
 *** context-element (string) is used to set up exceptions and short
@@ -150,7 +194,7 @@
 psgml. Use (require 'psgml-api) to use the API functions (psgml-api
 includes the rest of the psgml files).
 
-The new functions in psgml-api is two functions to travers the element
+The new functions in psgml-api is two functions to traverse the element
 structure.
 
 *** (sgml-map-content element element-function data-function pi-function)
@@ -189,7 +233,7 @@
 it used to leave point at the beginning of the element.
 
 * sgml-hide-tags/attributes is better at handling minimized tags
-
+				   
 * New options
 ** sgml-validate-files and slight change of sgml-validate-command.
 ** sgml-recompile-out-of-date-cdtd
@@ -197,8 +241,8 @@
 * Now saving attribute specification list in parse tree
 Faster sgml-element-attval, but more memory used.
 
-* Long menus that are split into submenus now show the range of
-choices in the different submenus.
+* Long menus that are split into sub-menus now show the range of
+choices in the different sub-menus.
 
 The option `sgml-range-indicator-max-length' determines how many
 characters from the first and the last choice to show.
@@ -273,7 +317,7 @@
 
 
 * Compiled DTDs are now associated with external `Document Type
-Declaration Subset' entitys.  You will have to create a catalog with
+Declaration Subset' entities.  You will have to create a catalog with
 entries for all the DTDs that should be compiled.  This should make
 it, in most cases, unnecessary to make saved dtds or to set the
 `sgml-default-dtd-file', at the expense of having to maintain the
@@ -350,7 +394,7 @@
 
 Now it should be possible to edit html files if you put them in
 sgml-mode.  The file must either start with a proper DOCTYPE or with a
-<html> tag.  To be abel to start with empty files and to edit files
+<html> tag.  To be able to start with empty files and to edit files
 not starting with <html> you can create a html-mode that sets the
 default document type name:
 
@@ -372,7 +416,7 @@
 * Handling of tags for undefined elements
 
 ** Start-tags for undefined elements will either be ignored, if
-`sgml-ignore-undefined-elements' is t, or assumed to be acceptabled in
+`sgml-ignore-undefined-elements' is t, or assumed to be acceptable in
 the current element and defined with `O O ANY'.
 
 ** An end-tag for an element that is not currently open will be ignored.
@@ -433,7 +477,7 @@
 entities are expanded to the replacement text of the entity, other
 short references are expanded into general entity references.  If
 argument, TO-ENTITY, is non-nil, or if called interactive with numeric
-prefix argument, all short references are replaced by generaly entity
+prefix argument, all short references are replaced by generally entity
 references.
 
 ** sgml-normalize: expand short references also
@@ -466,13 +510,13 @@
 transparent.
 
 * Local catalog files
-Variabel `sgml-local-catalogs'
+Variable `sgml-local-catalogs'
 A list of SGML entity catalogs to be searched first when parsing the buffer.
-This is used in addtion to `sgml-catalog-files',  and `sgml-public-map'.
+This is used in addition to `sgml-catalog-files',  and `sgml-public-map'.
 This variable is automatically local to the buffer.
 
 * New commands
-Thanks to David Megginson the custom menus are now reacable from the
+Thanks to David Megginson the custom menus are now reachable from the
 keyboard:
 ** C-c C-u C-d  (sgml-custom-dtd)
 ** C-c C-u C-m  (sgml-custom-markup)
@@ -576,3 +620,9 @@
 
 `sgml-exposed-tags' is local to each buffer in which it has been set;
 use `setq-default' to set it to a value that is shared among buffers.
+
+
+Local variables:
+mode: text
+mode: outline
+end: