Joshau Bloch talk on API design
It’s very worth watching/reading.
Maybe I need a wiki as well as a blog? Stream of consciousness writing in the blog as a temporal reference, constant editing in the wiki? Is there something better than a wiki?
This is one of my posts of “study the mistakes of others, so you can learn from them and not repeat them directly or indirectly”.
This is common to see, at least for me
The directory name y:\backup-2012-09-01-2230\Applications\Adobe Acrobat 9 Pro\Adobe Acrobat Pro.app\Contents\Plug-ins\PaperCapture.acroplugin\Contents\Frameworks\OCRLibrary.framework\Versions\A\Frameworks\iDRS.framework\Versions\A\Resources\Asian.framework\Versions\A\.AppleDouble is too long.
(ignore the fact I’m cataloging Mac apps on a Windows share).
The 260 character limit is so deeply embedded in the Windows system that it’s been almost impossible for Microsoft to eradicate it; it persists even into theoretically new frameworks like .NET (mainly because .NET isn’t actually a completely new system, it’s in many cases a thin shim on top of the older Win32 libraries). While there are APIs that let you access paths up to 32767 characters long, there’s enough bits in the system that use the older MAX_PATH limit that you really can’t do anything about it. So while you can use Windows NT-style paths in many cases (paths prefixed with \\?) in your own code, some core APIs in Windows use the old functions (like LoadLibrary, for example).
Note that you can use \\? paths with cmd.exe, BUT these must be drive letter paths, UNC paths don’t work (don’t know why, maybe one needs to use the NT file namespace or volume GUID path?), and it’s useless, because the resultant path is still subject to MAX_PATH limitations. You also can’t set the current working directory to a UNC path (unless you employ a registry hack, see Microsoft KB 156276).
There are a few workarounds I’ve used in the past:
All of these create new virtual hierarchies so that you can read a deeply nested file without needing a path longer than MAX_PATH; the first two can at best double the length, though.
There are some wacky things people have done in code.
Starting in Windows Vista, the shell starts shrinking individual elements in the path until the whole thing fits within MAX_PATH. This is why you can browse a really deep hierarchy in Explorer.exe, and usually copy it or delete it. This, of course, requires that NT short name creation is not disabled.
Of course, the real answer is “stop using Windows, and just use Unix (Linux or Mac OS X)”, but there’s still a lot of programs that run on Windows and not Unix…
These are mostly tech/news
This is a list I’ll maintain of books you need to either read; either you will learn from them, or you will confirm that you have already mastered their contents.
Read the Pragmatic Programmer.
It’s hard to over-sell this book. If you know and live everything in this book, then I definitely want to hire you.
Software Foundations is published online. It’s pretty amazing. It’s both a study of the foundations of programming languages, a use of Coq (“an industrial-strength proof assistant), and a more advanced introduction to functional programming. The book is aimed at Ph.D. students and researchers, but should be understandable by someone at the upper end of the undergraduate level.
Here’s a collection of solutions to the exercises in the book: https://github.com/dragonwasrobot/software-foundations-exercises
This is a list of blogs I’ve read. I’m keeping the list roughly sorted by last-update time, so blogs that are infrequently updated are nearer the bottom (and blogs updated less often than say six months just fall off the bottom).