diff -r 9554ce1c2e54 -r b7d96e94796f src/HOL/Library/README.html --- a/src/HOL/Library/README.html Fri Oct 20 08:46:41 2000 +0200 +++ b/src/HOL/Library/README.html Fri Oct 20 13:15:26 2000 +0200 @@ -22,6 +22,7 @@
Files +
Avoid unnecessary scattering of theories over several files. Use new-style theories only, as old ones tend to clutter the file space with separate .thy and .ML files. @@ -29,19 +30,21 @@
Examples
Theories should be as ``generic'' as is sensible. Unused (or -rather unusable?) standalone theories should be avoided; common -applications should actually refer to the present theory. Small -example uses may be included as well, but should be put in a separate +rather unusable?) theories should be avoided; common applications +should actually refer to the present theory. Small example uses may +be included in the library as well, but should be put in a separate theory, such as Foobar accompanied by Foobar_Examples.
Theory names +
The theory loader name space is flat, so use sufficiently long and descriptive names to reduce the danger of clashes with the user's own theories. The convention for theory names is as follows: Foobar_Doobar (this looks best in LaTeX output).
Names of logical items +
There are separate hierarchically structured name spaces for types, constants, theorems etc. Nevertheless, some care should be taken, as the name spaces are always ``open''. Use adequate names; @@ -56,16 +59,18 @@ \<oplus>), but leave these for user applications.
Global context declarations +
Only items introduced in the present theory should be declared -globally (e.g. as Simplifier rules). Note that adding / deleting -rules stemming from parent theories may result in strange behavior -later, depending on the user's arrangement of import lists. +globally (e.g. as Simplifier rules). Note that adding and deleting +rules from parent theories may result in strange behavior later, +depending on the user's arrangement of import lists.
Mathematical symbols -
Non-ASCII symbols should be used with some care. In particular, -avoid unreadable arrows: ==> should be preferred over -\<Longrightarrow>. Use isatool unsymbolize to -clean up the sources. + +
Non-ASCII symbols should be used as appropriate, with some +care. In particular, avoid unreadable arrows: ==> should +be preferred over \<Longrightarrow>. Use isatool +unsymbolize to clean up the sources.

@@ -73,14 +78,14 @@ @, !, ?, ?!, %, better use SOME, ALL (or \<forall>), EX (or \<exists>), EX! (or -\<exists;>!), \<lambda>, respectively. +\<exists>!), \<lambda>, respectively. Note that bracket notation [| |] looks bad in LaTeX output.

Some additional mathematical symbols are quite suitable for both -readable sources and output document: +readable sources and the output document: \<Inter>, \<Union>, \<and>,