Recent changes to Cross_Platform_Guide

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Wed, 02 May 2012 02:31:08 -0000

--- v10 
+++ v11 
@@ -2,7 +2,17 @@
 
 also see [Code_Style_Conventions]
 
-ANTz is a cross-platform application written in C99 and sometimes wrapped in C++ (MSW) or Cocoa (OSX).
+----
+Platforms:
+
+MSW - XP, W2K3, Vista, W7 (32 & 64bit)
+OSX - 10.5, 10.6 and 10.7
+Linux - CentOS, Red Hat, Fedora, Ubuntu, SUSE, Debian
+
+*BSD under consideration
+
+
+ANTz is a cross-platform application written in C99 and can be wrapped in C++ or Cocoa (OSX).
 
 This guide is intended to allow programmers to generate code on one platform that is easy to port to others. It is good to keep in mind that we plan to make ANTz into an API library that can be used by other apps.

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Sat, 31 Mar 2012 21:35:45 -0000

--- v9 
+++ v10 
@@ -1,4 +1,5 @@
-[Home]
+[Home] - also see: [Code_Style_Conventions] - hosted at [openANTz.com](http://openantz.com/)
+
 also see [Code_Style_Conventions]
 
 ANTz is a cross-platform application written in C99 and sometimes wrapped in C++ (MSW) or Cocoa (OSX).

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Wed, 28 Mar 2012 19:18:20 -0000

--- v8 
+++ v9 
@@ -1,3 +1,6 @@
+[Home]
+also see [Code_Style_Conventions]
+
 ANTz is a cross-platform application written in C99 and sometimes wrapped in C++ (MSW) or Cocoa (OSX).
 
 This guide is intended to allow programmers to generate code on one platform that is easy to port to others. It is good to keep in mind that we plan to make ANTz into an API library that can be used by other apps.

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Tue, 27 Mar 2012 00:56:09 -0000

--- v7 
+++ v8 
@@ -1,6 +1,6 @@
 ANTz is a cross-platform application written in C99 and sometimes wrapped in C++ (MSW) or Cocoa (OSX).
 
-This guide is intended to allow programmers to generate code on one platform that is easy to port to others. It is good to keep in mind that we plan to make ANTz and API library that can be used by other apps.
+This guide is intended to allow programmers to generate code on one platform that is easy to port to others. It is good to keep in mind that we plan to make ANTz into an API library that can be used by other apps.
 
 ANTz Conventions:
 - All platform specific code and libraries are isolated in the '\os\' folder. The files 'os/npos.h' and 'os/npos.c' serve as a re-direct for all OS specific methods.  The actual OS specific code resides in a sub-folder for that OS, such as 'os/msw/npmsw.h' which is also where the actual OS specific libraries are included, for example 'windows.h'.

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Tue, 27 Mar 2012 00:55:40 -0000

--- v6 
+++ v7 
@@ -1,6 +1,6 @@
 ANTz is a cross-platform application written in C99 and sometimes wrapped in C++ (MSW) or Cocoa (OSX).
 
-This guide is intended to allow programmers to generate code on one platform that is easy to port to others.
+This guide is intended to allow programmers to generate code on one platform that is easy to port to others. It is good to keep in mind that we plan to make ANTz and API library that can be used by other apps.
 
 ANTz Conventions:
 - All platform specific code and libraries are isolated in the '\os\' folder. The files 'os/npos.h' and 'os/npos.c' serve as a re-direct for all OS specific methods.  The actual OS specific code resides in a sub-folder for that OS, such as 'os/msw/npmsw.h' which is also where the actual OS specific libraries are included, for example 'windows.h'.

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Tue, 27 Mar 2012 00:54:04 -0000

--- v5 
+++ v6 
@@ -3,11 +3,11 @@
 This guide is intended to allow programmers to generate code on one platform that is easy to port to others.
 
 ANTz Conventions:
-- all platform specific code and libraries are isolated in the '\os\' folder. The files 'os/npos.h' and 'os/npos.c' serve as a re-direct for all OS specific methods.  The actual OS specific code resides in a sub-folder for that OS, such as 'os/msw/npmsw.h' which is also where the actual OS specific libraries are included, for example 'windows.h'.
-

-- be aware that when adding any platform specific functionality it needs to be implemented across all platforms. So either write the other OS methods at the same time or get someone else to do it. Otherwise the code will not be included.
-

-- sometimes there is no cross-platform method possible for a desired functionality. In this case an exception might be made, however there has to be a very good reason, (such as the infinite z, though they intend to make there library cross-platform in the future.) Another such exception is video codecs, on OSX we will likely use QuickTime, on MSW and Linux we plan to use VLC (which does not really work on OSX.)
+- All platform specific code and libraries are isolated in the '\os\' folder. The files 'os/npos.h' and 'os/npos.c' serve as a re-direct for all OS specific methods.  The actual OS specific code resides in a sub-folder for that OS, such as 'os/msw/npmsw.h' which is also where the actual OS specific libraries are included, for example 'windows.h'.
+

+- Be aware that when adding any platform specific functionality it needs to be implemented across all platforms. So either write the other OS methods at the same time or get someone else to do it. Otherwise the code will not be included.
+

+- Sometimes there is no cross-platform method possible for a desired functionality. In this case the additional functionality should likely be made into a plugin using a .DLL(MSW) or .RO (OSX and Linux). An exception is video codecs, on OSX we will likely use QuickTime, on MSW and Linux we plan to use VLC, (which does not work for OSX.) In some cases a special code branch is made, (different version of ANTz,) However there has to be a very good reason, such as support for the infinite z, (they intend to make their library cross-platform in the future.) Either way the IZ system will likely be made into a plugin at a future date.
 
 Issues:

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Tue, 27 Mar 2012 00:45:59 -0000

--- v4 
+++ v5 
@@ -1,4 +1,4 @@
-ANTz is a cross-platform application written in C and sometimes wrapped in C++ (MSW) or Cocoa (OSX)
+ANTz is a cross-platform application written in C99 and sometimes wrapped in C++ (MSW) or Cocoa (OSX).
 
 This guide is intended to allow programmers to generate code on one platform that is easy to port to others.

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Tue, 27 Mar 2012 00:38:36 -0000

--- v3 
+++ v4 
@@ -30,3 +30,6 @@
 - watch out when doing any bitwise or bytewise operations.
 - be-aware of byte orders in communicating with other machines.
 
+Global Variables
+- rather then use globals, it is preferred to store global-like variables in the main data structure, (data->...myVariable).
+- however, temporary use of globals to aid short-term development is okay, just do not initialize them when declared, as this has caused problems. Instead use one of the startup Init...() functions to initialize global variables.

WikiPage Cross_Platform_Guide modified by Shane Saxon

Shane Saxon — Sun, 25 Mar 2012 22:32:31 -0000

WikiPage Cross Platform Guide modified by Shane Saxon

Shane Saxon — Sat, 24 Mar 2012 19:52:39 -0000

--- v1 
+++ v2 
@@ -2,24 +2,31 @@
 
 This guide is intended to allow programmers to generate code on one platform that is easy to port to others.
 
+ANTz Conventions:
+- all platform specific code and libraries are isolated in the '\os\' folder. The files 'os/npos.h' and 'os/npos.c' serve as a re-direct for all OS specific methods.  The actual OS specific code resides in a sub-folder for that OS, such as 'os/msw/npmsw.h' which is also where the actual OS specific libraries are included, for example 'windows.h'.
+

+- be aware that when adding any platform specific functionality it needs to be implemented across all platforms. So either write the other OS methods at the same time or get someone else to do it. Otherwise the code will not be included.
+

+- sometimes there is no cross-platform method possible for a desired functionality. In this case an exception might be made, however there has to be a very good reason, (such as the infinite z, though they intend to make there library cross-platform in the future.) Another such exception is video codecs, on OSX we will likely use QuickTime, on MSW and Linux we plan to use VLC (which does not really work on OSX.)
+
 Issues:
 
 Line Endings - CRLF(MSW), CR(OSX), LF(Linux)
 - CSV files need to be tolerant to all of the above.
 - Code files (.c and .h etc...) need an extra blank line return at end of file.
 
 File Path - '\'(MSW) vs '/'(OSX, Linux)
 - file path routines need to be OS aware and use appropriate slashes.
+- header include statements should always use a forward slash ("../io/npgl.h") as this works under all OS compilers (MSW, OSX, Linux.)
 
 Visual Studio - is far too tolerant of bad code...
 - watch out for 'warning' followed by 'assuming' resulting from missing function declarations usually a headers issue.
 
 Xcode - also too tolerant of non-C code...
 - allows C++ behavior in C files... avoid this.
 - declare all variables at the top of the function before any logic statements.
 
 BIG ENDIAN vs little endian
 - watch out when doing any bitwise or bytewise operations.
 - be-aware of byte orders in communicating with other machines.
-