Return to guideline.txt CVS log

Up to [local] / OpenXM / src / asir-contrib

Annotation of OpenXM/src/asir-contrib/guideline.txt, Revision 1.5

1.5     ! takayama    1: $OpenXM: OpenXM/src/asir-contrib/guideline.txt,v 1.4 2005/03/24 09:05:05 takayama Exp $
1.1       takayama    2:
1.4       takayama    3: How to commit your asir program to asir-contrib? [2005, 3/24]
                      4:
                      5:    1.  The name of your source code should be
                      6:             yourname_xyz.rr
                      7:        The part "yourname" may be your nickname.
                      8:        Example:  noro_matrix.rr
1.1       takayama    9:
                     10:        Your asir source should be at asir-contrib/packages/src.
1.5     ! takayama   11:        Or, you may make a new directory under asir-contrib/packages/src
        !            12:        to put your programs and data.
        !            13:        Example: todo_parametrize
1.4       takayama   14:
1.5     ! takayama   15:        Your may use both your own directory and the top level source code.
        !            16:        Example:  naka_mora
        !            17:                  naka_mora.rr
        !            18:
        !            19:    2.  Please encapsulate your source code with module.
1.4       takayama   20:        If you want to use the module name which represents a mathematical notion
                     21:        or a data structure,
                     22:        the module name should be
                     23:            pxxxx
                     24:        where "p" is your identifying prefix and xxxx is a name of mathematical
                     25:        notion or data structure name related to your module.
                     26:        Example: nmatrix  where "p" is "n" and "xxxx" is "matrix".
                     27:        Example: fres  where "p" is "f" and "xxxx" is "res" (or "resultant").
1.5     ! takayama   28:        Example: nmora  where "p" is "n" and "xxxx" is "mora".
1.4       takayama   29:
1.1       takayama   30:
1.4       takayama   31:    3.  Manuals should be written by the texinfo in English and/or Japanese.
                     32:        They are put in asir-contrib/packagers/doc/'yourname_xyz'
                     33:        The Makefile asir-contrib/packagers/doc/'yourname_xyz'/Makefile
                     34:        is also necessary.
                     35:        Example: asir-contrib/packages/doc/todo_parametrize/Makefile
                     36:
                     37:    4. If you want to embed your manual in the source, you are welcome
                     38:       to use "oxweave" or "gdoc" (see http://texinfo.org).
                     39:
                     40:    5. Please refer to papers that explain algorithms in your package
                     41:       from your texinfo manual.
                     42:
                     43:    6. Please include test data that you used to check the correctness
                     44:       of your implementation.
                     45:
                     46:
                     47:  Directory structure
                     48:  Windows:
                     49:      bin/
                     50:      lib/
                     51:      lib-asir-contrib/
                     52:
                     53:  Unix:
                     54:     lib/asir
                     55:     lib/asir-contrib
                     56:
                     57:  Documents (unix):
                     58:    Online manual (ja)
                     59:     lib/asir/help-jp/
                     60:     lib/asir/help-jp/'modulename.functionname'
                     61:
                     62:    HTML manual (ja)
                     63:     doc/asir-contrib/help-ja/cman-ja_toc.html
                     64:     doc/asir-contrib/help-ja/'yourname_xyz'/'yourname_xyz'_ja_toc.html