{"action":"created","issue":{"url":"https://api.github.com/repos/RasppleII/a2server/issues/55","labels_url":"https://api.github.com/repos/RasppleII/a2server/issues/55/labels{/name}","comments_url":"https://api.github.com/repos/RasppleII/a2server/issues/55/comments","events_url":"https://api.github.com/repos/RasppleII/a2server/issues/55/events","html_url":"https://github.com/RasppleII/a2server/issues/55","id":123757066,"number":55,"title":"release notes for \"release\" 1.2.8 aka commit 14f5ef6","user":{"login":"IvanExpert","id":1761075,"avatar_url":"https://avatars.githubusercontent.com/u/1761075?v=3","gravatar_id":"","url":"https://api.github.com/users/IvanExpert","html_url":"https://github.com/IvanExpert","followers_url":"https://api.github.com/users/IvanExpert/followers","following_url":"https://api.github.com/users/IvanExpert/following{/other_user}","gists_url":"https://api.github.com/users/IvanExpert/gists{/gist_id}","starred_url":"https://api.github.com/users/IvanExpert/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/IvanExpert/subscriptions","organizations_url":"https://api.github.com/users/IvanExpert/orgs","repos_url":"https://api.github.com/users/IvanExpert/repos","events_url":"https://api.github.com/users/IvanExpert/events{/privacy}","received_events_url":"https://api.github.com/users/IvanExpert/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-12-24T04:31:02Z","updated_at":"2016-01-18T11:29:41Z","closed_at":null,"body":"I don't know where else to put these so I'm putting them here for now. They should be probably be incorporated into README.md and whatever final release notes go with 1.3.0, which I'll think about later provided what I've done here makes sense and you don't think needs reworking. Version 1.2.8 is not an actual release, though it is \"releasable\". I've designated it as such on the way to 1.3.0 (which might be 1.5.0).\r\n\r\n\r\nA2SERVER 1.2.8 release notes\r\n\r\nImportant: the default URL for binaries (ivanx.com/a2server/files) probably does not work, and until I clean that up on the web host for the 1.3.0 release, you'll need to use the new alternate binary server described below.\r\n\r\n\r\nPRELIMINARY JESSIE SUPPORT\r\n\r\nThe installer can be run on Debian 8 and Raspbian \"Jessie\". (It could before, but it would install untested libraries and compile for them, which was much slower.)\r\n\r\n\r\n\r\n64-BIT SUPPORT\r\n\r\n64-bit Debian 7 (Wheezy) and Debian 8 (Jessie) precompiled binaries are available and supported.\r\n\r\n\r\n\r\nTCP/IP OVER APPLETALK (MacIP) SUPPORT\r\n\r\nThe MacIPgw package, contributed by Jason King based on work by Stefan Bethke, allows for IIgs and classic Mac computers to connect to the Internet over LocalTalk by using MacIP.\r\n\r\n\r\n\r\nALTERNATE HOSTING FOR BINARIES\r\n\r\nNew A2SERVER_BINARY_URL variable supports hosting binaries elsewhere, including locally. It would usually contain \"${A2SERVER_SCRIPT_URL}files/\". A tarball containing the expected contents of this folder is at http://ivanx.com/a2server/files/dist/binaries.tar.gz. See below for an outline of the expected files.\r\n\r\nExternal dependencies (i.e. source code, older Debian packages, Apple II software) can be self-hosted. They need to go in \"${A2SERVER_BINARY_URL}external/\". A tarball containing the full contents of this folder is at http://ivanx.com/a2server/files/dist/external.tar.gz -- see below for an outline of the expected files.\r\n\r\nIf present, self-hosted external dependencies are automatically used as a fallback in case of failure when attempting to get the resources from external sites. This \"fallback\" can be preferred (that is, the external sites aren't tried) by exporting A2SERVER_NO_EXTERNAL=1.\r\n\r\n(There is at present no error checking for what happens if the fallback fails; you'll just get a broken install.)\r\n\r\n\r\n\r\nOFFLINE INSTALL\r\n\r\nUsing locally hosted binaries and external dependencies, it's possible to install completely offline if dependent packages have been previously installed, as follows.\r\n\r\nIf precompiled binaries are available:\r\n\r\nWheezy: unzip libgnustep-base1.22 libdb5.1 libgcrypt11 libssl1.0.0 attr fuse libglib2.0-0 libattr1 libfuse2\r\n\r\nJessie: unzip unar libdb5.3 libgcrypt20 libssl1.0.0 attr fuse libglib2.0-0 libattr1 libfuse2\r\n\r\nIf precompiled binaries are not available:\r\n\r\nWheezy: unzip build-essential zlib1g-dev libgnustep-base-dev libz-dev libbz2-dev libssl-dev libicu-dev libdb5.1-dev libgcrypt11-dev libglib2.0-dev libattr1-dev libfuse-dev\r\n\r\nJessie: unzip unar build-essential zlib1g-dev unzip libssl-dev libdb5.3-dev libgcrypt11-dev libglib2.0-dev libattr1-dev libfuse-dev\r\n\r\n\r\n\r\nEXTERNAL SUBDIRECTORY\r\n\r\nA completely populated external subdirectory, as of 1.2.8, contains the following files, which expand from external.tar.gz. A production tarball for developers would omit Apple_II_System_Disk_3.2.sea.bin, and the GS/OS installer disks; these could be added manually by the developer, with the names specified below.\r\n\r\n(click Edit to see these hierarchically as they're supposed to be, pending markdown reformatting.)\r\nexternal:\r\n\tappleii:\r\n\t\tApple_II_System_Disk_3.2.sea.bin\r\n\t\tAsimov.shk\r\n\t\tdsk2file.shk\r\n\t\tgshk11.sea\r\n\t\tgsos601:\r\n\t\t\tDisk_1_of_7-Install.sea.bin\r\n\t\t\tDisk_2_of_7-System.Disk.sea.bin\r\n\t\t\tDisk_3_of_7-SystemTools1.sea.bin\r\n\t\t\tDisk_4_of_7-SystemTools2.sea.bin\r\n\t\t\tDisk_5_of_7-Fonts.sea.bin\r\n\t\t\tDisk_6_of_7-synthLAB.sea.bin\r\n\t\t\tDisk_7_of_7-Apple_II_Setup.sea.bin\r\n\t\tgsos602:\r\n\t\t\tFonts1.po\r\n\t\t\tFonts2.po\r\n\t\t\tInstall.po\r\n\t\t\tsynthLAB.po\r\n\t\t\tSystem.Disk.po\r\n\t\t\tSystemTools1.po\r\n\t\t\tSystemTools2.po\r\n\t\t\tSystemTools3.po\r\n\t\tgsos603:\r\n\t\t\tFonts.po\r\n\t\t\tInstall.po\r\n\t\t\tsynthLAB.po\r\n\t\t\tSystem.Disk.po\r\n\t\t\tSystemTools1.po\r\n\t\t\tSystemTools2.po\r\n\t\tMOUNTIT.SHK\r\n\t\tshrinkit.sdk\r\n\t\tspectrum:\r\n\t\t\tspectrum_extras.2mg\r\n\t\t\tspectrum_gold_2mg.zip\r\n\t\t\tspectrum_manuals.2mg\r\n\t\t\tspectrum_sounds.2mg\r\n\t\t\tspectrum.2mg\r\n\tdeb:\r\n\t\tlibdb5.1_5.1.29-5_amd64.deb\r\n\t\tlibdb5.1_5.1.29-5_armhf.deb\r\n\t\tlibdb5.1_5.1.29-5_i386.deb\r\n\t\tlibdb5.1-dev_5.1.29-5_amd64.deb\r\n\t\tlibdb5.1-dev_5.1.29-5_armhf.deb\r\n\t\tlibdb5.1-dev_5.1.29-5_i386.deb\r\n\t\tlibgcrypt11_1.5.0-5+deb7u3_amd64.deb\r\n\t\tlibgcrypt11_1.5.0-5+deb7u3_armhf.deb\r\n\t\tlibgcrypt11_1.5.0-5+deb7u3_i386.deb\r\n\t\tlibgcrypt11-dev_1.5.0-5+deb7u3_amd64.deb\r\n\t\tlibgcrypt11-dev_1.5.0-5+deb7u3_armhf.deb\r\n\t\tlibgcrypt11-dev_1.5.0-5+deb7u3_i386.deb\r\n\tsource:\r\n\t\tciopfs-0.4.tar.gz\r\n\t\tmacipgw-src.zip\r\n\t\tnetatalk-2.2.4.tar.gz\r\n\t\tnulibdist.tar.gz\r\n\t\tunar-1.8.zip\r\n\r\n\r\nREORGANIZED FILES (BINARIES) SUBDIRECTORY\r\n\r\nThe following items are expected in the binaries folder, and are in the tarball binaries.tgz. The \"precompiled\" folder, or some subset of it, is optional; the items outside of it are not. If items in the precompiled folder are not found at install time, they will be compiled from source obtained from an external or self-hosted URL.\r\n\r\nfiles:\r\n\tA2CLOUD.DSK\r\n\tA2CLOUD.HDV\r\n\tA2FILES-list.txt\r\n\tappletalk-3.2.27+-rpi.ko.gz\r\n\tappletalk-3.6.11+-rpi.ko.gz\r\n\tappletalk-3.12.22+-rpi.ko.gz\r\n\tFARALLON.B1.BXY\r\n\tFARALLON.B1.PO\r\n\tmacip-prefs.tgz\r\n\tnetatalk-init.d-clean.txt\r\n\tnetatalk-maketar.txt\r\n\tprecompiled:\r\n\t\tappletalk-3.2.0-4-486-debian_x86.tgz\r\n\t\tappletalk-3.2.0-4-amd64-debian_x64.tgz\r\n\t\tappletalk-3.16.0-4-586-debian_x86.tgz\r\n\t\tappletalk-3.16.0-4-amd64-debian_x64.tgz\r\n\t\tciopfs-debian_x64.tgz\r\n\t\tciopfs-debian_x86.tgz\r\n\t\tciopfs-rpi.tgz\r\n\t\tmacipgw-debian_x64.tgz\r\n\t\tmacipgw-debian_x86.tgz\r\n\t\tmacipgw-rpi.tgz\r\n\t\tnetatalk224-debian_x64.tgz\r\n\t\tnetatalk224-debian_x86.tgz\r\n\t\tnetatalk224-rpi.tgz\r\n\t\tnulib2-debian_x64.tgz\r\n\t\tnulib2-debian_x86.tgz\r\n\t\tnulib2-rpi.tgz\r\n\t\tunar-debian_x64.tgz\r\n\t\tunar-debian_x86.tgz\r\n\t\tunar-rpi.tgz\r\n\r\n\r\n1.2.7:\r\nCase insensitive file system for A2FILES; existing is converted and GSFILES is removed if empty\r\nPreliminary Jessie support\r\nA2SERVER_SCRIPT_URL variable allows for installation from different site [had been available post 1.2.4, but only from Joseph's codebase]\r\nUnification of Ivan's and Joseph's codebases\r\n\r\n1.2.6:\r\nFull installation of Spectrum during netboot installation.\r\n"},"comment":{"url":"https://api.github.com/repos/RasppleII/a2server/issues/comments/172503293","html_url":"https://github.com/RasppleII/a2server/issues/55#issuecomment-172503293","issue_url":"https://api.github.com/repos/RasppleII/a2server/issues/55","id":172503293,"user":{"login":"IvanExpert","id":1761075,"avatar_url":"https://avatars.githubusercontent.com/u/1761075?v=3","gravatar_id":"","url":"https://api.github.com/users/IvanExpert","html_url":"https://github.com/IvanExpert","followers_url":"https://api.github.com/users/IvanExpert/followers","following_url":"https://api.github.com/users/IvanExpert/following{/other_user}","gists_url":"https://api.github.com/users/IvanExpert/gists{/gist_id}","starred_url":"https://api.github.com/users/IvanExpert/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/IvanExpert/subscriptions","organizations_url":"https://api.github.com/users/IvanExpert/orgs","repos_url":"https://api.github.com/users/IvanExpert/repos","events_url":"https://api.github.com/users/IvanExpert/events{/privacy}","received_events_url":"https://api.github.com/users/IvanExpert/received_events","type":"User","site_admin":false},"created_at":"2016-01-18T11:29:41Z","updated_at":"2016-01-18T11:29:41Z","body":"This is mostly covered by the expanded README.md, versionhistory.txt, and the A2SERVER web site, plus it is somewhat out of date, so I think it can be closed. The question is: Should some kind of release notes along these lines go somewhere like a wiki as you suggest?"}}