[Mesa-dev] [PATCH shader-db 0/3] Makefile and documentation cleanup

[Rhys Kidd]

Patchset adds Makefile and documentation improvements.

I aimed to write these as I would have found most helpful when seeking to
understand shader-db's operation, as a new Mesa developer.

First patch resolves the build errors [0] experienced on Ubuntu 15.04 and
permit a simple 'make' to work if the dependencies are met. The following two
patches improve the documentation of those dependencies.

[0]
$ cc --version
cc (Ubuntu 4.9.2-10ubuntu13) 4.9.2
...
$ make
cc -g -O2 -march=native -pipe -std=gnu99 -fopenmp  -lepoxy -lgbm  run.c   -o run
/tmp/ccaZrtAC.o: In function `main._omp_fn.0':
/home/usera/Coding/shader-db/run.c:511: undefined reference to `epoxy_eglBindAPI'
/home/usera/Coding/shader-db/run.c:513: undefined reference to `epoxy_eglCreateContext'
/home/usera/Coding/shader-db/run.c:516: undefined reference to `epoxy_eglMakeCurrent'
/home/usera/Coding/shader-db/run.c:528: undefined reference to `epoxy_eglCreateContext'
/home/usera/Coding/shader-db/run.c:536: undefined reference to `epoxy_eglMakeCurrent'
/home/usera/Coding/shader-db/run.c:541: undefined reference to `epoxy_glEnable'
/home/usera/Coding/shader-db/run.c:542: undefined reference to `epoxy_glEnable'
/home/usera/Coding/shader-db/run.c:543: undefined reference to `epoxy_glDebugMessageControl'
/home/usera/Coding/shader-db/run.c:545: undefined reference to `epoxy_glDebugMessageControl'
/home/usera/Coding/shader-db/run.c:548: undefined reference to `epoxy_glDebugMessageCallback'
/home/usera/Coding/shader-db/run.c:642: undefined reference to `epoxy_eglDestroyContext'
/home/usera/Coding/shader-db/run.c:643: undefined reference to `epoxy_eglDestroyContext'
/home/usera/Coding/shader-db/run.c:644: undefined reference to `epoxy_eglReleaseThread'
/home/usera/Coding/shader-db/run.c:585: undefined reference to `epoxy_eglMakeCurrent'
/home/usera/Coding/shader-db/run.c:620: undefined reference to `epoxy_glGenProgramsARB'
/home/usera/Coding/shader-db/run.c:621: undefined reference to `epoxy_glBindProgramARB'
/home/usera/Coding/shader-db/run.c:622: undefined reference to `epoxy_glProgramStringARB'
/home/usera/Coding/shader-db/run.c:624: undefined reference to `epoxy_glDeleteProgramsARB'
/home/usera/Coding/shader-db/run.c:625: undefined reference to `epoxy_glGetError'
/home/usera/Coding/shader-db/run.c:594: undefined reference to `epoxy_glCreateProgram'
/home/usera/Coding/shader-db/run.c:611: undefined reference to `epoxy_glAttachShader'
/home/usera/Coding/shader-db/run.c:612: undefined reference to `epoxy_glDeleteShader'
/home/usera/Coding/shader-db/run.c:597: undefined reference to `epoxy_glCreateShader'
/home/usera/Coding/shader-db/run.c:598: undefined reference to `epoxy_glShaderSource'
/home/usera/Coding/shader-db/run.c:599: undefined reference to `epoxy_glCompileShader'
/home/usera/Coding/shader-db/run.c:602: undefined reference to `epoxy_glGetShaderiv'
/home/usera/Coding/shader-db/run.c:606: undefined reference to `epoxy_glGetShaderInfoLog'
/home/usera/Coding/shader-db/run.c:615: undefined reference to `epoxy_glLinkProgram'
/home/usera/Coding/shader-db/run.c:616: undefined reference to `epoxy_glDeleteProgram'
/home/usera/Coding/shader-db/run.c:517: undefined reference to `epoxy_glEnable'
/home/usera/Coding/shader-db/run.c:518: undefined reference to `epoxy_glEnable'
/home/usera/Coding/shader-db/run.c:519: undefined reference to `epoxy_glDebugMessageControl'
/home/usera/Coding/shader-db/run.c:521: undefined reference to `epoxy_glDebugMessageControl'
/home/usera/Coding/shader-db/run.c:525: undefined reference to `epoxy_glDebugMessageCallback'
/tmp/ccaZrtAC.o: In function `main':
/home/usera/Coding/shader-db/run.c:334: undefined reference to `epoxy_eglQueryString'
/home/usera/Coding/shader-db/run.c:354: undefined reference to `gbm_create_device'
/home/usera/Coding/shader-db/run.c:361: undefined reference to `epoxy_eglGetPlatformDisplayEXT'
/home/usera/Coding/shader-db/run.c:369: undefined reference to `epoxy_eglInitialize'
/home/usera/Coding/shader-db/run.c:379: undefined reference to `epoxy_eglQueryString'
/home/usera/Coding/shader-db/run.c:395: undefined reference to `epoxy_eglChooseConfig'
/home/usera/Coding/shader-db/run.c:659: undefined reference to `epoxy_eglTerminate'
/home/usera/Coding/shader-db/run.c:661: undefined reference to `gbm_device_destroy'
/home/usera/Coding/shader-db/run.c:401: undefined reference to `epoxy_eglBindAPI'
/home/usera/Coding/shader-db/run.c:412: undefined reference to `epoxy_eglCreateContext'
/home/usera/Coding/shader-db/run.c:415: undefined reference to `epoxy_eglMakeCurrent'
/home/usera/Coding/shader-db/run.c:462: undefined reference to `epoxy_eglCreateContext'
/home/usera/Coding/shader-db/run.c:470: undefined reference to `epoxy_eglMakeCurrent'
/home/usera/Coding/shader-db/run.c:475: undefined reference to `epoxy_glGetString'
/home/usera/Coding/shader-db/run.c:478: undefined reference to `epoxy_glGetString'
/home/usera/Coding/shader-db/run.c:417: undefined reference to `epoxy_glGetIntegerv'
/home/usera/Coding/shader-db/run.c:426: undefined reference to `epoxy_glGetStringi'
/home/usera/Coding/shader-db/run.c:449: undefined reference to `epoxy_glGetString'
collect2: error: ld returned 1 exit status
<builtin>: recipe for target 'run' failed
make: *** [run] Error 1


Rhys Kidd (3):
  Makefile: avoid undefined reference build errors with LIBS
  docs: Improve dependencies documentation
  docs: Add symbolic link generation step

 .gitignore |  1 +
 Makefile   | 14 +++++++++++---
 README     | 18 +++++++++++++++++-
 3 files changed, 29 insertions(+), 4 deletions(-)

-- 
2.1.4