First commit of partial RosettaCode contents.

Pushing this for testing purposes. Lots of work still needed.

Task/Comments/0DESCRIPTION

@@ -0,0 +1,4 @@
+Demonstrate all ways to include text in a language source file which is completely ignored by the compiler or interpreter.
+
+'''See Also:'''<br>
+* [http://xkcd.com/156 xkcd] (Humor: hand gesture denoting <code>//</code> for "commenting out" people).

Task/Comments/1META.yaml

@@ -0,0 +1,2 @@
+---
+note: Basic language learning

Task/Comments/4D/comments.4d

@@ -0,0 +1 @@
+`Comments in 4th Dimension begin with the accent character and extend to the end of the line.

Task/Comments/AWK/comments.awk

@@ -0,0 +1,3 @@
+BEGIN { # this code does something
+  # do something
+}

Task/Comments/Befunge/comments-2.bf

@@ -0,0 +1,6 @@
+&;read a number;2+;add two;.@;display result and exit;
+  ^- inline comments -^     <-^- other comments
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;completely isolated comment block for the paranoid;
+;(almost - you can still skip into it.)            ;
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

Task/Comments/Befunge/comments.bf

@@ -0,0 +1,2 @@
+& read a number 2+ add two .@ display result and exit
+  ^- inline comments -^     <-^- other comments

Task/Comments/C/comments-2.c

@@ -0,0 +1,2 @@
+struct charisma {};
+void f(char/* comment */isma) {}

Task/Comments/C/comments-3.c

@@ -0,0 +1 @@
+/* some comment /* trying to nest some other comment */ inside */

Task/Comments/C/comments-4.c

@@ -0,0 +1,3 @@
+#if 0
+While technically not a comment, this is also ignored by the compiler
+#endif

Task/Comments/C/comments-5.c

@@ -0,0 +1,7 @@
+#ifdef UNDEFINED
+This is not compiled.
+#if 0
+Nor is this.
+#endif
+And this still is not compiled.
+#endif

Task/Comments/C/comments-6.c

@@ -0,0 +1,3 @@
+#if 0	
+This isn't valid.	
+#endif

Task/Comments/C/comments-7.c

@@ -0,0 +1 @@
+// C++ single-line comments were adopted in the C99 standard.

Task/Comments/C/comments.c

@@ -0,0 +1,4 @@
+/* This is a comment. */
+/* So is this
+   multiline comment.
+ */

Task/Comments/Clojure/comments-2.clj

@@ -0,0 +1 @@
+(comment (println (foo)) "bar" :baz 123 (System/exit 0))  ;; does nothing, returns nil

Task/Comments/Clojure/comments-3.clj

@@ -0,0 +1,2 @@
+(+ 1 (comment "foo") 3)  ;; Throws an exception, because it tries to add nil to an integer
+(+ 1 #_"foo" 3)          ;; Returns 4

Task/Comments/Clojure/comments.clj

@@ -0,0 +1,3 @@
+;; This is a comment
+(defn foo []
+  123) ; also a comment

Task/Comments/CoffeeScript/comments.coffee

@@ -0,0 +1,5 @@
+# one line comment
+
+### multi
+line
+comment ###

Task/Comments/Erlang/comments.erl

@@ -0,0 +1 @@
+% Erlang comments begin with "%" and extend to the end of the line.

Task/Comments/Forth/comments-2.fth

@@ -0,0 +1 @@
+: myword ( a b -- c )  ...

Task/Comments/Forth/comments-3.fth

@@ -0,0 +1,2 @@
+: add'em ( a b -- a+b )   + ;
+: strlen ( addr -- len )   count nip ;

Task/Comments/Forth/comments-4.fth

@@ -0,0 +1,11 @@
+\s skips all remaining text in the file
+(( skips until the next double-paren,
+   stretching across multiple lines ))
+comment:
+   Ignore all text in this section
+comment;
+doc
+   Another comment block
+enddoc
+/* C-style comment */
+(* Pascal-style comment *)

Task/Comments/Forth/comments.fth

@@ -0,0 +1,2 @@
+\ The backslash skips everything else on the line
+( The left paren skips everything up to the next right paren on the same line)

Task/Comments/Fortran/comments-2.f

@@ -0,0 +1,2 @@
+C     If compiled in debugging mode, print the current value of I
+D     PRINT *, I

Task/Comments/Fortran/comments-3.f

@@ -0,0 +1 @@
+real :: a = 0.0   ! initialize A to be zero

Task/Comments/Fortran/comments-4.f

@@ -0,0 +1,7 @@
+?? if (.false.) then
+do while (oh_no)
+   a = bad_news()
+   b = big_mistake()
+   c = gigo()
+end do
+?? end if

Task/Comments/Fortran/comments.f

@@ -0,0 +1,2 @@
+C     This would be some kind of comment
+C     Usually one would avoid columns 2-6 even in a comment.

Task/Comments/Go/comments.go

@@ -0,0 +1,5 @@
+// this is a single line comment
+/* this is
+   a multi-line
+   block comment.
+/* It does not nest */

Task/Comments/Haskell/comments.hs

@@ -0,0 +1,15 @@
+i code = True -- I am a comment.
+
+{- I am also
+   a comment. {-comments can be nested-}
+   let u x = x x (this code not compiled)
+   Are you? -}
+
+-- |This is a Haddock documentation comment for the following code
+i code = True
+-- ^This is a Haddock documentation comment for the preceding code
+
+{-|
+  This is a Haddock documentation block comment
+-}
+i code = True

Task/Comments/Java/comments-2.java

@@ -0,0 +1,5 @@
+/*
+ * This is
+ * a multiple
+ * line comment.
+ */

Task/Comments/Java/comments-3.java

@@ -0,0 +1 @@
+// This is a comment

Task/Comments/Java/comments-4.java

@@ -0,0 +1 @@
+/** This is a Javadoc comment */

Task/Comments/Java/comments-5.java

@@ -0,0 +1,5 @@
+/**
+ * This is
+ * a multiple
+ * line Javadoc comment
+ */

Task/Comments/Java/comments.java

@@ -0,0 +1 @@
+/* This is a comment */

Task/Comments/LaTeX/comments-2.tex

@@ -0,0 +1,7 @@
+\newcommand{\firstpart}{understand}
+\newcommand{\secondpart}{able}
+\newcommand{\complete}{%
+\firstpart%
+\secondpart}
+
+\complete

Task/Comments/LaTeX/comments.tex

@@ -0,0 +1 @@
+% This is a comment

Task/Comments/Lua/comments-2.lua

@@ -0,0 +1,2 @@
+--[====[ A multi-line comment that can contain [[ many square brackets ]]
+]====]

Task/Comments/Lua/comments.lua

@@ -0,0 +1,4 @@
+-- A single line comment
+
+--[[A multi-line
+    comment --]]

Task/Comments/PHP/comments-2.php

@@ -0,0 +1,2 @@
+$var = 1; # this is the comment part
+$var = 1; // this is the comment part

Task/Comments/PHP/comments-3.php

@@ -0,0 +1,4 @@
+/*
+Here are my comments
+this is multi-line
+*/

Task/Comments/PHP/comments-4.php

@@ -0,0 +1,4 @@
+/**
+ * phpdoc Comments
+ * @todo this is a todo stub
+ */

Task/Comments/PHP/comments.php

@@ -0,0 +1,2 @@
+# this is commented
+// this is commented

Task/Comments/Perl/comments-2.pl

@@ -0,0 +1 @@
+my $var = 1; # this is the comment part

Task/Comments/Perl/comments-3.pl

@@ -0,0 +1,6 @@
+=pod
+
+Here are my comments
+this is multi-line
+
+=cut

Task/Comments/Perl/comments-4.pl

@@ -0,0 +1,4 @@
+=head1
+=head4
+=over 4
+=Any Old String

Task/Comments/Perl/comments.pl

@@ -0,0 +1 @@
+# this is commented

Task/Comments/PicoLisp/comments.l

@@ -0,0 +1,12 @@
+# The rest of the line is ignored
+#{
+   This is a
+   multiline comment
+}#
+NIL
+Immediately stop reading this file. Because all text in the input file following
+a top-level 'NIL' is ignored.
+
+This is typically used conditionally, with a read-macro expression like
+`*Dbg
+so that this text is only read if in debugging mode.

Task/Comments/Python/comments-2.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python
+# Example of using doc strings
+"""My Doc-string example"""
+
+class Foo:
+     '''Some documentation for the Foo class'''
+     def __init__(self):
+        "Foo's initialization method's documentation"
+
+def bar():
+    """documentation for the bar function"""
+
+if __name__ == "__main__":
+    print (__doc__)
+    print (Foo.__doc__)
+    print (Foo.__init__.__doc__)
+    print (bar.__doc__)

Task/Comments/Python/comments.py

@@ -0,0 +1,9 @@
+"""Un-assigned strings in triple-quotes might be used
+   as multi-line comments
+"""
+
+'''
+   "triple quoted strings" can be delimited by either 'single' or "double" quote marks; and they can contain mixtures
+   of other quote marks without any need to \escape\ them using any special characters.  They also may span multiple
+   lines without special escape characters.
+'''

Task/Comments/REXX/comments-2.rexx

@@ -0,0 +1,3 @@
+-- A REXX line comment
+
+say "something" -- another line comment

Task/Comments/REXX/comments.rexx

@@ -0,0 +1,42 @@
+/*REXX program to demonstrate various uses and types of comments. */
+
+/* everything between a "climbstar" and a "starclimb" (exclusive of literals) is
+   a comment.
+                         climbstar =  /*   [slash-asterisk]
+                         starclimb =  */   [asterisk-slash]
+
+            /* this is a nested comment, by gum! */
+            /*so is this*/
+
+Also, REXX comments can span multiple records.
+
+There can be no intervening character between the slash and asterisk  (or
+the asterisk and slash).  These two joined characters cannot be separated
+via a continued line, as in the manner of:
+
+       say 'If I were two─faced,' ,
+           'would I be wearing this one?' ,
+           '      --- Abraham Lincoln'
+
+Here come's the thingy that ends this REXX comment. ───┐
+                                                       │
+                                                       │
+                                                       ↓
+
+                                                       */
+
+    hour = 12       /*high noon                   */
+midnight = 00       /*first hour of the day       */
+   suits = 1234     /*card suits:   ♥  ♦  ♣  ♠    */
+
+hutchHdr = '/*'
+hutchEnd = "*/"
+
+    /* the previous two "hutch" assignments aren't
+       the start  nor  the end of a REXX comment. */
+
+  x=1000000 **   /*¡big power!*/   1000
+
+/*not a real good place for a comment (above),
+  but essentially, a REXX comment can be
+  anywhere whitespace is allowed.            */

Task/Comments/Ruby/comments.rb

@@ -0,0 +1,5 @@
+x = "code" # I am a comment
+
+=begin hello
+I a POD documentation comment like Perl
+=end puts "code"

Task/Comments/Scala/comments.scala

@@ -0,0 +1,4 @@
+// A single line comment
+
+/* A multi-line
+   comment */

Task/Comments/Tcl/comments-2.tcl

@@ -0,0 +1,4 @@
+set aList {foo}
+lappend aList # bar
+puts $aList           ;# ==> prints "foo # bar"
+puts [llength $aList] ;# ==> 3

Task/Comments/Tcl/comments-3.tcl

@@ -0,0 +1,3 @@
+if 0 {
+   Comments...
+}

Task/Comments/Tcl/comments.tcl

@@ -0,0 +1,3 @@
+# comment on a line by itself. The next is a command by itself:
+set var1 $value1
+set var2 $value2 ; # comment that follows a line of code