[BACK]Return to guideline.txt CVS log [TXT][DIR] Up to [local] / OpenXM / src / asir-contrib

Diff for /OpenXM/src/asir-contrib/guideline.txt between version 1.5 and 1.9

version 1.5, 2005/03/24 09:09:34 version 1.9, 2005/04/20 22:58:58
Line 1 
Line 1 
 $OpenXM: OpenXM/src/asir-contrib/guideline.txt,v 1.4 2005/03/24 09:05:05 takayama Exp $  $OpenXM: OpenXM/src/asir-contrib/guideline.txt,v 1.8 2005/03/26 23:25:46 takayama Exp $
   
 How to commit your asir program to asir-contrib? [2005, 3/24]  How to commit your asir program to asir-contrib? [2005, 3/24]
   
    1.  The name of your source code should be     1.  The name of your source code should be
             yourname_xyz.rr              yourname_xyz.rr
          if xyz is a general name like matrix, prime, resultant, etc.
        The part "yourname" may be your nickname.         The part "yourname" may be your nickname.
        Example:  noro_matrix.rr         Example:  noro_matrix.rr
          If xyz is not a general name, the part yourname_ is not necessary.
   
        Your asir source should be at asir-contrib/packages/src.         Your asir source should be at asir-contrib/packages/src.
        Or, you may make a new directory under asir-contrib/packages/src         Or, you may make a new directory under asir-contrib/packages/src
        to put your programs and data.         to put your programs and data.
        Example: todo_parametrize         Example: asir-contrib/packages/src/todo_parametrize
   
        Your may use both your own directory and the top level source code.         Your may use both your own directory and the top level source code
        Example:  naka_mora         to load sources in the own directory.
                  naka_mora.rr         Example:  asir-contrib/packages/src/naka_mora
                    asir-contrib/packages/src/naka_mora.rr
   
    2.  Please encapsulate your source code with module.     2.  Please encapsulate your source code with modules.
        If you want to use the module name which represents a mathematical notion         When you use the module name which represents a mathematical notion
        or a data structure,         or a data structure,
        the module name should be         the module name should be
            pxxxx             pxxxx
Line 28  How to commit your asir program to asir-contrib? [2005
Line 30  How to commit your asir program to asir-contrib? [2005
        Example: nmora  where "p" is "n" and "xxxx" is "mora".         Example: nmora  where "p" is "n" and "xxxx" is "mora".
   
   
    3.  Manuals should be written by the texinfo in English and/or Japanese.     3.  Manuals should be written by the texinfo (gentexi, oxweave)
        They are put in asir-contrib/packagers/doc/'yourname_xyz'         in English and/or Japanese.
          They are put under the directory
          asir-contrib/packagers/doc/'yourname_xyz'
        The Makefile asir-contrib/packagers/doc/'yourname_xyz'/Makefile         The Makefile asir-contrib/packagers/doc/'yourname_xyz'/Makefile
        is also necessary.         is also necessary.
        Example: asir-contrib/packages/doc/todo_parametrize/Makefile         Example 1: asir-contrib/packages/doc/todo_parametrize/Makefile
             asir-contrib/packages/doc/todo_parametrize/todo_parametrize_ja.texi
          Example 2: asir-contrib/packages/doc/plucker
   
    4. If you want to embed your manual in the source, you are welcome     4. You are welcome to use "oxweave & gentexi" to generate texinfo manual.
       to use "oxweave" or "gdoc" (see http://texinfo.org).        Example: asir-contrib/packages/doc/plucker/*.oxg, *.oxw
   
    5. Please refer to papers that explain algorithms in your package     5. Please refer to papers that explain algorithms in your package
       from your texinfo manual.        from your texinfo manual.
   
    6. Please include test data that you used to check the correctness     6. Please include test data that you used to check the correctness
       of your implementation.        of your implementation or to make demonstrations.
   
      7. About function names of your module.
        Please use any names you like.
        However, please also include "long function names" separated by "_"
        such as  "total_degree".
   
  Directory structure   Directory structure
  Windows:   Windows:
Line 60  How to commit your asir program to asir-contrib? [2005
Line 70  How to commit your asir program to asir-contrib? [2005
     lib/asir/help-jp/'modulename.functionname'      lib/asir/help-jp/'modulename.functionname'
   
    HTML manual (ja)     HTML manual (ja)
     doc/asir-contrib/help-ja/cman-ja_toc.html      doc/asir-contrib/ja/cman-html/cman-ja_toc.html
     doc/asir-contrib/help-ja/'yourname_xyz'/'yourname_xyz'_ja_toc.html      doc/asir-contrib/ja/'yourname_xyz'-html/'yourname_xyz'_ja_toc.html

Legend:
Removed from v.1.5  
changed lines
  Added in v.1.9

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>