Added comments

2 files changed, 13 insertions, 0 deletions

diff --git a/atari/misc.c b/atari/misc.c
index 2a22e166c..2893bde5f 100755
--- a/atari/misc.c
+++ b/atari/misc.c
@@ -330,6 +330,13 @@ void gem_set_cursor( MFORM_EX * cursor )
 	flags = cursor->flags;

 }
 
+/**
+ * Convert NKC (atari normalized key code) to netsurf
+ * Input key code and/or to ucs4 (depends on keycode).
+ * When the input key can not be found for the NKC,
+ * the function will return 0 and fill ucs4_out with
+ * the NKC converted to UC4 encoding.
+*/
 long nkc_to_input_key(short nkc, long * ucs4_out)
 {
 	unsigned char ascii = (nkc & 0xFF);

diff --git a/atari/misc.h b/atari/misc.h
index f533f483f..948b22526 100755
--- a/atari/misc.h
+++ b/atari/misc.h
@@ -57,7 +57,13 @@ hlcache_handle *load_icon( const char *name, hlcache_handle_callback cb,
 void dbg_grect(const char * str, GRECT * r);
 void dbg_pxy(const char * str, short * pxy);
 void dbg_rect(const char * str, int * pxy);
+
 const char * file_select( const char * title, const char * name );
+
+/**
+ * Convert NKC (atari normalized key code) to netsurf
+ * Input key code and/or to ucs4 (depends on keycode).
+*/
 long nkc_to_input_key(short nkc, long * ucs4_out);
 
 #endif