version 1.7, 2005/03/24 23:41:16 |
version 1.10, 2009/02/22 17:30:03 |
|
|
$OpenXM: OpenXM/src/asir-contrib/guideline.txt,v 1.6 2005/03/24 22:07:15 takayama Exp $ |
$OpenXM: OpenXM/src/asir-contrib/guideline.txt,v 1.9 2005/04/20 22:58:58 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: asir-contrib/packages/src/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 |
|
to load sources in the own directory. |
Example: asir-contrib/packages/src/naka_mora |
Example: asir-contrib/packages/src/naka_mora |
asir-contrib/packages/src/naka_mora.rr |
asir-contrib/packages/src/naka_mora.rr |
|
|
2. Please encapsulate your source code with module. |
2. Please encapsulate your source code with modules. |
When you 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 |
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) |
|
in English and/or Japanese. |
They are put under the directory |
They are put under the directory |
asir-contrib/packagers/doc/'yourname_xyz' |
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 |
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. |
Line 62 How to commit your asir program to asir-contrib? [2005 |
|
Line 66 How to commit your asir program to asir-contrib? [2005 |
|
|
|
Documents (unix): |
Documents (unix): |
Online manual (ja) |
Online manual (ja) |
lib/asir/help-jp/ |
lib/asir/help-ja/ |
lib/asir/help-jp/'modulename.functionname' |
lib/asir/help-ja/'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 |