From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.4 Path: eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!news.eternal-september.org!mx02.eternal-september.org!.POSTED!not-for-mail From: "Jeffrey R. Carter" Newsgroups: comp.lang.ada Subject: Re: New Version of PragmARC.Text_IO Date: Fri, 4 Mar 2016 11:36:24 -0700 Organization: Also freenews.netfront.net; news.tornevall.net; news.eternal-september.org Message-ID: References: <60553d26-5829-46a4-8885-8b869a92e931@googlegroups.com> Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Injection-Date: Fri, 4 Mar 2016 18:33:23 -0000 (UTC) Injection-Info: mx02.eternal-september.org; posting-host="48b46be33beed75863f69afa437f956b"; logging-data="26938"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX180ULSK34suRvXpTToOOSgg2STfOepcQOw=" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.5.1 In-Reply-To: <60553d26-5829-46a4-8885-8b869a92e931@googlegroups.com> Cancel-Lock: sha1:JKhp4wiW7sBoiBc442pCjEQe0LU= Xref: news.eternal-september.org comp.lang.ada:29670 Date: 2016-03-04T11:36:24-07:00 List-Id: On 03/04/2016 08:05 AM, jrmarino wrote: > Hi Jeff, > Thanks for moving this to Github. It made it easy for me to add PragmARCs to FreeBSD ports: > http://www.freshports.org/devel/pragmarcs/ I'm glad this helped you. However, I haven't moved them to GitHub; rather, I've provided an alternative access path to the code through GitHub. This was primarily to assist the distribution of some Gnoga demo code. > Some observations: > 1) You *really* need some documentation in the actual repository (more than just list each package with a one-line description, which isn't even in the repo). Documentation should be installed. There are 2 questions that apply here: which version of the PragmARCs you're referring to, and what you mean by repository. The Ada-95 version comes with a set of test programs and some documentation, all provided through the main site for the components, pragmada.x10hosting.com. These are not part of the components' code, and so not found at GitHub. But the primary documentation for a pkg is in its spec. The version that uses features of ISO/IEC 8652:2007 is labeled "beta" and is only the source code. The test programs and documentation for the Ada-95 version may be useful as a starting point for a better understanding of this version than provided by the pkg specs. Someday I might make the effort to convert the test programs and add some documentation to this version and move it out of beta status. > 2) It would really help to use github's "release" mechanism by tagging. Since there was no release info, I had to invent a versioning scheme and I picked a ISO8601 date scheme and a git hash tag. It would provide more re-ensurance to correspond to actual releases instead of random tags. The beta version for ISO/IEC 8652:2007 comes as ZIP files with the year and month of the release as part of the file name. The branch at GitHub that reflects this version contains the most recent of these. There's been no change to the Ada-95 version for several years so it exists as a single, undated ZIP file. > 3) it built very cleanly with gcc5 FSF. there was only one warning in the whole thing (unreachable code on line 108 of the menu_handler) Interesting. IIRC, that line is in there because of a compiler warning that there was no return statement there. -- Jeff Carter "The men get one hot meal a day: a bowl of steam." Take the Money and Run 145