Better log messages, small user-visible info fixes

include/libpst-types.h

@@ -22,7 +22,7 @@ typedef enum {
     IS_PUBLIC       = 0x00000040,   ///< public member of class
 } pst_fun_flags;
 
-
+/// @brief information about function
 typedef struct {
     char*           name;   ///< demangled name of the function. NULL if function name resolution failed
     char*           file;   ///< file name where the function is defined. NULL if library failed to get file name
@@ -70,6 +70,7 @@ typedef enum {
     PARAM_TYPE_FUNCPTR  = 0x04000000,   ///< pointer to function
 } pst_param_flags;
 
+/// @brief information about parameter
 typedef struct {
     char*           name;           ///< parameter's name
     char*           type_name;      ///< name of parameter's type

include/libpst.h

@@ -84,9 +84,10 @@ const pst_function_info* pst_get_function_info(pst_function* function);
 int pst_get_register(pst_function* function, int regno, unw_word_t* val);
 
 /**
- * @brief Check memory range of process to validity (i.e. that process has access to this range)
+ * @brief Check memory range of process for validity (i.e. that process has access to this range)
  * @param p pointer to start of range
  * @param size size of range to check
+ * @return zero if range of memory pointed by 'p' is valid
  */
 int pst_pointer_valid(void *p, uint32_t size);