From b81617dec85a3d2574dd288dc18fc6548c6edb54 Mon Sep 17 00:00:00 2001 From: Brian Holman Date: Mon, 9 Nov 2026 23:45:55 -0700 Subject: [PATCH] Add VCC Plus disk packaging and verified Ebitor demo documentation --- .gitattributes | 3 + .gitignore | 15 + COPYING | 674 +++++++++++++++++++++++++++++++++++ Ebitor.DSK | Bin 0 -> 161280 bytes README.md | 168 ++------- VCCPlus.mk | 9 + docs/PROVENANCE.md | 50 +++ docs/UPSTREAM_README.md | 150 ++++++++ docs/VALIDATION.md | 47 +++ docs/screenshots/editor.png | Bin 0 -> 8050 bytes docs/screenshots/running.png | Bin 0 -> 8626 bytes vccplus-project.json | 25 ++ 12 files changed, 1002 insertions(+), 139 deletions(-) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 COPYING create mode 100644 Ebitor.DSK create mode 100644 VCCPlus.mk create mode 100644 docs/PROVENANCE.md create mode 100644 docs/UPSTREAM_README.md create mode 100644 docs/VALIDATION.md create mode 100644 docs/screenshots/editor.png create mode 100644 docs/screenshots/running.png create mode 100644 vccplus-project.json diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..fbc3629 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,3 @@ +*.DSK binary +*.dsk binary +*.png binary diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..cba57fd --- /dev/null +++ b/.gitignore @@ -0,0 +1,15 @@ +# Generated build products and local editor metadata. +.DS_Store +*.o +*.a +*.bin +*.BIN +*.dsk +*.DSK +!/Ebitor.DSK +*.lst +*.map +*.i +*.d +.vccplus/ +.vscode/ diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..94a9ed0 --- /dev/null +++ b/COPYING @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/Ebitor.DSK b/Ebitor.DSK new file mode 100644 index 0000000000000000000000000000000000000000..d00bfce5d626fb4998057c6862cb039a4b04dbf6 GIT binary patch literal 161280 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 literal 0 HcmV?d00001 diff --git a/README.md b/README.md index b0155e7..6878376 100644 --- a/README.md +++ b/README.md @@ -1,150 +1,40 @@ -# Ebitor: A reusable text editor C library for 8-bit systems +# Ebitor text-editor demo -Ebitor is a C library that implements a bare bones text editor -that can be adapted to work in any terminal. It features text -search and can be extended by the client program. +A reusable text-editor C library by **Pierre Sarrazin**, with a Color Computer +demonstration. This repository contains upstream version **0.1.1**. -Copyright © 2021-2025 Pierre Sarrazin +![Ebitor editing text in VCC Plus](docs/screenshots/editor.png) -This code comes with ABSOLUTELY NO WARRANTY. +[Download Ebitor.DSK](Ebitor.DSK) · [Original documentation](docs/UPSTREAM_README.md) -It is recommended to make backups of any files whose contents -are subjected to this editor. +## Run +Mount `Ebitor.DSK` in drive 0 of a **512 KB CoCo 3 / 6809 / Disk BASIC** setup +and type `LOADM"EBITDEMO":EXEC`. Choose **8** for the 80-column editor. +Type to insert text; use the arrow keys to move and Backspace to delete. +**Break** opens the demo’s command menu. -## License: GPLv3 +## Build in VCC Plus -This program is free software: you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation, either version 3 of the License, or -(at your option) any later version. +Open this repository’s root folder through **Develop → C Development → Open**. +Select **Release** and choose **Build Disk**. The project uses `VCCPlus.mk` +target `vccplus-disk`, which includes the original `Makefile` and packages +`ebitdemo.bin` as `Ebitor.DSK`. Use VCC Plus’s bundled CMOC toolchain. -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. +The disk build, mode selection and text entry in the 80-column demo were verified +through VCC Plus 3.5.0 build 43’s public MCP interface. The library’s complete +editing API and other display modes were not tested. See +[validation details](docs/VALIDATION.md). -You should have received a copy of the GNU General Public License -along with this program. If not, see . +## Source and license -See file COPYING. +- Author: [Pierre Sarrazin](http://sarrazip.com/). +- [CMOC project index](http://sarrazip.com/dev/cmoc.html). +- [Original 0.1.1 source archive](http://sarrazip.com/dev/ebitor-0.1.1.tar.gz). +- Archive SHA-256: `6911a9d2ee80925622f1d82db1b77710a1f896865e63d29a04dc16489b150e83`. - -## Introduction - -This is NOT an editor application, it is only a **C library**. -It is intended for programmers who want to integrate a full-screen -editor into their own application. - -This library implements a bare bones editor: It has very few features. -More features can be implemented by the client program. They would -typically be invoked by the user by typing the escape key followed by -another key. For example, the Break key followed by A could be used to -put the cursor at the start of the current line. - - -## Features - -- Used as a library, not a program. -- Terminal functions are entirely provided by the client program. - This allows this editor to be used with any terminal type. -- CoCo 32x16, 40x25, 64x25, 80x25 terminal drivers provided. -- OS-9 40- and 80-column driver provided. - The 32-column terminal is not supported. - (The OS-9 version needs the BControl library, available from - the CMOC home page.) -- Does not require dynamic memory allocation. -- Folds lines that are longer than the terminal width. - Does not support non-folding with horizontal scrolling. -- Only one editor can be operated at a given time. -- Should be compiled with the CMOC compiler. - See . - The code assumes a 64k addressable space. -- The only controls provided are moving the cursor with the arrow - keys, and a backspace key to erase the previous character. - Other controls like page-up, page-down and string search must be - implemented by the client program. - The library offers function Ebitor_findStringAndScrollToShow() - to facilitate the latter. - - -## Building Ebitor - -In a Unix-like development environment, do `make` to compile -for the CoCo, or `make TARGET=os9` to compile for OS-9. - -See `Makefile` for details. - - -## Programming for Ebitor - -See `smoldemo.c` for a minimal example and `ebitdemo.c` for a -substantial one. To compile these demos, do `make`, then run -`smoldemo.bin` or `ebitdemo.bin` on a CoCo or an emulator. - -Either of these demos first #includes header files for one or -more terminal structs, e.g., `sgterm.h` for SG-4 mode (32x16), -`gimeterm.h` for the CoCo 3 text modes, or `os9term.h` for an -OS-9 40- or 80-character terminal. - -Then it #includes `Ebitor.h` to use the editor structs and functions. - -The demo's first step is to fill an ebitor_Window object that defines -the text window that the editor will use. Then it calls Ebitor's -`sg4term_init()` function, in the case of ,`smoldemo.c` to initialize -the 32x16 screen terminal. - -Then `Ebitor_init()` is called to initialize the editor. This call -receives several pointers to several functions that Ebitor will need, -e.g., clearing the terminal, locating the cursor, etc. In the case of -the 32x16 screen, `sg4term_clear` and `sg4term_locate` are passed. - -Then the demo enters its main editing loop. This loop must call -`Ebitor_processEditing()`. This function will operate until the user -presses the escape key, typically Break on a CoCo. - -Then the editing loop shows a prompt to ask the user what to do after -pressing the escape key. Both demos offer to quit the program or to -show a help page. `ebitdemo.c` also offers to find some text. - -If the user presses the escape key again instead of choosing one -of those options, the editing loop just goes back to the call to -`Ebitor_processEditing()`. - -When exiting the editor loop, `Ebitor_shutdown()` must be called. - - -## Porting to other environments - -`Ebitor_init()` accepts pointers to functions that handle the -terminal operations needed by the editor. Porting to a different -type of terminal mainly involves writing functions that fill the -same roles, and passing the addresses of those functions to -`Ebitor_init()`. - -A good starting point can be to make a copy of sg4term.h and -sg4term.c under new names, then reworking the code for the new -terminal type. - - -## Memory requirements - -The Ebitor library code should take about 5100 bytes in memory under DECB, -but about 5400 under OS-9. - -The SG4 (32x16) terminal code (sg4term.c) should take about 1300 bytes. - -The GIME (CoCo 3) terminal code (gimeterm.c) should take about 1300 bytes. - -The OS-9 terminal code should take about 1000 bytes. - -These sizes do not count: -* the text buffer in which the edited text is stored; -* the stack space needed during operation; -* the space that would be used if the assert() statements were enabled - by compiling without NDEBUG. - - -## Version history - -0.1.0 - 2027-07-27 - First public release. +Licensed under **GPL-3.0-or-later**. [COPYING](COPYING) supplies the GPLv3 text +referenced by the upstream notices but omitted from the archive. +The C/header sources and original Makefile are unchanged. VCC Plus integration +adds disk packaging, project settings, documentation and screenshots. +See [provenance](docs/PROVENANCE.md). diff --git a/VCCPlus.mk b/VCCPlus.mk new file mode 100644 index 0000000..3566329 --- /dev/null +++ b/VCCPlus.mk @@ -0,0 +1,9 @@ +# VCC Plus disk packaging; the upstream build rules remain in Makefile. +include Makefile + +.PHONY: vccplus-disk +vccplus-disk: Ebitor.DSK + +Ebitor.DSK: ebitdemo.bin + perl -e 'print chr(255) x (35*18*256)' > $@ + writecocofile $@ ebitdemo.bin diff --git a/docs/PROVENANCE.md b/docs/PROVENANCE.md new file mode 100644 index 0000000..ed368ae --- /dev/null +++ b/docs/PROVENANCE.md @@ -0,0 +1,50 @@ +# Source provenance + +## Upstream snapshot + +- Original author: Pierre Sarrazin. +- Package: ebitor 0.1.1. +- Source archive: . +- Author project page: . +- Archive SHA-256: `6911a9d2ee80925622f1d82db1b77710a1f896865e63d29a04dc16489b150e83`. +- Git import baseline: `53bf6abdd50177da8b6dad36f487dcdac1b59176`. + +The first Git commit is the regular-file contents of the original release archive, +with its single enclosing package directory removed and executable modes retained. +It is an archive snapshot, not a reconstruction of upstream Git history. +The following integration commit records the VCC Plus adaptations separately. +The original README is preserved byte-for-byte in +[UPSTREAM_README.md](UPSTREAM_README.md). + +The author’s project index linked the matching archive during provenance review. +No historical HTTP receipt establishes the date of the original download; the +SHA-256 identifies the observed archive bytes, not authenticity or a license grant. + +## VCC Plus integration + +- The original C/header sources and Makefile are byte-identical to the archive. +- `VCCPlus.mk` includes the original Makefile and adds target `vccplus-disk` + to package `ebitdemo.bin` into `Ebitor.DSK`. +- `vccplus-project.json` selects that disk target and launches the demo with + `LOADM"EBITDEMO":EXEC`. +- Public documentation, build-output exclusions and actual guest screenshots + accompany the verified disk. Source notices and authored runtime data remain + intact. Generated intermediate build files are excluded from Git. + +## License scope + +The upstream README and source explicitly grant GPL-3.0-or-later permissions. +The archive omits the `COPYING` file referenced by its README. This integration +adds unmodified GPLv3 license text from VCC Plus’s `COPYING`, accompanying the +existing notices without changing their “or later” permission. + +The upstream version history says “2027-07-27” for version 0.1.0, while the author’s +project index observed during provenance review identifies version 0.1.1 in 2025. +The original README is preserved without correcting that inconsistent historical +date; the archive version and hash identify this import. + +## Verification + +The Release disk build and guest execution were verified through the public MCP +interface of installed VCC Plus 3.5.0 build 43. The checked-in disk and screenshots +are identified in [VALIDATION.md](VALIDATION.md), including the limits of that check. diff --git a/docs/UPSTREAM_README.md b/docs/UPSTREAM_README.md new file mode 100644 index 0000000..b0155e7 --- /dev/null +++ b/docs/UPSTREAM_README.md @@ -0,0 +1,150 @@ +# Ebitor: A reusable text editor C library for 8-bit systems + +Ebitor is a C library that implements a bare bones text editor +that can be adapted to work in any terminal. It features text +search and can be extended by the client program. + +Copyright © 2021-2025 Pierre Sarrazin + +This code comes with ABSOLUTELY NO WARRANTY. + +It is recommended to make backups of any files whose contents +are subjected to this editor. + + +## License: GPLv3 + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . + +See file COPYING. + + +## Introduction + +This is NOT an editor application, it is only a **C library**. +It is intended for programmers who want to integrate a full-screen +editor into their own application. + +This library implements a bare bones editor: It has very few features. +More features can be implemented by the client program. They would +typically be invoked by the user by typing the escape key followed by +another key. For example, the Break key followed by A could be used to +put the cursor at the start of the current line. + + +## Features + +- Used as a library, not a program. +- Terminal functions are entirely provided by the client program. + This allows this editor to be used with any terminal type. +- CoCo 32x16, 40x25, 64x25, 80x25 terminal drivers provided. +- OS-9 40- and 80-column driver provided. + The 32-column terminal is not supported. + (The OS-9 version needs the BControl library, available from + the CMOC home page.) +- Does not require dynamic memory allocation. +- Folds lines that are longer than the terminal width. + Does not support non-folding with horizontal scrolling. +- Only one editor can be operated at a given time. +- Should be compiled with the CMOC compiler. + See . + The code assumes a 64k addressable space. +- The only controls provided are moving the cursor with the arrow + keys, and a backspace key to erase the previous character. + Other controls like page-up, page-down and string search must be + implemented by the client program. + The library offers function Ebitor_findStringAndScrollToShow() + to facilitate the latter. + + +## Building Ebitor + +In a Unix-like development environment, do `make` to compile +for the CoCo, or `make TARGET=os9` to compile for OS-9. + +See `Makefile` for details. + + +## Programming for Ebitor + +See `smoldemo.c` for a minimal example and `ebitdemo.c` for a +substantial one. To compile these demos, do `make`, then run +`smoldemo.bin` or `ebitdemo.bin` on a CoCo or an emulator. + +Either of these demos first #includes header files for one or +more terminal structs, e.g., `sgterm.h` for SG-4 mode (32x16), +`gimeterm.h` for the CoCo 3 text modes, or `os9term.h` for an +OS-9 40- or 80-character terminal. + +Then it #includes `Ebitor.h` to use the editor structs and functions. + +The demo's first step is to fill an ebitor_Window object that defines +the text window that the editor will use. Then it calls Ebitor's +`sg4term_init()` function, in the case of ,`smoldemo.c` to initialize +the 32x16 screen terminal. + +Then `Ebitor_init()` is called to initialize the editor. This call +receives several pointers to several functions that Ebitor will need, +e.g., clearing the terminal, locating the cursor, etc. In the case of +the 32x16 screen, `sg4term_clear` and `sg4term_locate` are passed. + +Then the demo enters its main editing loop. This loop must call +`Ebitor_processEditing()`. This function will operate until the user +presses the escape key, typically Break on a CoCo. + +Then the editing loop shows a prompt to ask the user what to do after +pressing the escape key. Both demos offer to quit the program or to +show a help page. `ebitdemo.c` also offers to find some text. + +If the user presses the escape key again instead of choosing one +of those options, the editing loop just goes back to the call to +`Ebitor_processEditing()`. + +When exiting the editor loop, `Ebitor_shutdown()` must be called. + + +## Porting to other environments + +`Ebitor_init()` accepts pointers to functions that handle the +terminal operations needed by the editor. Porting to a different +type of terminal mainly involves writing functions that fill the +same roles, and passing the addresses of those functions to +`Ebitor_init()`. + +A good starting point can be to make a copy of sg4term.h and +sg4term.c under new names, then reworking the code for the new +terminal type. + + +## Memory requirements + +The Ebitor library code should take about 5100 bytes in memory under DECB, +but about 5400 under OS-9. + +The SG4 (32x16) terminal code (sg4term.c) should take about 1300 bytes. + +The GIME (CoCo 3) terminal code (gimeterm.c) should take about 1300 bytes. + +The OS-9 terminal code should take about 1000 bytes. + +These sizes do not count: +* the text buffer in which the edited text is stored; +* the stack space needed during operation; +* the space that would be used if the assert() statements were enabled + by compiling without NDEBUG. + + +## Version history + +0.1.0 - 2027-07-27 - First public release. diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md new file mode 100644 index 0000000..7f9de3e --- /dev/null +++ b/docs/VALIDATION.md @@ -0,0 +1,47 @@ +# VCC Plus validation + +Verified November 9, 2026 (Mountain time; receipts continue into November 10 UTC). + +## Environment and scope + +- Installed VCC Plus **3.5.0, build 43**, using its public MCP project/build/playtest + interface and bundled toolchain. +- An isolated native copy retained the installed emulator code; its bundle identity + and ad-hoc signature were changed to avoid interfering with another active app. +- **Release**, **512 KB CoCo 3**, emulated **MC6809**, Disk BASIC. +- This verifies the source layout and build recipe in this repository. No host + rebuild, Xcode toolchain or alternate emulator was used for the guest check. + +The disk build succeeded with no compiler warnings shown in the build receipt. + +## Observed result + +The demo launched with `LOADM"EBITDEMO":EXEC` and displayed its terminal-mode +menu. Mode 8 selected the 80-column editor, and the text `VCC PLUS` was entered +and appeared in the actual guest display. The inspected editor screenshot shows +that text and the `PRESS BREAK FOR MENU` prompt. No search, scrolling, deletion, +command menu, quit, file persistence, other terminal modes or OS-9 execution was +tested. The library’s `ebittest` test program was not run. + +The playtest was stopped cleanly. The receipt reported no disk writes and matching +initial/final disk hashes. The screenshots are actual emulator framebuffer captures, +not mockups. + +- Download disk: [`Ebitor.DSK`](../Ebitor.DSK), 161280 bytes. +- Disk SHA-256: `91c1ca42316042923537ad9da2c8933117264c1c0f238c8c2e38df90a6268eeb`. +- Main screenshot: [`screenshots/editor.png`](screenshots/editor.png). +- Initial screen: [`screenshots/running.png`](screenshots/running.png). + +## Evidence identifiers + +- Build: `169420CA-0B1D-4E4F-8F1A-6F6918DB40D8`. +- Artifact: `84B6A900-382F-43E0-9160-6777A3D46F95`. +- Run: `BF481772-32CF-457B-B344-3A5A4BD5BEB5`. +- Editor capture: machine frame `1280`; 80-column GIME text, + captured as a 640 × 480 framebuffer. + +Private build/run/input/capture/stop receipts supplied these identifiers. Raw logs, +access grants and machine-specific paths are intentionally excluded. + +No claim is made for full application coverage, audible output, emulated HD6309, +Intel/Rosetta execution, physical Intel hardware or all supported macOS versions. diff --git a/docs/screenshots/editor.png b/docs/screenshots/editor.png new file mode 100644 index 0000000000000000000000000000000000000000..63de35a15bc62f2e2314ea8f0287ee60a6d32e2c GIT binary patch literal 8050 zcmeHM{Z~_U7{7N8&xTnkkP#)C31X(w@+{<4LWoj_T2cYiQdwdf5)Nl$yMt4wRAR?N z9wgmMSslw9+A1VBwxdU{Cy{F}fNQop8!};x%beSQyX|(7d;1qUo$e3!?0#RL@Avb( z+-INXK*@%p*|Cqs0st_(_{D-v0KifK0O;h*Bzsoa~Av@s%s$KWYuB)oO&F%jP`1AWsE= ztgD>x_O?vviGMnvSxZ!19IDxHi5+jf^vGx(mzo}{$H+zZN4KSeF?-H_aK2)?sZz1- zWZvJB9DQwF9$5a)ElDdiSr1G;NbSIWB(4OQS9Z?6n3_zAo56_tcfqvcZrGkWlhP#6 zAZ2HP<)Z%4PbmG3b&%RU^dHwQR58ayc>G?!-|LM;AS^3tuCNJ{a`8}ezrmmmX(A3p z(yw;wZrgOVCS_PI$D+JuH-_9rY5OdlHy*x`(9v>63uyJS12j6vVwUTGoOk_jYSq>V zei*rtdn8j!TnU>)k0Y5;MRngQ3fa74s#KLYsfG57m1$$o#OxuyA6K78 z_0T-44;u&yewO^%A4NSHvwL{b*1fMQShc^)FVw7`3LvBa**V~I>cpIf$Dd#cCip7X zkaIys&SKL~IfIqTWZhq0Ub!OL8)z%9q~*1zkn&E63+7YUSoyQ+hq%t@*MFq%r)&Ilpq-6Eq%*9m!#hDNXmuGZBAql(L?Jg_lB5qssF zus=;t{;53Y|w{!75IeFW-ND9(3l0TQG zAk`ex4$$=8r+cN5qJg^PXSL1Z6=Ittd$HY8%@_J~uC7gZSxN$b#Z&ibgYliL6|VzO z+gbZUiW@h5V!cSr+(WS4BWc%9^dptH7lm9a&n-wU2k(A@sbmPJFC$ z($*sobr_4f?lq-bG)J^&uQ?_Y-RNq$T+!$36UjBx{Ob6pBx}6Ye^){sGtX?jC;+On zZHcT>foy(TvPhGi_6MS?NH&I)YF^Kv$X_jT;GL@p$4H%chvhx=w8yA}j@&w2zv$xW zCSfYYE*Fv{ zh}0dW3^LtD+n@TAY=Lg5Kl zz>CST3?WI%*Eym;xbXHU$@vqJE4UiV(B7(^2H3fur3G@3UyEsAVjDt;noo3eAAFTt zOc|!EnN$i=vp1F^ko1Ll;J2?I(bH?(oF)I6VP`wkrTG2*1iIXlw@pZz#{L&l>6+a) zWEt=qDfeaS?nmd90Pfiux*l|LZV7OzZ}Bn;iEY9>@Hl@jiw5Q;5|}qy&(Of^C(DM8 z>s-3Il;q>9DlW{W3KxSh@r>aA8`KV>C1_lFmNpTPwV8Cl4Zg$_%EIn(!%0+`AFck$W{1%~`>jei3%m)q3< literal 0 HcmV?d00001 diff --git a/docs/screenshots/running.png b/docs/screenshots/running.png new file mode 100644 index 0000000000000000000000000000000000000000..b5e4986cb7a8c050f9d3e51fae2ab6379510a52f GIT binary patch literal 8626 zcmeHNdr(tX9=-{o1s^p^*ShslwAO4NR$FU}N)oELmX(^e*hL-^+lq*kM~xvsNN&*G zQgv3lWmS~NRd*>BB)9@%2zl&ipHqk}7}`P}wbm=S=H6%sfrOjv$<4i;{i`$G+3C#A zFO#?pRzyeuAC^nA(iWAy7WDrFQW zhI+T^3WsC7a$k{_zGktm6^G~K#+THppt5g_g(oN*-1vCNHx9yiU(>Ayed0*HO7P~q&MpZp?q?8GQ zecDDFPO`6Lv0N9bhM%TwfZ*mwg8P50oE<*On=svFLt&_tvtgwBM;QMm)-GHoW z1rWsAaA_lREsW+E;XM;J2DDL}sf9-AXIevCiIfoMWhtl~29>}u{p2WJWS~aRG zAYtuM52>c8kOU^!!A*OdPDauJRh&^K%HMM2*3NvjjkInhN4+h=jft??cVN?4o zcVvoy4S!2vD4+&$A1qjY7i*b-R>VW&rfUx{O0ohd$%=O}QfZO7{SX)O z=k30q3F!nN&WX!Uh27%Bj7^VGk*hkR==>Tt1MqFmo*PFCj4ygB%ZSa81#?|U;PB!! z0(XOYVYnNUh}xSGErED2c{>Qc6jS3S|1L|m3031GHvS7<)ZNm5-kn0ZA=n0BaR01L z1&kN6m;~0yIRSrEBR|`zhZTefJ1-UMlpYh)qrbPvkRcpOH}#R_Me0x_*U5A8t|BW+ zJ8}UyGHcNhGm~_JTf(mWV?)i^F1#{0%6n-575Nbq?lE~LJr&LZHKDHa2q-`s{{@WA zTBL8IQ=B&~ftA{)klnbx_t|3(I34|>9DUAH>TP#ebwS)G^IteZxj8i*j0;BZY-gmu z@&n+5<+)qQyKz&>U^d{cg3wxP)awM=0IKxq3Un5Ko<)6hQt6!899)#i1J>5eu6kXZaoMlubx ziAA7M$#>=Rm?~!hFfCtpm`RfD(RfH{ddm4H+IY$4B&he}owI42+vNb7#L1=xrn*G{ z$=$V2EupPd9#z59%Nl;f4KtKp@r+3)Iz;wXkexw~B8~Wh*kcKS<$N7B+3OEv82r60 z9rAuJ<%<0P&^zU|m7VJuPhSWL;NQgj(UUdJ=}4B%AP`E2q@!55$rnKMc@A=HG99V& zI(>#7Au-GsdKF=ct^jqOh~Cf{&7|Z>P!;i47soSq@bl}iRvvn@&`hXh(lG2$67y{( zyVPMNa)n9=vn)?CP2TW0(4sb*a{t&s0M#_}a@|uRtWSbvH{(7sTWmpk(yXz zip+ha#;U*@ZEYfjkaSvw-ZVm<-mpFB)>{O({1&$ac1$d#eEk@Bez>|>%H&MM3DnE# z6_?%_$KiW*cV|%bzx~iRvQKPz*I z5}X+Jh=NB(a89wqi8q(t!+qxj*TZtc0->^!A7iY&3_v3rI2CtBBjmj*(JA{$k0t|j zl?ty$uIv_g$gysDaKxr7#)D&%+b!t^n+|rQB4F9$ChRo7 z{&oF=;RLx?IN4YBE>-BU>30HGo8i3fQjp$Xgbudd`{mbL7^k~|f@P)7WtKcVw%lvBvRdkT}1-PtC+Ay+v5VpvGu2Fg;DKf<81vKc_8xDKm$ zZE|d9v4h{{F6Ih$ut2(?z%t;X;H95iWr3UsYs{ z6j?Dw*3Z-^k-?FK{dyp&3Pu&oi@q6?dj7f4|4yWA M+>)$bzhnQu0hj-s%>V!Z literal 0 HcmV?d00001 diff --git a/vccplus-project.json b/vccplus-project.json new file mode 100644 index 0000000..f8a2e55 --- /dev/null +++ b/vccplus-project.json @@ -0,0 +1,25 @@ +{ + "entrySource": "ebitdemo.c", + "makefile": "VCCPlus.mk", + "buildTarget": "all", + "binary": "ebitdemo.bin", + "launchMode": "disk", + "configurations": [ + { + "name": "Debug", + "makeArguments": [ + "INTERMEDIATE=--intermediate" + ] + }, + { + "name": "Release", + "makeArguments": [] + } + ], + "jobs": 4, + "diskTarget": "vccplus-disk", + "diskImage": "Ebitor.DSK", + "launchCommands": [ + "LOADM\"EBITDEMO\":EXEC" + ] +}