Update documentation for *gc-margin* and *gc-merge*

Author: Affonso-Gui

doc/jlatex/euslisp.hlp

@@ -1,5 +1,5 @@
 ; This file is help command list for euslisp
-"/home/affonso/euslisp_ws/src/euslisp/Euslisp/doc/jlatex" ; Directory of TeX manual
+"/home/affonso/euslisp_new_ws/src/euslisp/Euslisp/doc/jlatex" ; Directory of TeX manual
 ;
 "and" 6 "jcontrols" 334 3
 "or" 6 "jcontrols" 541 3
@@ -605,140 +605,140 @@
 "sys:*gc-debug*" 5 "jsysfunc" 7125 2
 "sys:*gc-merge*" 5 "jsysfunc" 7259 2
 "sys:*gc-margin*" 5 "jsysfunc" 7838 2
-"sys:reclaim" 2 "jsysfunc" 8237 3
-"sys:reclaim-tree" 2 "jsysfunc" 8468 3
-"sys::bktrace" 2 "jsysfunc" 8603 3
-"sys:memory-report" 2 "jsysfunc" 8732 3
-"sys:room" 2 "jsysfunc" 8885 3
-"sys:address" 2 "jsysfunc" 8993 3
-"sys:peek" 2 "jsysfunc" 9179 3
-"sys:poke" 2 "jsysfunc" 10371 3
-"sys:list-all-chunks" 2 "jsysfunc" 10872 3
-"sys:object-size" 2 "jsysfunc" 11019 3
-"unix:ptimes" 2 "jsysfunc" 12528 3
-"unix:runtime" 2 "jsysfunc" 12821 3
-"unix:localtime" 2 "jsysfunc" 12954 3
-"unix:asctime" 2 "jsysfunc" 13419 3
-"unix:getpid" 2 "jsysfunc" 13711 3
-"unix:getppid" 2 "jsysfunc" 13807 3
-"unix:getpgrp" 2 "jsysfunc" 13881 3
-"unix:setpgrp" 2 "jsysfunc" 13958 3
-"unix:getuid" 2 "jsysfunc" 14043 3
-"unix:geteuid" 2 "jsysfunc" 14120 3
-"unix:getgid" 2 "jsysfunc" 14211 3
-"unix:getegid" 2 "jsysfunc" 14300 3
-"unix:setuid" 2 "jsysfunc" 14403 3
-"unix:setgid" 2 "jsysfunc" 14507 3
-"unix:fork" 2 "jsysfunc" 14622 3
-"unix:vfork" 2 "jsysfunc" 14945 3
-"unix:exec" 2 "jsysfunc" 15105 3
-"unix:wait" 2 "jsysfunc" 15191 3
-"unix::exit" 2 "jsysfunc" 15288 3
-"sys:*exit-hook*" 5 "jsysfunc" 15431 2
-"unix:getpriority" 2 "jsysfunc" 15535 3
-"unix:setpriority" 2 "jsysfunc" 15748 3
-"unix:getrusage" 2 "jsysfunc" 16482 3
-"unix:system" 2 "jsysfunc" 17634 3
-"unix:getenv" 2 "jsysfunc" 17815 3
-"unix:putenv" 2 "jsysfunc" 17897 3
-"unix:sleep" 2 "jsysfunc" 18095 3
-"unix:usleep" 2 "jsysfunc" 18195 3
-"unix:uread" 2 "jsysfunc" 18531 3
-"unix:write" 2 "jsysfunc" 19198 3
-"unix:fcntl" 2 "jsysfunc" 19422 2
-"unix:ioctl" 2 "jsysfunc" 19469 2
-"unix:ioctl_" 2 "jsysfunc" 19516 2
-"unix:ioctl_r" 2 "jsysfunc" 19567 2
-"unix:ioctl_w" 2 "jsysfunc" 19641 2
-"unix:ioctl_wr" 2 "jsysfunc" 19716 2
-"unix:uclose" 2 "jsysfunc" 19789 3
-"unix:dup" 2 "jsysfunc" 19879 3
-"unix:pipe" 2 "jsysfunc" 19994 3
-"unix:lseek" 2 "jsysfunc" 20103 3
-"unix:link" 2 "jsysfunc" 20269 3
-"unix:unlink" 2 "jsysfunc" 20334 3
-"unix:mknod" 2 "jsysfunc" 20519 3
-"unix:mkdir" 2 "jsysfunc" 20697 3
-"unix:access" 2 "jsysfunc" 20889 3
-"unix:stat" 2 "jsysfunc" 20983 3
-"unix:chdir" 2 "jsysfunc" 21538 3
-"unix:getwd" 2 "jsysfunc" 21628 3
-"unix:chmod" 2 "jsysfunc" 21695 3
-"unix:chown" 2 "jsysfunc" 21799 3
-"unix:isatty" 2 "jsysfunc" 21895 3
-"unix:msgget" 2 "jsysfunc" 22075 3
-"unix:msgsnd" 2 "jsysfunc" 22207 2
-"unix:msgrcv" 2 "jsysfunc" 22267 2
-"unix:socket" 2 "jsysfunc" 22322 3
-"unix:bind" 2 "jsysfunc" 22615 3
-"unix:connect" 2 "jsysfunc" 22838 3
-"unix:listen" 2 "jsysfunc" 22957 3
-"unix:accept" 2 "jsysfunc" 23151 3
-"unix:recvfrom" 2 "jsysfunc" 23321 3
-"unix:sendto" 2 "jsysfunc" 23891 3
-"unix:getservbyname" 2 "jsysfunc" 24398 3
-"unix:gethostbyname" 2 "jsysfunc" 24572 3
-"unix:syserrlist" 2 "jsysfunc" 24720 3
-"unix:signal" 2 "jsysfunc" 24915 3
-"unix:kill" 2 "jsysfunc" 25667 3
-"unix:pause" 2 "jsysfunc" 25777 3
-"unix:alarm" 2 "jsysfunc" 25889 3
-"unix:ualarm" 2 "jsysfunc" 26220 3
-"unix:getitimer" 2 "jsysfunc" 26508 3
-"unix:setitimer" 2 "jsysfunc" 26752 3
-"unix:select" 2 "jsysfunc" 27165 3
-"unix:select-read-fd" 2 "jsysfunc" 28289 3
-"unix:thr-self" 2 "jsysfunc" 29002 3
-"unix:thr-getprio" 2 "jsysfunc" 29100 3
-"unix:thr-setprio" 2 "jsysfunc" 29207 3
-"unix:thr-getconcurrency" 2 "jsysfunc" 29707 3
-"unix:thr-setconcurrency" 2 "jsysfunc" 29838 3
-"unix:thr-create" 2 "jsysfunc" 30603 3
-"unix:malloc" 2 "jsysfunc" 31073 3
-"unix:free" 2 "jsysfunc" 31168 3
-"unix:valloc" 2 "jsysfunc" 31277 2
-"unix:mmap" 2 "jsysfunc" 31307 2
-"unix:munmap" 2 "jsysfunc" 31377 2
-"unix:vadvise" 2 "jsysfunc" 31417 2
-"unix:tiocgetp" 2 "jsysfunc" 32399 3
-"unix:tiocsetp" 2 "jsysfunc" 32483 3
-"unix:tiocsetn" 2 "jsysfunc" 32561 2
-"unix:tiocgetd" 2 "jsysfunc" 32614 2
-"unix:tiocflush" 2 "jsysfunc" 32669 3
-"unix:tiocgpgrp" 2 "jsysfunc" 32746 3
-"unix:tiocspgrp" 2 "jsysfunc" 32833 3
-"unix:tiocoutq" 2 "jsysfunc" 32924 2
-"unix:fionread" 2 "jsysfunc" 32965 2
-"unix:tiocsetc" 2 "jsysfunc" 33006 2
-"unix:tioclbis" 2 "jsysfunc" 33043 2
-"unix:tioclbic" 2 "jsysfunc" 33080 2
-"unix:tioclset" 2 "jsysfunc" 33117 2
-"unix:tioclget" 2 "jsysfunc" 33154 2
-"unix:tcseta" 2 "jsysfunc" 33190 3
-"unix:tcsets" 2 "jsysfunc" 33289 3
-"unix:tcsetsw" 2 "jsysfunc" 33380 3
-"unix:tcsetsf" 2 "jsysfunc" 33534 3
-"unix:tiocsetc" 2 "jsysfunc" 33750 2
-"unix:tcsetaf" 2 "jsysfunc" 33789 2
-"unix:tcsetaw" 2 "jsysfunc" 33828 2
-"unix:tcgeta" 2 "jsysfunc" 33866 2
-"unix:tcgets" 2 "jsysfunc" 33904 2
-"unix:tcgetattr" 2 "jsysfunc" 33945 2
-"unix:tcsetattr" 2 "jsysfunc" 33986 2
-"dbm-open" 2 "jsysfunc" 34646 3
-"dbm-store" 2 "jsysfunc" 35757 3
-"dbm-fetch" 2 "jsysfunc" 36071 3
-"cd" 2 "jsysfunc" 37850 3
-"ez" 2 "jsysfunc" 37952 3
-"piped-fork" 2 "jsysfunc" 38088 3
-"rusage" 2 "jsysfunc" 38239 3
-"load-foreign" 3 "jsysfunc" 46043 3
-"defforeign" 3 "jsysfunc" 49274 3
-"defun-c-callable" 3 "jsysfunc" 51575 3
-"pod-address" 2 "jsysfunc" 52850 3
-"array-entity" 3 "jsysfunc" 53177 3
-"float2double" 2 "jsysfunc" 53481 3
-"double2float" 2 "jsysfunc" 53719 3
+"sys:reclaim" 2 "jsysfunc" 8236 3
+"sys:reclaim-tree" 2 "jsysfunc" 8467 3
+"sys::bktrace" 2 "jsysfunc" 8602 3
+"sys:memory-report" 2 "jsysfunc" 8731 3
+"sys:room" 2 "jsysfunc" 8884 3
+"sys:address" 2 "jsysfunc" 8992 3
+"sys:peek" 2 "jsysfunc" 9178 3
+"sys:poke" 2 "jsysfunc" 10370 3
+"sys:list-all-chunks" 2 "jsysfunc" 10871 3
+"sys:object-size" 2 "jsysfunc" 11018 3
+"unix:ptimes" 2 "jsysfunc" 12527 3
+"unix:runtime" 2 "jsysfunc" 12820 3
+"unix:localtime" 2 "jsysfunc" 12953 3
+"unix:asctime" 2 "jsysfunc" 13418 3
+"unix:getpid" 2 "jsysfunc" 13710 3
+"unix:getppid" 2 "jsysfunc" 13806 3
+"unix:getpgrp" 2 "jsysfunc" 13880 3
+"unix:setpgrp" 2 "jsysfunc" 13957 3
+"unix:getuid" 2 "jsysfunc" 14042 3
+"unix:geteuid" 2 "jsysfunc" 14119 3
+"unix:getgid" 2 "jsysfunc" 14210 3
+"unix:getegid" 2 "jsysfunc" 14299 3
+"unix:setuid" 2 "jsysfunc" 14402 3
+"unix:setgid" 2 "jsysfunc" 14506 3
+"unix:fork" 2 "jsysfunc" 14621 3
+"unix:vfork" 2 "jsysfunc" 14944 3
+"unix:exec" 2 "jsysfunc" 15104 3
+"unix:wait" 2 "jsysfunc" 15190 3
+"unix::exit" 2 "jsysfunc" 15287 3
+"sys:*exit-hook*" 5 "jsysfunc" 15430 2
+"unix:getpriority" 2 "jsysfunc" 15534 3
+"unix:setpriority" 2 "jsysfunc" 15747 3
+"unix:getrusage" 2 "jsysfunc" 16481 3
+"unix:system" 2 "jsysfunc" 17633 3
+"unix:getenv" 2 "jsysfunc" 17814 3
+"unix:putenv" 2 "jsysfunc" 17896 3
+"unix:sleep" 2 "jsysfunc" 18094 3
+"unix:usleep" 2 "jsysfunc" 18194 3
+"unix:uread" 2 "jsysfunc" 18530 3
+"unix:write" 2 "jsysfunc" 19197 3
+"unix:fcntl" 2 "jsysfunc" 19421 2
+"unix:ioctl" 2 "jsysfunc" 19468 2
+"unix:ioctl_" 2 "jsysfunc" 19515 2
+"unix:ioctl_r" 2 "jsysfunc" 19566 2
+"unix:ioctl_w" 2 "jsysfunc" 19640 2
+"unix:ioctl_wr" 2 "jsysfunc" 19715 2
+"unix:uclose" 2 "jsysfunc" 19788 3
+"unix:dup" 2 "jsysfunc" 19878 3
+"unix:pipe" 2 "jsysfunc" 19993 3
+"unix:lseek" 2 "jsysfunc" 20102 3
+"unix:link" 2 "jsysfunc" 20268 3
+"unix:unlink" 2 "jsysfunc" 20333 3
+"unix:mknod" 2 "jsysfunc" 20518 3
+"unix:mkdir" 2 "jsysfunc" 20696 3
+"unix:access" 2 "jsysfunc" 20888 3
+"unix:stat" 2 "jsysfunc" 20982 3
+"unix:chdir" 2 "jsysfunc" 21537 3
+"unix:getwd" 2 "jsysfunc" 21627 3
+"unix:chmod" 2 "jsysfunc" 21694 3
+"unix:chown" 2 "jsysfunc" 21798 3
+"unix:isatty" 2 "jsysfunc" 21894 3
+"unix:msgget" 2 "jsysfunc" 22074 3
+"unix:msgsnd" 2 "jsysfunc" 22206 2
+"unix:msgrcv" 2 "jsysfunc" 22266 2
+"unix:socket" 2 "jsysfunc" 22321 3
+"unix:bind" 2 "jsysfunc" 22614 3
+"unix:connect" 2 "jsysfunc" 22837 3
+"unix:listen" 2 "jsysfunc" 22956 3
+"unix:accept" 2 "jsysfunc" 23150 3
+"unix:recvfrom" 2 "jsysfunc" 23320 3
+"unix:sendto" 2 "jsysfunc" 23890 3
+"unix:getservbyname" 2 "jsysfunc" 24397 3
+"unix:gethostbyname" 2 "jsysfunc" 24571 3
+"unix:syserrlist" 2 "jsysfunc" 24719 3
+"unix:signal" 2 "jsysfunc" 24914 3
+"unix:kill" 2 "jsysfunc" 25666 3
+"unix:pause" 2 "jsysfunc" 25776 3
+"unix:alarm" 2 "jsysfunc" 25888 3
+"unix:ualarm" 2 "jsysfunc" 26219 3
+"unix:getitimer" 2 "jsysfunc" 26507 3
+"unix:setitimer" 2 "jsysfunc" 26751 3
+"unix:select" 2 "jsysfunc" 27164 3
+"unix:select-read-fd" 2 "jsysfunc" 28288 3
+"unix:thr-self" 2 "jsysfunc" 29001 3
+"unix:thr-getprio" 2 "jsysfunc" 29099 3
+"unix:thr-setprio" 2 "jsysfunc" 29206 3
+"unix:thr-getconcurrency" 2 "jsysfunc" 29706 3
+"unix:thr-setconcurrency" 2 "jsysfunc" 29837 3
+"unix:thr-create" 2 "jsysfunc" 30602 3
+"unix:malloc" 2 "jsysfunc" 31072 3
+"unix:free" 2 "jsysfunc" 31167 3
+"unix:valloc" 2 "jsysfunc" 31276 2
+"unix:mmap" 2 "jsysfunc" 31306 2
+"unix:munmap" 2 "jsysfunc" 31376 2
+"unix:vadvise" 2 "jsysfunc" 31416 2
+"unix:tiocgetp" 2 "jsysfunc" 32398 3
+"unix:tiocsetp" 2 "jsysfunc" 32482 3
+"unix:tiocsetn" 2 "jsysfunc" 32560 2
+"unix:tiocgetd" 2 "jsysfunc" 32613 2
+"unix:tiocflush" 2 "jsysfunc" 32668 3
+"unix:tiocgpgrp" 2 "jsysfunc" 32745 3
+"unix:tiocspgrp" 2 "jsysfunc" 32832 3
+"unix:tiocoutq" 2 "jsysfunc" 32923 2
+"unix:fionread" 2 "jsysfunc" 32964 2
+"unix:tiocsetc" 2 "jsysfunc" 33005 2
+"unix:tioclbis" 2 "jsysfunc" 33042 2
+"unix:tioclbic" 2 "jsysfunc" 33079 2
+"unix:tioclset" 2 "jsysfunc" 33116 2
+"unix:tioclget" 2 "jsysfunc" 33153 2
+"unix:tcseta" 2 "jsysfunc" 33189 3
+"unix:tcsets" 2 "jsysfunc" 33288 3
+"unix:tcsetsw" 2 "jsysfunc" 33379 3
+"unix:tcsetsf" 2 "jsysfunc" 33533 3
+"unix:tiocsetc" 2 "jsysfunc" 33749 2
+"unix:tcsetaf" 2 "jsysfunc" 33788 2
+"unix:tcsetaw" 2 "jsysfunc" 33827 2
+"unix:tcgeta" 2 "jsysfunc" 33865 2
+"unix:tcgets" 2 "jsysfunc" 33903 2
+"unix:tcgetattr" 2 "jsysfunc" 33944 2
+"unix:tcsetattr" 2 "jsysfunc" 33985 2
+"dbm-open" 2 "jsysfunc" 34645 3
+"dbm-store" 2 "jsysfunc" 35756 3
+"dbm-fetch" 2 "jsysfunc" 36070 3
+"cd" 2 "jsysfunc" 37849 3
+"ez" 2 "jsysfunc" 37951 3
+"piped-fork" 2 "jsysfunc" 38087 3
+"rusage" 2 "jsysfunc" 38238 3
+"load-foreign" 3 "jsysfunc" 46042 3
+"defforeign" 3 "jsysfunc" 49273 3
+"defun-c-callable" 3 "jsysfunc" 51574 3
+"pod-address" 2 "jsysfunc" 52849 3
+"array-entity" 3 "jsysfunc" 53176 3
+"float2double" 2 "jsysfunc" 53480 3
+"double2float" 2 "jsysfunc" 53718 3
 "connect-vxw" 2 "jvxw" 3159 3
 "vxw" 2 "jvxw" 3910 3
 "defvxw" 3 "jvxw" 5715 3

doc/jlatex/jsysfunc.tex

@@ -20,7 +20,7 @@ \subsection{メモリ管理}
 拡張は、動作中に自動的に発生するかあるいはユーザーが{\bf system:alloc}関数を
 呼び出すことにより発生する。
 自動的に処理されるとき、使用可能なメモリサイズは合計のヒープサイズの
-約25\%に保つ。%by default,
+約40\%に保つ。%by default,
 この比率は、{\bf sys:*gc-margin*}パラメータに0.1から0.9までの値を設定
 することにより変更することができる。
 
@@ -38,7 +38,7 @@ \subsection{メモリ管理}
 したがって、Euslispは{\tt cons}の高速化のためにマージされないある特定の量の
 ヒープを残すことを許可している。
 この比率は、{\bf sys:*gc-merge*}パラメータによって決定される。その値のデフォルトは
-0.3である。
+0.2である。
 {\bf sys:*gc-merge*}に大きな値を設定することにより、マージされないヒープを多く残す。
 これは、{\tt cons}が要求されるとき、buddy-cellの分割が滅多に起こらないので、{\tt cons}の性能を改善する。
 これは、また3次元ベクトルのような相対的に小さなセルのアロケーションについて
@@ -117,7 +117,7 @@ \subsection{メモリ管理}
 メモリ管理用のパラメータ。
 {\bf *gc-merge*}は、GCによりマージされずに残すヒープメモリの比率を示す。
 このマージされない領域は、すぐに{\bf cons}のような小さなセルに満たされる。
-デフォルトの値は、0.3である。
+デフォルトの値は、0.2である。
 この値を0.4のように大きくすると、マージされない空きヒープが40\%であることを
 示し、consのためには役立つが、実数ベクトルやエッジや面などのような大きなセル
 の確保には、害を及ぼす。}
@@ -127,7 +127,7 @@ \subsection{メモリ管理}
 {\bf *gc-margin*}は、全体のヒープに対する空きヒープの比率を決定する。
 メモリは、UNIXから獲得したものであるため、空き空間はこの比率より
 小さくならない。
-デフォルトは、0.25であり、GCの際に25\%以上の
+デフォルトは、0.4であり、GCの際に40\%以上の
 空き空間が維持されることを意味する。}
 
 \funcdesc{sys:reclaim}{object}{