view PROGRAMMING_NOTES @ 9180:c16b81557679

[gaim-migrate @ 9975] "I saw, that someone has detected the misspelled word [commmand] with 3 m's in src/gaim-remote.c and corrected it already: $ cvs diff -u -r 1.16 -r 1.17 src/gaim-remote.c Index: src/gaim-remote.c =================================================================== RCS file: /cvsroot/gaim/gaim/src/gaim-remote.c,v retrieving revision 1.16 retrieving revision 1.17 diff -u -3 -p -u -r1.16 -r1.17 --- src/gaim-remote.c 20 Apr 2004 22:39:38 -0000 1.16 +++ src/gaim-remote.c 27 May 2004 04:09:14 -0000 1.17 @@ -69,7 +69,7 @@ void show_remote_usage(char *name) " quit Close running copy of Gaim\n\n" " OPTIONS:\n" - " -h, --help [commmand] Show help for command\n"), name); + " -h, --help [command] Show help for command\n"), name); message(text,1); g_free(text); Unfortunately this breaks the string freeze. Especially the 0.78 translations already commited are affected. Because there is no much time for the translators to re-translate, I suggest the following patch (i18n61.patch). i18n61.patch contains: ---------------------- - replaces [commmand] with [command] in all msgid's - replaces only msgid's with translated msgstr's - replaces wrong translated msgstr's (commmand with 3 m's) in en_GB,fr and zh_TW " -- Bjoern Voigt 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)