X-Git-Url: http://git.mutantstargoat.com/user/nuclear/?p=dosdemo;a=blobdiff_plain;f=README.md;h=b3a41a1e2e394608b01c718de18a05340b331d35;hp=109455cd4da7079c90cc46c3525b40c1bfce75df;hb=HEAD;hpb=43fe8d9e51a6d86b532c4aec7a06be6225a67e96

diff --git a/README.md b/README.md
index 109455c..6d34b63 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,31 @@ Source structure
  - libs/imago/   image loading library (includes libpng, zlib, libjpeg)
  - libs/anim/    keyframe animation library
 
+Coding style conventions
+------------------------
+Very few style issues are mandated:
+
+  - All filenames should be lowercase unless convention says otherwise
+    (`Makefile`, `README`, etc).
+  - All filenames under `src/` and of any tools necessary to build from MS-DOS
+    will have to use maximum 8.3 characters.
+  - Source code should be C89-compliant. Any compiler-specific features beyond
+    that will have to be ifdefed.
+  - Use tabs for indentation, where each tab is equivalent to 4 spaces.
+
+Everything else is left to the discretion of each individual, but also if
+you're editing an existing file, try to match the style of the surrounding code.
+
+Some general style suggestions, which will not be enforced:
+
+  - Don't use overly long names, abbreviate wherever it makes sense.
+  - Don't cast the return value of malloc. `void*` are converted implicitly, and
+    the cast hides forgetting to include `stdlib.h`.
+  - Preferably use lowercase with underscores for everything.
+  - Preferably use the K&R brace style if possible.
+
+This section will be expanded as necessary.
+
 Building on DOS with Watcom
 ---------------------------
 Make sure you have Watcom or OpenWatcom installed, and the appropriate env-vars
@@ -154,10 +179,10 @@ thankfully most NIC vendors seem to provide, and a number of useful network
 utilities which come with their own TCP/IP stack (mTCP and WATTCP). The
 following are recommended:
 
-    - mTCP: http://www.brutman.com/mTCP
-    - WATTCP: http://www.watt-32.net
-    - ssh2dos: http://sshdos.sourceforge.net
-    - rsync: http://www.2net.co.uk/rsync.html
+ - mTCP: http://www.brutman.com/mTCP
+ - WATTCP: http://www.watt-32.net
+ - ssh2dos: http://sshdos.sourceforge.net
+ - rsync: http://www.2net.co.uk/rsync.html
 
 Here's an example batch file I'm using to set up the network: