after you build, you can see the differences inside some files in your project. it creates three HXML files with the different flags: debug.hxml, release.hxml, and final.hxml. so if you run

lime build html5 -debug

, it would compile with bin/html5/haxe/debug.hxml (replace bin with Export, or whatever your project is using for the output directory)