Remove docs from platform std implementation classes.

Duplicate docs are resulting in duplicate fields in documentation. Removing
them fixes this and simplifies ongoing documentation.

std/cpp/_std/haxe/ds/StringMap.hx

@@ -44,18 +44,12 @@ package haxe.ds;
 		return untyped __global__.__hxcpp_anon_remove(__Internal,key);
 	}
 
-	/**
-		Returns an iterator of all keys in the hashtable.
-	**/
 	public function keys() : Iterator<String> {
 		var a:Array<String> = [];
 		untyped __Internal.__GetFields(a);
 		return a.iterator();
 	}
 
-	/**
-		Returns an iterator of all values in the hashtable.
-	**/
 	public function iterator() : Iterator<T> {
 		var a:Array<String> = [];
 		untyped __Internal.__GetFields(a);
@@ -67,10 +61,6 @@ package haxe.ds;
 		};
 	}
 
-	/**
-		Returns an displayable representation of the hashtable content.
-	**/
-
 	public function toString() : String {
 		var s = new StringBuf();
 		s.add("{");

std/cs/_std/Array.hx

@@ -21,11 +21,6 @@
  */
 import cs.NativeArray;
 
-/**
-	An Array is a storage for values. You can access it using indexes or
-	with its API. On the server side, it's often better to use a [List] which
-	is less memory and CPU consuming, unless you really need indexed access.
-**/
 @:classCode('
 	public Array(T[] native)
 	{
@@ -35,9 +30,6 @@ import cs.NativeArray;
 ')
 @:final @:coreApi class Array<T> implements ArrayAccess<T> {
 
-	/**
-		The length of the Array
-	**/
 	public var length(default,null) : Int;
 
 	private var __a:NativeArray<T>;
@@ -58,18 +50,12 @@ import cs.NativeArray;
 		return null;
 	}
 
-	/**
-		Creates a new Array.
-	**/
 	public function new() : Void
 	{
 		this.length = 0;
 		this.__a = new NativeArray(0);
 	}
 
-	/**
-		Returns a new Array by appending [a] to [this].
-	**/
 	public function concat( a : Array<T> ) : Array<T>
 	{
 		var len = length + a.length;
@@ -98,9 +84,6 @@ import cs.NativeArray;
 		this.length = len;
 	}
 
-	/**
-		Returns a representation of an array with [sep] for separating each element.
-	**/
 	public function join( sep : String ) : String
 	{
 		var buf = new StringBuf();
@@ -120,9 +103,6 @@ import cs.NativeArray;
 		return buf.toString();
 	}
 
-	/**
-		Removes the last element of the array and returns it.
-	**/
 	public function pop() : Null<T>
 	{
 		var __a = __a;
@@ -139,9 +119,6 @@ import cs.NativeArray;
 		}
 	}
 
-	/**
-		Adds the element [x] at the end of the array.
-	**/
 	public function push(x : T) : Int
 	{
 		if (length >= __a.Length)
@@ -157,9 +134,6 @@ import cs.NativeArray;
 		return ++length;
 	}
 
-	/**
-		Reverse the order of elements of the Array.
-	**/
 	public function reverse() : Void
 	{
 		var i = 0;
@@ -176,9 +150,6 @@ import cs.NativeArray;
 		}
 	}
 
-	/**
-		Removes the first element and returns it.
-	**/
 	public function shift() : Null<T>
 	{
 		var l = this.length;
@@ -195,12 +166,6 @@ import cs.NativeArray;
 		return x;
 	}
 
-	/**
-		Copies the range of the array starting at [pos] up to,
-		but not including, [end]. Both [pos] and [end] can be
-		negative to count from the end: -1 is the last item in
-		the array.
-	**/
 	public function slice( pos : Int, ?end : Int ) : Array<T>
 	{
 		if( pos < 0 ){
@@ -223,11 +188,6 @@ import cs.NativeArray;
 		return ofNative(newarr);
 	}
 
-	/**
-		Sort the Array according to the comparison public function [f].
-		[f(x,y)] should return [0] if [x == y], [>0] if [x > y]
-		and [<0] if [x < y].
-	**/
 	public function sort( f : T -> T -> Int ) : Void
 	{
 		if (length == 0)
@@ -235,10 +195,6 @@ import cs.NativeArray;
 		quicksort(0, length - 1, f);
 	}
 
-	/**
-		quicksort author: tong disktree
-		http://blog.disktree.net/2008/10/26/array-sort-performance.html
-	 */
 	private function quicksort( lo : Int, hi : Int, f : T -> T -> Int ) : Void
 	{
         var buf = __a;
@@ -260,9 +216,6 @@ import cs.NativeArray;
         if( i < hi ) quicksort( i, hi, f );
 	}
 
-	/**
-		Removes [len] elements starting from [pos] an returns them.
-	**/
 	public function splice( pos : Int, len : Int ) : Array<T>
 	{
 		if( len < 0 ) return new Array();
@@ -314,9 +267,6 @@ import cs.NativeArray;
 			a[this.length + len] = null;
 	}
 
-	/**
-		Returns a displayable representation of the Array content.
-	**/
 	public function toString() : String
 	{
 		var ret = new StringBuf();
@@ -336,9 +286,6 @@ import cs.NativeArray;
 		return ret.toString();
 	}
 
-	/**
-		Adds the element [x] at the start of the array.
-	**/
 	public function unshift( x : T ) : Void
 	{
 		var __a = __a;
@@ -358,10 +305,6 @@ import cs.NativeArray;
 		++this.length;
 	}
 
-	/**
-		Inserts the element [x] at the position [pos].
-		All elements after [pos] are moved one index ahead.
-	**/
 	public function insert( pos : Int, x : T ) : Void
 	{
 		var l = this.length;
@@ -396,11 +339,6 @@ import cs.NativeArray;
 		}
 	}
 
-	/**
-		Removes the first occurence of [x].
-		Returns false if [x] was not present.
-		Elements are compared by using standard equality.
-	**/
 	public function remove( x : T ) : Bool
 	{
 		var __a = __a;
@@ -435,10 +373,6 @@ import cs.NativeArray;
 		return ret;
 	}
 
-	/**
-		Returns a copy of the Array. The values are not
-		copied, only the Array structure.
-	**/
 	public function copy() : Array<T>
 	{
 		var len = length;
@@ -448,9 +382,6 @@ import cs.NativeArray;
 		return ofNative(newarr);
 	}
 
-	/**
-		Returns an iterator of the Array values.
-	**/
 	public function iterator() : Iterator<T>
 	{
 		var i = 0;

std/cs/_std/Date.hx

@@ -27,9 +27,6 @@ import haxe.Int64;
 {
 	private var date:DateTime;
 
-	/**
-		Creates a new date object.
-	**/
 	public function new(year : Int, month : Int, day : Int, hour : Int, min : Int, sec : Int ) : Void
 	{
 		if (day <= 0) day = 1;
@@ -37,77 +34,46 @@ import haxe.Int64;
 		date = new DateTime(year, month + 1, day, hour, min, sec);
 	}
 
-	/**
-		Returns the timestamp of the date. It's the number of milliseconds
-		elapsed since 1st January 1970. It might only have a per-second precision
-		depending on the platforms.
-	**/
 	public inline function getTime() : Float
 	{
 		return (cast(date.Ticks, Float) / TimeSpan.TicksPerMillisecond);
 	}
 
-	/**
-		Returns the hours value of the date (0-23 range).
-	**/
 	public inline function getHours() : Int
 	{
 		return date.Hour;
 	}
 
-	/**
-		Returns the minutes value of the date (0-59 range).
-	**/
 	public inline function getMinutes() : Int
 	{
 		return date.Minute;
 	}
 
-	/**
-		Returns the seconds of the date (0-59 range).
-	**/
 	public inline function getSeconds() : Int
 	{
 		return date.Second;
 	}
 
-	/**
-		Returns the full year of the date.
-	**/
 	public inline function getFullYear() : Int
 	{
 		return date.Year;
 	}
 
-	/**
-		Returns the month of the date (0-11 range).
-	**/
 	public inline function getMonth() : Int
 	{
 		return date.Month - 1;
 	}
 
-	/**
-		Returns the day of the date (1-31 range).
-	**/
 	public inline function getDate() : Int
 	{
 		return date.Day;
 	}
 
-	/**
-		Returns the week day of the date (0-6 range).
-	**/
 	public inline function getDay() : Int
 	{
 		return cast(date.DayOfWeek, Int);
 	}
 
-	/**
-		Returns a string representation for the Date, by using the
-		standard format [YYYY-MM-DD HH:MM:SS]. See [DateTools.format] for
-		other formating rules.
-	**/
 	public function toString():String
 	{
 		var m = getMonth() + 1;
@@ -123,9 +89,6 @@ import haxe.Int64;
 			+":"+(if( s < 10 ) "0"+s else ""+s);
 	}
 
-	/**
-		Returns a Date representing the current local time.
-	**/
 	static public function now() : Date
 	{
 		var d = new Date(0, 0, 0, 0, 0, 0);
@@ -133,10 +96,6 @@ import haxe.Int64;
 		return d;
 	}
 
-	/**
-		Returns a Date from a timestamp [t] which is the number of
-		milliseconds elapsed since 1st January 1970.
-	**/
 	static public function fromTime( t : Float ) : Date
 	{
 		var d = new Date(0, 0, 0, 0, 0, 0);
@@ -144,12 +103,6 @@ import haxe.Int64;
 		return d;
 	}
 
-
-	/**
-		Returns a Date from a formated string of one of the following formats :
-		[YYYY-MM-DD hh:mm:ss] or [YYYY-MM-DD] or [hh:mm:ss]. The first two formats
-		are expressed in local time, the third in UTC Epoch.
-	**/
 	static public function fromString( s : String ) : Date
 	{
 		switch( s.length )

std/cs/_std/Reflect.hx

@@ -45,15 +45,8 @@ import cs.internal.Function;
  * DAMAGE.
  */
 
-/**
-	The Reflect API is a way to manipulate values dynamicly through an
-	abstract interface in an untyped manner. Use with care.
-**/
 @:keep @:coreApi class Reflect {
 
-	/**
-		Tells if an object has a field set. This doesn't take into account the object prototype (class methods).
-	**/
 	@:functionCode('
 		if (o is haxe.lang.IHxObject)
 			return ((haxe.lang.IHxObject) o).__hx_getField(field, haxe.lang.FieldLookup.hash(field), false, true, false) != haxe.lang.Runtime.undefined;
@@ -65,9 +58,6 @@ import cs.internal.Function;
 		return false;
 	}
 
-	/**
-		Returns the field of an object, or null if [o] is not an object or doesn't have this field.
-	**/
 	@:functionCode('
 		if (o is haxe.lang.IHxObject)
 			return ((haxe.lang.IHxObject) o).__hx_getField(field, haxe.lang.FieldLookup.hash(field), false, false, false);
@@ -79,10 +69,6 @@ import cs.internal.Function;
 		return null;
 	}
 
-
-	/**
-		Set an object field value.
-	**/
 	@:functionCode('
 		if (o is haxe.lang.IHxObject)
 			((haxe.lang.IHxObject) o).__hx_setField(field, haxe.lang.FieldLookup.hash(field), value, false);
@@ -94,9 +80,6 @@ import cs.internal.Function;
 
 	}
 
-	/**
-		Similar to field but also supports property (might be slower).
-	**/
 	@:functionCode('
 		if (o is haxe.lang.IHxObject)
 			return ((haxe.lang.IHxObject) o).__hx_getField(field, haxe.lang.FieldLookup.hash(field), false, false, true);
@@ -111,9 +94,6 @@ import cs.internal.Function;
 		return null;
 	}
 
-	/**
-		Similar to setField but also supports property (might be slower).
-	**/
 	@:functionCode('
 		if (o is haxe.lang.IHxObject)
 			((haxe.lang.IHxObject) o).__hx_setField(field, haxe.lang.FieldLookup.hash(field), value, true);
@@ -127,9 +107,6 @@ import cs.internal.Function;
 
 	}
 
-	/**
-		Call a method with the given object and arguments.
-	**/
 	@:functionCode('
 		return ((haxe.lang.Function) func).__hx_invokeDynamic(args);
 	')
@@ -138,9 +115,6 @@ import cs.internal.Function;
 		return null;
 	}
 
-	/**
-		Returns the list of fields of an object, excluding its prototype (class methods).
-	**/
 	@:functionCode('
 		if (o is haxe.lang.IHxObject)
 		{
@@ -158,9 +132,6 @@ import cs.internal.Function;
 		return null;
 	}
 
-	/**
-		Tells if a value is a function or not.
-	**/
 	@:functionCode('
 		return f is haxe.lang.Function;
 	')
@@ -169,9 +140,6 @@ import cs.internal.Function;
 		return false;
 	}
 
-	/**
-		Generic comparison function, does not work for methods, see [compareMethods]
-	**/
 	@:functionCode('
 		return haxe.lang.Runtime.compare(a, b);
 	')
@@ -180,9 +148,6 @@ import cs.internal.Function;
 		return 0;
 	}
 
-	/**
-		Compare two methods closures. Returns true if it's the same method of the same instance.
-	**/
 	@:functionCode('
 		if (f1 == f2)
 			return true;
@@ -202,10 +167,6 @@ import cs.internal.Function;
 		return false;
 	}
 
-	/**
-		Tells if a value is an object or not.
-
-	**/
 	@:functionCode('
 		return v != null && !(v is haxe.lang.Enum || v is haxe.lang.Function || v is System.ValueType);
 	')
@@ -224,9 +185,6 @@ import cs.internal.Function;
 		}
 	}
 
-	/**
-		Delete an object field.
-	**/
 	@:functionCode('
 		return (o is haxe.lang.DynamicObject && ((haxe.lang.DynamicObject) o).__hx_deleteField(field, haxe.lang.FieldLookup.hash(field)));
 	')
@@ -235,9 +193,6 @@ import cs.internal.Function;
 		return false;
 	}
 
-	/**
-		Make a copy of the fields of an object.
-	**/
 	public static function copy<T>( o : T ) : T
 	{
 		var o2 : Dynamic = {};
@@ -246,10 +201,6 @@ import cs.internal.Function;
 		return cast o2;
 	}
 
-	/**
-		Transform a function taking an array of arguments into a function that can
-		be called with any number of arguments.
-	**/
 	@:overload(function( f : Array<Dynamic> -> Void ) : Dynamic {})
 	public static function makeVarArgs( f : Array<Dynamic> -> Dynamic ) : Dynamic
 	{

std/cs/_std/Sys.hx

@@ -47,33 +47,21 @@ import cs.system.threading.Thread;
  * DAMAGE.
  */
 
-/**
-	This class gives you access to many base functionalities of system platforms. Looks in [sys] sub packages for more system APIs.
-**/
 @:coreApi
 class Sys {
 	private static var _env:haxe.ds.StringMap<String>;
 	private static var _args:Array<String>;
 
-	/**
-		Print any value on the standard output.
-	**/
 	public static function print( v : Dynamic ) : Void
 	{
 		cs.system.Console.Write(v);
 	}
 
-	/**
-		Print any value on the standard output, followed by a newline
-	**/
 	public static function println( v : Dynamic ) : Void
 	{
 		cs.system.Console.WriteLine(v);
 	}
 
-	/**
-		Returns all the arguments that were passed by the commandline.
-	**/
 	public static function args() : Array<String>
 	{
 		if (_args == null)
@@ -85,17 +73,11 @@ class Sys {
 		return _args.copy();
 	}
 
-	/**
-		Returns the value of the given environment variable.
-	**/
 	public static function getEnv( s : String ) : String
 	{
 		return Environment.GetEnvironmentVariable(s);
 	}
 
-	/**
-		Set the value of the given environment variable.
-	**/
 	public static function putEnv( s : String, v : String ) : Void
 	{
 		Environment.SetEnvironmentVariable(s, v);
@@ -103,9 +85,6 @@ class Sys {
 			_env.set(s, v);
 	}
 
-	/**
-		Returns the whole environement variables.
-	**/
 	public static function environment() : haxe.ds.StringMap<String>
 	{
 		if (_env == null)
@@ -121,44 +100,27 @@ class Sys {
 		return _env;
 	}
 
-	/**
-		Suspend the current execution for the given time (in seconds).
-	**/
 	public static function sleep( seconds : Float ) : Void
 	{
 		Thread.Sleep( Std.int(seconds * 1000) );
 	}
 
-	/**
-		Change the current time locale, which will affect [DateTools.format] date formating.
-		Returns true if the locale was successfully changed
-	**/
 	public static function setTimeLocale( loc : String ) : Bool
 	{
 		//TODO C#
 		return false;
 	}
 
-	/**
-		Get the current working directory (usually the one in which the program was started)
-	**/
 	public static function getCwd() : String
 	{
 		return cs.system.io.Directory.GetCurrentDirectory();
 	}
 
-	/**
-		Change the current working directory.
-	**/
 	public static function setCwd( s : String ) : Void
 	{
 		cs.system.io.Directory.SetCurrentDirectory(s);
 	}
 
-	/**
-		Returns the name of the system you are running on. For instance :
-			"Windows", "Linux", "BSD" and "Mac" depending on your desktop OS.
-	**/
 	public static function systemName() : String
 	{
 		//doing a switch with strings since MacOS might not be available
@@ -175,11 +137,6 @@ class Sys {
 		}
 	}
 
-	/**
-		Run the given command with the list of arguments. The command output will be printed on the same output as the current process.
-		The current process will block until the command terminates and it will return the command result (0 if there was no error).
-		Read the [sys.io.Process] api for a more complete way to start background processes.
-	**/
 	public static function command( cmd : String, ?args : Array<String> ) : Int
 	{
 		var proc:Process = new Process(cmd, args == null ? [] : args);
@@ -189,42 +146,27 @@ class Sys {
 		return ret;
 	}
 
-	/**
-		Exit the current process with the given error code.
-	**/
 	public static function exit( code : Int ) : Void
 	{
 		Environment.Exit(code);
 	}
 
-	/**
-		Gives the most precise timestamp value (in seconds).
-	**/
 	public static function time() : Float
 	{
 		return Date.now().getTime() / 1000;
 	}
 
-	/**
-		Gives the most precise timestamp value (in seconds) but only account for the actual time spent running on the CPU for the current thread/process.
-	**/
 	public static function cpuTime() : Float
 	{
 		return Environment.TickCount / 1000;
 	}
 
-	/**
-		Returns the path to the current executable that we are running.
-	**/
 	public static function executablePath() : String
 	{
 		//TODO: add extern references
 		return untyped __cs__('System.Reflection.Assembly.GetExecutingAssembly().GetName().CodeBase');
 	}
 
-	/**
-		Read a single input character from the standard input (without blocking) and returns it. Setting [echo] to true will also display it on the output.
-	**/
 	public static function getChar( echo : Bool ) : Int
 	{
 		#if !(Xbox || CF || MF) //Xbox, Compact Framework, Micro Framework
@@ -234,9 +176,6 @@ class Sys {
 		#end
 	}
 
-	/**
-		Returns the process standard input, from which you can read what user enters. Usually it will block until the user send a full input line. See [getChar] for an alternative.
-	**/
 	public static function stdin() : haxe.io.Input
 	{
 #if !(Xbox || CF || MF)
@@ -246,9 +185,6 @@ class Sys {
 #end
 	}
 
-	/**
-		Returns the process standard output on which you can write.
-	**/
 	public static function stdout() : haxe.io.Output
 	{
 #if !(Xbox || CF || MF)
@@ -258,9 +194,6 @@ class Sys {
 #end
 	}
 
-	/**
-		Returns the process standard error on which you can write.
-	**/
 	public static function stderr() : haxe.io.Output
 	{
 #if !(Xbox || CF || MF)

std/cs/_std/haxe/Int64.hx

@@ -129,10 +129,7 @@ using haxe.Int64;
 	{
 		return cast (a.asNative() - b.asNative());
 	}
-
-	/**
-		Compare two Int64 in unsigned mode.
-	**/
+	
 	public static function ucompare( a : Int64, b : Int64 ) : Int
 	{
 		if (a.asNative() < 0.mkNative())

std/cs/_std/sys/FileSystem.hx

@@ -25,31 +25,19 @@ import cs.system.io.File;
 import cs.system.io.Directory;
 import cs.system.io.FileInfo;
 
-/**
-	This class allows you to get informations about the files and directories.
-**/
 @:coreApi
 class FileSystem {
 
-	/**
-		Tells if the given file or directory exists.
-	**/
 	public static function exists( path : String ) : Bool
 	{
 		return (File.Exists(path) || Directory.Exists(path));
 	}
 
-	/**
-		Rename the corresponding file or directory, allow to move it accross directories as well.
-	**/
 	public static function rename( path : String, newpath : String ) : Void
 	{
 		Directory.Move(path, newpath);
 	}
 
-	/**
-		Returns informations for the given file/directory.
-	**/
 	public static function stat( path : String ) : FileStat
 	{
 		if (File.Exists(path))
@@ -89,17 +77,11 @@ class FileSystem {
 
 	}
 
-	/**
-		Returns the full path for the given path which is relative to the current working directory.
-	**/
 	public static function fullPath( relpath : String ) : String
 	{
 		return new FileInfo(relpath).FullName;
 	}
 
-	/**
-		Tells if the given path is a directory. Throw an exception if it does not exists or is not accesible.
-	**/
 	public static function isDirectory( path : String ) : Bool
 	{
 		var isdir = Directory.Exists(path);
@@ -108,33 +90,21 @@ class FileSystem {
 		throw "Path '" + path + "' doesn't exist";
 	}
 
-	/**
-		Create the given directory. Not recursive : the parent directory must exists.
-	**/
 	public static function createDirectory( path : String ) : Void
 	{
 		Directory.CreateDirectory(path);
 	}
 
-	/**
-		Delete a given file.
-	**/
 	public static function deleteFile( path : String ) : Void
 	{
 		File.Delete(path);
 	}
 
-	/**
-		Delete a given directory.
-	**/
 	public static function deleteDirectory( path : String ) : Void
 	{
 		Directory.Delete(path);
 	}
 
-	/**
-		Read all the files/directories stored into the given directory.
-	**/
 	public static function readDirectory( path : String ) : Array<String>
 	{
 		var ret = Directory.GetFileSystemEntries(path);

std/cs/_std/sys/io/File.hx

@@ -21,9 +21,6 @@
  */
 package sys.io;
 
-/**
-	API for reading and writing to files.
-**/
 @:coreApi
 class File {
 

std/cs/_std/sys/io/FileInput.hx

@@ -21,9 +21,6 @@
  */
 package sys.io;
 
-/**
-	Use [sys.io.File.read] to create a [FileInput]
-**/
 class FileInput extends cs.io.NativeInput {
 	public function new(stream:cs.system.io.FileStream)
 	{

std/cs/_std/sys/io/FileOutput.hx

@@ -21,9 +21,6 @@
  */
 package sys.io;
 
-/**
-	Use [sys.io.File.write] to create a [FileOutput]
-**/
 class FileOutput extends cs.io.NativeOutput {
 	public function new(stream:cs.system.io.FileStream)
 	{

std/java/_std/Array.hx

@@ -22,11 +22,6 @@
 import java.lang.System;
 import java.NativeArray;
 
-/**
-	An Array is a storage for values. You can access it using indexes or
-	with its API. On the server side, it's often better to use a [List] which
-	is less memory and CPU consuming, unless you really need indexed access.
-**/
 @:classCode('
 	public Array(T[] _native)
 	{
@@ -36,9 +31,6 @@ import java.NativeArray;
 ')
 @:final @:coreApi class Array<T> implements ArrayAccess<T> {
 
-	/**
-		The length of the Array
-	**/
 	public var length(default,null) : Int;
 
 	private var __a:NativeArray<T>;
@@ -59,18 +51,12 @@ import java.NativeArray;
 		return null;
 	}
 
-	/**
-		Creates a new Array.
-	**/
 	public function new() : Void
 	{
 		this.length = 0;
 		this.__a = new NativeArray(0);
 	}
 
-	/**
-		Returns a new Array by appending [a] to [this].
-	**/
 	public function concat( a : Array<T> ) : Array<T>
 	{
 		var length = length;
@@ -101,9 +87,6 @@ import java.NativeArray;
 		this.length = len;
 	}
 
-	/**
-		Returns a representation of an array with [sep] for separating each element.
-	**/
 	public function join( sep : String ) : String
 	{
 		var buf = new StringBuf();
@@ -123,9 +106,6 @@ import java.NativeArray;
 		return buf.toString();
 	}
 
-	/**
-		Removes the last element of the array and returns it.
-	**/
 	public function pop() : Null<T>
 	{
 		var __a = __a;
@@ -142,9 +122,6 @@ import java.NativeArray;
 		}
 	}
 
-	/**
-		Adds the element [x] at the end of the array.
-	**/
 	public function push(x : T) : Int
 	{
 		var length = length;
@@ -161,9 +138,6 @@ import java.NativeArray;
 		return ++this.length;
 	}
 
-	/**
-		Reverse the order of elements of the Array.
-	**/
 	public function reverse() : Void
 	{
 		var i = 0;
@@ -180,9 +154,6 @@ import java.NativeArray;
 		}
 	}
 
-	/**
-		Removes the first element and returns it.
-	**/
 	public function shift() : Null<T>
 	{
 		var l = this.length;
@@ -199,12 +170,6 @@ import java.NativeArray;
 		return x;
 	}
 
-	/**
-		Copies the range of the array starting at [pos] up to,
-		but not including, [end]. Both [pos] and [end] can be
-		negative to count from the end: -1 is the last item in
-		the array.
-	**/
 	public function slice( pos : Int, ?end : Int ) : Array<T>
 	{
 		if( pos < 0 ){
@@ -227,11 +192,6 @@ import java.NativeArray;
 		return ofNative(newarr);
 	}
 
-	/**
-		Sort the Array according to the comparison public function [f].
-		[f(x,y)] should return [0] if [x == y], [>0] if [x > y]
-		and [<0] if [x < y].
-	**/
 	public function sort( f : T -> T -> Int ) : Void
 	{
 		if (length == 0)
@@ -239,10 +199,6 @@ import java.NativeArray;
 		quicksort(0, length - 1, f);
 	}
 
-	/**
-		quicksort author: tong disktree
-		http://blog.disktree.net/2008/10/26/array-sort-performance.html
-	 */
 	private function quicksort( lo : Int, hi : Int, f : T -> T -> Int ) : Void
 	{
         var buf = __a;
@@ -264,9 +220,6 @@ import java.NativeArray;
         if( i < hi ) quicksort( i, hi, f );
 	}
 
-	/**
-		Removes [len] elements starting from [pos] an returns them.
-	**/
 	public function splice( pos : Int, len : Int ) : Array<T>
 	{
 		if( len < 0 ) return new Array();
@@ -318,9 +271,6 @@ import java.NativeArray;
 			a[this.length + len] = null;
 	}
 
-	/**
-		Returns a displayable representation of the Array content.
-	**/
 	public function toString() : String
 	{
 		var ret = new StringBuf();
@@ -340,9 +290,6 @@ import java.NativeArray;
 		return ret.toString();
 	}
 
-	/**
-		Adds the element [x] at the start of the array.
-	**/
 	public function unshift( x : T ) : Void
 	{
 		var __a = __a;
@@ -362,10 +309,6 @@ import java.NativeArray;
 		++this.length;
 	}
 
-	/**
-		Inserts the element [x] at the position [pos].
-		All elements after [pos] are moved one index ahead.
-	**/
 	public function insert( pos : Int, x : T ) : Void
 	{
 		var l = this.length;
@@ -400,11 +343,6 @@ import java.NativeArray;
 		}
 	}
 
-	/**
-		Removes the first occurence of [x].
-		Returns false if [x] was not present.
-		Elements are compared by using standard equality.
-	**/
 	public function remove( x : T ) : Bool
 	{
 		var __a = __a;
@@ -424,10 +362,6 @@ import java.NativeArray;
 		return false;
 	}
 
-	/**
-		Returns a copy of the Array. The values are not
-		copied, only the Array structure.
-	**/
 	public function copy() : Array<T>
 	{
 		var len = length;
@@ -437,9 +371,6 @@ import java.NativeArray;
 		return ofNative(newarr);
 	}
 
-	/**
-		Returns an iterator of the Array values.
-	**/
 	public function iterator() : Iterator<T>
 	{
 		var i = 0;

std/java/_std/Date.hx

@@ -27,9 +27,6 @@ import haxe.Int64;
 {
 	private var date:java.util.Date;
 
-	/**
-		Creates a new date object.
-	**/
 	public function new(year : Int, month : Int, day : Int, hour : Int, min : Int, sec : Int ) : Void
 	{
 		//issue #1769
@@ -37,77 +34,46 @@ import haxe.Int64;
 		date = new java.util.Date(year, month, day, hour, min, sec);
 	}
 
-	/**
-		Returns the timestamp of the date. It's the number of milliseconds
-		elapsed since 1st January 1970. It might only have a per-second precision
-		depending on the platforms.
-	**/
 	public inline function getTime() : Float
 	{
 		return cast date.getTime();
 	}
 
-	/**
-		Returns the hours value of the date (0-23 range).
-	**/
 	public inline function getHours() : Int
 	{
 		return date.getHours();
 	}
 
-	/**
-		Returns the minutes value of the date (0-59 range).
-	**/
 	public inline function getMinutes() : Int
 	{
 		return date.getMinutes();
 	}
 
-	/**
-		Returns the seconds of the date (0-59 range).
-	**/
 	public inline function getSeconds() : Int
 	{
 		return date.getSeconds();
 	}
 
-	/**
-		Returns the full year of the date.
-	**/
 	public inline function getFullYear() : Int
 	{
 		return date.getYear() + 1900;
 	}
 
-	/**
-		Returns the month of the date (0-11 range).
-	**/
 	public inline function getMonth() : Int
 	{
 		return date.getMonth();
 	}
 
-	/**
-		Returns the day of the date (1-31 range).
-	**/
 	public inline function getDate() : Int
 	{
 		return date.getDate();
 	}
 
-	/**
-		Returns the week day of the date (0-6 range).
-	**/
 	public inline function getDay() : Int
 	{
 		return date.getDay();
 	}
 
-	/**
-		Returns a string representation for the Date, by using the
-		standard format [YYYY-MM-DD HH:MM:SS]. See [DateTools.format] for
-		other formating rules.
-	**/
 	public function toString():String
 	{
 		var m = date.getMonth() + 1;
@@ -123,9 +89,6 @@ import haxe.Int64;
 			+":"+(if( s < 10 ) "0"+s else ""+s);
 	}
 
-	/**
-		Returns a Date representing the current local time.
-	**/
 	static public function now() : Date
 	{
 		var d = new Date(0, 0, 0, 0, 0, 0);
@@ -133,10 +96,6 @@ import haxe.Int64;
 		return d;
 	}
 
-	/**
-		Returns a Date from a timestamp [t] which is the number of
-		milliseconds elapsed since 1st January 1970.
-	**/
 	static public function fromTime( t : Float ) : Date
 	{
 		var d = new Date(0, 0, 0, 0, 0, 0);
@@ -144,11 +103,6 @@ import haxe.Int64;
 		return d;
 	}
 
-	/**
-		Returns a Date from a formated string of one of the following formats :
-		[YYYY-MM-DD hh:mm:ss] or [YYYY-MM-DD] or [hh:mm:ss]. The first two formats
-		are expressed in local time, the third in UTC Epoch.
-	**/
 	static public function fromString( s : String ) : Date
 	{
 		switch( s.length )

std/java/_std/Math.hx

@@ -19,9 +19,7 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  * DEALINGS IN THE SOFTWARE.
  */
-/**
-	This class defines mathematical functions and constants.
-**/
+
 @:coreApi
 @:native("java.lang.Math") extern class Math
 {

std/java/_std/Reflect.hx

@@ -19,42 +19,12 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  * DEALINGS IN THE SOFTWARE.
  */
+
 import java.internal.Function;
 import java.Boot;
-/*
- * Copyright (c) 2005, The Haxe Project Contributors
- * All rights reserved.
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *   - Redistributions of source code must retain the above copyright
- *     notice, this list of conditions and the following disclaimer.
- *   - Redistributions in binary form must reproduce the above copyright
- *     notice, this list of conditions and the following disclaimer in the
- *     documentation and/or other materials provided with the distribution.
- *
- * THIS SOFTWARE IS PROVIDED BY THE HAXE PROJECT CONTRIBUTORS "AS IS" AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE HAXE PROJECT CONTRIBUTORS BE LIABLE FOR
- * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
- * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
- * DAMAGE.
- */
 
-/**
-	The Reflect API is a way to manipulate values dynamicly through an
-	abstract interface in an untyped manner. Use with care.
-**/
 @:keep @:coreApi class Reflect {
 
-	/**
-		Tells if an object has a field set. This doesn't take into account the object prototype (class methods).
-	**/
 	@:functionCode('
 		if (o instanceof haxe.lang.IHxObject)
 		return ((haxe.lang.IHxObject) o).__hx_getField(field, false, true, false) != haxe.lang.Runtime.undefined;
@@ -66,9 +36,6 @@ import java.Boot;
 		return false;
 	}
 
-	/**
-		Returns the field of an object, or null if [o] is not an object or doesn't have this field.
-	**/
 	@:functionCode('
 		if (o instanceof haxe.lang.IHxObject)
 			return ((haxe.lang.IHxObject) o).__hx_getField(field, false, false, false);
@@ -80,10 +47,6 @@ import java.Boot;
 		return null;
 	}
 
-
-	/**
-		Set an object field value.
-	**/
 	@:functionCode('
 		if (o instanceof haxe.lang.IHxObject)
 			((haxe.lang.IHxObject) o).__hx_setField(field, value, false);
@@ -95,9 +58,6 @@ import java.Boot;
 
 	}
 
-	/**
-		Similar to field but also supports property (might be slower).
-	**/
 	@:functionCode('
 		if (o instanceof haxe.lang.IHxObject)
 			return ((haxe.lang.IHxObject) o).__hx_getField(field, false, false, true);
@@ -112,9 +72,6 @@ import java.Boot;
 		return null;
 	}
 
-	/**
-		Similar to setField but also supports property (might be slower).
-	**/
 	@:functionCode('
 		if (o instanceof haxe.lang.IHxObject)
 			((haxe.lang.IHxObject) o).__hx_setField(field, value, true);
@@ -128,9 +85,6 @@ import java.Boot;
 
 	}
 
-	/**
-		Call a method with the given object and arguments.
-	**/
 	@:functionCode('
 		return ((haxe.lang.Function) func).__hx_invokeDynamic(args);
 	')
@@ -139,9 +93,6 @@ import java.Boot;
 		return null;
 	}
 
-	/**
-		Returns the list of fields of an object, excluding its prototype (class methods).
-	**/
 	@:functionCode('
 		if (o instanceof haxe.lang.IHxObject)
 		{
@@ -159,9 +110,6 @@ import java.Boot;
 		return null;
 	}
 
-	/**
-		Tells if a value is a function or not.
-	**/
 	@:functionCode('
 		return f instanceof haxe.lang.Function;
 	')
@@ -170,9 +118,6 @@ import java.Boot;
 		return false;
 	}
 
-	/**
-		Generic comparison function, does not work for methods, see [compareMethods]
-	**/
 	@:functionCode('
 		return haxe.lang.Runtime.compare(a, b);
 	')
@@ -181,9 +126,6 @@ import java.Boot;
 		return 0;
 	}
 
-	/**
-		Compare two methods closures. Returns true if it's the same method of the same instance.
-	**/
 	@:functionCode('
 		if (f1 == f2)
 			return true;
@@ -204,10 +146,6 @@ import java.Boot;
 		return false;
 	}
 
-	/**
-		Tells if a value is an object or not.
-
-	**/
 	@:functionCode('
 		return v != null && !(v instanceof haxe.lang.Enum || v instanceof haxe.lang.Function || v instanceof java.lang.Enum || v instanceof java.lang.Number || v instanceof java.lang.Boolean);
 	')
@@ -226,9 +164,6 @@ import java.Boot;
 		}
 	}
 
-	/**
-		Delete an object field.
-	**/
 	@:functionCode('
 		return (o instanceof haxe.lang.DynamicObject && ((haxe.lang.DynamicObject) o).__hx_deleteField(field));
 	')
@@ -237,9 +172,6 @@ import java.Boot;
 		return false;
 	}
 
-	/**
-		Make a copy of the fields of an object.
-	**/
 	public static function copy<T>( o : T ) : T
 	{
 		var o2 : Dynamic = {};
@@ -248,10 +180,6 @@ import java.Boot;
 		return cast o2;
 	}
 
-	/**
-		Transform a function taking an array of arguments into a function that can
-		be called with any number of arguments.
-	**/
 	@:overload(function( f : Array<Dynamic> -> Void ) : Dynamic {})
 	public static function makeVarArgs( f : Array<Dynamic> -> Dynamic ) : Dynamic
 	{

std/java/_std/Std.hx

@@ -19,6 +19,7 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  * DEALINGS IN THE SOFTWARE.
  */
+
 import java.Boot;
 import java.Lib;
 import java.internal.Exceptions;

std/java/_std/StringBuf.hx

@@ -19,6 +19,7 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  * DEALINGS IN THE SOFTWARE.
  */
+
 @:coreApi
 class StringBuf {
 

std/java/_std/Sys.hx

@@ -19,60 +19,25 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  * DEALINGS IN THE SOFTWARE.
  */
+
 import java.lang.System;
 import sys.io.Process;
-/*
- * Copyright (c) 2005-2012, The Haxe Project Contributors
- * All rights reserved.
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *   - Redistributions of source code must retain the above copyright
- *     notice, this list of conditions and the following disclaimer.
- *   - Redistributions in binary form must reproduce the above copyright
- *     notice, this list of conditions and the following disclaimer in the
- *     documentation and/or other materials provided with the distribution.
- *
- * THIS SOFTWARE IS PROVIDED BY THE HAXE PROJECT CONTRIBUTORS "AS IS" AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE HAXE PROJECT CONTRIBUTORS BE LIABLE FOR
- * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
- * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
- * DAMAGE.
- */
 
-/**
-	This class gives you access to many base functionalities of system platforms. Looks in [sys] sub packages for more system APIs.
-**/
 @:coreApi class Sys {
 	private static var _args:java.NativeArray<String>;
 	private static var _env:haxe.ds.StringMap<String>;
 	private static var _sysName:String;
 
-	/**
-		Print any value on the standard output.
-	**/
 	public static inline function print( v : Dynamic ) : Void
 	{
 		java.lang.System.out.print(v);
 	}
 
-	/**
-		Print any value on the standard output, followed by a newline
-	**/
 	public static inline function println( v : Dynamic ) : Void
 	{
 		java.lang.System.out.println(v);
 	}
 
-	/**
-		Returns all the arguments that were passed by the commandline.
-	**/
 	public static function args() : Array<String>
 	{
 		if (_args == null)
@@ -80,27 +45,17 @@ import sys.io.Process;
 		return java.Lib.array(_args);
 	}
 
-	/**
-		Returns the value of the given environment variable.
-	**/
 	public static function getEnv( s : String ) : String
 	{
 		return java.lang.System.getenv(s);
 	}
 
-	/**
-		Set the value of the given environment variable.
-		Warning: It is not implemented in Java
-	**/
 	public static function putEnv( s : String, v : String ) : Void
 	{
 		//java offers no support for it (!)
 		throw "Not implemented in this platform";
 	}
 
-	/**
-		Returns the whole environement variables.
-	**/
 	public static function environment() : haxe.ds.StringMap<String>
 	{
 		if (_env != null)
@@ -114,9 +69,6 @@ import sys.io.Process;
 		return _env;
 	}
 
-	/**
-		Suspend the current execution for the given time (in seconds).
-	**/
 	public static function sleep( seconds : Float ) : Void
 	{
 		try
@@ -125,36 +77,22 @@ import sys.io.Process;
 			throw e;
 	}
 
-	/**
-		Change the current time locale, which will affect [DateTools.format] date formating.
-		Returns true if the locale was successfully changed
-	**/
 	public static function setTimeLocale( loc : String ) : Bool
 	{
 		return false;
 	}
 
-	/**
-		Get the current working directory (usually the one in which the program was started)
-	**/
 	public static function getCwd() : String
 	{
 		return new java.io.File(".").getAbsolutePath().substr(0,-1);
 	}
 
-	/**
-		Change the current working directory.
-	**/
 	public static function setCwd( s : String ) : Void
 	{
 		//java offers no support for it (!)
 		throw "not implemented";
 	}
 
-	/**
-		Returns the name of the system you are running on. For instance :
-			"Windows", "Linux", "BSD" and "Mac" depending on your desktop OS.
-	**/
 	public static function systemName() : String
 	{
 		if (_sysName != null) return _sysName;
@@ -171,11 +109,6 @@ import sys.io.Process;
 		return _sysName = System.getProperty("os.name");
 	}
 
-	/**
-		Run the given command with the list of arguments. The command output will be printed on the same output as the current process.
-		The current process will block until the command terminates and it will return the command result (0 if there was no error).
-		Read the [sys.io.Process] api for a more complete way to start background processes.
-	**/
 	public static function command( cmd : String, ?args : Array<String> ) : Int
 	{
 		var proc:Process = new Process(cmd, args == null ? [] : args);
@@ -185,70 +118,45 @@ import sys.io.Process;
 		return ret;
 	}
 
-	/**
-		Exit the current process with the given error code.
-	**/
 	public static function exit( code : Int ) : Void
 	{
 		System.exit(code);
 	}
 
-	/**
-		Gives the most precise timestamp value (in seconds).
-	**/
 	public static function time() : Float
 	{
 		return cast(System.currentTimeMillis(), Float) / 1000;
 	}
 
-	/**
-		Gives the most precise timestamp value (in seconds) but only account for the actual time spent running on the CPU for the current thread/process.
-	**/
 	public static function cpuTime() : Float
 	{
 		return cast(System.nanoTime(), Float) / 1000000000;
 	}
 
-	/**
-		Returns the path to the current executable that we are running.
-	**/
 	public static function executablePath() : String
 	{
 		return getCwd();
 	}
 
-	/**
-		Read a single input character from the standard input (without blocking) and returns it. Setting [echo] to true will also display it on the output.
-	**/
 	public static function getChar( echo : Bool ) : Int
 	{
 		//TODO
 		return throw "Not implemented";
 	}
 
-	/**
-		Returns the process standard input, from which you can read what user enters. Usually it will block until the user send a full input line. See [getChar] for an alternative.
-	**/
 	public static function stdin() : haxe.io.Input
 	{
 		var _in:java.io.InputStream = Reflect.field(System, "in");
 		return new java.io.NativeInput(_in);
 	}
 
-	/**
-		Returns the process standard output on which you can write.
-	**/
 	public static function stdout() : haxe.io.Output
 	{
 		return new java.io.NativeOutput(System.out);
 	}
 
-	/**
-		Returns the process standard error on which you can write.
-	**/
 	public static function stderr() : haxe.io.Output
 	{
 		return new java.io.NativeOutput(System.err);
 	}
-
-}
+}

std/java/_std/haxe/Int64.hx

@@ -130,9 +130,6 @@ private typedef NativeInt64 = Int;
 		return cast(a.asNative() - b.asNative(), Int);
 	}
 
-	/**
-		Compare two Int64 in unsigned mode.
-	**/
 	public static function ucompare( a : Int64, b : Int64 ) : Int
 	{
 		if (a.asNative() < 0.mkNative())
@@ -144,5 +141,3 @@ private typedef NativeInt64 = Int;
 		return a + "";
 	}
 }
-
-

std/java/_std/sys/FileSystem.hx

@@ -23,23 +23,14 @@ package sys;
 import java.io.File;
 import java.Lib;
 
-/**
-	This class allows you to get informations about the files and directories.
-**/
 @:coreApi
 class FileSystem {
 
-	/**
-		Tells if the given file or directory exists.
-	**/
 	public static function exists( path : String ) : Bool
 	{
 		return new File(path).exists();
 	}
 
-	/**
-		Rename the corresponding file or directory, allow to move it accross directories as well.
-	**/
 	public static function rename( path : String, newpath : String ) : Void
 	{
 		if (!new File(path).renameTo(new File(newpath)))
@@ -48,9 +39,6 @@ class FileSystem {
 		}
 	}
 
-	/**
-		Returns informations for the given file/directory.
-	**/
 	public static function stat( path : String ) : FileStat
 	{
 		var f = new File(path);
@@ -71,17 +59,11 @@ class FileSystem {
 		};
 	}
 
-	/**
-		Returns the full path for the given path which is relative to the current working directory.
-	**/
 	public static function fullPath( relpath : String ) : String
 	{
 		return new File(relpath).getAbsolutePath();
 	}
 
-	/**
-		Tells if the given path is a directory. Throw an exception if it does not exists or is not accesible.
-	**/
 	public static function isDirectory( path : String ) : Bool
 	{
 		var f = new File(path);
@@ -90,36 +72,24 @@ class FileSystem {
 		return f.isDirectory();
 	}
 
-	/**
-		Create the given directory. Not recursive : the parent directory must exists.
-	**/
 	public static function createDirectory( path : String ) : Void
 	{
 		if (!new File(path).mkdirs())
 			throw "Cannot create dir " + path;
 	}
 
-	/**
-		Delete a given file.
-	**/
 	public static function deleteFile( path : String ) : Void
 	{
 		if (!new File(path).delete())
 			throw "Cannot delete file " + path;
 	}
 
-	/**
-		Delete a given directory.
-	**/
 	public static function deleteDirectory( path : String ) : Void
 	{
 		if (!new File(path).delete())
 			throw "Cannot delete directory " + path;
 	}
 
-	/**
-		Read all the files/directories stored into the given directory.
-	**/
 	public static function readDirectory( path : String ) : Array<String>
 	{
 		var f = new File(path);
@@ -127,5 +97,4 @@ class FileSystem {
 			throw "Path " + path + " doesn't exist";
 		return Lib.array( f.list() );
 	}
-
 }

std/java/_std/sys/io/File.hx

@@ -21,9 +21,6 @@
  */
 package sys.io;
 
-/**
-	API for reading and writing to files.
-**/
 @:coreApi
 class File {
 

std/java/_std/sys/io/FileInput.hx

@@ -27,9 +27,6 @@ import haxe.io.Input;
 import java.io.EOFException;
 import java.io.IOException;
 
-/**
-	Use [sys.io.File.read] to create a [FileInput]
-**/
 class FileInput extends Input {
 	var f:java.io.RandomAccessFile;
 	public function new(f)

std/java/_std/sys/io/FileOutput.hx

@@ -26,9 +26,6 @@ import haxe.io.Output;
 import java.io.EOFException;
 import java.io.IOException;
 
-/**
-	Use [sys.io.File.write] to create a [FileOutput]
-**/
 class FileOutput extends Output {
 	var f:java.io.RandomAccessFile;
 	public function new(f)

std/java/_std/sys/net/Host.hx

@@ -22,20 +22,11 @@
 package sys.net;
 import java.net.InetAddress;
 
-/**
-	A given IP host name.
-**/
 class Host {
-	/**
-		The actual IP corresponding to the host.
-	**/
 	public var ip(default,null) : Int;
 
 	@:allow(sys.net) private var wrapped:InetAddress;
-	/**
-		Creates a new Host : the name can be an IP in the form "127.0.0.1" or an host name such as "google.com", in which case
-		the corresponding IP address is resolved using DNS. An exception occur if the host name could not be found.
-	**/
+
 	public function new( name : String ) : Void
 	{
 		try
@@ -46,25 +37,16 @@ class Host {
 		this.ip = cast(rawIp[3], Int) | (cast(rawIp[2], Int) << 8) | (cast(rawIp[1], Int) << 16) | (cast(rawIp[0], Int) << 24);
 	}
 
-	/**
-		Returns the IP representation of the host
-	**/
 	public function toString() : String
 	{
 		return wrapped.getHostAddress();
 	}
 
-	/**
-		Perform a reverse-DNS query to resolve a host name from an IP.
-	**/
 	public function reverse() : String
 	{
 		return wrapped.getHostName();
 	}
 
-	/**
-		Returns the local computer host name
-	**/
 	public static function localhost() : String
 	{
 		try

std/java/_std/sys/net/Socket.hx

@@ -28,17 +28,12 @@ class Socket {
 	public var input(default,null) : haxe.io.Input;
 	public var output(default,null) : haxe.io.Output;
 
-	/**
-		A custom value that can be associated with the socket. Can be used to retreive your custom infos after a [select].
-	***/
 	public var custom : Dynamic;
 
 	private var sock:java.net.Socket;
 	private var server:java.net.ServerSocket;
 	private var boundAddr:java.net.SocketAddress;
-	/**
-		Creates a new unconnected socket.
-	**/
+
 	public function new() : Void
 	{
 		create();
@@ -53,9 +48,6 @@ class Socket {
 		} catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Closes the socket : make sure to properly close all your sockets or you will crash when you run out of file descriptors.
-	**/
 	public function close() : Void
 	{
 		try
@@ -68,25 +60,16 @@ class Socket {
 		catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Read the whole data available on the socket.
-	**/
 	public function read() : String
 	{
 		return input.readAll().toString();
 	}
 
-	/**
-		Write the whole data to the socket output.
-	**/
 	public function write( content : String ) : Void
 	{
 		output.writeString(content);
 	}
 
-	/**
-		Connect to the given server host/port. Throw an exception in case we couldn't sucessfully connect.
-	**/
 	public function connect( host : Host, port : Int ) : Void
 	{
 		try
@@ -98,9 +81,6 @@ class Socket {
 		catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Allow the socket to listen for incoming questions. The parameter tells how many pending connections we can have until they get refused. Use [accept()] to accept incoming connections.
-	**/
 	public function listen( connections : Int ) : Void
 	{
 		if (boundAddr == null) throw "You must bind the Socket to an address!";
@@ -109,9 +89,6 @@ class Socket {
 		catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Shutdown the socket, either for reading or writing.
-	**/
 	public function shutdown( read : Bool, write : Bool ) : Void
 	{
 		try
@@ -124,9 +101,6 @@ class Socket {
 		catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Bind the socket to the given host/port so it can afterwards listen for connections there.
-	**/
 	public function bind( host : Host, port : Int ) : Void
 	{
 		if (boundAddr != null)
@@ -136,9 +110,6 @@ class Socket {
 		this.boundAddr = new java.net.InetSocketAddress(host.wrapped, port);
 	}
 
-	/**
-		Accept a new connected client. This will return a connected socket on which you can read/write some data.
-	**/
 	public function accept() : Socket
 	{
 		var ret = try server.accept() catch(e:Dynamic) throw e;
@@ -149,9 +120,6 @@ class Socket {
 		return s;
 	}
 
-	/**
-		Return the informations about the other side of a connected socket.
-	**/
 	public function peer() : { host : Host, port : Int }
 	{
 		var rem:java.net.InetSocketAddress = cast sock.getInetAddress();
@@ -162,9 +130,6 @@ class Socket {
 		return { host: host, port: rem.getPort() };
 	}
 
-	/**
-		Return the informations about our side of a connected socket.
-	**/
 	public function host() : { host : Host, port : Int }
 	{
 		var local = sock.getLocalAddress();
@@ -174,9 +139,6 @@ class Socket {
 		return { host: host, port: sock.getPort() };
 	}
 
-	/**
-		Gives a timeout after which blocking socket operations (such as reading and writing) will abort and throw an exception.
-	**/
 	public function setTimeout( timeout : Float ) : Void
 	{
 		try
@@ -184,25 +146,16 @@ class Socket {
 		catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Block until some data is available for read on the socket.
-	**/
 	public function waitForRead() : Void
 	{
 		throw "Not implemented";
 	}
 
-	/**
-		Change the blocking mode of the socket. A blocking socket is the default behavior. A non-blocking socket will abort blocking operations immediatly by throwing a haxe.io.Error.Blocking value.
-	**/
 	public function setBlocking( b : Bool ) : Void
 	{
 		throw "Not implemented";
 	}
 
-	/**
-		Allows the socket to immediatly send the data when written to its output : this will cause less ping but might increase the number of packets / data size, especially when doing a lot of small writes.
-	**/
 	public function setFastSend( b : Bool ) : Void
 	{
 		try
@@ -210,18 +163,9 @@ class Socket {
 		catch(e:Dynamic) throw e;
 	}
 
-	/**
-		Wait until one of the sockets groups is ready for the given operation :
-		[read] contains sockets on which we want to wait for available data to be read,
-		[write] contains sockets on which we want to wait until we are allowed to write some data to their output buffers,
-		[others] contains sockets on which we want to wait for exceptional conditions.
-		[select] will block until one of the condition is met, in which case it will return the sockets for which the condition was true.
-		In case a [timeout] (in seconds) is specified, select might wait at worse until the timeout expires.
-	**/
 	public static function select(read : Array<Socket>, write : Array<Socket>, others : Array<Socket>, ?timeout : Float) : { read: Array<Socket>,write: Array<Socket>,others: Array<Socket> }
 	{
 		throw "Not implemented";
 		return null;
 	}
-
 }

std/neko/_std/sys/io/File.hx

@@ -24,9 +24,6 @@ package sys.io;
 enum FileHandle {
 }
 
-/**
-	API for reading and writing to files.
-**/
 @:coreApi class File {
 
 	public static function getContent( path : String ) : String {