Clean-up logging in build scripts

[dhowe]

Not a critical issue, but there are massive numbers of warnings and debugging output in the bill scripts that make it difficult to tell if things are working correctly. Would be nice to clean these up. A bit of output is shown below but it even worse in the tests:

$ grunt
(node:47751) Warning: Accessing non-existent property 'cat' of module exports inside circular dependency
(Use `node --trace-warnings ...` to show where the warning was created)
(node:47751) Warning: Accessing non-existent property 'cd' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'chmod' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'cp' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'dirs' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'pushd' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'popd' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'echo' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'tempdir' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'pwd' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'exec' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'ls' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'find' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'grep' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'head' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'ln' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'mkdir' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'rm' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'mv' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'sed' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'set' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'sort' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'tail' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'test' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'to' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'toEnd' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'touch' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'uniq' of module exports inside circular dependency
(node:47751) Warning: Accessing non-existent property 'which' of module exports inside circular dependency
Running "yuidoc:prod" (yuidoc) task
Failed to find lines for {
  name: 'Shape',
  submodules: {
    '2D Primitives': 1,
    Curves: 1,
    Vertex: 1,
    '3D Primitives': 1,
    '3D Models': 1
  },
  elements: {},
  classes: {},
  fors: { p5: 1 },
  namespaces: {}
}
Failed to find lines for {
  name: 'Events',
  submodules: { Acceleration: 1, Keyboard: 1, Mouse: 1, Touch: 1 },
  elements: {},
  classes: {},
  fors: { p5: 1 },
  namespaces: {}
}
src/io/files.js:1388: method p5.save missing example
src/webgl/material.js:151: method p5.shader missing example
src/webgl/p5.Camera.js:187: method p5.createCamera missing example
src/webgl/p5.Camera.js:298: method p5.Camera.perspective missing example
src/webgl/p5.Camera.js:380: method p5.Camera.ortho missing example
src/webgl/p5.Camera.js:671: method p5.Camera.camera missing example
src/webgl/p5.Geometry.js:50: method p5.Geometry.computeFaces missing example
src/webgl/p5.Geometry.js:92: method p5.Geometry.computeNormals missing example
src/webgl/p5.Geometry.js:131: method p5.Geometry.averageNormals missing example
src/webgl/p5.Geometry.js:152: method p5.Geometry.averagePoleNormals missing example
src/webgl/p5.Geometry.js:245: method p5.Geometry.normalize missing example
src/webgl/p5.Shader.js:274: method p5.Shader.setUniform missing example
Start YUIDoc compile...
Scanning: src/, lib/addons/
Output: docs/reference/
YUIDoc compile completed in 0.778 seconds

[limzykenneth]

Would be happy to see the output cleaned up!

[rt1301]

@limzykenneth @dhowe If this issue is open, I would like to work on this. Can you suggest to me how to get started with it?

[limzykenneth]

@rt1301 Sure, do go ahead and see if it can be cleaned up

[rt1301]

One of the errors occurring in the YUIDocs is:

Failed to find lines for {
  name: 'Shape',
  submodules: {
    '2D Primitives': 1,
    Curves: 1,
    Vertex: 1,
    '3D Primitives': 1,
    '3D Models': 1
  },
  elements: {},
  classes: {},
  fors: { p5: 1 },
  namespaces: {}
}

@limzykenneth What does the "line" key-value pair signifies in the YUI Documentation?

[limzykenneth]

@rt1301 I'm not quite sure what you are referring to here. Can you elaborate a bit more?

[rt1301]

@limzykenneth In the data.json file we have all the p5.js reference functions written in this way:

"Structure": {
            "name": "Structure",
            "submodules": {},
            "elements": {},
            "classes": {},
            "fors": {
                "p5": 1
            },
            "namespaces": {},
            "module": "IO",
            "file": "src\\core\\main.js",
            "line": 1,
            "requires": [
                "constants"
            ]
        }

So what does "line":1 signifies in the YUI doc?

[limzykenneth]

That is the line number of where the function/property is defined in the code file. In the example here it means line 1 of src/core/main.js file. It is used to let the link at the bottom of the reference entry on the website link to the correct line where the function/property is defined.