Change plain text docs files to Markdown.

This includes CHANGES, INSTALL, LICENSE.

Author: lgritz

CHANGES CHANGES.mdCHANGES renamed to CHANGES.md

@@ -1,7 +1,5 @@
-Changes:
-
 Release 1.8 -- (in progress - dev) ?? 2016 (compared to 1.7)
-=====================================================
+--------------------------------------------------
 
 Language, standard libary, and compiler changes (for shader writers):
 * Language features:
@@ -107,7 +105,7 @@ Release 1.7.2 -- 1 Mar 2016 (compared to 1.7.1)
 
 
 Release 1.7 [1.7.1] -- 29 Jan 2016 (compared to 1.6)
-====================================================
+--------------------------------------------------
 Language, standard libary, and compiler changes (for shader writers):
 * Language features:
    * Support for closure arrays in shader inputs. #544 (1.7.0)
@@ -516,9 +514,9 @@ Release 1.5 (1.5.10) -- July 30, 2014 (compared to 1.4)
 ----------------------------------------------
 Language, standard libary, and compiler changes (for shader writers):
 * New closure function for microfacet BSDFs:
-    closure color microfacet (string distribution, normal N,
+      closure color microfacet (string distribution, normal N,
                               float alpha, float eta, int refract)
-    closure color microfacet (string distribution, normal N, vector U,
+      closure color microfacet (string distribution, normal N, vector U,
                           float xalpha, float yalpha, float eta, int refract)
   These replace the growing zoo of microfacet_blah functions (using
   different distribution values such as "beckmann" or "ggx", as well as
@@ -558,11 +556,11 @@ API changes, new options, new ShadingSystem features (for renderer writers):
      SEE SECTION BELOW ON GROUP-SPECIFIC ATTRIBUTES
    * New ShaderGroupBegin() variant takes a text description of a shader
      group. (3.5.8) (#379) For example:
-        ShaderGroupBegin ("groupname", "surface",
-                             "param float fin 3.14; " /*concatenate string*/
-                             "shader a alayer;"
-                             "shader b blayer;"
-                             "connect alayer.f_out blayer.f_in;");
+         ShaderGroupBegin ("groupname", "surface",
+                           "param float fin 3.14; " /*concatenate string*/
+                           "shader a alayer;"
+                           "shader b blayer;"
+                            "connect alayer.f_out blayer.f_in;");
    * ShadingSystem methods renderer() and texturesys() retrieve the
      RendererServices and TextureSystem, respectively. (1.5.8)
    * ShadingSystem statistics output now prints the version and major
@@ -1433,6 +1431,3 @@ Release 0.5.2 - Mar 14, 2011
   "smartcubic", "cubic", "linear", "closest").
 * Bug fixes to getmessage() and its handling of derivatives, which includes
   a slight RendererServices API change.
-
-
-

CMakeLists.txt

@@ -609,8 +609,8 @@ set (CPACK_PACKAGE_VENDOR "Sony Pictures Imageworks")
 set (CPACK_PACKAGE_DESCRIPTION_SUMMARY "OpenShadingLanguage is...")
 set (CPACK_PACKAGE_DESCRIPTION_FILE "${PROJECT_SOURCE_DIR}/src/doc/Description.txt")
 set (CPACK_PACKAGE_FILE_NAME OSL-${OSL_LIBRARY_VERSION_MAJOR}.${OSL_LIBRARY_VERSION_MINOR}.${OSL_LIBRARY_VERSION_PATCH}-${platform})
-file (COPY "${PROJECT_SOURCE_DIR}/LICENSE" DESTINATION "${CMAKE_BINARY_DIR}")
-file (RENAME "${CMAKE_BINARY_DIR}/LICENSE" "${CMAKE_BINARY_DIR}/License.txt")
+file (COPY "${PROJECT_SOURCE_DIR}/LICENSE.md" DESTINATION "${CMAKE_BINARY_DIR}")
+file (RENAME "${CMAKE_BINARY_DIR}/LICENSE.md" "${CMAKE_BINARY_DIR}/License.txt")
 set (CPACK_RESOURCE_FILE_LICENSE "${CMAKE_BINARY_DIR}/License.txt")
 file (COPY "${PROJECT_SOURCE_DIR}/README.md" DESTINATION "${CMAKE_BINARY_DIR}")
 file (RENAME "${CMAKE_BINARY_DIR}/README.md" "${CMAKE_BINARY_DIR}/Readme.txt")

INSTALL INSTALL.mdINSTALL renamed to INSTALL.md

@@ -1,5 +1,5 @@
 Building OSL
-------------
+============
 
 OSL currently compiles and runs cleanly on Linux and Mac OS X.  We have
 not yet compiled it for Windows, but we believe we it should be very
@@ -20,7 +20,7 @@ Here are the steps to check out, build, and test the OSL distribution:
 
 0. Install and build dependencies.  You will need Boost (www.boost.org),
    Imath (http://openexr.com/downloads.html), and OpenImageIO
-   (openimageio.org).
+   (http://openimageio.org).
 
    After building OpenImageIO, if you don't have it installed in a
    "standard" place (like /usr/include), you should set the environment
@@ -31,12 +31,12 @@ Here are the steps to check out, build, and test the OSL distribution:
 
 1. Check out a copy of the source code from the Git repository:
 
-     git clone https://github.com/imageworks/OpenShadingLanguage.git osl
+       git clone https://github.com/imageworks/OpenShadingLanguage.git osl
 
 2. Change to the distribution directory and 'make'
 
-     cd osl
-     make
+       cd osl
+       make
 
    Note: OSL uses 'CMake' for its cross-platform build system.  But for
    simplicity, we have made a "make wrapper" around it, so that by just
@@ -62,11 +62,8 @@ Here are the steps to check out, build, and test the OSL distribution:
 5. After building (and setting your library path), you can run the
    test suite with:
 
-     make test
+       make test
 
    (Note: currently all tests pass on OS X but a few tests fail on Linux
    strictly for floating point precision reasons, not because anything
    is really broken.  We're working on a fix for this.)
-
-
-

LICENSE LICENSE.mdLICENSE renamed to LICENSE.md

@@ -4,6 +4,7 @@ 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
@@ -12,6 +13,7 @@ met:
 * Neither the name of Sony Pictures Imageworks nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.
+
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

src/doc/CMakeLists.txt

@@ -3,9 +3,8 @@ set (public_docs osl-languagespec.pdf)
 
 install (FILES ${public_docs} DESTINATION doc COMPONENT documentation)
 
-install ( FILES "${PROJECT_SOURCE_DIR}/LICENSE"
-                "${PROJECT_SOURCE_DIR}/INSTALL"
-                "${PROJECT_SOURCE_DIR}/CHANGES"
+install ( FILES "${PROJECT_SOURCE_DIR}/LICENSE.md"
+                "${PROJECT_SOURCE_DIR}/INSTALL.md"
+                "${PROJECT_SOURCE_DIR}/CHANGES.md"
                 "${PROJECT_SOURCE_DIR}/README.md"
           DESTINATION . )
-