Initial commit

Signed-off-by: Raphael Moreira Zinsly <[email protected]>

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Process For Accepting Third Party Code Contributions
+
+To improve tracking of contributions to this project we will use a process
+modelled on the modified DCO 1.1 and use a "sign-off" procedure on patches that
+are being emailed around or contributed in any other way.
+
+The sign-off is a simple line at the end of the explanation for the patch,
+which certifies that you wrote it or otherwise have the right to pass it on as
+an open-source patch.  The rules are pretty simple: if you can certify the
+below:
+
+	Developer's Certificate of Origin 1.1
+
+	By making a contribution to this project, I certify that:
+
+	(a). The contribution was created in whole or in part by me and I
+	have the right to submit it under the open source license
+	indicated in the file; or
+
+	(b). The contribution is based upon previous work that, to the best
+	of my knowledge, is covered under an appropriate open source
+	License and I have the right under that license to submit that
+	work with modifications, whether created in whole or in part
+	by me, under the same open source license (unless I am
+	permitted to submit under a different license), as indicated
+	in the file; or
+
+	(c). The contribution was provided directly to me by some other
+	person who certified (a), (b) or (c) and I have not modified
+	it.
+
+	(d). The contribution is made free of any other party's intellectual
+	property claims or rights.
+
+	(e). I understand and agree that this project and the contribution
+	are public and that a record of the contribution (including all
+	personal information I submit with it, including my sign-off) is
+	maintained indefinitely and may be redistributed consistent with
+	project or the open source license(s) involved.
+
+then you just add a line saying
+
+	Signed-off-by: Random J Developer <[email protected]>
+
+using your real name (sorry, no pseudonyms or anonymous contributions.)
+
+# Quick HOWTO
+
+1. Make sure you have a [GitHub account](https://github.com/signup/free)
+
+2. Fork the repo.
+
+3. Make the changes and run the testcases. We only take pull requests with
+passing tests.
+
+4. If it is applicable, improve or add the current testcases to cover for the
+new functionality.
+
+5. Push to your fork and submit a pull request.
+
+After 5. the pull request will be reviewed and checked.  We may suggest some
+changes or improvements or alternatives.

DFP.txt

@@ -0,0 +1,76 @@
+DFP usage notes:
+
+The Advance Toolchain currently provides Decimal Floating Point compiler
+and library support in a standalone toolchain.
+
+In order to be able to reference DFP defined symbols (including constants
+and functions) one's source code must define the following:
+
+#define __STDC_WANT_DEC_FP__ 1
+
+or build the source with the following define flag:
+-D__STDC_WANT_DEC_FP__=1
+
+GNU99 compatibility is required to pick up some DFP prototypes.  It will
+define __USE_ISOC99.  Use the following compilation flag:
+-std=gnu99
+
+NOTE: -std=gnu99 IS NOT THE SAME AS __USE_ISOC99 though -std=gnu99 DOES
+DEFINE __USE_ISOC99!
+
+NOTE: If you forget to use -std=gnu99 you may notice that you will get very
+screwy results when you call dfp math functions.  If the compiler can't
+find the prototypes (due to missing defines) it will attempt to create a
+default prototype which will have the incorrect return type.
+
+The following include files provide the constants and function prototypes
+provided by DFP but only when __STDC_WANT_DEC_FP__ is defined to '1'.
+
+	/* fe_dec_getround(), fe_dec_setround(), and rounding mode
+	 * enumeration types provided by an implicit #include
+	 * <bits/dfpfenv.h to pic.  */
+	#include <fenv.h>
+
+	/* All math function prototypes for d32/d64/d128, polymorphic
+	 * classification macros, comparison macros, and DEC_NAN and
+	 * DEC_INFINITY macros.  This includes an implicit #include
+	 * <bits/dfpcalls.h> to pick up new DFP only prototypes defined in
+	 * include/bits/dfpcalls.h.  */
+	#include <math.h>
+
+	/* Type dependent floating point macros for DFP support
+	 * traditionally defined in float.h.  */
+	#include <decfloat.h>
+
+The Decimal Floating Point IEEE types are as follows:
+
+	_Decimal32
+	_Decimal64
+	_Decimal128
+
+The printf format flags follow:
+
+	%H - for _Decimal32
+	%D - for _Decimal64
+	%DD - for _Decimal128
+
+The scanf format flags follow:
+
+	%DF - for _Decimal32
+	%DD - for _Decimal64
+	%DL - for _Decimal128
+
+The floating point suffix for DFP constants follows:
+
+	'DF' for _Decimal32, e.g. _Decimal32 d32 = 1.045DF;
+	'DD' for _Decimal64, e.g. _Decimal64 d64 = 1.4738273DD;
+	'DL' for _Decimal128, e.g. _Decimal128 d128 = 1.0823382394823945DL;
+
+NOTE: Assigning a naked constant to a DFP variable will actually be
+performing a binary to decimal conversion and, depending on the precision,
+can assign an incorrect number.  Always use the decimal floating point
+suffix!
+
+A compilation and link for a DFP program will look like the following:
+
+/opt/at05/bin/gcc test_dfp.c -o dfp -D__STDC_WANT_DEC_FP__=1 -std=gnu99 -ldfp

LICENSE

@@ -0,0 +1,159 @@
+Apache License
+
+Version 2.0, January 2004
+
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation source, and
+configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object
+code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work (an example is provided in the Appendix
+below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original
+version of the Work and any modifications or additions to that Work or
+Derivative Works thereof, that is intentionally submitted to Licensor for
+inclusion in the Work by the copyright owner or by an individual or Legal
+Entity authorized to submit on behalf of the copyright owner. For the purposes
+of this definition, "submitted" means any form of electronic, verbal, or
+written communication sent to the Licensor or its representatives, including
+but not limited to communication on electronic mailing lists, source code
+control systems, and issue tracking systems that are managed by, or on behalf
+of, the Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise designated in
+writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
+section) patent license to make, have made, use, offer to sell, sell, import,
+and otherwise transfer the Work, where such license applies only to those
+patent claims licensable by such Contributor that are necessarily infringed by
+their Contribution(s) alone or by combination of their Contribution(s) with the
+Work to which such Contribution(s) was submitted. If You institute patent
+litigation against any entity (including a cross-claim or counterclaim in a
+lawsuit) alleging that the Work or a Contribution incorporated within the Work
+constitutes direct or contributory patent infringement, then any patent
+licenses granted to You under this License for that Work shall terminate as of
+the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+    You must give any other recipients of the Work or Derivative Works a copy
+of this License; and
+    You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+    You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any
+part of the Derivative Works; and
+    If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the
+Derivative Works; within the Source form or documentation, if provided along
+with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works that
+You distribute, alongside or as an addendum to the NOTICE text from the Work,
+provided that such additional attribution notices cannot be construed as
+modifying the License.
+
+    You may add Your own copyright statement to Your modifications and may
+provide additional or different license terms and conditions for use,
+reproduction, or distribution of Your modifications, or for any such Derivative
+Works as a whole, provided Your use, reproduction, and distribution of the Work
+otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions. Notwithstanding the above, nothing herein shall
+supersede or modify the terms of any separate license agreement you may have
+executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work (and each Contributor provides its
+Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied, including, without limitation, any warranties
+or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law (such as deliberate and grossly negligent acts) or agreed to in
+writing, shall any Contributor be liable to You for damages, including any
+direct, indirect, special, incidental, or consequential damages of any
+character arising as a result of this License or out of the use or inability to
+use the Work (including but not limited to damages for loss of goodwill, work
+stoppage, computer failure or malfunction, or any and all other commercial
+damages or losses), even if such Contributor has been advised of the
+possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations
+and/or rights consistent with this License. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility, not on behalf of any other Contributor, and only if You agree
+to indemnify, defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS