[Subject Prev][Subject Next][Thread Prev][Thread Next][Subject Index][Thread Index]

[OSASK 2155] Re: マニュアルの改善の要望



光成です。
>  もし光成さんが書いてくだされば、僕はこちらのページでのダウンロ
>ードできるようにしたいと思っています。

ためしに書き始めてみましたが、私には無理でした。
少なくとも私には今のguigui00の仕様を簡潔に説明できるほど読み込む時間と
能力がありません。

以下は単なる私の感想ですが、今のguigui00のAPIはあまりにOS内部に
直結していて複雑すぎて使いにくいです。
一般プログラミングユーザ向けに機能を絞った簡易APIを提供すべきでは
ないでしょうか。
#もしかしたらこれはだれかにやって欲しいと仰るかもしれませんね。
#できればやりたいですけど残念ながらちょっと私には出来そうにないです。

また少なくとも各種定数はマクロ定義すべきだと思います。
そうでないと突然引数に0x32を指定してくださいと言われても困りますし
毎回マニュアルを見ないととても記述できません。

もしかしたら「そのためのintroシリーズだ」と仰るかもしれませんが、
数十行に及ぶ説明がないと使い方の分からないAPIはその仕様を見直すべきだ
と思われませんか?
#単に私の理解能力が足りないだけかもしれないけど...

以下は書いてる最中にダウンしたapi.txtです。
役に立てなくて申し訳ない。m(__)m

begin 666 api.lzh
M(`LM;&@V+2T*``"A)```H@0P*R`!!T%022Y46%2AC$T```<$<[WNC;:OWFD2
MGO[>*MQ32=TFLUV+DMK-8M%:I,;4UIM"2N2.NM5UN$?2QRX$B?<+:-V-MQR.
M.HQ:%@+"'555D%MU5+BE+(JZN8D)582R*K0J-I*D)/>'(66\'WW__W=W-RSH
MW9)M+"T%; !Atmark! `$L? !Atmark! (>(2/*"R$"6WG`/./\/>U;;;<]75?>_S_*NNJJFNJ^\J(
M?)"?' !Atmark! !R*CO"\.\ !Atmark! /;Q!\]NKF[ !Atmark! /T[Z`^W%\[^:XJJFH'[04T'K]-""^ !Atmark! )UE
M145U6 !Atmark! IME(JETH\Q^C%\Y`AQH%(7,"1O<B>V;V.?D$;_#JJF5T0S)+X0T.>'
M&JJF1U,CU!^BY,#*C8$G,#C!RU'BD,?#:AE+I$(-A;'#_1(QP5D?8Q.8/VJ"
M,Z'A((PDD5OQ"N0<"&"0`R1&%8WN8[R1C^-O7-54^&2#D@O]6BJ;138J8RFY
M832>I:87F*;Q3&#D!FH9S6X%Z[?P8%^_O$[YU=[K0:]HM=[;0-5`:3.B-*`3
MA9W7HHA]D/81A6%FB"L3H@JE8@KC^:(;E!]4/O!SA]W-$O;!2R,8MB+I7@^?
MEDC !Atmark! 9<>\E<(6X<\,D/2#+^%L\,4"OQ_F(,"4.)[</E$KO7B[>OWJ9-5 !Atmark! IWU_
M=IH;.TV%SM;;R-DA5X$"^W1-;=/L!U !Atmark! P4$>ZU=HXR]_+O2-^+;!-E;(/3Q.<
M'X2B8C9%)KYR+_=A9.0.XZ:H[4V8P8O%/-)_:FV"?C6Z[%VF#;38[;:;"VVR
M%6O$,F[A)W4"$3+2A]@7I3ME^"R4\JB$"^0-_"1YXR!EA6L7":+3S`-T,;%W
M`?0+Y@#Q\#$>R+-D!A7,%[O7;)M;4%6'P@5Q?S!PP^TX'U*"X*U4N)/CX?0<
MLD7!_418]WJD5`?PZ'7L"#V2/%X\?J@K"B\R5M7`MS&9G0(F#[Y$P?=(E"+&
MTM?%MMJA5H8#U_>0,`]7*0[:?HK:>+1/MWN75]!=IMN5A(V5$'*1ZY(,[#OM
M"0YDY,J1:>*Q)`<'"<VMLV5QXWTAFFQ0X !Atmark! 98N`&3*7O")[#AEW,A.A\+7'8>
MA'NTK$_RJJG"]`8D&*[R`*D1SHBM2(4N!^+Q3?'COI3"L1$$1B\!X=T-?X2#
MC.::MZ*Y#7(=Z@DBY(,/"\(TD<:%[RY'P6?HPDS*0X?6Q^@"NC,K[Z2B70G:
MYJL-FE5<<1^'+PQ^!AD)T;UPS(_TQK.]8,V7;R<PR:-G69(=BA;2U+-UGR?M
MAZ+-;9=1DF5&B6V_>2DQ#%>TJ#* !Atmark! A-//2$\U\C*$<S</GQ+9#.9&&7C<4./2
M85OW@3`G!TAJKBC)56<+T(CR3]8KDIXX#0(60DB<IY0H8[4^@S"BIY9\$067
MY !Atmark! B)4YMVZW3M89<.0F !Atmark! +,E/.&XS\IK!JSQ]I.S4:%I,!.)6"<80EF,.?*MRP
MFOBKT4;ZC==Y>AFO7=/0ZS[A2P(O17;K?MX]:U@T<":L-_258A6UM;GAD*YO
M#AI4^6H;(?"E<!NG8T+X)"]1H"\>[I"_9I.M4D]-F(^I(.:,8]P,'%J$Z5PB
MAZH!L; !Atmark! !S8V0$R/`&6< !Atmark! \.4.2'P1Q)S8EYL/"?'\^-]3%X`?E6O\G*3)$F2N
M:''#V"F4#+Q?N#+?Y(XH5`!ZC(#_[`Y;K5>)Y-E:6BU:^!+G4L52]OTQA$>O
MWER8+SLK5C`W*"AK`LH0.E*`O"88TJRK>-Z.'T)-^X-=5\'L7Y*$$^H0<'WB
M#3P_F,,#L7I5KJ[1[9PRB/0G219N$<+;I:UM):.'QI2M$HZ%6*+U#2F2_9TH
MX$*.4<E% !Atmark! C5`Z0KT83)"Q\L>\"9OMF5,J/UHOGA.BY6)U0FC=Y*PSRS,KF$%
M#7TT8<M9;O]96(:RW3U@3\>SC<4^>=V+)L^'O1L:YLGD!DD6#%:>(?SAK:\\
M8TS"]*XEVK>=*SZR`T[*GPR0GH03\/K2<R-P8G1'ZQ"HC"T#DMR-8#IZG!>O
M'[I\F]W;O1D9-5![\V:9"LVZLYAR\P-2#, !Atmark! 9^[ !Atmark! L$RF!W[\B0[O#!A(4B:.!
M!$:UM@EJA*1@FPKQ";&PU0FO((L>^$(\#6]S4_\PPIX)C(;^4?F#BQU]Q85Z
M$JZ8:L>LW+_(<Q%`C6'1<H$3_)%J$Y*5=%(RA3#D60YPEK]?8).5A1&MUI"S
M.2IW[,-4CI#"L4CG+C<&+'<4GJN0F9'K1(`=,X$Y+<Q-$8L*M01G4R3T(_YQ
MD2](/NC(I/'<O^O0/=FUBR>J,BTQ;9+6)N-<]LOK1^?VD`LE/GB;O*4ME'I9
ML&A@\T>#0)DE]I<&6QI$I62+AC&T6,)`KGN0DEE[&97/%E?1#+IR]B^N8+:B
MRU>(/[S1X@7IC?!ZQG`9)<0F;)\G+$Y=`Q5VU4BBK_RR5T^8=_R\LVW,T2V@
MV^\=[AZ-`PR[)7J.E>+U:)8D)U?OD[EU!(C(Y]%8=7#](BDN(MIHJ;$HS[O2
M^3KG$6OK-5)#K#\$#!<,YUXE1 !Atmark! 5-ZOU\-/\;V%2G/,]R?2>\.E29-^U9-&J"
M:R<E7]G.W[+G__V-M5ZNBZ=K@$J]FJ%BVT/V1">D5ZR+'*ITX;:1_2N!8-'[
M$Y47I+GCNUL_CK8EF'8P[:6^U(9*<,%'B/$J<+O;A:[4V-)SF4:0XMXQ>LFJ
MRGY:Z2]:#*-DSY+<$/^+B":GC"ACQ? !Atmark! (9.9OMO2:L^ !Atmark! .KS<#TG9<#;3FZ%FR
M6G-<34EC+H32D$/G;]8'-:\SD1RC(B;/ !Atmark! 7],C'.03([5DBU1G&93<"U*X#U1
M)GSC<:E<=QWNNA+\=$"LGQY%FPFC#%&-Q1?TS1^O#2L;K!3=K<@+_VL,M@\C
M@1<`W1JY++*EWK$W8)N+^"'P0^^'%[+WD=*3E&%KC]42DX9903)O$M=DN;7/
MO2IK`/[92?]X4F?QE:K/A&$SR!_>Y#+9C',TK3DMH<<WI26MX"C/-S$RYM#:
M<FZSL:S.C[\O3[+QF6;/E(H=G!`W?7!*9*NG4%W49Z4F9'W>I[HI4X649RS*
MN1R<$A1K9HIOB4)=)]'G;#G9P2(M!LUKDR9L3Z(9F-D#(P4X"QM+L(L^FPYK
M-"0P<6-GE3VVQ+;W!Z#4?UHOX@G;A^F/$HW:-:G"3</2[FV[11K7V]W+F-\F
M/3S?VWUL<L;K$!X+8NN0#J#GQ%G]4>",_UP$_[.`?_?829X!&G(&7`$T)'O@
MU.5DUF1LB-S(_5CVDODZ7<1_YHFZFR\2T,<V4=B"W95-2OC90@K3KK$IGCQS
M]',SV%E6P1-.BV[/UWVII)7SLN<W6'3=&OI<TLVALCU\:84@P<A>[6PY\Y4/
MT:!A4I,F>M:5:9*L-#\;(W1#Q%,(T]?&&[!S8^'+X"SR5AJ8/?H'Y!)@AS)?
M$#\:UOXNG[5#*]TJ\D/3/_AFV,L1;<;8$9F@M&1D8_M!-D[`P=ELW=%F=H,J
M:M_AU,Y`C,GFY'3$>T=X<S\RI+5^ML<+;]\CX%BA)]K&A%ZOBBK58J3JE)W(
>S<3U.QKCT-Z9'3WIOX[T?[ !Atmark! M+^`77_R_PB.I0D``
`
end