view PROGRAMMING_NOTES @ 6351:ffb1b5003772

[gaim-migrate @ 6850] Bjoern Voigt writes: "I've prepared a new German translation. The patch i18n17.patch contains: - Updated German translation - added src/protocols/irc/{cmds.c,msgs.c,parse.c} to po/POTFILES.in - ngettext-support for src/protocols/irc/msgs.c (IRC idle times) I also found a number of bugs in src/gaim-remote.c. The patch gaim-remote1.patch contains: - parameter processing fix in gaim-remote (gaim-remote no longer segfaults on "gaim-remote uri") - gaim-remote now has correct error messages and return codes, if connection to gaim fails (gaim-remote is not longer silent, if gaim-remote uri 'aim:goim?screenname=Penguin&message=hello+world' failes, because gaim is not running) I also have a feature request for gaim-remote: "I want to have two commands in gaim-remote: - connect list|all: connects all specified accounts with auto-login - disconnect list|all: disconnects all specified accounts The commands will be especially useful for users with dialup connections. They could include gaim-remote in /etc/ppp/{ip-up,ip-down}. The auto-reconnection plugin doesn't solve the dialup-problem, because it generates to much error message windows over the time." Where can I place such a feature-request?" hhmm. that feature-request looks pretty placed ;-) committer: Tailor Script <[e-mail]>

Notes on keeping GAIM OS independant
------------------------------------

General
-------
- Use G_DIR_SEPARATOR_S and G_DIR_SEPARATOR for paths

- Use g_getenv, g_snprintf, g_vsnprintf

- Use gaim_home_dir instead of g_get_home_dir or g_getenv("HOME")

- Make sure when including win32dep.h that it is the last header to
  be included.

- Open binary files when reading or writing with 'b' mode.

  e.g: fopen("somefile", "wb");

  Not doing so will open files in windows using defaut translation mode. 
  i.e. newline -> <CR><LF>

Paths
-----

- DATADIR, LOCALEDIR & LIBDIR are defined in wingaim as functions.
  Doing the following will therefore break the windows build:

  printf("File in DATADIR is: %s\n", DATADIR G_DIR_SEPARATOR_S "pic.png");

  it should be:

  printf("File in DATADIR is: %s%s%s\n", DATADIR, G_DIR_SEPARATOR_S, "pic.png");

- When writing out paths to .gaimrc, use wgaim_escape_dirsep. This is necessary
  because the Windows dir separator '\' is being used to escape characters, when
  paths are read in from the .gaimrc file.

PLUGINS & PROTOS
----------------

- G_MODULE_EXPORT all functions which are to be accessed from outside the
  scope of its "dll" or "so". (E.G. gaim_plugin_init)

- G_MODULE_IMPORT all global variables which are located outside your
  dynamic library. (E.G. connections)

  (Not doing this will cause "Memory Access Violations" in Win32)