X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=libchimara%2Fchimara-if.h;h=deda6474e8e893f85645ee66f603ff2a31326a08;hb=c6e78c57fc1b323ec055bfe48c7430515be27d1c;hp=006829206867586dc859eb68d96050b80a3fcf7d;hpb=92895be4421d350eb674093c1789d8703c2d8f94;p=rodin%2Fchimara.git

diff --git a/libchimara/chimara-if.h b/libchimara/chimara-if.h
index 0068292..deda647 100644
--- a/libchimara/chimara-if.h
+++ b/libchimara/chimara-if.h
@@ -13,26 +13,71 @@ G_BEGIN_DECLS
 #define CHIMARA_IS_IF_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), CHIMARA_TYPE_IF))
 #define CHIMARA_IF_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj), CHIMARA_TYPE_IF, ChimaraIFClass))
 
+/**
+ * ChimaraIFFormat:
+ * @CHIMARA_IF_FORMAT_Z5: Z-code version 5
+ * @CHIMARA_IF_FORMAT_Z6: Z-code version 6
+ * @CHIMARA_IF_FORMAT_Z8: Z-code version 8
+ * @CHIMARA_IF_FORMAT_Z_BLORB: Blorbed Z-code
+ * @CHIMARA_IF_FORMAT_GLULX: Glulx
+ * @CHIMARA_IF_FORMAT_GLULX_BLORB: Blorbed Glulx
+ *
+ * Constants representing all game formats supported by the Chimara system.
+ */
 typedef enum _ChimaraIFFormat {
+	/*< private >*/
 	CHIMARA_IF_FORMAT_NONE = -1,
+	/*< public >*/
 	CHIMARA_IF_FORMAT_Z5,
 	CHIMARA_IF_FORMAT_Z6,
 	CHIMARA_IF_FORMAT_Z8,
 	CHIMARA_IF_FORMAT_Z_BLORB,
 	CHIMARA_IF_FORMAT_GLULX,
 	CHIMARA_IF_FORMAT_GLULX_BLORB,
+	/*< private >*/
 	CHIMARA_IF_NUM_FORMATS
 } ChimaraIFFormat;
 
+/**
+ * ChimaraIFInterpreter:
+ * @CHIMARA_IF_INTERPRETER_FROTZ: Frotz
+ * @CHIMARA_IF_INTERPRETER_NITFOL: Nitfol
+ * @CHIMARA_IF_INTERPRETER_GLULXE: Glulxe
+ * @CHIMARA_IF_INTERPRETER_GIT: Git
+ * 
+ * Constants representing the available interpreter plugins.
+ */
 typedef enum _ChimaraIFInterpreter {
+    /*< private >*/
 	CHIMARA_IF_INTERPRETER_NONE = -1,
+	/*< public >*/
 	CHIMARA_IF_INTERPRETER_FROTZ,
 	CHIMARA_IF_INTERPRETER_NITFOL,
 	CHIMARA_IF_INTERPRETER_GLULXE,
 	CHIMARA_IF_INTERPRETER_GIT,
+	/*< private >*/
 	CHIMARA_IF_NUM_INTERPRETERS
 } ChimaraIFInterpreter;
 
+/**
+ * ChimaraIFZmachineVersion:
+ * @CHIMARA_IF_ZMACHINE_DEFAULT: Use the interpreter's default interpreter
+ * number.
+ * @CHIMARA_IF_ZMACHINE_DECSYSTEM_20: DEC System 20
+ * @CHIMARA_IF_ZMACHINE_APPLE_IIE: Apple IIe
+ * @CHIMARA_IF_ZMACHINE_MACINTOSH: Apple Macintosh
+ * @CHIMARA_IF_ZMACHINE_AMIGA: Commodore Amiga
+ * @CHIMARA_IF_ZMACHINE_ATARI_ST: Atari ST
+ * @CHIMARA_IF_ZMACHINE_IBM_PC: IBM PC
+ * @CHIMARA_IF_ZMACHINE_COMMODORE_128: Commodore 128
+ * @CHIMARA_IF_ZMACHINE_COMMODORE_64: Commodore 64
+ * @CHIMARA_IF_ZMACHINE_APPLE_IIC: Apple IIc
+ * @CHIMARA_IF_ZMACHINE_APPLE_IIGS: Apple IIgs
+ * @CHIMARA_IF_ZMACHINE_TANDY_COLOR: Tandy Color Computer
+ * 
+ * Allowed values for the #ChimaraIF:interpreter-number property. All trademarks
+ * are the property of their respective owners.
+ */
 typedef enum _ChimaraIFZmachineVersion {
 	CHIMARA_IF_ZMACHINE_DEFAULT = 0,
 	CHIMARA_IF_ZMACHINE_DECSYSTEM_20,
@@ -46,11 +91,19 @@ typedef enum _ChimaraIFZmachineVersion {
 	CHIMARA_IF_ZMACHINE_APPLE_IIC,
 	CHIMARA_IF_ZMACHINE_APPLE_IIGS,
 	CHIMARA_IF_ZMACHINE_TANDY_COLOR,
+	/*< private >*/
 	CHIMARA_IF_ZMACHINE_MAXVAL = CHIMARA_IF_ZMACHINE_TANDY_COLOR
 } ChimaraIFZmachineVersion;
 
+/**
+ * ChimaraIF:
+ * 
+ * This structure contains no public members.
+ */
 typedef struct _ChimaraIF {
 	ChimaraGlk parent_instance;
+	
+	/*< public >*/
 } ChimaraIF;
 
 typedef struct _ChimaraIFClass {