Re: glib.sgml

[Yusuke NOGUCHI <noguchi@xxxxxxxxxxxxxxxxxxxxxxxxx>]

野口@九大です。

初め〜よく使われるマクロ までで、気になる部分を挙げてみました。

全体を通して、 `type' -> `タイプ' とされていらっしゃるようですが、「型」
とされた方が良いのではないかと思います。

(ex.)
glib's fundamental type definitions = glib の基本的な型定義

-----
glib is a C portability and utility library for UNIX-like systems and
Windows.  

4  glib は、UNIXシステム互換機及びウインドウズ上で Cの移植性ある
   実用的ライブラリです。

glib は UNIX 互換システム及び Windows のための、移植性と実用性に優れた
C ライブラリです。
-----

-----
glib is simple, and the concepts are familiar;

7  glib は単純で、概念的にもよく知られています。

glib は単純で、その概念はありふれたものです。
-----


-----
glib has a single header file, <filename role="header">glib.h</filename>.

21      glib には、シングルヘッダファイル <filename role="header">glib.h</filename>
22      が存在します。

glib は、ヘッダーファイルを1つだけ(<filename
role="header">glib.h</filename>)持ちます。
-----


-----
This section describes glib's fundamental type definitions, macros,
memory allocation routines, and string utility functions.

29        この章では、glibの
30        基礎的なタイプ定義、マクロ、メモリ割り当てルーチン、ユーティリティ関数の配列
31        について解説します。

この章は、glib の基本的な型定義、マクロ、記憶割当てルーチンそして文字
列処理関数について解説します。
-----

-----
<structname role="C">guint</structname> is simply easier to type than
<structname role="C">unsigned</structname>.

42          <structname role="C">guint</structname> は、単純ですが <structname
43          role="C">unsigned</structname> よりタイプにするのが容易です。

<structname role="C">guint</structname> は、単に <structname
role="C">unsigned</structname> よりも入力を簡単にするためのものです。
-----

-----
if a  platform has them, glib will define <function
role="macro">G_HAVE_GINT64</function>.  (If it isn'tobvious, the
<structname role="C">guint</structname> types are unsigned, the
<structname role="C">gint</structname> types are signed.) 

63              つまりプラットフォームが、それらを必要とするならば、
64              glib は、<function role="macro">G_HAVE_GINT64</function> を定義
65              しなければなりません。(簡単にいうと、
66              <structname role="C">guint</structname> タイプは unsigned で、
67              <structname role="C">gint</structname>タイプは signed です。)

もし、あるプラットフォームがそれら(64bit 整数値)をサポートする場合には、
glib は、<function role="macro">G_HAVE_GINT64</function> を定義するで
しょう。(それがはっきりしない場合には、<structname
role="C">guint</structname>型は符合無しで、<structname
role="C">gint</structname> 型は符合付きとなります。)
-----


-----
<function role="macro">MIN()</function>/<function
role="macro">MAX()</function> return the smaller or larger of their
arguments. 

   106          <function role="macro">MIN()</function>/<function role="macro">MAX()
   107          </function> は、その引数の中で最小値及び最大値を返します。
 
<function role="macro">MIN()</function>/<function
role="macro">MAX</function>は、引数の小さい方の値もしくは大きい方の値
を返します。
-----