README.dev 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. # StarPU --- Runtime system for heterogeneous multicore architectures.
  2. #
  3. # Copyright (C) 2009, 2010, 2011 Université de Bordeaux 1
  4. # Copyright (C) 2010, 2011 Centre National de la Recherche Scientifique
  5. #
  6. # StarPU is free software; you can redistribute it and/or modify
  7. # it under the terms of the GNU Lesser General Public License as published by
  8. # the Free Software Foundation; either version 2.1 of the License, or (at
  9. # your option) any later version.
  10. #
  11. # StarPU is distributed in the hope that it will be useful, but
  12. # WITHOUT ANY WARRANTY; without even the implied warranty of
  13. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14. #
  15. # See the GNU Lesser General Public License in COPYING.LGPL for more details.
  16. Contents
  17. ========
  18. - Developer Warnings
  19. - Naming Conventions
  20. - Coding Style
  21. Developer Warnings
  22. ------------------
  23. They are enabled only if the STARPU_DEVEL environment variable is
  24. defined to a non-empty value, when calling configure.
  25. Naming Conventions
  26. ------------------
  27. * Prefix names of public objects (types, functions, etc.) with "starpu"
  28. * Prefix names of internal objects (types, functions, etc.) with "_starpu"
  29. * Names for qualified types (struct, union, enum) do not end with _t, _s or similar.
  30. Use _t only for typedef types, such as opaque public types, e.g
  31. typedef struct _starpu_data_state* starpu_data_handle_t;
  32. or
  33. typedef uint64_t starpu_tag_t;
  34. * When a variable can only take a finite set of values, use an enum
  35. type instead of defining macros for each of the values.
  36. Coding Style
  37. ------------
  38. * Curly braces always go on a new line