From e79a1bb02a0ce3c265c4a64c117018a9207064c9 Mon Sep 17 00:00:00 2001 From: Ian Romanick Date: Mon, 13 Sep 2010 13:46:29 -0700 Subject: [PATCH] glsl: Explain file naming convention --- src/glsl/README | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/src/glsl/README b/src/glsl/README index 62742bf1396..dd80a53d476 100644 --- a/src/glsl/README +++ b/src/glsl/README @@ -215,3 +215,15 @@ talloc_parent() call is expensive, so many passes will cache the result of the first talloc_parent(). Cleaning up all the optimization passes to take a context argument and not call talloc_parent() is left as an exercise. + +Q: What is the file naming convention in this directory? + +Initially, there really wasn't one. We have since adopted one: + + - Files that implement code lowering passes should be named lower_* + (e.g., lower_noise.cpp). + - Files that implement optimization passes should be named opt_*. + - Files that implement a class that is used throught the code should + take the name of that class (e.g., ir_hierarchical_visitor.cpp). + - Files that contain code not fitting in one of the previous + categories should have a sensible name (e.g., glsl_parser.ypp). -- 2.30.2