Describe design decisions and implementation reasons

[mnogu]

Moved from https://bugs.freedesktop.org/show_bug.cgi?id=639

YamaKen 2004-05-18 01:15:22 UTC

Describe design decisions and implementation reasons is required for developers
to answer "Why behaves so?" and to prevent corruption of implicit specification
on code rewriting.

Comment 1 YamaKen 2004-05-19 05:43:45 UTC

I have described a new function to follow the subject. I will continue so for a
week as a test drive.

/** Update custom value from property message.

• Update custom value from property message. All variable update is

• validated by custom APIs rather than arbitrary sexp

• evaluation. Custom symbol \a custom is quoted in sexp string to be

• restricted to accept symbol literal only. This prevents arbitrary

• sexp evaluation.
  */
  void
  uim_prop_update_custom(uim_context uc, const char *custom, const char *val)
  {
  if(!custom || !val)
  return;

  UIM_EVAL_FSTRING3(uc, "(prop-handler %d 'prop-update-custom '%s %s)",
  uc->id, custom, val);
  }