Yasumichi Akahoshi
yasum****@users*****
2005年 4月 18日 (月) 22:51:47 JST
Index: libcxp/src/cxp-about-dialog.c
diff -u libcxp/src/cxp-about-dialog.c:1.5 libcxp/src/cxp-about-dialog.c:1.6
--- libcxp/src/cxp-about-dialog.c:1.5 Mon Apr 18 03:03:18 2005
+++ libcxp/src/cxp-about-dialog.c Mon Apr 18 22:51:47 2005
@@ -1,4 +1,4 @@
-/* $Id: cxp-about-dialog.c,v 1.5 2005/04/17 18:03:18 yasumichi Exp $ */
+/* $Id: cxp-about-dialog.c,v 1.6 2005/04/18 13:51:47 yasumichi Exp $ */
/**
* \if japanese
* @file
@@ -6,7 +6,7 @@
*
* @author 赤星 柔充
* @date Sat Apr 9 2005
- * $Revision: 1.5 $
+ * $Revision: 1.6 $
* \endif
* \if english
* @file
@@ -14,7 +14,7 @@
*
* @author Yasumichi Akahoshi
* @date Sat Apr 9 2005
- * $Revision: 1.5 $
+ * $Revision: 1.6 $
* \endif
*/
@@ -51,6 +51,15 @@
gboolean dispose_has_run;
} CxpAboutDialogPrivate;
+/**
+ * \if japanese
+ * CxpAboutDialog型のインスタンスoに関連づけられたプライベートな構造体を得るための内部マクロです。
+ * \endif
+ * \if english
+ * It is an internal macro to obtain the private structure related to instance
+ * o of the CxpAboutDialog type.
+ * \endif
+ */
#define CXP_ABOUT_DIALOG_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), CXP_TYPE_ABOUT_DIALOG, CxpAboutDialogPrivate))
static GObjectClass *parent_class = NULL;
Index: libcxp/src/cxp-entry-dialog.c
diff -u libcxp/src/cxp-entry-dialog.c:1.7 libcxp/src/cxp-entry-dialog.c:1.8
--- libcxp/src/cxp-entry-dialog.c:1.7 Mon Apr 18 03:03:18 2005
+++ libcxp/src/cxp-entry-dialog.c Mon Apr 18 22:51:47 2005
@@ -1,4 +1,4 @@
-/* $Id: cxp-entry-dialog.c,v 1.7 2005/04/17 18:03:18 yasumichi Exp $ */
+/* $Id: cxp-entry-dialog.c,v 1.8 2005/04/18 13:51:47 yasumichi Exp $ */
/**
* \if japanese
* @file
@@ -6,7 +6,7 @@
*
* @author 赤星 柔充
* @date Sat Feb 12 2005
- * $Revision: 1.7 $
+ * $Revision: 1.8 $
* \endif
* \if english
* @file
@@ -14,7 +14,7 @@
*
* @author Yasumichi Akahoshi
* @date Sat Feb 12 2005
- * $Revision: 1.7 $
+ * $Revision: 1.8 $
* \endif
*/
@@ -50,6 +50,15 @@
gboolean dispose_has_run;
} CxpEntryDialogPrivate;
+/**
+ * \if japanese
+ * CxpEntryDialog型のインスタンスoに関連づけられたプライベートな構造体を得るための内部マクロです。
+ * \endif
+ * \if english
+ * It is an internal macro to obtain the private structure related to instance
+ * o of the CxpEntryDialog type.
+ * \endif
+ */
#define CXP_ENTRY_DIALOG_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), CXP_TYPE_ENTRY_DIALOG, CxpEntryDialogPrivate))
static GObjectClass *parent_class = NULL;
@@ -57,6 +66,14 @@
enum
{
+ /**
+ * \if japanese
+ * プロパティ『filename』の識別子
+ * \endif
+ * \if english
+ * Identifier of property 'filename'
+ * \endif
+ */
CXP_ENTRY_DIALOG_FILENAME = 1,
};
Index: libcxp/src/cxp-handler.c
diff -u libcxp/src/cxp-handler.c:1.11 libcxp/src/cxp-handler.c:1.12
--- libcxp/src/cxp-handler.c:1.11 Sun Apr 17 00:34:27 2005
+++ libcxp/src/cxp-handler.c Mon Apr 18 22:51:47 2005
@@ -1,4 +1,4 @@
-/* $Id: cxp-handler.c,v 1.11 2005/04/16 15:34:27 yasumichi Exp $ */
+/* $Id: cxp-handler.c,v 1.12 2005/04/18 13:51:47 yasumichi Exp $ */
/**
* \if japanese
* @file
@@ -6,7 +6,7 @@
*
* @author 赤星 柔充
* @date Tue Mar 29 2005
- * $Revision: 1.11 $
+ * $Revision: 1.12 $
* \endif
* \if english
* @file
@@ -14,7 +14,7 @@
*
* @author Yasumichi Akahoshi
* @date Tue Mar 29 2005
- * $Revision: 1.11 $
+ * $Revision: 1.12 $
* \endif
*/
@@ -54,11 +54,21 @@
gboolean dispose_has_run; /**< Is dispose funciton executed */
} CxpHandlerPrivate;
+/**
+ * \if japanese
+ * CxpHandler型のインスタンスoに関連づけられたプライベートな構造体を得るための内部マクロです。
+ * \endif
+ * \if english
+ * It is an internal macro to obtain the private structure related to instance
+ * o of the CxpHandler type.
+ * \endif
+ */
#define CXP_HANDLER_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), CXP_TYPE_HANDLER, CxpHandlerPrivate))
static GObjectClass *parent_class = NULL;
/*
+ * プライベートメッソドのプロトタイプ宣言
* Prototypes of privete methods
*/
static void cxp_handler_init (GTypeInstance * instance, gpointer g_class);
Index: libcxp/src/cxp-profile.c
diff -u libcxp/src/cxp-profile.c:1.11 libcxp/src/cxp-profile.c:1.12
--- libcxp/src/cxp-profile.c:1.11 Sun Apr 17 00:34:27 2005
+++ libcxp/src/cxp-profile.c Mon Apr 18 22:51:47 2005
@@ -1,4 +1,4 @@
-/* $Id: cxp-profile.c,v 1.11 2005/04/16 15:34:27 yasumichi Exp $ */
+/* $Id: cxp-profile.c,v 1.12 2005/04/18 13:51:47 yasumichi Exp $ */
/**
* \if japanese
* @file
@@ -6,7 +6,7 @@
*
* @author 赤星 柔充
* @date Fri Jan 21 16:34:46 2005
- * $Revision: 1.11 $
+ * $Revision: 1.12 $
* \endif
* \if english
* @file
@@ -14,7 +14,7 @@
*
* @author Yasumichi Akahoshi
* @date Fri Jan 21 2005
- * $Revision: 1.11 $
+ * $Revision: 1.12 $
* \endif
*/
@@ -78,6 +78,15 @@
gboolean dispose_has_run; /**< Is dispose funciton executed */
} CxpProfilePrivate;
+/**
+ * \if japanese
+ * CxpProfile型のインスタンスoに関連づけられたプライベートな構造体を得るための内部マクロです。
+ * \endif
+ * \if english
+ * It is an internal macro to obtain the private structure related to instance
+ * o of the CxpProfile type.
+ * \endif
+ */
#define CXP_PROFILE_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), CXP_TYPE_PROFILE, CxpProfilePrivate))
static GObjectClass *parent_class = NULL;
Index: libcxp/src/cxp-utils.c
diff -u libcxp/src/cxp-utils.c:1.8 libcxp/src/cxp-utils.c:1.9
--- libcxp/src/cxp-utils.c:1.8 Sun Apr 17 00:37:07 2005
+++ libcxp/src/cxp-utils.c Mon Apr 18 22:51:47 2005
@@ -1,4 +1,4 @@
-/* $Id: cxp-utils.c,v 1.8 2005/04/16 15:37:07 yasumichi Exp $ */
+/* $Id: cxp-utils.c,v 1.9 2005/04/18 13:51:47 yasumichi Exp $ */
/**
* \if japanese
* @file
@@ -6,7 +6,7 @@
*
* @author 赤星 柔充
* @date Fri Jan 21 2005
- * $Revision: 1.8 $
+ * $Revision: 1.9 $
* \endif
* \if english
* @file
@@ -14,7 +14,7 @@
*
* @author Yasumichi Akahoshi
* @date Fri Jan 21 2005
- * $Revision: 1.8 $
+ * $Revision: 1.9 $
* \endif
*/
@@ -46,8 +46,15 @@
static gchar *fname_filter = NULL;
/**
- * Use this function to set the directory containing installed pixmaps.
- * @param directory [in] Directory name which I search pixmap file from.
+ * \if japanese
+ * 画像ファイルを検索するディレクトリを追加します。Gladeが生成するサポート関数です。
+ * @param [in] directory 追加するディレクトリ名
+ * \endif
+ * \if english
+ * The directory that retrieves the picture file is added. It is a support
+ * function that Glade generates.
+ * @param [in] directory Directory Added directory name
+ * \endif
*/
void add_pixmap_directory (const gchar * directory)
{
@@ -56,9 +63,19 @@
}
/**
- * This is an internally used function to find pixmap files.
- * @param filename [in] Filename which you want to use.
- * @return Full path of filename found.
+ * \if japanese
+ * ファイル名からadd_pixmap_directoryで加えられたディレクトリを検索し、
+ * 見つかったファイルのパスを返します。Gladeが生成するサポート関数です。
+ * @param [in] filename 利用したい画像ファイルの名前
+ * @return 見つかったファイルのパス。見つからない場合は、NULL。
+ * \endif
+ * \if english
+ * The directory of the file name added with add_pixmap_directory is retrieved,
+ * and passing the found file is returned. It is a support function that Glade
+ * generates.
+ * @param [in] filename Name of picture file that wants to be used
+ * @return Passing of found file. NULL when not found.
+ * \endif
*/
static gchar *find_pixmap_file (const gchar * filename)
{
@@ -81,10 +98,18 @@
}
/**
+ * \if japanese
+ * 画像ファイルから、pixmapを作成する。
+ * @param [in] widget ウィジェットへのポインタ
+ * @param [in] filename 画像ファイルの名前
+ * @return 新たに作成したウィジェット
+ * \endif
+ * \if english
* This is an internally used function to create pixmaps.
* @param widget [in] Pointer to widget.
* @param filename [in] File name of pixmap.
* @return Pointer to new widget of pixmap.
+ * \endif
*/
GtkWidget *create_pixmap (GtkWidget * widget, const gchar * filename)
{
@@ -108,9 +133,15 @@
}
/**
- * This is an internally used function to create pixmaps.
- * @param filename [in] File name of Pixmap which you want to use.
- * @return An instance of GtkPixbuf.
+ * \if japanese
+ * メモリ上に画像を読み込む
+ * @param [in] filename 読み込みたい画像ファイル
+ * @return メモリ上の画像イメージ
+ * \endif
+ * \if english
+ * @param [in] filename Picture file that wants to read
+ * @return Image of image in memory
+ * \endif
*/
GdkPixbuf *create_pixbuf (const gchar * filename)
{
@@ -140,17 +171,47 @@
return pixbuf;
}
+/**
+ * \if japanese
+ * ファイル名をローケルでエンコードするための外部フィルタを設定します。
+ * @param [in] value 外部フィルタのコマンドライン
+ * \endif
+ * \if english
+ * An external filter to encode the file name with locale is set.
+ * @param [in] value Command line of external filter
+ * \endif
+ */
void cxp_utils_set_filename_filter (const gchar *value)
{
fname_filter = g_strdup (value);
}
+/**
+ * \if japanese
+ * ファイル名をローケルでエンコードするために外部フィルタを使う設定を解除します。
+ * \endif
+ * \if english
+ * The setting that uses an external filter to encode the file name with locale
+ * is released.
+ * \endif
+ */
void cxp_utils_free_filename_filter (void)
{
g_free (fname_filter);
}
/**
+ * \if japanese
+ * ファイル名の最後の構成要素をUTF-8でエンコードした文字列を取得します。もし、
+ * ファイル名の最後がディレクトリの区切り文字で終わっていた場合、得られるのは
+ * 最後のスラッシュの前の要素です。もし、ファイル名がディレクトリの区切り文字
+ * のみであったら、単一の区切り文字が返されます。もし、ファイル名が空であれば、
+ * "."が得られます。
+ * @param [in] file_name ファイル名
+ * @return 新たに確保されたファイル名の最後の構成要素でローケルからUTF-8へ変換
+ * された文字列です。
+ * \endif
+ * \if english
* Gets the last component of the filename converted to UTF-8. If file_name ends
* with a directory separator it gets the component before the last slash. If
* file_name consists only of directory separators (and on Windows, possibly a
@@ -159,6 +220,7 @@
* @param file_name the name of the file.
* @return a newly allocated string containing the last component of the
* filename converted from locale to UTF-8.
+ * \endif
*/
gchar *cxp_path_get_basename_of_utf8 (const gchar * file_name)
{
@@ -188,11 +250,20 @@
}
/**
+ * \if japanese
+ * ファイル名のディレクトリ部分をUTF-8に変換したものを取得します。もし、ファイル名
+ * がディレクトリ部分を含んでいなければ、"."が返されます。返された文字列は必要なく
+ * なり次第、解放してください。
+ * @param [in] file_name ファイル名
+ * @return ローケルからUTF-8に変換されたファイル名のディレクトリ部分
+ * \endif
+ * \if english
* Gets the directory components of a file name converted to UTF-8. If the file
* name has no directory components "." is returned. The returned string should
* be freed when no longer needed.
* @param file_name the name of the file.
* @return the directory components of the file converted from locale to UTF-8.
+ * \endif
*/
gchar *cxp_path_get_dirname_of_utf8 (const gchar * file_name)
{
@@ -208,9 +279,16 @@
}
/**
+ * \if japanese
+ * 日付と時刻を"2005/01/28 10:05:00"の様な文字列に変換します。
+ * @param [in] timep 日付時刻を表すtime_t型へのポインタ
+ * @return 新たに確保された変換後の文字列
+ * \endif
+ * \if english
* This function format date and time.
* @param timep pointer to time_t.
* @return newly alocate formatted string.
+ * \endif
*/
gchar *cxp_strftime (const time_t * timep)
{