[update conventions documentation
John Meacham <john@repetae.net>**20060314233019] hunk ./docs/conventions.txt 21
-* Jhc@ - A finite set of built in special names that never occur in haskell source
+* Jhc@ - A finite set of built in special names that never occur in haskell
+source. These are enumerated in Name.Names
hunk ./docs/conventions.txt 26
+* A@ - bindings created by atomization of arguments
+
hunk ./docs/conventions.txt 51
-Jhc is never targeted towards a particular architecture or bitwidth, Jhc
-should be able to produce code for any backend or architecture so no
-arch-dependent ifdefs or hardcoding of type sizes. Jhc itself should be
-entirely portable and produce identical results for identical target arches
-no matter what it is running on. (among other reasons, so we may
-cross-compile to embedded architectures and to aid in bootstrapping)
+Jhc is never targeted towards a particular architecture or bitwidth, any
+compiled version of Jhc running on any architecture should be able to produce
+code for any backend or architecture so no arch-dependent ifdefs or hardcoding
+of type sizes. Jhc itself should be entirely portable and produce identical
+results for identical target arches no matter what it is running on. (among
+other reasons, so we may cross-compile to embedded architectures and to aid in
+bootstrapping)
hunk ./docs/conventions.txt 59
-non-literate sources are preferred to literate sources. haddock style comments
-should be included liberally.
+non-literate sources are preferred to literate sources. Correct haddock style
+comments should be included liberally, even for non-exported functions.
hunk ./docs/conventions.txt 69
-modules to avoid the recursion should be preferred when possible.
+modules to avoid the recursion should be preferred when possible, but a
+logical layout of the module hierachy takes precidence.
hunk ./docs/conventions.txt 85
-* in general, I use under_scores for CAFs, global names, and tables. camelCaps
-for functions and CapCaps for data, type constructors, and classes.
+* in general, I use under_scores for CAFs, global non-function names, and
+tables. camelCaps for functions and CapCaps for data, type constructors, and
+classes.