[uim-commit] r2864 - branches/r5rs/sigscheme/doc

yamaken at freedesktop.org yamaken at freedesktop.org
Mon Jan 9 02:44:08 PST 2006


Author: yamaken
Date: 2006-01-09 02:44:02 -0800 (Mon, 09 Jan 2006)
New Revision: 2864

Added:
   branches/r5rs/sigscheme/doc/style.txt
Removed:
   branches/r5rs/sigscheme/doc/style
Log:
* sigscheme/doc/style
* sigscheme/doc/style.txt
  - Rename style to style.txt


Deleted: branches/r5rs/sigscheme/doc/style
===================================================================
--- branches/r5rs/sigscheme/doc/style	2006-01-09 10:42:39 UTC (rev 2863)
+++ branches/r5rs/sigscheme/doc/style	2006-01-09 10:44:02 UTC (rev 2864)
@@ -1,55 +0,0 @@
-Coding style
-
-* Cosmetic style
-
-  C:
-    indent-tabs-mode: nil
-    fill-column: 79
-    c-basic-offset: 4
-    substatement-open: 0
-    c-backslash-column: 77
-
-  Scheme:
-    (put 'and-let* 'scheme-indent-function 1)
-    (put 'receive 'scheme-indent-function 2)
-    (put 'with-exception-handler 'scheme-indent-function 1)
-    (put 'guard 'scheme-indent-function 1)
-
-  The value 77 for c-backslash-column is selected to maximize writable space,
-  eliminate jagged end of lines and prevent overflow of lines on diffs posted
-  to the uim-commit list.
-
-  Avoid placing a character at column 80 even if your editor displays it
-  without overflow in 80-column window. Many editor displays it as continuance
-  mark or folding mark. i.e. Treat column 79 as end-of-line, especially for
-  decorations for comments.
-
-
-* Macro definition
-
-  Any argument should be wrapped into () or [] if no exceptional reason exist,
-  to prevent unintended operator associations.
-
-    #define SCM_CONS_SET_CAR(a, car)   (SCM_CAR(a) = (car))
-
-  And ultra-cowardively, passing an argument to another function or macro is
-  should also be wrapped as follows.
-
-    #define SCM_CONS(kar, kdr) (Scm_NewCons((kar), (kdr)))
-
-  This is intended to endure unconditional safety against rare-cases such as
-  follows.
-
-    #define FOO assert(), get_foo()
-    #define MAKE_LIST2(x, y) make_list(x, y)
-    
-    MAKE_LIST2(FOO, SCM_FALSE);
-    /* => make_list(assert(), get_foo(), SCM_FALSE) */
-
-
-* Macro invocation
-
-  Don't pass a destructive or side-effective expression to a SigScheme macro as
-  an argument (e.g. CONTINUATIONP(continuation_stack_unwind(cont))), because
-  there's an possibility that continuation_stack_unwind() is evaluated multiple
-  times after the macro expantion.

Copied: branches/r5rs/sigscheme/doc/style.txt (from rev 2861, branches/r5rs/sigscheme/doc/style)



More information about the uim-commit mailing list