I wrote some code in the mean time. I also wait for the
bug report for ftpcopy, but nobody seems to have found it by
The new code is a caching library with some command line
around it. Nothing complicated, just a kind of "put this
cache and if there's not enough space then throw away the
entries", but it took me some days to get the bugs out. I'm
quite confident that it's stable by now.
Now i want to package it up and release it to the world,
that somebody else will not have to reinvent the wheel. But
coding for me is one thing, coding for others is completely
different. I mean, it hurts to say "you are an idiot
code doesn't work reliably" to yourself - but it hurts
if someone else tells this truth to you.
So i better make sure ... what? That's there the problem
- Documentation. There be a manual page? Sorry, have to
this myself. But i hate writing documentation.
i'm going to not use POD but tmac.an, and try to get
readable from groff -Thtml.
- Code quality. There's a big difference between "works
me" and "works or does something reasonable in every
"works for me" usually means "breaks on machines with
different endian or alignment requirements". Think of
everywhere. What about strange input values or a corrupted
cache? I've to re-read the whole
stuff. It's _so_ boring.
- What hidden limitations do the functions have? Remove
or document them (the problem is the "hidden" part).
- Simplicity: make sure that the code is so simple that at
i don't have problems to understand it in 17 months from
This possibly means to rewrite the function to enter
into the cache. Not funny.
- Library API: make sure the API is consistent. I tend to
not even notice
"f(char *buf, bufsize)" against "g(bufsize, buf)". Make
functions, constants, ... have reasonable names.
- Command line API: make sure the tools options and
- Locking: Did i _really_ correctly document the locking
requirements? I don't think i'll get it right the first time
That's _work_. Boring work. Stuff for some evenings.
And it's summer now. For that kind of stuff winter has
invented, i think.