From a63a96e877a7a3b77e90be2196a9ecd762d17d71 Mon Sep 17 00:00:00 2001
From: Eric Wasylishen <ewasylishen@gmail.com>
Date: Fri, 27 May 2016 20:45:44 -0600
Subject: [PATCH] light: update usage text

---
 light/light.cc | 60 +++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 55 insertions(+), 5 deletions(-)

diff --git a/light/light.cc b/light/light.cc
index cb1fdcd2..c89e128f 100644
--- a/light/light.cc
+++ b/light/light.cc
@@ -1401,11 +1401,61 @@ main(int argc, const char **argv)
     }
 
     if (i != argc - 1) {
-        printf("usage: light [-threads num] [-extra|-extra4]\n"
-               "             [-light num] [-addmin] [-anglescale|-anglesense]\n"
-               "             [-dist n] [-range n] [-gate n] [-lit|-lit2] [-lux] [-bspx] [-lmscale n]\n"
-               "             [-dirt] [-dirtdebug] [-dirtmode n] [-dirtdepth n] [-dirtscale n] [-dirtgain n] [-dirtangle n]\n"
-               "             [-soft [n]] [-fence] [-gamma n] [-surflight_subdivide n] [-surflight_dump] [-onlyents] [-sunsamples n] [-phongdebug] -[phong 0] bspfile\n");
+        printf(
+"usage: light [options] mapname.bsp\n" 
+"\n"
+"Performance options:\n"
+"-threads n          set the number of threads\n"
+"-extra              2x supersampling\n"
+"-extra4             4x supersampling, slowest, use for final compile\n"
+"-gate n             cutoff lights at this brightness level\n"
+"-sunsamples n       set samples for _sunlight2, default 64\n"
+"-surflight_subdivide  surface light subdivision size\n"
+"\n"
+"Output format options:\n"
+"-lit                write .lit file\n"
+"-onlyents           only update entities\n"
+"\n"
+"Global options:\n"
+"-light n            sets global minlight level n\n"
+"-addmin             additive minlight\n"
+"-anglescale n       set weight of cosine term, default 0.5, 1=realistic\n"
+"-anglesense n       same as -anglescale n\n"
+"-dist n             scale fade distance of all lights, default 1\n"
+"-range n            scale brightness of all lights, default 0.5\n"
+"-phong n            0=disable phong shading\n"
+"\n"
+"Dirtmapping (ambient occlusion) options:\n"
+"-dirt [n]           enable global AO, 0=disable even if set in worldspawn\n"
+"-dirtmode n         0=ordered (default), 1=random AO\n"
+"-dirtdepth n        distance for occlusion test, default 128\n"
+"-dirtscale n        scale factor for AO, default 1, higher values are darker\n"
+"-dirtgain n         exponent for AO, default 1, lower values are darker\n"
+"-dirtangle n        maximum angle for AO rays, default 88\n"
+"\n"
+"Bounce options:\n"
+"-bounce [n]         enables 1 bounce, 0=disable even if set in worldspawn\n"
+"-bouncescale n      scales brightness of bounce lighting, default 1\n"
+"-bouncecolorscale n amount to use texture color in bounce lighting, 0=none (default), 1=fully\n" 
+"\n"
+"Postprocessing options:\n"
+"-gamma n            gamma correct final lightmap, default 1.0\n"
+"-soft [n]           blurs the lightmap, not recommended\n"
+"\n"
+"Debug modes:\n"
+"-dirtdebug          only save the AO values to the lightmap\n"
+"-phongdebug         only save the normals to the lightmap\n"
+"-bouncedebug        only save bounced lighting to the lightmap\n"
+"-surflight_dump     dump surface lights to a .map file\n"
+"\n"
+"Experimental options:\n"
+"-lit2               write .lit2 file\n"
+"-lmscale n          change lightmap scale, vanilla engines only allow 16\n"
+"-lux                write .lux file\n"
+"-bspxlit            writes rgb data into the bsp itself\n"
+"-bspx               writes both rgb and directions data into the bsp itself\n"
+"-novanilla          implies -bspxlit. don't write vanilla lighting\n"
+        );
         exit(1);
     }