I learned a long time ago that what starts out as a single file often becomes a directory.
E.g. one of my first "open source" things was my debug header, debug.h. Standardly ~/src/libag/debug.h
But many years later I drank the koolaid of testing, so I wanted debug-test.c. And a Makefile. Where did I put it?
Separate files makes it easy to copy debug.h without the tests:
And the Makefile would have to have stuff for all the things in the same directory. Messy.
So I learned that it was good to create "directory objects" for such things. Places where all of the usual things, e.g., associated with a single header-only library fo:
tests, Makefiles, README, man pages, etc.:
Makefile // just for debug.g
Makefile // just for some other lib header
So, all is happy. It is slightly annoying to have to type debug/debug.h, as in
but I am willing to do so to get the goodness of directory objects.
But then I encounter... barbarians. Tools that do not use "directory objects".
E.g. I recently had to debug my X windows setup. I'm learning that even simple stuff in something like a .twmrc needs tests. Where do I but them? .twmrc is in a directory, ~/,
shared by many tools.
Convention: create .twmrc.DIR, and put the stuff in there.
Generalization: given a file "file" that is not by itself in a directory "file/file", create "file.DIR/" as the place to hold such meta-information.
It might be nice to make this transparent: Create a file "file", and let it live without the stuff that I put in the accompanying or enclosing directory.
As long as it needs to.
But when it comes time to create the accompanying stuff, the meta stuff, like READMEs and manual pages and tests and examples and makefiles...
- allow file.DIR top be created. (Or cvall it file.meta, or ...).
But make file and file.DIR semi-transparent. If you do "cp file dest ", then it is equivalent to "cp -R file file.DIR dest".
Or, rather, perhaps, use the old concept of filesystem forks, such as resource forks.
Make "file" be an alias for "file.DIR/file".