63d4ce2b51
The info text for askYesNo was a problem. First, it involved a long, complex, paragraph encoded as string on the command line. That's NEVER a good idea. Secondly, it passed that string unprocessed to printf (albeit printf(1) but still) as a format string. And third, there's no way to manage line length when you're doing that. The alternative is to put the strings in a here document. We then cat the result between a couple of empty echo commands to create the original output. This addresses all of the above issues, but creates a new one: The info text follows the prompt, rather than the other way around. Not the most elegant. So … why do this at all, why not just echo the info text outside of the function, particularly since the function only echoes it once no matter how many times you give a bogus answer? Well, if at some point we decide to implement a dialog-type interface (whiptail, zenity, whatever you prefer), then it becomes easy to do so. Unsure that's desirable at this time, but options are good.
A2SERVER
AppleTalk server for Apple // computers developed by Ivan Drucker
Documentation here is sparse for the moment; see Ivan's site for information about A2SERVER and how it all works. There's a lot there and it's kind of evolved organically over the years just as the scripts themselves have, so it's going to be awhile before that information can be backfilled and perhaps organized into something you might call a user manual.
Such a manual should not be considered a replacement for Ivan's organic online documentation--those contents themselves represent Apple // history, if a relatively modern piece of it. As such they should be preserved as they are.
Developer note
To use the scripts on a server other than Ivan's, you need to do two things. First, the server needs to be modified to serve setup/index.txt and update/index.txt the same way they would serve index.html. How you do that is beyond the scope of this repository for the moment. Secondly, you'll want to set the shell variable A2SERVER_SCRIPT_URL to the base URL of this repository on your server. The base-URL should be slash-terminated. You can then run the following snippet:
wget a2server-setup ${A2SERVER_SCRIPT_URL}setup/; source a2server-setup
You should probably export A2SERVER_SCRIPT_URL in your .bashrc or whatever file configures your development environment. Also be advised that as of version 1.24 of A2SERVER, you must use the snippet above.