Reintegrate wbw -> trunk

Tools/cpmtools/COPYING.txt

@@ -0,0 +1,676 @@
+
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ 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.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    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 <http://www.gnu.org/licenses/>.
+
+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:
+
+    <program>  Copyright (C) <year>  <name of author>
+    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
+<http://www.gnu.org/licenses/>.
+
+  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
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
+

Tools/cpmtools/NEWS.txt

@@ -0,0 +1,9 @@
+Changes since 2.17:
+
+o  Make timestamps in mkfs.com optional and add date stamper creation
+o  Better cpm.5 documentation
+o  Updated config.guess
+o  Fixed error handling for corrupt images or diskdefs
+o  Fixed off by one bug in fsck not detecting a wrong block number
+o  Fixed too short directory buffer for directory sizes not matching
+   whole blocks

Tools/cpmtools/README.txt

@@ -0,0 +1,43 @@
+This package allows to access CP/M file systems similar to the well-known
+mtools package, which accesses MSDOS file systems.  I use it for file
+exchange with a Z80-PC simulator, but it works on floppy devices as well.
+Currently it contains:
+
+o  cpmls - list sorted directory with output similar to ls, DIR, P2DOS
+   DIR and CP/M3 DIR[FULL]
+o  cpmcp - copy files from and to CP/M file systems
+o  cpmrm - erase files from CP/M file systems
+o  cpmchmod - change file permissions
+o  cpmchattr - change file attributes
+o  mkfs.cpm - make a CP/M file system
+o  fsck.cpm - check and repair a CP/M file system (only simple errors
+   can be repaired so far).  Some images of broken file systems are provided
+   for testing.
+o  fsed.cpm - view CP/M file system
+o  manual pages for everything including the CP/M file system format
+
+All CP/M file system features are supported.  Password protection
+is ignored, because passwords are easy to decrypt, but a pseudo file
+[passwd] contains them, if you are curious what your old password has
+been.  The disk label is read as special file [label].  User numbers
+are specified as user:file.
+
+Cpmtools should compile and work out of the box on each POSIX compliant
+system.  It can be additionally compiled for Win32 systems.  The source
+is available as a GNU zipped tape archive from:
+
+  http://www.moria.de/~michael/cpmtools/
+
+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, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Tools/cpmtools/diskdefs

@@ -266,16 +266,17 @@ diskdef interak
   sectrk 20
   blocksize 4096
   maxdir 256
-  skew 0
+  skew 1
   boottrk 2
   os 2.2
 end
 
-# For 512KB ROM, less 64K reserved for system
-diskdef rom512KB
-  seclen 128
-  tracks 14
-  sectrk 256
+# For 512KB ROM, less 96K reserved for system
+
+diskdef n8vem_rom512
+  seclen 512
+  tracks 13
+  sectrk 64
   blocksize 2048
   maxdir 256
   skew 0
@@ -283,14 +284,15 @@ diskdef rom512KB
   os 2.2
 end
 
-# For 1024KB ROM, less 64K reserved for system
-diskdef rom1024KB
-  seclen 128
-  tracks 30
-  sectrk 256
+# For 1024KB ROM, less 96K reserved for system
+
+diskdef n8vem_rom1024
+  seclen 512
+  tracks 29
+  sectrk 64
   blocksize 2048
   maxdir 256
-  skew 1
+  skew 0
   boottrk 0
   os 2.2
 end

Tools/cpmtools/docs/README.win32.cygwin.txt

@@ -1,518 +0,0 @@
-README.win32.cygwin.txt
------------------------
-
-Building cpmtools-2.9 in Windows XP using:
-
-- cpmtools http://www.moria.de/~michael/cpmtools/
-- cygwin and the ncurses library - http://www.cygwin.com/
-
-"The experts will always complain about shorter documents that do do not
-provide enough details to confuse the rest of us, and longer documents that
-do not omit enough details to confuse the rest of us. No documentation is
-needed for people of that calibre."
-
-- Bill Buckels, November 2008
-
-This document is provided 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. In particular, Bill Buckels has no warranty obligations
-or liability resulting from its use in any way whatsoever. If you don't agree
-then don't read it.
-
-Introduction
-------------
-
-This document is intended as a general guideline. An annotated summary is
-provided directly below especially for expert users followed by annotated
-details.
-
-Please review the other documentation and source code that comes with
-cpmtools for more information about cpmtools. Please review the cygwin
-documentation for more information about cygwin.
-
-At time of this writing, I have used the latest versions of the packages
-listed above to build the latest version of cpmtools in its entirety. I have
-documented the steps I followed below. 
-
-Although there are probably other environments and compilers that can build
-cpmtools for Windows I have not been successful in using the other several I
-tried. Using a complete cygwin installation I had no problems and I had
-cpmtools built in moments after I had cygwin installed and the cpmtools
-source in place as documented below.
-
-Intended Audience
------------------
-
-This document takes two tracks for installing cpmtools binary executables
-after they have been built in cygwin:
-
-1. End users who will run cpmtools from within the cygwin shell. This
-includes unix users who do not want to use the native Windows command line.
-
-2. End users who will run cpmtools from the native Windows command line. The
-average Windows user does not have cygwin, and probably won't want to install
-cygwin or learn a unix-like shell to use cpmtools.
-
-The consideration here is where cpmtools looks for its CP/M disk format
-definitions file (diskdefs) when not in a unix-like environment like cygwin
-and this consideration will affect the way you build cpmtools since this path
-is hardcoded into the binary executables.
-
-My hope is that this document will help address the needs of both types of
-Windows end users and those who wish to provide cpmtools to them.
-
-Summary 
--------
-
-- Install cygwin with ncurses.
-- Download cpmtools-2.9.tar.tar to your cygwin home directory.
-- Start cygwin from the shortcut on the Windows desktop.
-
-- Enter the following commands:
-
-tar -xvf cpmtools.tar.tar
-cd cpmtools-2.9
-./configure --with-diskdefs=/usr/local/share/diskdefs
-make
-mkdir /usr/local/share
-mkdir /usr/local/share/man
-mkdir /usr/local/share/man/man1
-mkdir /usr/local/share/man/man5
-make install
-
-Assumptions
------------
-
-The above builds cpmtools under cygwin for end users who will use cpmtools in
-the cygwin shell and who will use the default installation.
-
-I am assuming in this summary that all has gone well and that anyone who
-deviates from what I have done or who has customized their cygwin
-installation will be able to troubleshoot their own problems,
-
-I therefore make the following related assumptions in this summary:
-
-- That compiler related programs and libraries required to build cpmtools
-under cygwin (including ncurses) are installed.
-
-- That you wish to download into and work under your home directory. You may
-also consider whether a better place to download is in /usr/local/src and
-whether you should install in the binaries in /opt/cpmtools/ and things of
-that nature.
- 
-Default Format
---------------
-
-You can change the default format to accomodate the special needs of your
-users so they don't need to type their favorite format. The following line
-can be entered to configure for an apple-do default format:
-
-./configure --with-defformat="apple-do" --with-diskdefs=/usr/local/share/diskdefs
-
-Native Windows Installation
----------------------------
-
-If you wish to distribute your binaries to Windows end users who will not
-have the cygwin shell and who will use the Windows command line, you have 2
-options:
-
-1. Require your users to always work in the same directory as diskdefs.
-
-- or -
-
-2. Hardcode the default diskdefs path into your binary executables and
-require your users to always use the expected directory for diskdefs.
-
-The following line shows how to configure for an apple-do default format and
-to set the default diskdefs path in a mannner that is acceptable to Windows
-to a relative path from the root of the current drive:
-
-./configure --with-defformat="apple-do" --with-diskdefs=/cpmtools/diskdefs
-
-Cross-Cygwin Binary Installation
---------------------------------
-
-You can still use the binaries built as above and installed using "make
-install" in cygwin if you add the following line to /etc/fstab (assuming your
-cygdrive is the Windows C:drive):
-
-c:\cygwin\usr\local\share /cpmtools
-
-Making a Zip Installation for Native Windows Users
---------------------------------------------------
-
-If your target is the Windows user who does not have cygwin you can do the
-following in cygwin in your build directory to create a zip file that will
-contain the cpmtools binary executables:
-
-- mkdir cpmtools
-- cp *.exe cpmtools/.
-- cp diskdefs cpmtools/.
-- cp /bin/cygwin1.dll cpmtools/.
-- cp /bin/cygncurses-8.dll cpmtools/.
-- zip -R cpmtools/*.*
-
-Making Documentation for Native Windows Users
----------------------------------------------
-
-If you wish to provide the cpmtools manual pages in html format you can use
-man2html to generate your html in ugly format and redirect to a file and edit
-by hand. Here's an example:
-
-man2html -r cpm.5 > cpm.html
-
-If you wish to avoid html and provide the cpmtools manual pages in text
-format you can use troff to generate your text in ugly format and redirect to
-a file and edit by hand. Here's an example:
-
-troff -a cpm.5 > cpm.txt
-
-This concludes the summary. 
-
-Details, Alternatives, and Other Fluff
---------------------------------------
-
-1.cygwin
---------
-
-Cygwin gave me a complete and free environment to both configure and build
-cpmtools in its entirety.
-
-I installed cygwin from http://www.cygwin.com/ in its entirety which included
-the ncurses library and when prompted to select a download site I chose 
-ftp://mirrors.kernel.org/sourceware/cygwin/
-
-The site you pick will depend on your own preference and how much of cygwin
-you decide to install will be up to you. I have a good Internet connection
-and a large hard disk so installing ALL of cygwin was no problem for me.
-Those who don't may wish to attempt an incremental installation which I
-personally found to be annoying and tedious.
-
-It is not necessary to install ALL cygwin options. Another alternative is to
-take the minimalistic approach and just install the compiler related
-programs and libraries required to build cpmtools (including ncurses). If you
-have missed something you will still be able to select additional components
-via Cygwin Setup.
-
-By default cygwin installs into c:\cygwin and puts a shortcut on the Windows
-desktop. By default the cygwin shell starts in your cygwin home directory
-under c:\cygwin\home\. I used the cygwin default paths for my installation of
-cygwin.
-
-2. cpmtoools
-------------
-
-I then downloaded Download cpmtools-2.9 from 
-http://www.moria.de/~michael/cpmtools/
-and used WinRAR to extract cpmtools-2.9 to  
-C:\cygwin\home\bbuckels\cpmtools-2.9\
-
-I have noted in the summary that tar can be used. Use whatever you are
-comfortable with to handle things from unix of a tarball nature.
-
-3. Building 
------------
-
-3.1. I started cygwin by clicking on the cygwin shortcut on my desktop which
-placed me into my cygwin home directory in the cygwin shell.
-
-3.2  Now in the cygwin shell, I changed to the cpmtools directory by typing
-the following and pressing the [Enter] key:
-
-cd cpmtools-2.9
-
-
-3.3 Running the configure script
---------------------------------
-
-Before making cpmtools, the configure script must be run to create the
-cpmtools makefile and the config.h header file required by cpmtools.
-
-I ran the configure script with two options; to set the default format for
-cpmtools to Apple II DOS 3.3 disk images and to tell cpmtools where to find
-the diskdefs format definitions file (which is required to run cpmtools. See
-far below.)
-
-3.3.2 Building for use in the cygwin shell
-------------------------------------------
-
-If I was building for use in the cygwin shell and I was using the default
-paths used by "make install" noted far below, to be certain that my diskdefs
-file would be found and to set my default format to "apple-do" I would type
-the following and press the [Enter] key:
-
-./configure --with-defformat="apple-do" --with-diskdefs=/usr/local/share/diskdefs
-
-3.3.1  Building for the Native Windows command line
----------------------------------------------------
-
-To set the default format to "apple-do" and to provide a relative path for
-native Windows to my diskefs file which I would later copy to C:\cpmtools\ ,
-I typed the following and pressed the [Enter] key:
-
-./configure --with-defformat="apple-do" --with-diskdefs=/cpmtools/diskdefs
-
-Note: Windows paths are typed into the Windows native command line with
-backslashes in the MS- DOS tradition. Historically the forward slash used by
-unix as a path separator was used as a switch character in MS-DOS utilities
-and this has carried forward with the commands that come with Windows. But in
-a program, local Windows paths can be used with forward slashes instead and
-they still work. Backslashes will cause problems for configure so use forward
-slashes.
-
-3.4. The configure script created my cpmtools makefile and config.h with the
-options I chose. I then ran make by typing the following and pressing the
-[Enter] Key.
-
-make
-
-This concludes the first part of the details section of this document and I
-have covered the basic steps that I followed to build cpmtools. What you do
-will likely be a close variation.
-
-4. Installing
--------------
-
-4.1 Some of this is also noted in the summary. Also keep in mind that if
-cpmtools is used outside of cygwin access to the documentation which is in
-the form of unix-style man pages will not be available unless reformatted to
-a media type that Windows users are familiar with.
-
-4.1.1 Installing for the cygwin shell
------------------------------------
-
-You can review the summary and the cpmtools INSTALL document for more
-information on unix-like installations. Installation of cpmtools for use in
-the cygwin shell follows those conventions.
-
-If installing cpmtools to be used in cygwin using the cpmtools defaults and
-assuming the directories below don't already exist, you will need to manually
-create the following directories using the mkdir command as follows:
-
-mkdir /usr/local/share
-mkdir /usr/local/share/man
-mkdir /usr/local/share/man/man1
-mkdir /usr/local/share/man/man5
-
-This is because the manual pages (man pages) will not be installed if you
-don't. If you install the man pages, then when you need help on cpmtools in
-cygwin, you can just enter "man cpmls" or "man cpmchmod", etc. 
-
-After you make the directories above enter the following command:
-
-make install
-
-Assuming all has gone well, cpmtools is now part of your cygwin installation
-and can be used wherever you work in cygwin. 
-
-4.1.2 Installing for Use Outside Cygwin
----------------------------------------
-
-Please also read the summary.
-
-The requirements of my installation were to create a directory structure for
-a binary executable version of cpmtools targetted at Apple II disk image
-users that would run at the native Windows cmd prompt. I offer the following
-for general reference. The cygwin paths are based on my installation of
-cygwin and are presented using conventional windows pathname notation.
-
-4.1.2.1 Dll's
--------------
-
-Two dll's from the c:\cygwin\bin\ directory were required:
-
-cygwin1.dll
-cygncurses-8.dll
-
-Regardless of installation, for this cygwin and this ncurses version access
-to these dll's will be required by this version of the cpmtools excecutables.
-
-4.2 Manually Placing Files for Use Outside Cygwin
--------------------------------------------------
-
-I did my installation by hand. 
-
-My executables were created in c:\cygwin\home\bbuckels\cpmtools-2.9\ (my
-cygwin home directory) which is also where the diskdefs file was.
-
-I used Windows Explorer to manually do the following:
-
-4.2.1 create c:\cpmtools\ directory.
-4.2.2 copy all 8 exes into c:\cpmtools\
-4.2.3 copy both dll's listed above into c:\cpmtools\
-4.2.4 copy diskdefs into c:\cpmtools\
-
-This gave me my directory structure and files for testing and distribution.
-
-I also placed an Apple II CP/M disk image called EXMPLCPM.dsk in c:\cpmtools\
-as a test target.
-
-
-5. Additional Notes 
--------------------
-
-5.1 diskdefs - CP/M disk format definitions
---------------------------------------------
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available CP/M
-formats and their names. For Apple II CP/M 80 users the disk image formats
-apple-do and apple-po are available.
-
-The possible locations where cpmtools first looks for the diskdefs file:
-
-- Can vary depending on the preferences of the person who builds the cpmtools
-binaries (executables) from the source code.
-
-- The location is also installation dependent and the diskdefs file may also
-have been renamed (but we hope not).
-
-If it's not found the current (work) directory is then searched for a file
-called diskdefs.
-
-On a unix-like system, a ${prefix}/share/ style path like /usr/local/share/
-is a possible place that cpmtools could be made to first look for diskdefs.
-
-In a Win32 system sometimes unix-like shells like cygwin are used to run
-cpmtools instead of Windows cmd. For those installations unix-like
-conventions probably should apply.
-
-For cpmtools installations targetted at the average Windows user who does not
-have a unix-like shell and uses the Windows cmd prompt to run cpmtools there
-is no standard shared place that cpmtools can be made to first look for
-diskdefs. Pathed File names like \cpm\diskdefs or even c:\cpmtools\diskdefs
-are possible.
-
-5.2 Difficulties in using the Windows File System
----------------------------------------------------
-
-This is not a troubleshooting guide. Unless you wish to find-out for yourself
-as I did just how many problems you can face with all of this, or you are
-really an expert, please do yourself a favour and try to stay within what I
-am suggesting as standard or alternative ways of building cpmtools.
-
-Missing libaries and compiler tools can be solved by trial and error and
-reading the cygwin and cpmtools documentation.
-
-There are however some things about path names and file names that you need
-to be aware of, some of which I have mentioned throughout this document and
-some which I deliberately did not mention yet, like avoiding absolute paths
-and drive letters.
-
-If you use a drive letter like C: when hardcoding a path to diskdefs you are
-making several assumptions:
-
-First off, you are assuming that your build of cpmtools will only be run from
-within Windows cmd shell on the local drive C:, (not from a bash-like shell
-like cygwin which doesn't support drive letters the same way Windows cmd and
-Windows itself does), and that diskdefs will not be on another drive, and
-that drive C: exists in the first place, and that diskdefs is not on a
-Windows network either unless drive C:,X:,Y:,Z:,etc is a mapped network
-drive. It is questionable whether cpmtools build process for diskdefs pathing
-supports UNC pathing anyway. I couldn't get \\ to work since the first slash
-disappears in the configure script and the second slash becomes an escape
-sequence for the next letter. 
-
-Relative pathing will work and if you want to use conventions like
-/cpmtools-2.9/diskedefs this will work. Environments like ${USERPROFILE}
-aren't a good idea even if I could have got them to work since they are not
-portable for several reasons and I will say no more on this except I
-recommend that any path that you decide to use for diskdefs will only be
-almost portable between shells if off the root directory and contains forward
-slashes and no drive letters or colons.
-
-I hope what I have said proved less confusing to read than to write if you
-have bothered to read it. If you are not confused yet read further.
-
-- Since cpmtools has special meanings for A: and B: as command line targets
-it probably isn't a good idea to use these drives especially.
-
-- Some programmers and users have no difficulty in shifts between unix-like
-and Windows pathing. Some will be familiar with how colons are used on
-systems like Mac OSX. I think the only point to be made here is to consider
-your target audience and all the things you can anticipate going wrong with
-interoperability of all of this, (cpmtools being a set of command line
-tools), and build cpmtools accordingly for the needs of you or your users,
-then test what you have built with all this in mind.
-
-5.3 Testing your build of cpmtools
-----------------------------------
-
-To test what you have built I suggest you start with cpmls and cpmcp and an
-apple disk image or equivalent.
-
-John Elliot said "If you have appropriate rights, the CPMTOOLS should be able
-to access the floppy drive by using "A:" or "B:" as the name of the disc
-image.". I say don't bother mucking with your physical disk drive unless you
-have a physical CP/M disk of a format supported by cpmtools safely in the
-drive.
-
-Get an apple CP/M disk image and use it for testing is what I suggest. The
-following examples assume you have an Apple II DOS 3.3 order disk image
-called EXMPLCPM.dsk for testing.
-
-To list the files:
-
-cpmls -f apple-do EXMPLCPM.dsk
-
-The following example shows how to copy a file from an Apple II DOS 3.3 order
-cpm disk image to the current directory:
-
-cpmcp -f apple-do EXMPLCPM.dsk bhead.c 0:bhead.c
-
-The following example shows how to copy a file to an Apple II DOS 3.3 order
-cpm disk image from the current directory:
-
-cpmcp -f apple-do EXMPLCPM.dsk 0:bhead.c bhead.c
-
-To test the other utilities in cpmtools like cpmrm, cpmchattr, cpmchmod,
-fsck.cpm and fsed.cpm, review the appropriate manpages for usage.
-
-Those are simple tests as well using an apple-do format disk image. For
-mkfs.cpm I will leave it to those more capable than I to decide what to do
-there. Compared to them I am merely dangerous.
-
-Acknowledgements and Stuff
---------------------------
-
-Michael Haardt - for cpmtools in the first place and for his tireless and
-ongoing efforts in supporting cpmtools in the second.
-
-John Elliot - for bringing cpmtools to Windows.
-
-My focus is on Windows XP (and other Windows) users and making this available
-to them. At this point in time my focus is also on Apple II Z80 Softcard
-users. Thankfully Michael Haardt has considered Apple II disk images in
-cpmtools. My focus is also on the Aztec C Z80 MS-DOS cross-compiler which
-creates Apple II CP/M programs in Windows XP.
-
-Between Michael and John, with cpmtools I can now easily get these onto an
-Apple disk image and transfer the disk image over to my real Apple II which
-has a Z80 softcard clone using my Microdrive with a CF card and make a real
-CP/M disk from the image with DISKMAKER.8 or DSK2FILE then run my Aztec C
-CP/M programs using the real thing. I can also use the emulator that came
-with Apple II Oasis to run the disk image.
-
-Apparently nothing is missing from cpmtools for Windows XP that is available
-on cpmtools for unix-like systems and I am thankful for that. Hopefully you
-will be too.
-
-I would also like to acknowledge the following individuals from the
-comp.os.cpm and apple2.sys usenet newsgroups who gave their experience,
-thoughts and encouragement during my adventure with all of this and in no
-particular order:
-
-David Schmidt - for cygwin feedback.
-Udo Munk - for cygwin feedback. 
-Peter Dassow - for cygwin feedback.
-Stevo Tarkin - for msys feedback.
-Volker Pohlers - for msys and pdcurses feedback.
-Rolf Harmann - for linux feedback.
-Richard Brady - who may or may not know watfor:) 
-
-If I missed anyone, I thank them too. I am somewhat new to some of this and
-needed all the help I received. cygwin is now my friend.
-
-Bill Buckels
-bbuckels@mts.net
-November 2008

Tools/cpmtools/docs/WS_FTP.LOG

@@ -0,0 +1,12 @@
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpm.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmchattr.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmchattr.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmchmod.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmchmod.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmcp.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmcp.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmls.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmls.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\cpmrm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools cpmrm.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\fsck.cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools fsck.cpm.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\fsed.cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools fsed.cpm.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\index.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools index.htm
+2013.12.01 19:45 A C:\cpmtoolsWin32\docs\mkfs.cpm.htm --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools mkfs.cpm.htm
+2013.12.01 19:45 B C:\cpmtoolsWin32\docs\turkey.gif --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools turkey.gif
+2013.12.01 19:45 B C:\cpmtoolsWin32\docs\wturkey.gif --> www.cpm8680.com /public_html/clipshop.ca/cpm/cpmtools wturkey.gif

Tools/cpmtools/docs/cpm.htm

@@ -1,357 +1,425 @@
-<HTML><HEAD><TITLE>CPM - CP/M disk and file system format</TITLE>
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">CPM</A></H2>
-Section: File formats (5)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME cpm - CP/M disk and file system format.</B><BR><BR>
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>Characteristic sizes - Each CP/M disk format is described by the following specific sizes:</B>
-<BR>
-
-<DL COMPACT><DT><DD>
-
-Sector size in bytes
-<BR>
-
-Number of tracks
-<BR>
-
-Number of sectors
-<BR>
-
-Block size
-<BR>
-
-Number of directory entries
-<BR>
-
-Logical sector skew
-<BR>
-
-Number of reserved system tracks
-<BR><BR>
-</DL>
-
-A block is the smallest allocatable storage unit.  CP/M supports block
-sizes of 1024, 2048, 4096, 8192 and 16384 bytes.  Unfortunately, this
-format specification is not stored on the disk and there are lots of
-formats.  Accessing a block is performed by accessing its sectors, which
-are stored with the given software skew.
-<BR><BR>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>Device areas - A CP/M disk contains three areas:</B><BR>
-
-<DL COMPACT><DT><DD>
-
-System tracks (optional)
-<BR>
-
-Directory
-<BR>
-
-Data
-<BR><BR>
-</DL>
-
-The system tracks store the boot loader and CP/M itself.  In order to save
-disk space, there are non-bootable formats which omit those system tracks.
-The term <I>disk capacity</I> always excludes the space for system tracks.
-Note that there is no bitmap or list for free blocks.  When accessing a
-drive for the first time, CP/M builds this bitmap in core from the directory.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>Directory entries - The directory is a sequence of directory entries (also called extents),
-which contain 32 bytes of the following structure:</B><BR>
-<DL COMPACT><DT><DD>
-
-St<TT>&nbsp;</TT>F0<TT>&nbsp;</TT>F1<TT>&nbsp;</TT>F2<TT>&nbsp;</TT>F3<TT>&nbsp;</TT>F4<TT>&nbsp;</TT>F5<TT>&nbsp;</TT>F6<TT>&nbsp;</TT>F7<TT>&nbsp;</TT>E0<TT>&nbsp;</TT>E1<TT>&nbsp;</TT>E2<TT>&nbsp;</TT>Xl<TT>&nbsp;</TT>Bc<TT>&nbsp;</TT>Xh<TT>&nbsp;</TT>Rc<BR>
-<BR>
-
-Al<TT>&nbsp;&nbsp;&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>AlAl<BR>
-<BR>
-</DL>
-
-
-<B>St</B> is the status; possible values are:<BR>
-<DL COMPACT><DT><DD>
-
-0-15: used for file, status is the user number
-<BR>
-
-16-31: used for file, status is the user number (P2DOS)
-or used for password extent (CP/M 3 or higher)
-<BR>
-
-32: disc label
-<BR>
-
-33: time stamp (P2DOS)
-<BR>
-
-0xE5: unused
-<BR><BR>
-</DL>
-
-<B>F0-E2</B> are the file name and its extension.  They may consist of
-any printable 7 bit ASCII character but: <B>&lt; &gt; . , ; : = ? * [ ]</B>.
-The file name must not be empty, the extension may be empty.  Both are
-padded with blanks.  The highest bit of each character of the file name
-and extension is used as attribute.  The attributes have the following
-meaning:<BR>
-
-
-<DL COMPACT><DT><DD>
-F0: requires set wheel byte (Backgrounder II)
-<BR>
-
-F1: public file (P2DOS, ZSDOS), forground-only command (Backgrounder II)
-<BR>
-
-F2: date stamp (ZSDOS), background-only commands (Backgrounder II)
-<BR>
-
-F7: wheel protect (ZSDOS)
-<BR>
-
-E0: read-only
-<BR>
-
-E1: system file
-<BR>
-
-E2: archived
-<BR><BR>
-</DL>
-
-Public files (visible under each user number) are not supported by CP/M
-2.2, but there is a patch and some free CP/M clones support them without
-any patches.
-<BR><BR>
-
-The wheel byte is (by default) the memory location at 0x4b.  If it is
-zero, only non-privileged commands may be executed.
-
-<BR><BR>
-
-
-<B>Xl</B> and <B>Xh</B> store the extent number.  A file may use more than
-one directory entry, if it contains more blocks than an extent can hold.
-In this case, more extents are allocated and each of them is numbered
-sequentially with an extent number.  If a physical extent stores more than
-16k, it is considered to contain multiple logical extents, each pointing
-to 16k data, and the extent number of the last used logical extent
-is stored.  Note: Some formats decided to always store only one logical
-extent in a physical extent, thus wasting extent space.  CP/M 2.2 allows
-512 extents per file, CP/M 3 and higher allow up to 2048.  Bit 5-7 of
-Xl are 0, bit 0-4 store the lower bits of the extent number.  Bit 6
-and 7 of Xh are 0, bit 0-5 store the higher bits of the extent number.
-
-<BR><BR>
-
-
-<B>Rc</B> and <B>Bc</B> determine the length of the data used by this extent.  The
-physical extent is divided into logical extents, each of them being 16k
-in size (a physical extent must hold at least one logical extent, e.g. a
-blocksize of 1024 byte with two-byte block pointers is not allowed).
-Rc stores the number of 128 byte records of the last used logical extent.
-Bc stores the number of bytes in the last used record.  The value 0 means
-128 for backward compatibility with CP/M 2.2, which did not support Bc.
-
-<BR><BR>
-
-
-<B>Al</B> stores block pointers.  If the disk capacity is less than 256 blocks,
-Al is interpreted as 16 byte-values, otherwise as 8 double-byte-values.
-A block pointer of 0 marks a hole in the file.  If a hole
-covers the range of a full extent, the extent will not be allocated.  In particular,
-the first extent of a file does not neccessarily have extent number 0.
-A file may not share blocks with other files, as its blocks would be freed
-if the other files is erased without a following disk system reset.  CP/M returns
-EOF when it reaches a hole, whereas UNIX returns zero-value bytes, which makes
-holes invisible.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>Time stamps - P2DOS and CP/M Plus support time stamps, which are stored in each fourth
-directory entry.
-</B><BR><BR>
-This entry contains the time stamps for
-the extents using the previous three directory entries.  Note that you
-really have time stamps for each extent, no matter if it is the first
-extent of a file or not.  The structure of time stamp entries is:<BR>
-
-<DL COMPACT><DT><DD>
-
-1 byte status 0x21
-<BR>
-
-8 bytes time stamp for third-last directory entry
-<BR>
-
-2 bytes unused
-<BR>
-
-8 bytes time stamp for second-last directory entry
-<BR>
-
-2 bytes unused
-<BR>
-
-8 bytes time stamp for last directory entry
-<BR><BR>
-</DL>
-
-A time stamp consists of two dates: Creation and modification date (the
-latter being recorded when the file is closed).  CP/M Plus further
-allows optionally to record the access instead of creation date as first
-time stamp.<BR>
-
-<DL COMPACT><DT><DD>
-2 bytes (little-endian) days starting with 1 at 01-01-1978
-<BR>
-
-1 byte hour in BCD format
-<BR>
-
-1 byte minute in BCD format
-<BR><BR>
-</DL>
-
-
-<A NAME="lbAI">&nbsp;</A>
-<B>Disc labels - CP/M Plus supports disc labels, which are stored in an arbitrary directory
-entry.</B>
-<BR><BR>
-The structure of disc labels is:<BR>
-
-<DL COMPACT><DT><DD>
-1 byte status 0x20
-<BR>
-
-<B>F0-E2</B> are the disc label
-<BR>
-
-1 byte mode: bit 7 activates password protection, bit 6 causes time stamps on
-access, but 5 causes time stamps on modifications, bit 4 causes time stamps on
-creation and bit 0 is set when a label exists.  Bit 4 and 6 are exclusively set.
-<BR>
-
-1 byte password decode byte: To decode the password, xor this byte with the password
-bytes in reverse order.  To encode a password, add its characters to get the
-decode byte.
-<BR>
-
-2 reserved bytes
-<BR>
-
-8 password bytes
-<BR>
-
-4 bytes label creation time stamp
-<BR>
-
-4 bytes label modification time stamp
-<BR><BR>
-</DL>
-
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>Passwords - CP/M Plus supports passwords, which are stored in an arbitrary directory entry.</B>
-<BR><BR>
-
-The structure of these entries is:<BR>
-
-<DL COMPACT><DT><DD>
-
-1 byte status (user number plus 16)
-<BR>
-
-<B>F0-E2</B> are the file name and its extension.
-<BR>
-
-1 byte password mode: bit 7 means password required for reading, bit 6 for writing
-and bit 5 for deleting.
-<BR>
-
-1 byte password decode byte: To decode the password, xor this byte with the password
-bytes in reverse order.  To encode a password, add its characters to get the
-decode byte.
-<BR>
-
-2 reserved bytes
-<BR>
-
-8 password bytes
-<BR><BR>
-</DL>
-
-
-
-<A NAME="lbAK">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF=" ./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
-
-<I><A HREF=" ./fsck.cpm.htm">fsck.cpm</A></I>(1),
-
-<I><A HREF=" ./fsed.cpm.htm">fsed.cpm</A></I>(1),
-
-<I><A HREF=" ./cpmls.htm">cpmls</A></I>(1)
-
-
-<BR><BR>
-
-<HR>
-<A NAME="index">&nbsp;</A><B>Index</B><BR>
-<DL>
-<DT><A HREF="#lbAA">NAME cpm - CP/M disk and file system format</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">Characteristic sizes</A><DD>
-<DT><A HREF="#lbAF">Device areas</A><DD>
-<DT><A HREF="#lbAG">Directory entries</A><DD>
-<DT><A HREF="#lbAH">Time stamps</A><DD>
-<DT><A HREF="#lbAI">Disc labels </A><DD>
-<DT><A HREF="#lbAJ">Passwords</A><DD>
-</DL>
-<DT><A HREF="#lbAK">SEE ALSO</A><DD>
-</DL>
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>CPM - CP/M disk and file system format</TITLE>
+</HEAD>
+<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">CPM</A></H2>
+Section: File formats (5)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME cpm - CP/M disk and file system format.</B><BR><BR>
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>Characteristic sizes - Each CP/M disk format is described by the following specific sizes:</B>
+<BR>
+
+<DL COMPACT><DT><DD>
+
+Sector size in bytes
+<BR>
+
+Number of tracks
+<BR>
+
+Number of sectors
+<BR>
+
+Block size
+<BR>
+
+Number of directory entries
+<BR>
+
+Logical sector skew
+<BR>
+
+Number of reserved system tracks (optional)
+<BR>
+
+Offset to start of volume (optional)
+<BR><BR>
+</DL>
+
+A block is the smallest allocatable storage unit.
+CP/M supports block sizes of 1024, 2048, 4096, 8192 and 16384 bytes.
+Unfortunately, this format specification is not stored on the disk and
+there are lots of formats. Accessing a block is performed by
+accessing its sectors, which are stored with the given software skew.
+<BR><BR>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>Device areas - A CP/M disk contains these areas:</B><BR>
+
+<DL COMPACT><DT><DD>
+
+Volume Offset (optional)
+<BR>
+
+System tracks (optional)
+<BR>
+
+Directory
+<BR>
+
+Data
+<BR><BR>
+</DL>
+
+The system tracks store the boot loader and CP/M itself.  In order to save
+disk space, there are non-bootable formats which omit those system tracks.
+The term <I>disk capacity</I> always excludes the space for system tracks.
+Note that there is no bitmap or list for free blocks.  When accessing a
+drive for the first time, CP/M builds this bitmap in core from the directory.
+<BR><BR>
+
+A hard disk can have the additional notion of a <I>volume offset</I> to
+locate the start of the drive image (which may or may not have system
+tracks associated with it). The base unit for volume offset is byte
+count from the beginning of the physical disk, but specifiers of
+<I>K</I>, <I>M</I>, <I>T</I> or <I>S</I> may be appended to denote
+kilobytes, megabytes, tracks or sectors.  If provided, a specifier
+must immediately follow the numeric value with no whitespace.  For
+convenience upper and lower case are both accepted and only the first
+letter is significant, thus 2KB, 8MB, 1000trk and 16sec are valid
+values. Offset must appear subsequent to track, sector and sector
+length values.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>Directory entries - The directory is a sequence of directory entries (also called extents),
+which contain 32 bytes of the following structure:</B><BR>
+<DL COMPACT><DT><DD>
+
+St<TT>&nbsp;</TT>F0<TT>&nbsp;</TT>F1<TT>&nbsp;</TT>F2<TT>&nbsp;</TT>F3<TT>&nbsp;</TT>F4<TT>&nbsp;</TT>F5<TT>&nbsp;</TT>F6<TT>&nbsp;</TT>F7<TT>&nbsp;</TT>E0<TT>&nbsp;</TT>E1<TT>&nbsp;</TT>E2<TT>&nbsp;</TT>Xl<TT>&nbsp;</TT>Bc<TT>&nbsp;</TT>Xh<TT>&nbsp;</TT>Rc<BR>
+<BR>
+
+Al<TT>&nbsp;&nbsp;&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>Al<TT>&nbsp;</TT>AlAl<BR>
+<BR>
+</DL>
+
+
+<B>St</B> is the status; possible values are:<BR>
+<DL COMPACT><DT><DD>
+
+0-15: used for file, status is the user number
+<BR>
+
+16-31: used for file, status is the user number (P2DOS)
+or used for password extent (CP/M 3 or higher)
+<BR>
+
+32: disc label
+<BR>
+
+33: time stamp (P2DOS)
+<BR>
+
+0xE5: unused
+<BR><BR>
+</DL>
+
+<B>F0-E2</B> are the file name and its extension.  They may consist of
+any printable 7 bit ASCII character but: <B>&lt; &gt; . , ; : = ? * [ ]</B>.
+The file name must not be empty, the extension may be empty.  Both are
+padded with blanks.  The highest bit of each character of the file name
+and extension is used as attribute.  The attributes have the following
+meaning:<BR>
+
+
+<DL COMPACT><DT><DD>
+F0: requires set wheel byte (Backgrounder II)
+<BR>
+
+F1: public file (P2DOS, ZSDOS), foreground-only command (Backgrounder II)
+<BR>
+
+F2: date stamp (ZSDOS), background-only commands (Backgrounder II)
+<BR>
+
+F7: wheel protect (ZSDOS)
+<BR>
+
+E0: read-only
+<BR>
+
+E1: system file
+<BR>
+
+E2: archived
+<BR><BR>
+</DL>
+
+Public files (visible under each user number) are not supported by CP/M
+2.2, but there is a patch and some free CP/M clones support them without
+any patches.
+<BR><BR>
+
+The wheel byte is (by default) the memory location at 0x4b.  If it is
+zero, only non-privileged commands may be executed.
+
+<BR><BR>
+
+
+<B>Xl</B> and <B>Xh</B> store the extent number.  A file may use more than
+one directory entry, if it contains more blocks than an extent can hold.
+In this case, more extents are allocated and each of them is numbered
+sequentially with an extent number.  If a physical extent stores more than
+16k, it is considered to contain multiple logical extents, each pointing
+to 16k data, and the extent number of the last used logical extent
+is stored.  Note: Some formats decided to always store only one logical
+extent in a physical extent, thus wasting extent space.  CP/M 2.2 allows
+512 extents per file, CP/M 3 and higher allow up to 2048.  Bit 5-7 of
+Xl are 0, bit 0-4 store the lower bits of the extent number.  Bit 6
+and 7 of Xh are 0, bit 0-5 store the higher bits of the extent number.
+
+<BR><BR>
+
+
+<B>Rc</B> and <B>Bc</B> determine the length of the data used by  this  extent.
+The physical extent is divided into logical extents, each of them being 16k
+in size (a physical extent must hold at least one logical extent,  e.g.
+a  blocksize of 1024 byte with two-byte block pointers is not allowed).
+Rc stores the number of 128 byte  records  of  the  last  used  logical
+extent.   Bc  stores  the number of bytes in the last used record.  The
+value 0 means 128 for backward compatibility with CP/M 2.2,  which  did
+not support Bc.  ISX records the number of unused instead of used bytes
+in Bc.
+
+<BR><BR>
+
+
+<B>Al</B> stores block pointers.  If the disk capacity minus boot  tracks  but
+including the directory area is less than 256 blocks, Al is interpreted
+as 16 byte-values, otherwise as 8 double-byte-values.  Since the direc-
+tory area is not subtracted, the directory area starts with block 0 and
+files can never allocate block 0, which is why this value can be  given
+a  new  meaning:  A  block pointer of 0 marks a hole in the file.  If a
+hole covers the range of a full extent, the extent will  not  be  allo-
+cated.  In particular, the first extent of a file does not neccessarily
+have extent number 0.  A file may not share blocks with other files, as
+its  blocks  would be freed if the other files were erased without a fol-
+lowing disk system reset.  CP/M returns EOF when  it  reaches  a  hole,
+whereas UNIX returns zero-value bytes, which makes holes invisible.
+<BR><BR>
+
+<A NAME="lbAH0">&nbsp;</A>
+<B>Native Time stamps</B><BR><BR>
+
+P2DOS  and  CP/M  Plus  support  time  stamps, which are stored in each
+fourth directory entry.  This entry contains the time  stamps  for  the
+extents  using  the  previous  three  directory entries.  Note that you
+really have time stamps for each extent, no matter if it is  the  first
+extent of a file or not.  The structure of time stamp entries is:<BR>
+
+<DL COMPACT><DT><DD>
+
+1 byte status 0x21
+<BR>
+
+8 bytes time stamp for third-last directory entry
+<BR>
+
+2 bytes unused
+<BR>
+
+8 bytes time stamp for second-last directory entry
+<BR>
+
+2 bytes unused
+<BR>
+
+8 bytes time stamp for last directory entry
+<BR><BR>
+</DL>
+
+A time stamp consists of two dates: Creation and modification date (the
+latter being recorded when the file is closed).  CP/M Plus further
+allows optionally to record the access instead of creation date as first
+time stamp.<BR>
+
+<DL COMPACT><DT><DD>
+2 bytes (little-endian) days starting with 1 at 01-01-1978
+<BR>
+
+1 byte hour in BCD format
+<BR>
+
+1 byte minute in BCD format
+<BR><BR>
+</DL>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>DateStamper Time stamps</B><BR><BR>
+
+The DateStamper software added functions to the BDOS to manage
+time stamps by allocating a read only file with the name "!!!TIME&.DAT"
+in the very first directory entry, covering the very first data blocks.
+(The first 7 characters of this read-only file name is the magic number.)
+<BR>
+<BR>
+
+It contains one entry per directory entry with the following
+structure of 16 bytes: <BR>
+<DL COMPACT><DT><DD>
+
+5 bytes create datefield
+<BR>
+
+5 bytes access datefield
+<BR>
+
+5 bytes modify datefield
+<BR>
+
+1 byte magic number/checksum
+<BR><BR>
+</DL>
+
+The magic number is used for the  first  7  entries  of  each  128-byte
+record and contains the characters !, !, !, T, I, M and E (<b>!!!TIME</b>).
+The check-sum is used on every 8th entry (last entry in 128-byte record)  and  is
+the  sum of the first 127 bytes of the record.  Each datefield has this
+structure:<BR>
+
+<DL COMPACT><DT><DD>
+
+1 byte BCD coded year (no century, so it is sane assuming any year < 70 means 21st century)
+<BR>
+
+1 byte BCD coded month
+<BR>
+
+1 byte BCD coded day
+<BR>
+
+1 byte BCD coded hour or, if the high bit is set, the high byte of a counter for systems without real time clock
+<BR>
+
+1 byte BCD coded minute, or the low byte of the counter
+<BR><BR>
+</DL>
+
+
+<A NAME="lbAI">&nbsp;</A>
+<B>Disc labels - CP/M Plus supports disc labels, which are stored in an arbitrary directory
+entry.</B>
+<BR><BR>
+The structure of disc labels is:<BR>
+
+<DL COMPACT><DT><DD>
+1 byte status 0x20
+<BR>
+
+<B>F0-E2</B> are the disc label
+<BR>
+
+1 byte mode: bit 7 activates password protection, bit 6 causes time stamps on
+access, but 5 causes time stamps on modifications, bit 4 causes time stamps on
+creation and bit 0 is set when a label exists.  Bit 4 and 6 are exclusively set.
+<BR>
+
+1 byte password decode byte: To decode the password, xor this byte with the password
+bytes in reverse order.  To encode a password, add its characters to get the
+decode byte.
+<BR>
+
+2 reserved bytes
+<BR>
+
+8 password bytes
+<BR>
+
+4 bytes label creation time stamp
+<BR>
+
+4 bytes label modification time stamp
+<BR><BR>
+</DL>
+
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>Passwords - CP/M Plus supports passwords, which are stored in an arbitrary directory entry.</B>
+<BR><BR>
+
+The structure of these entries is:<BR>
+
+<DL COMPACT><DT><DD>
+
+1 byte status (user number plus 16)
+<BR>
+
+<B>F0-E2</B> are the file name and its extension.
+<BR>
+
+1 byte password mode: bit 7 means password required for reading, bit 6 for writing
+and bit 5 for deleting.
+<BR>
+
+1 byte password decode byte: To decode the password, xor this byte with the password
+bytes in reverse order.  To encode a password, add its characters to get the
+decode byte.
+<BR>
+
+2 reserved bytes
+<BR>
+
+8 password bytes
+<BR><BR>
+</DL>
+
+
+
+<A NAME="lbAK">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF=" ./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
+
+<I><A HREF=" ./fsck.cpm.htm">fsck.cpm</A></I>(1),
+
+<I><A HREF=" ./fsed.cpm.htm">fsed.cpm</A></I>(1),
+
+<I><A HREF=" ./cpmls.htm">cpmls</A></I>(1)
+
+
+<BR><BR>
+
+<HR>
+<A NAME="index">&nbsp;</A><B>Index</B><BR>
+<DL>
+<DT><A HREF="#lbAA">NAME cpm - CP/M disk and file system format</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">Characteristic sizes</A><DD>
+<DT><A HREF="#lbAF">Device areas</A><DD>
+<DT><A HREF="#lbAG">Directory entries</A><DD>
+<DT><A HREF="#lbAH0">Native Time stamps</A><DD>
+<DT><A HREF="#lbAH">DateStamper Time stamps</A><DD>
+<DT><A HREF="#lbAI">Disc labels </A><DD>
+<DT><A HREF="#lbAJ">Passwords</A><DD>
+</DL>
+<DT><A HREF="#lbAK">SEE ALSO</A><DD>
+</DL>
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/cpmtools/docs/cpmchattr.htm

@@ -1,256 +1,249 @@
-<HTML><HEAD><TITLE>CPMCHATTR - change file attributes on CP/M files</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">CPMCHATTR</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME cpmchattr - change file attributes on CP/M files.</B><BR><BR>
-
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-
-<B>cpmchattr</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-<I>image</I>
-
-<I>attrib</I>
-
-<I>file-pattern</I>
-
-...
-
-<BR><BR>
-
-<b>Note: Wildcards like *.com should be preceded with the user number
-using a pattern like 0:*.com.</b>
-<br>
-<br>
-
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Cpmchattr changes the file attributes for files on CP/M disks.</B>
-<BR>
-<BR>
-
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-<b>For Apple II CP/M 80 users the cpmchattr command may have no practical
-effect. Try
-<A HREF=" ./cpmchmod.htm">cpmchmod</A> instead for setting read only
-attributes.</b>
-<BR><BR>
-
-<DT><b>attrib</b> Set the file attributes as given.<DD>
-
-<BR>
-</DL>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>FILE ATTRIBUTES - The file attribute string can contain the characters
-1,2,3,4,s,a,N and M.</B><BR><BR>
-
-The meanings of these are:
-
-<DL COMPACT>
-<DT><B>1-4</B><BR>
-
-<DD>
-The CP/M &quot;user attributes&quot; F1-F4.  CP/M does not assign any
-meaning to these attributes, though MP/M does.
-<BR>
-
-<DT><B>s</B><BR>
-
-<DD>
-The file is a system file.  This attribute can also be set by
-<I><A HREF=" ./cpmchmod.htm">cpmchmod</A>(1).</I>
-
-<DT><B>a</B><BR>
-
-<DD>
-The file has been backed up.
-<DT><B>N</B><BR>
-
-<DD>
-Reset all attributes to zero.  So the string &quot;N1r&quot; resets all attributes and
-then sets F1 and Read-Only.
-<DT><B>M</B><BR>
-
-<DD>
-Attributes after an M are unset rather than set.  The string &quot;12M34&quot; sets
-atttributes F1 and F2, and unsets F3 and F4.
-<BR><BR>
-</DL>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system the
-exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system the
-exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAI">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available CP/M
-formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>For Apple II CP/M 80 users the cpmchattr command may have no
-practical effect. Try
-<A HREF=" ./cpmchmod.htm">cpmchmod</A> instead for setting read only
-attributes.</b>
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-
-<A NAME="lbAK">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF="./cpmls.htm">cmpls</A></I>(1),
-
-<I><A HREF="./cpmchmod.htm">cpmchmod</A></I>(1),
-
-<I><A HREF="./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME cpmchattr - change file attributes on CP/M files.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">FILE ATTRIBUTES</A><DD>
-<DT><A HREF="#lbAG">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAH">ERRORS</A><DD>
-<DT><A HREF="#lbAI">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAJ">AUTHORS</A><DD>
-<DT><A HREF="#lbAK">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
-
+<HTML><HEAD><TITLE>CPMCHATTR - change file attributes on CP/M files</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">CPMCHATTR</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME cpmchattr - change file attributes on CP/M files.</B><BR><BR>
+
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+
+<B>cpmchattr</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+<I>image</I>
+
+<I>attrib</I>
+
+<I>file-pattern</I>
+
+...
+
+<BR><BR>
+
+<b>Note: Wildcards like *.com should be preceded with the user number
+using a pattern like 0:*.com.</b>
+<br>
+<br>
+
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Cpmchattr changes the file attributes for files on CP/M disks.</B>
+<BR>
+<BR>
+
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+<b>For Apple II CP/M 80 users the cpmchattr command may have no practical
+effect. Try
+<A HREF=" ./cpmchmod.htm">cpmchmod</A> instead for setting read only
+attributes.</b>
+<BR><BR>
+
+<DT><b>attrib</b> Set the file attributes as given.<DD>
+
+<BR>
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>The  file  attribute  string can contain the characters 1,2,3,4,r,s,a,n
+and m.</B><BR><BR>
+
+The meanings of these are:
+
+<DL COMPACT>
+<DT><B>1-4</B><BR>
+
+<DD>
+The CP/M &quot;user attributes&quot; F1-F4.  CP/M does not assign any
+meaning to these attributes, though MP/M does.
+<BR>
+
+<DT><B>r</B><BR>
+
+<DD>
+The file is read-only.  This is the same as using
+<I><A HREF=" ./cpmchmod.htm">cpmchmod</A>(1).</I> to
+revoke write permissions.
+
+<DT><B>s</B><BR>
+
+<DD>
+The file is a system file.  This attribute can also be set by
+<I><A HREF=" ./cpmchmod.htm">cpmchmod</A>(1).</I>
+
+<DT><B>a</B><BR>
+
+<DD>
+The file has been backed up.
+<DT><B>n</B><BR>
+
+<DD>
+Reset all attributes to zero.  So the string &quot;n1r&quot; resets all attributes and
+then sets F1 and Read-Only.
+<DT><B>m</B><BR>
+
+<DD>
+Attributes after an m are unset rather than set.  The string &quot;12m34&quot; sets
+atttributes F1 and F2, and unsets F3 and F4.
+<BR><BR>
+</DL>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system the
+exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system the
+exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAI">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+
+<A NAME="lbAK">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF="./cpmls.htm">cmpls</A></I>(1),
+
+<I><A HREF="./cpmchmod.htm">cpmchmod</A></I>(1),
+
+<I><A HREF="./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME cpmchattr - change file attributes on CP/M files.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">FILE ATTRIBUTES</A><DD>
+<DT><A HREF="#lbAG">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAH">ERRORS</A><DD>
+<DT><A HREF="#lbAI">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAJ">AUTHORS</A><DD>
+<DT><A HREF="#lbAK">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>
+

Tools/cpmtools/docs/cpmchmod.htm

@@ -1,251 +1,242 @@
-<HTML><HEAD><TITLE>CPMCHMOD - change file mode on CP/M files</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">CPMCHMOD</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME cpmchmod - change file mode on CP/M files.</B><BR><BR>
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-<B>cpmchmod</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-<I>image</I>
-
-<I>mode</I>
-
-<I>file-pattern</I>
-
-...
-
-<BR><BR>
-
-<b>Note: Wildcards like *.com should be preceded with the user number
-using a pattern like 0:*.com.</b>
-<br>
-<br>
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Cpmchmod changes the file mode for files on CP/M disks.</B>
-<BR>
-<BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-
-
-<DT><b>mode</b> Octal file mode, as used in the <b>unix command chmod</b>.<DD>
-
-<BR>
-<b>Numeric (Octal) file mode:</b>
-<br>
-<br>
-From one to four octal digits. Any omitted digits are assumed to be leading zeros.
-<br>
-<br>
-<b>chmod Examples:</b>
-<br>
-<br>
-chmod 400 file - Read by owner<br>
-chmod 040 file - Read by group<br>
-chmod 004 file - Read by world
-<br>
-<br>
-chmod 200 file - Write by owner<br>
-chmod 020 file - Write by group<br>
-chmod 002 file - Write by world
-<br>
-<br>
-chmod 100 file - execute by owner<br>
-chmod 010 file - execute by group<br>
-chmod 001 file - execute by world
-<br>
-<br>
-To combine these, just add the numbers together:
-<br>
-<br>
-chmod 444 file - Allow read permission to owner and group and world<br>
-chmod 777 file - Allow everyone to read, write, and execute file
-<br>
-<BR>
-</DL>
-<b>cmpchmod Examples:</b>
-<BR>
-<BR>
-The following example shows how to change a file on an Apple II DOS 3.3
-order cpm disk image to read only:
-<BR>
-<BR>
-cpmchmod -f apple-do exmplcpm.dsk 444 bhead.c
-<BR>
-<BR>
-The following example shows how to change a file on an Apple II DOS 3.3
-order cpm disk image to read/write:
-<BR>
-<BR>
-cpmchmod -f apple-do exmplcpm.dsk 666 bhead.c
-<BR>
-<BR>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system the
-exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system the
-exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available CP/M
-formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-<A NAME="lbAI">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME cpmchmod - change file mode on CP/M files.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAI">AUTHORS</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-</DL>
-
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
-
+<HTML><HEAD><TITLE>CPMCHMOD - change file mode on CP/M files</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">CPMCHMOD</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME cpmchmod - change file mode on CP/M files.</B><BR><BR>
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+<B>cpmchmod</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+<I>image</I>
+
+<I>mode</I>
+
+<I>file-pattern</I>
+
+...
+
+<BR><BR>
+
+<b>Note: Wildcards like *.com should be preceded with the user number
+using a pattern like 0:*.com.</b>
+<br>
+<br>
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Cpmchmod changes the file mode for files on CP/M disks.</B>
+<BR>
+<BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+
+
+<DT><b>mode</b> Octal file mode, as used in the <b>unix command chmod</b>.<DD>
+
+<BR>
+<b>Numeric (Octal) file mode:</b>
+<br>
+<br>
+From one to four octal digits. Any omitted digits are assumed to be leading zeros.
+<br>
+<br>
+<b>chmod Examples:</b>
+<br>
+<br>
+chmod 400 file - Read by owner<br>
+chmod 040 file - Read by group<br>
+chmod 004 file - Read by world
+<br>
+<br>
+chmod 200 file - Write by owner<br>
+chmod 020 file - Write by group<br>
+chmod 002 file - Write by world
+<br>
+<br>
+chmod 100 file - execute by owner<br>
+chmod 010 file - execute by group<br>
+chmod 001 file - execute by world
+<br>
+<br>
+To combine these, just add the numbers together:
+<br>
+<br>
+chmod 444 file - Allow read permission to owner and group and world<br>
+chmod 777 file - Allow everyone to read, write, and execute file
+<br>
+<BR>
+</DL>
+<b>cmpchmod Examples:</b>
+<BR>
+<BR>
+The following example shows how to change a file on an Apple II DOS 3.3
+order cpm disk image to read only:
+<BR>
+<BR>
+cpmchmod -f apple-do exmplcpm.dsk 444 bhead.c
+<BR>
+<BR>
+The following example shows how to change a file on an Apple II DOS 3.3
+order cpm disk image to read/write:
+<BR>
+<BR>
+cpmchmod -f apple-do exmplcpm.dsk 666 bhead.c
+<BR>
+<BR>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system the
+exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system the
+exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+<A NAME="lbAI">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME cpmchmod - change file mode on CP/M files.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAI">AUTHORS</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+</DL>
+
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>
+

Tools/cpmtools/docs/cpmcp.htm

@@ -1,290 +1,281 @@
-<HTML><HEAD><TITLE>CPMCP - copy files from and to CP/M disks</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">CPMCP</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME cpmcp - copy files from and to CP/M disks.</B><BR><BR>
-
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-<B>cpmcp</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-[<B>-p</B>]
-
-[<B>-t</B>]
-
-<I>image</I>
-
-<I>user</I><B>:</B><I>file</I> <I>file</I>
-<BR>
-<BR>
-
-<B>cpmcp</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-[<B>-p</B>]
-
-[<B>-t</B>]
-
-<I>image</I>
-
-<I>user</I><B>:</B><I>file</I> ... <I>directory</I>
-<BR>
-<BR>
-
-<B>cpmcp</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-[<B>-p</B>]
-
-[<B>-t</B>]
-
-<I>image</I>
-
-<I>file</I> <I>user</I><B>:</B><I>file</I>
-<BR>
-<BR>
-
-<B>cpmcp</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-[<B>-p</B>]
-
-[<B>-t</B>]
-
-<I>image</I>
-
-<I>file</I> ... <I>user</I><B>:</B>
-
-<BR><BR>
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Cpmcp copies one or more files to or from a CP/M disk.</B>
-<BR>
-<BR>
-
-
-When copying multiple files, the last argument must be a drive or directory.
-The drive letter does not matter because the device is specified by the
-image, it is only used to specify which direction you want to copy.  The user
-number is specified after the drive letter, if omitted user 0 is used.
-<BR><BR>
-
-You can use <B>*</B> and <B>?</B> as <b>"wildcards"</b> in CP/M file names,
-which have the same meaning in unix-like shells, and also on the MS-DOS
-and Windows command lines for file name patterns.
-
-<BR>
-<BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-For Apple II CP/M 80
-users the disk image formats apple-do and apple-po are available. These
-are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
-using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
-<BR><BR>
-
-<DT><B>-p</B><DD>
-Preserve time stamps when copying files from CP/M to UNIX (not
-implemented for copying the other way so far).
-<BR>
-<BR>
-
-
-<DT><B>-t</B><DD>
-Convert text files between CP/M and UNIX conventions.
-<BR>
-
-</DL>
-
-<b>Examples:</b>
-<BR>
-<BR>
-The following example shows how to copy a file from an Apple II DOS 3.3 order cpm disk image
-to the current directory:
-<BR>
-<BR>
-<b>cpmcp -f apple-do exmplcpm.dsk bhead.c 0:bhead.c</b>
-<BR>
-<BR>
-The following example shows how to copy a file to an Apple II DOS 3.3 order cpm disk image
-from the current directory:
-<BR>
-<BR>
-<b>cpmcp -f apple-do exmplcpm.dsk 0:bhead.c bhead.c</b>
-<BR>
-<BR>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available
-CP/M formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-
-<A NAME="lbAI">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
-The Windows port is
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME cpmcp - copy files from and to CP/M disks.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAI">AUTHORS</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>CPMCP - copy files from and to CP/M disks</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">CPMCP</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME cpmcp - copy files from and to CP/M disks.</B><BR><BR>
+
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+<B>cpmcp</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+[<B>-p</B>]
+
+[<B>-t</B>]
+
+<I>image</I>
+
+<I>user</I><B>:</B><I>file</I> <I>file</I>
+<BR>
+<BR>
+
+<B>cpmcp</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+[<B>-p</B>]
+
+[<B>-t</B>]
+
+<I>image</I>
+
+<I>user</I><B>:</B><I>file</I> ... <I>directory</I>
+<BR>
+<BR>
+
+<B>cpmcp</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+[<B>-p</B>]
+
+[<B>-t</B>]
+
+<I>image</I>
+
+<I>file</I> <I>user</I><B>:</B><I>file</I>
+<BR>
+<BR>
+
+<B>cpmcp</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+[<B>-p</B>]
+
+[<B>-t</B>]
+
+<I>image</I>
+
+<I>file</I> ... <I>user</I><B>:</B>
+
+<BR><BR>
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Cpmcp copies one or more files to or from a CP/M disk.</B>
+<BR>
+<BR>
+
+
+When copying multiple files, the last argument must be a drive or directory.
+The drive letter does not matter because the device is specified by the
+image, it is only used to specify which direction you want to copy.  The user
+number is specified after the drive letter, if omitted user 0 is used.
+<BR><BR>
+
+You can use <B>*</B> and <B>?</B> as <b>"wildcards"</b> in CP/M file names,
+which have the same meaning in unix-like shells, and also on the MS-DOS
+and Windows command lines for file name patterns.
+
+<BR>
+<BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+For Apple II CP/M 80
+users the disk image formats apple-do and apple-po are available. These
+are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
+using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
+<BR><BR>
+
+<DT><B>-p</B><DD>
+Preserve time stamps when copying files from CP/M to UNIX (not
+implemented for copying the other way so far).
+<BR>
+<BR>
+
+
+<DT><B>-t</B><DD>
+Convert text files between CP/M and UNIX conventions.
+<BR>
+
+</DL>
+
+<b>Examples:</b>
+<BR>
+<BR>
+The following example shows how to copy a file from an Apple II DOS 3.3 order cpm disk image
+to the current directory:
+<BR>
+<BR>
+<b>cpmcp -f apple-do exmplcpm.dsk 0:bhead.c bhead.c</b>
+<BR>
+<BR>
+The following example shows how to copy a file to an Apple II DOS 3.3 order cpm disk image
+from the current directory:
+<BR>
+<BR>
+<b>cpmcp -f apple-do exmplcpm.dsk bhead.c 0:bhead.c</b>
+<BR>
+<BR>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+
+<A NAME="lbAI">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
+The Windows port is
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF=" ./cpmls.htm">cmpls</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME cpmcp - copy files from and to CP/M disks.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAI">AUTHORS</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/cpmtools/docs/cpmls.htm

@@ -1,235 +1,226 @@
-<HTML><HEAD><TITLE>CPMLS - list sorted contents of directory</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">CPMLS</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME cpmls - list sorted contents of directory</B><BR><BR>
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-
-<B>cpmls</B>
-
-[<B>-d</B>|<B>-D</B>|<B>-F</B>|<B>-A</B>|<B>-l</B>[<B>-c</B>][<B>-i</B>]]
-
-[<B>-f</B>
-
-<I>format</I>]
-
-<I>image</I>
-
-[<I>file-pattern</I>...]
-<BR><BR>
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Cpmls lists the sorted contents of the directory.</B>
-<BR>
-<BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-For Apple II CP/M 80
-users the disk image formats apple-do and apple-po are available. These
-are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
-using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
-<BR><BR>
-
-<DT><B>-d</B><BR><DD>
-Old CP/M 2.2 dir output.
-<BR><BR>
-
-<DT><B>-D</B><BR><DD>
-P2DOS 2.3 ddir-like output.
-<BR><BR>
-
-<DT><B>-F</B><BR><DD>
-CP/M 3.x dir output.
-<BR><BR>
-
-<DT><B>-A</B><BR><DD>
-E2fs lsattr-like output.
-<BR><BR>
-
-<DT><B>-l</B><BR><DD>
-Long UNIX-style directory listing including size, time stamp and user number.
-<BR><BR>
-
-<DT><B>-c</B><BR><DD>
-Output the creation time, not the modification time.
-<BR><BR>
-
-<DT><B>-i</B><BR><DD>
-Print index number of each file.
-<BR>
-</DL>
-
-<b>Example:</b>
-<BR>
-<BR>
-The following example shows how to list the files on an Apple II DOS 3.3
-order cpm disk image using a unix-like output:
-<BR>
-<BR>
-<b>cpmls -f apple-do -l exmplcpm.dsk</b>
-<BR>
-<BR>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system the
-exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available
-CP/M formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
-The Windows port is
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF=" ./cpmcp.htm">cpmcp</A></I>(1),
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME cpmls - list sorted contents of directory.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAI">AUTHORS</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>CPMLS - list sorted contents of directory</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">CPMLS</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME cpmls - list sorted contents of directory</B><BR><BR>
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+
+<B>cpmls</B>
+
+[<B>-d</B>|<B>-D</B>|<B>-F</B>|<B>-A</B>|<B>-l</B>[<B>-c</B>][<B>-i</B>]]
+
+[<B>-f</B>
+
+<I>format</I>]
+
+<I>image</I>
+
+[<I>file-pattern</I>...]
+<BR><BR>
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Cpmls lists the sorted contents of the directory.</B>
+<BR>
+<BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+For Apple II CP/M 80
+users the disk image formats apple-do and apple-po are available. These
+are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
+using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
+<BR><BR>
+
+<DT><B>-d</B><BR><DD>
+Old CP/M 2.2 dir output.
+<BR><BR>
+
+<DT><B>-D</B><BR><DD>
+P2DOS 2.3 ddir-like output.
+<BR><BR>
+
+<DT><B>-F</B><BR><DD>
+CP/M 3.x dir output.
+<BR><BR>
+
+<DT><B>-A</B><BR><DD>
+E2fs lsattr-like output.
+<BR><BR>
+
+<DT><B>-l</B><BR><DD>
+Long UNIX-style directory listing including size, time stamp and user number.
+<BR><BR>
+
+<DT><B>-c</B><BR><DD>
+Output the creation time, not the modification time.
+<BR><BR>
+
+<DT><B>-i</B><BR><DD>
+Print index number of each file.
+<BR>
+</DL>
+
+<b>Example:</b>
+<BR>
+<BR>
+The following example shows how to list the files on an Apple II DOS 3.3
+order cpm disk image using a unix-like output:
+<BR>
+<BR>
+<b>cpmls -f apple-do -l exmplcpm.dsk</b>
+<BR>
+<BR>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system the
+exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
+The Windows port is
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF=" ./cpmcp.htm">cpmcp</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME cpmls - list sorted contents of directory.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAI">AUTHORS</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/cpmtools/docs/cpmrm.htm

@@ -1,203 +1,196 @@
-<HTML><HEAD><TITLE>CPMRM - remove files on CP/M disks</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">CPMRM</H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME cpmrm - remove files on CP/M disks.</B><BR><BR>
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-
-<B>cpmrm</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-<I>image</I>
-
-<I>file-pattern</I>
-
-...
-<BR><BR>
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Cpmrm removes files from CP/M disks.</B>
-<BR>
-<BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-For Apple II CP/M 80
-users the disk image formats apple-do and apple-po are available. These
-are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
-using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
-<BR>
-<BR>
-</DL>
-<b>Example:</b>
-<BR>
-<BR>
-The following example shows how to remove a file on an Apple II DOS 3.3
-order cpm disk image:
-<BR>
-<BR>
-<b>cpmrm -f apple-do exmplcpm.dsk 0:bhead.c</b>
-<BR>
-<BR>
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available
-CP/M formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-<A NAME="lbAI">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
-The Windows port is
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME cpmrm - remove files on CP/M disks.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAI">AUTHORS</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>CPMRM - remove files on CP/M disks</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">CPMRM</H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME cpmrm - remove files on CP/M disks.</B><BR><BR>
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+
+<B>cpmrm</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+<I>image</I>
+
+<I>file-pattern</I>
+
+...
+<BR><BR>
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Cpmrm removes files from CP/M disks.</B>
+<BR>
+<BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+For Apple II CP/M 80
+users the disk image formats apple-do and apple-po are available. These
+are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
+using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
+<BR>
+<BR>
+</DL>
+<b>Example:</b>
+<BR>
+<BR>
+The following example shows how to remove a file on an Apple II DOS 3.3
+order cpm disk image:
+<BR>
+<BR>
+<b>cpmrm -f apple-do exmplcpm.dsk 0:bhead.c</b>
+<BR>
+<BR>
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+<A NAME="lbAI">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
+The Windows port is
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME cpmrm - remove files on CP/M disks.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAI">AUTHORS</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/cpmtools/docs/fsck.cpm.htm

@@ -1,228 +1,218 @@
-<HTML><HEAD><TITLE>FSCK.CPM - check a CP/M file system</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">FSCK.CPM</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME fsck.cpm - check a CP/M file system.</B><BR><BR>
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-<B>fsck.cpm</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-[<B>-n</B>]
-
-<I>image</I>
-
-<BR><BR>
-
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Fsck.cpm is used to check and repair a CP/M file system.</B>
-<BR>
-<BR>
-After reading the directory, it makes two passes.  The first pass checks
-extent fields for range and format violations (bad status, extent number,
-last record byte count, file name, extension, block number, record count,
-size of .COM files, time stamp format, invalid password characters, invalid
-time stamp mode).  The second pass checks extent connectivity (multiple
-allocated blocks and duplicate directory entries).
-<BR>
-<BR>
-<B>fsck.cpm can not yet repair all errors.</B>
-<BR>
-<BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-For Apple II CP/M 80
-users the disk image formats apple-do and apple-po are available. These
-are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
-using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
-<BR><BR>
-
-
-<DT><B>-n</B><DD>
-Open the file system read-only and do not repair any errors.
-<BR>
-<BR>
-</DL>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available
-CP/M formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-
-<A NAME="lbAI">&nbsp;</A>
-<B>DIAGNOSTICS - <I>image</I>: used/total files (n.n% non-contiguos), used/total blocks</B>
-<BR>
-<BR>
-No inconsistencies could be found.  The number of used files actually
-is the number of used extents.  Since a file may use more than
-one extent, this may be greater than the actual number of files, but a
-correct measure would not reflect how many files could still be created
-at most.  A file is considered fragmented, if sequential data blocks
-pointed to by the same extent do not have sequential block numbers.
-The number of used blocks includes the blocks used for system tracks
-and the directory.
-<BR>
-<BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
-The Windows port is
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAK">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME fsck.cpm - check a CP/M file system.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-<DT><A HREF="#lbAI">DIAGNOSTICS</A><DD>
-</DL>
-<DT><A HREF="#lbAJ">AUTHORS</A><DD>
-<DT><A HREF="#lbAK">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>FSCK.CPM - check a CP/M file system</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">FSCK.CPM</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME fsck.cpm - check a CP/M file system.</B><BR><BR>
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+<B>fsck.cpm</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+[<B>-n</B>]
+
+<I>image</I>
+
+<BR><BR>
+
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Fsck.cpm is used to check and repair a CP/M file system.</B>
+<BR>
+<BR>
+After reading the directory, it makes two passes.  The first pass checks
+extent fields for range and format violations (bad status, extent number,
+last record byte count, file name, extension, block number, record count,
+size of .COM files, time stamp format, invalid password characters, invalid
+time stamp mode).  The second pass checks extent connectivity (multiple
+allocated blocks and duplicate directory entries).
+<BR>
+<BR>
+<B>fsck.cpm can not yet repair all errors.</B>
+<BR>
+<BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+For Apple II CP/M 80
+users the disk image formats apple-do and apple-po are available. These
+are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
+using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
+<BR><BR>
+
+
+<DT><B>-n</B><DD>
+Open the file system read-only and do not repair any errors.
+<BR>
+<BR>
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+<A NAME="lbAI">&nbsp;</A>
+<B>DIAGNOSTICS - <I>image</I>: used/total files (n.n% non-contiguos), used/total blocks</B>
+<BR>
+<BR>
+No inconsistencies could be found.  The number of used files actually
+is the number of used extents.  Since a file may use more than
+one extent, this may be greater than the actual number of files, but a
+correct measure would not reflect how many files could still be created
+at most.  A file is considered fragmented, if sequential data blocks
+pointed to by the same extent do not have sequential block numbers.
+The number of used blocks includes the blocks used for system tracks
+and the directory.
+<BR>
+<BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
+The Windows port is
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAK">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME fsck.cpm - check a CP/M file system.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+<DT><A HREF="#lbAI">DIAGNOSTICS</A><DD>
+</DL>
+<DT><A HREF="#lbAJ">AUTHORS</A><DD>
+<DT><A HREF="#lbAK">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/cpmtools/docs/fsed.cpm.htm

@@ -1,202 +1,193 @@
-<HTML><HEAD><TITLE>FSED.CPM - edit a CP/M file system</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">FSED.CPM</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME fsed.cpm - edit a CP/M file system.</B><BR><BR>
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-<B>fsed.cpm</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-<I>image</I>
-
-<BR>
-<BR>
-
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Fsed.cpm edits a CP/M file system on an image file or device.</B>
-<BR>
-<BR>
-It knows about the system, directory and data area, using sector skew on
-the last two.  Directory entries are decoded.  The interactive usage is
-self-explanatory, provided you are familiar with programming tools like
-hexadecimal editors. If you are not then you should work with this program
-and familiarize yourself with its usage.
-<BR>
-<BR>
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-For Apple II CP/M 80
-users the disk image formats apple-do and apple-po are available. These
-are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
-using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
-<BR><BR>
-</DL>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available
-CP/M formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-<A NAME="lbAI">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
-The Windows port is
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF="./fsck.cpm.htm">mkfs.cpm</A></I>(1),
-
-<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
-
-<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME fsed.cpm - edit a CP/M file system.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAI">AUTHORS</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>FSED.CPM - edit a CP/M file system</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">FSED.CPM</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME fsed.cpm - edit a CP/M file system.</B><BR><BR>
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+<B>fsed.cpm</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+<I>image</I>
+
+<BR>
+<BR>
+
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Fsed.cpm edits a CP/M file system on an image file or device.</B>
+<BR>
+<BR>
+It knows about the system, directory and data area, using sector skew on
+the last two.  Directory entries are decoded.  The interactive usage is
+self-explanatory, provided you are familiar with programming tools like
+hexadecimal editors. If you are not then you should work with this program
+and familiarize yourself with its usage.
+<BR>
+<BR>
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+For Apple II CP/M 80
+users the disk image formats apple-do and apple-po are available. These
+are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
+using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
+<BR><BR>
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+<A NAME="lbAI">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
+The Windows port is
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF="./fsck.cpm.htm">fsck.cpm</A></I>(1),
+
+<I><A HREF="./mkfs.cpm.htm">mkfs.cpm</A></I>(1),
+
+<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME fsed.cpm - edit a CP/M file system.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAI">AUTHORS</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/cpmtools/docs/index.htm

@@ -1,11 +1,14 @@
-<HTML><HEAD><TITLE>Cpmtools 2.9 Executables for Windows Users</TITLE>
+<HTML><HEAD><TITLE>Wild Turkey - Cpmtools Executables for Windows Users</TITLE>
 </HEAD>
 
 <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
 <a name=topmenu></a><FONT FACE="Arial" SIZE=3><P>
 <center>
 <B>Welcome to the Wonderfully Ancient World of CP/M<br></B>
-Cpmtools 2.9 Executables for Windows Users<br></FONT>
+Cpmtools Executables for Windows Users<br>
+<img src="./wturkey.gif" alt="Wild Turkey" BORDER="0" ALIGN="middle"><br>
+The Wild Turkey Distribution<br>
+</FONT>
 </center>
 <FONT FACE="Arial" SIZE=2 COLOR="#000000">
 <UL>
@@ -13,11 +16,13 @@ Cpmtools 2.9 Executables for Windows Users<br></FONT>
 <br>
 <UL>
 <a href="./index.htm#intro">Introduction</a><br>
+<a href="./index.htm#custom">Customizations</a><br>
+<a href="./index.htm#features">Features</a><br>
 <a href="./index.htm#licence">Licence</a><br>
 <a href="./index.htm#disclaimer">Disclaimer</a><br>
 </UL>
 <br>
-<a name=programs></a><b>Program Documentation</b><br>
+<a name=programs></a><b>cpmtools Program Documentation</b><br>
 <br>
 <UL>
 <a href="./cpm.htm">CPM - CP/M disk and file system format</a><br>
@@ -45,7 +50,6 @@ Cpmtools 2.9 Executables for Windows Users<br></FONT>
 <UL>
 <a href="./index.htm#unix">cpmtools source code</a><br>
 <a href="./index.htm#windows">cpmtools Native Win32 Executables</a><br>
-<a href="./index.htm#cygwin">cpmtools cygwin Win32 Executables</a><br>
 <a href="./index.htm#resources">CP/M Resources</a><br>
 </UL>
 </UL>
@@ -64,8 +68,8 @@ source code... just to use them.</b>
 </FONT>
 <BR>
 <BR>
-Cpmtools is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+Cpmtools is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt; and
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
 <BR>
 <BR>
 <a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
@@ -109,7 +113,7 @@ option) any later version.
 <a name="unix"></a><b>Downloads</b>
 <br>
 <br>
-The source for the <b>latest version of cpmtools</b> is available as
+The source for the <b>latest "official" version of cpmtools</b> is available as
 a GNU zipped tape archive from:
 <br>
 <br>
@@ -118,37 +122,59 @@ a GNU zipped tape archive from:
 </b>
 <br>
 <br>
-The cpmtools source used in cygwin to build both the Windows binary (Executable) versions of
-cpmtools 2.9 noted below is available from the
+<a name="windows"></a><b>Cpmtools For Windows Users</b>
+<br>
+<br>
+<center>
+<img src="./turkey.gif" alt="Cooked Turkey" BORDER="0" ALIGN="middle"><br>
+<b>A Forked Version</b>
+</center>
+<br>
+The Wild Turkey Distribution of cpmtools has been forked from the "official" version
+and was "cooked-up" by Tom Burnett (using gcc under MinGW) with a recipe that we
+believe better suits the native Windows environment.
+Unlike earlier binaries that were distributed from this website which were built
+under cygwin, MinGW's binaries are free from dependence on "dll-hell" bloatware baggage,
+and run more quickly using MinGW's native Windows calls. We also believe Wild Turkey is less
+likely to cause other problems under Windows (like "gobbling-up" memory) than the "official" cpmtools source.
+<I>(Tom's Alloc became Turkey Alloc as Thanksgiving 2013 and his MinGW solution roughly coincided.)</I>
+<br>
+<br>
+<b>Native Win32 cpmtools Binaries (Executables)</b> are available from the
 <a href="http://www.cpm8680.com/">www.cpm8680.com Website</a> in a zip file format:
 <br>
 <br>
 <b>
-<a href="http://www.cpm8680.com/cpmtools/cpmtools-2.9.zip">http://www.cpm8680.com/cpmtools/cpmtools-2.9.zip</a>
+<a href="http://www.cpm8680.com/cpmtools/cpmtoolsWin32.zip">http://www.cpm8680.com/cpmtools/cpmtoolsWin32.zip</a>
 </b>
 <br>
 <br>
-<a name="windows"></a><b>For Windows Users</b> who do not wish to make working programs from source code, a compiled
-<b>Native Win32 Binary (Executable)</b> version of cpmtools 2.9 is available from the
-<a href="http://www.cpm8680.com/">www.cpm8680.com Website</a> in a zip file format:
+The cpmtools source used to build the Windows binaries (Executables) is included in the zip file.
 <br>
 <br>
-<b>
-<a href="http://www.cpm8680.com/cpmtools/cpmtools-2.9-Win32.zip">http://www.cpm8680.com/cpmtools/cpmtools-2.9-Win32.zip</a>
-</b>
+<b>To install cpmtools</b>, just unzip with pathnames intact to the root of your local drive
+(usually C:). A Windows XP Shortcut has been added to the \cpmtools directory for Windows
+XP, Vista, and Windows 7 Users.
 <br>
 <br>
-Just unzip with pathnames intact to the root of your local drive (usually C:)
-and open-up a cmd prompt in the \cpmtools directory (Windows XP and Vista users
-can click-on the cpmtools XP Shortcut)
-and you should be good to go. The document you are reading and the program description documents
-that it links to are included in the Windows zip file. To use them just click-on them from Windows explorer and
-in the \cpmtools\docs directory and
-they will load into your favorite web browser.
+<b>To run cpmtools</b>, just click on this shortcut in Windows Explorer. This shortcut can
+also be copied to the desktop. Users of earlier versions of Windows that support Win32 can
+run cpmtools from the Windows command prompt in the \cpmtools directory or by running
+cpmtools.bat (also provided). The \cpmtools direcory can also be added to the Windows path
+environment variable.
+<br>
+<br>
+The document you are
+reading and the program description documents that it links to are included in the Windows
+zip file. To use them just click-on them from Windows explorer in the \cpmtools\docs
+directory and they will load into your favorite web browser.
 <BR>
 <BR>
-<FONT FACE="Arial" SIZE=2 COLOR="#0000ff"><b>
-The distribution noted above has the following customizations:</b>
+<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
+<BR>
+<BR>
+<a name=custom></a><b>The Wild Turkey Distribution has the following customizations:</b>
+<FONT FACE="Arial" SIZE=2 COLOR="#0000ff">
 <br>
 <br>
 <b>The default disk image format is apple-do</b>. This means that if you are working
@@ -157,79 +183,106 @@ format option when typing in your command line.
 <br>
 <br>
 <b>The diskdefs file is called \cpmtools\diskdefs</b>. This has been hardcoded
-into the executables. This means that you can add the \cpmtools directory
-to your PATH and the disk and disk image format definitions file will be found.
-Users of earlier versions of Windows than XP that support Win32 will need to open a command
-prompt and run \cpmtools\cpmtools.bat to set their PATH.
-<br>
-<br>
-<b>A Windows XP Shortcut has been added for Windows XP Users</b>. This should
-also work in Windows Vista. This means that Windows XP and Vista users can just
-click on this shortcut in Windows Explorer or the Shortcut can be copied to
-the desktop.
-</FONT>
-<BR>
-<BR>
-<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
-<br>
-<br>
-<a name="cygwin"></a><b>For cygwin Users</b> who do not wish to make working programs from source code, a compiled
-<b>cygwin 5 Binary (Executable)</b> version of cpmtools 2.9 is available from the
-<a href="http://www.cpm8680.com/">www.cpm8680.com Website</a> in a zip file format:
-<br>
-<br>
-<b>
-<a href="http://www.cpm8680.com/cpmtools/cpmtools-2.9-cygwin.zip">http://www.cpm8680.com/cpmtools/cpmtools-2.9-cygwin.zip</a>
+into the executables.
 </b>
-<br>
-<br>
-Outside cygwin just unzip with pathnames intact to the root of the drive that the cygwin
-version 5 directory is installed on (\cygwin is assumed). If you are doing this inside cygwin
-using zip and cygwin is installed on C:, then cd \cygdrive\c before un-zipping.
-<br>
-<br>
-The cygwin installation comes complete with the manpages but not the html manual.
-It overlays your cygwin installation so review the zip before installing.
-<BR>
-<BR>
-<FONT FACE="Arial" SIZE=2 COLOR="#0000ff"><b>
-The distribution noted above has the following customization:</b>
-<br>
-<br>
-<b>The default disk image format is apple-do</b>. This means that if you are working
-with Apple II DOS 3.3 order disk images you never need to include the -f apple-do
-format option when typing in your command line.
-<br>
-<br>
-Other than that, it is what you would get if you built from scratch then installed
-using "make install". If you wish to know more you should download
-the source as well.
 </FONT>
 <BR>
 <BR>
 <a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
-<br>
-<br>
+<BR>
+<BR>
+<a name=features></a><B>The Wild Turkey Distribution has the following features:</B>
+<BR>
+<UL>
+* HTML documentation with additional information and examples for Windows Users.<BR>
+* Runs Without Compiling (no need to be a programmer).<BR>
+* Runs in Native Windows (no need for non-native shells or additional DLL's).<BR>
+* Runs Under Windows XP - 31% of Desktop Computers Worldwide (November 2013).<BR>
+* Runs Under Windows 7 - 46% of Desktop Computers Worldwide (November 2013).<BR>
+* Pre-configured for Apple II CP/M (the single most popular platform to run CP/M).<BR>
+</UL>
+<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
 <HR>
 <a name="resources"><b>CP/M Resources</b></a>
 <BR>
 <BR>
-<a href="http://www.aztecmuseum.ca/index.htm#cpm">Aztec C CP/M compilers</a> for
-making programs in Windows, MS-DOS, and CP/M that will run in CP/M are available
-from the <a href="http://www.aztecmuseum.ca/">Aztec C Museum Website</a> for Fair Use and for
-free by hobbyists and enthusiasts. These are no longer commercially available and are offered
-with the permission of the Copyright holder.
+<b>Compilers</b><br><br>
+<UL>
+<a href="http://www.aztecmuseum.ca/index.htm#cpm"><b>Aztec C compilers</b></a>
 <br>
 <br>
-The <a href="http://www.aztecmuseum.ca/">Aztec C Museum Website</a> is only one of many free
-CP/M resources on the Internet <b>too numerous to mention</b> that can be used in conjunction with
-cpmtools. Some of these include:
+Aztec C compilers for making programs in Windows, MS-DOS, and CP/M that will
+run in CP/M are available from
+the <a href="http://www.aztecmuseum.ca/">Aztec C Museum Website</a> for
+Fair Use and for free by hobbyists and enthusiasts.
+These are no longer commercially available and are offered with the
+permission of the Copyright holder.
+<br>
+<br>
+Using <b>MS-DOS Emulators</b> like <a href="http://www.dosbox.com/">DOSBox</a>
+and <a href="http://dosemu.sourceforge.net/">DOSEMU</a>,
+Aztec C CP/M 80 and CP/M 86 cross-compilers that run in Windows and MS-DOS
+will run in Ubuntu and other Linux distros and on other platforms that
+support MS-DOS emulators.
+<br>
+<br>
+<a href="http://www.z80.eu/c-compiler.html"><b>Peter Dassow's C Compiler Site</b></a>
+<br>
+<br>
+What compiler should somebody use for programming CP/M applications? Peter's
+C Compiler site offers native mode CP/M 80 C Compilers that are hard to impossible
+to find anywhere else.
+<br>
+<br>
+<a href="http://primepuzzle.com/mouse/hints0.htm"><b>Lee Bradley's MaxZ80 Tutorial Project</b></a>
+<br>
+<br>
+<b>CP/M Emulators</b> like Simeon Cran's MyZ80 can be used under
+Windows to build programs using a native mode CP/M 80 compiler like the Aztec C
+native mode CP/M 80 compiler or other CP/M 80 compilers in general
+independently from a real CP/M machine. Cpmtools
+can be used to move programs between a MyZ80 disk image
+and the Windows or Linux (and other) filesystems where cpmtools runs.
+<br>
+<br>
+In the spirit of providing a <b>rewarding educational experience</b> for
+Windows users interested in developing their personal understanding of the
+history of CP/M, Lee Bradley has rebundled the full version of MyZ80
+including many programming tools such as Turbo Pascal and Leor Zolman's
+BDSC C compiler. Lee calls his tutorial project MaxZ80. The link above is for
+his tutorial and the one below is for the MaxZ80 download. When you run Lee's
+tutorial the web page is fussy about how it should be used. </b>Click on a
+topic in the list, then press the TAB key followed by the ENTER key to select
+a topic</b>.
+<br>
+<br>
+<a href="http://primepuzzle.com/mouse/maxz80.zip">http://primepuzzle.com/mouse/maxz80.zip</a>
+<br>
+<br>
+<a href="http://www.bdsoft.com/resources/bdsc.html"><b>Leor Zolman's BDS C Compiler</b></a>
+<br>
+</UL>
+<a href="./index.htm#topmenu">&lt;&lt; Back to Top</a>
+<br>
+<br>
+<b>Other CP/M Resources</b>
+<br>
+<br>
+CP/M resources on the Internet that can be used in conjunction with
+cpmtools are <b>too numerous to mention</b>. Some are listed below:
 <br>
 <UL>
+<A HREF="http://www.moria.de/~michael/cpmtools/"><b>Michael Haardt's cpmtools Main Page</b></a><br>
+<A HREF="http://tech.groups.yahoo.com/group/applecpm/">Willi Kusche's Apple CPM Group on Yahoo</a><br>
 <a href="http://www.apple2info.net/hardware/softcard/softcard.htm">The Microsoft Softcard</a><br>
 <a href="ftp://ftp.apple.asimov.net/pub/apple_II/images/cpm/">The Apple II CP/M Archives at ftp.apple.asimov.net</a><br>
-<a href="http://www.seasip.info/Cpm/index.html">John Elliot's CP/M Pages Site</a><br>
-<a href="http://www.cpm.z80.de/index.html">The Unofficial CP/M Website aka Gaby Chaudry's Site</a><br>
+<a href="http://groups.google.com/group/comp.sys.apple2/topics">The comp.sys.apple2 Newsgroup on google</b><br>
+<a href="http://groups.google.com/group/comp.os.cpm/topics">The comp.os.cpm Newsgroup on google</b><br>
+<a href="http://www.z80.eu/">Peter Dassow's Website at z80.eu</a><br>
+<a href="http://www.seasip.info/Cpm/index.html"><b>John Elliot's CP/M Pages</b></a><br>
+<a href="http://www.cpm.z80.de/index.html">Gaby's Unofficial CP/M Website</a><br>
+<a href="http://www.gaby.de/ehome.htm">Gaby Chaudry's Home Page</a><br>
+<a href="http://ftp.gaby.de/">Gaby's FTP Server</b><br>
 <a href="http://www.cpm80.com/">Harte Technologies CP/M-80 Information and Download Page</a><br>
 <a href="http://www.retroarchive.org/cpm/">Commercial CP/M Software Archive</a><br>
 </UL>
@@ -240,8 +293,8 @@ cpmtools. Some of these include:
 <a name="disclaimer"><b>Caveat Emptor</b></a>
 <br>
 <br>
-This document was written and formatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>. Its
-contents are either part of cpmtools or provide additional information about using cmptools. It is targetted primarily
+The contents of this document
+are either part of cpmtools or provide additional information about using cpmtools. It is targetted primarily
 at Windows users but most of it applies to all users of cpmtools.
 <br>
 <br>

Tools/cpmtools/docs/mkfs.cpm.htm

@@ -1,215 +1,214 @@
-<HTML><HEAD><TITLE>MKFS.CPM - make a CP/M file system</TITLE>
-</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
-<FONT FACE="Arial" SIZE=2>
-<H2><A NAME="lbAA">MKFS.CPM</A></H2>
-Section: User commands (1)<BR>
-Updated: June 16, 2008<BR><BR>
-
-<A HREF="#index">Index&nbsp;&nbsp;</A>
-<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
-<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
-
-<A NAME="lbAB">&nbsp;</A>
-<B>NAME mkfs.cpm - make a CP/M file system.</B><BR><BR>
-
-<A NAME="lbAC">&nbsp;</A>
-<B>SYNOPSIS</B><BR><BR>
-
-<B>mkfs.cpm</B>
-
-[<B>-f</B>
-
-<I>format</I>]
-
-[<B>-b</B>
-
-<I>boot</I>]
-
-[<B>-L</B>
-
-<I>label</I>]
-
-<I>image</I>
-
-<BR>
-<BR>
-
-<A NAME="lbAD">&nbsp;</A>
-<B>DESCRIPTION</B><BR><BR>
-
-<B>Mkfs.cpm makes a CP/M file system on an image file or device.</B>
-<BR>
-<BR>
-
-<A NAME="lbAE">&nbsp;</A>
-<B>OPTIONS</B><BR><BR>
-
-<DL COMPACT><DT><DD>
-
-<DT><B>-f</B><BR><DD>
-
-Use the given CP/M disk <I>format</I> instead of the default format.
-<BR><BR>
-For Apple II CP/M 80
-users the disk image formats apple-do and apple-po are available. These
-are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
-using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
-<BR><BR>
-
-<DT><B>-b</B> <I>bootblock</I><DD>
-
-<BR>
-Write the contents of the file <I>bootblock</I> to the system tracks
-instead of filling them with 0xe5.  This option can be used up to four
-times.  The file contents (typically boot block, CCP, BDOS and BIOS)
-are written to sequential sectors, padding with 0xe5 if needed.
-<BR>
-<BR>
-
-<DT><B>-L</B> <I>label</I><DD>
-<BR>
-Label the file system.  This is only supported by CP/M Plus.
-<BR><BR>
-</DL>
-
-<A NAME="lbAF">&nbsp;</A>
-<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAG">&nbsp;</A>
-<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
-
-This will likely only be of interest to programmers. In a Win32 system
-the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
-return value when run from another Win32 console program written in a
-language like C.
-<BR><BR>
-
-<A NAME="lbAH">&nbsp;</A>
-<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
-
-The diskdefs file is a plain ascii text file that serves as a database of
-disk and disk image format definitions. It can be reviewed for available
-CP/M formats and their names. For Apple II CP/M 80 users the disk
-image formats apple-do and apple-po are available.
-<BR><BR>
-<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
-<BR>
-<BR>
-- Can vary depending on the preferences of the person who builds the
-cpmtools binaries (executables) from the source code.
-<BR><BR>
-- The location is also installation dependent and the diskdefs file
-may also have been renamed.
-<BR>
-<BR>
-<b>If it's not found the current (work) directory is then searched for a
-file called diskdefs.</b>
-<BR>
-<BR>
-<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
-like <b>/usr/local/share/</b> is a possible place that cpmtools will first
-look for diskdefs.
-<BR>
-<BR>
-<b>In a Win32 system</b> sometimes unix-like shells like cygwin
-are used to run cpmtools instead of Windows cmd. For those installations
-unix-like conventions probably apply.
-<br>
-<br>
-For cpmtools installations targetted at the average
-Windows user who does not have a unix-like shell and uses the Windows cmd
-prompt to run cpmtools there is no standard shared place that cpmtools will first
-look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
-even <b>c:\cpmtools\diskdefs</b> are possible.
-<BR>
-<BR>
-
-
-<A NAME="lbAI">&nbsp;</A>
-<B>AUTHORS</B>
-<BR>
-<BR>
-This program is copyright 1997-2008 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
-The Windows port is
-copyright 2000, 2001 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
-<BR><BR>
-
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<BR><BR>
-
-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
-<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
-<BR><BR>
-
-You should have received a copy of the GNU General Public License along
-with this program.  If not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-<BR><BR>
-
-<A NAME="lbAJ">&nbsp;</A>
-<B>SEE ALSO</B><BR><BR>
-
-<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
-
-<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
-
-<BR><BR>
-
-<HR>
-
-<A NAME="index">&nbsp;</A><B>Index</B>
-<BR>
-<BR>
-
-<DL>
-<DT><A HREF="#lbAA">NAME mkfs.cpm - make a CP/M file system.</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
-<DT><A HREF="#lbAG">ERRORS</A><DD>
-<DT><A HREF="#lbAH">FILES</A><DD>
-</DL>
-<DT><A HREF="#lbAI">AUTHORS</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-</DL>
-
-<HR>
-<b>Gradus ad Parnassum</b>
-<br>
-<br>
-An ugly version of this document was initially created by man2html on November 14, 2008
-using the cpmtools version 2.8 manual pages
-then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
-<br>
-<br>
-<a name="disclaimer"><b>Caveat Emptor</b></a>
-<br>
-<br>
-The contents of this document
-are either part of cpmtools or provide additional information about using cmptools.
-You can redistribute it under the terms of
-the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
-published by the Free Software Foundation; either version 3 of the License, or (at your
-option) any later version.
-<br>
-<br>
-Bill Buckels has no warranty
-obligations or liability resulting from this document's use in any way whatsoever. If you don't
-agree then don't read it.
-</FONT></BODY>
-</HTML>
+<HTML><HEAD><TITLE>MKFS.CPM - make a CP/M file system</TITLE>
+</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
+<FONT FACE="Arial" SIZE=2>
+<H2><A NAME="lbAA">MKFS.CPM</A></H2>
+Section: User commands (1)<BR>
+Updated: December 1, 2013<BR><BR>
+
+<A HREF="#index">Index&nbsp;&nbsp;</A>
+<A HREF=" ./index.htm">Return to Main Contents&nbsp;&nbsp;</A>
+<a href="#disclaimer">Disclaimer&nbsp;&nbsp;</a><br><BR><HR>
+
+<A NAME="lbAB">&nbsp;</A>
+<B>NAME mkfs.cpm - make a CP/M file system.</B><BR><BR>
+
+<A NAME="lbAC">&nbsp;</A>
+<B>SYNOPSIS</B><BR><BR>
+
+<B>mkfs.cpm</B>
+
+[<B>-f</B>
+
+<I>format</I>]
+
+[<B>-b</B>
+
+<I>boot</I>]
+
+[<B>-L</B>
+
+<I>label</I>]
+
+[<B>-t</B>]
+
+<I>image</I>
+
+<BR>
+<BR>
+
+<A NAME="lbAD">&nbsp;</A>
+<B>DESCRIPTION</B><BR><BR>
+
+<B>Mkfs.cpm makes a CP/M file system on an image file or device.</B>
+<BR>
+<BR>
+
+<A NAME="lbAE">&nbsp;</A>
+<B>OPTIONS</B><BR><BR>
+
+<DL COMPACT><DT><DD>
+
+<DT><B>-f</B><BR><DD>
+
+Use the given CP/M disk <I>format</I> instead of the default format.
+<BR><BR>
+For Apple II CP/M 80
+users the disk image formats apple-do and apple-po are available. These
+are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
+using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
+<BR><BR>
+
+<DT><B>-b</B> <I>bootblock</I><DD>
+
+<BR>
+Write the contents of the file <I>bootblock</I> to the system tracks
+instead of filling them with 0xe5.  This option can be used up to four
+times.  The file contents (typically boot block, CCP, BDOS and BIOS)
+are written to sequential sectors, padding with 0xe5 if needed.
+<BR>
+<BR>
+
+<DT><B>-L</B> <I>label</I><DD>
+<BR>
+Label the file system.  This is only supported by CP/M Plus.
+<BR><BR>
+
+<DT><B>-t</B><DD>
+Create time stamps.
+<BR><BR>
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAG">&nbsp;</A>
+<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
+
+This will likely only be of interest to programmers. In a Win32 system
+the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
+return value when run from another Win32 console program written in a
+language like C.
+<BR><BR>
+
+<A NAME="lbAH">&nbsp;</A>
+<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
+
+The diskdefs file is a plain ascii text file (in "unix" format, not Windows format)
+that serves as a database of
+disk and disk image format definitions. It can be reviewed for available CP/M
+formats and their names. For Apple II CP/M 80 users the disk
+image formats apple-do and apple-po are available.
+<BR>
+To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
+included in the Windows distro of the cpmtools binaries. These are included so you
+can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
+does not edit "unix" text.
+<BR><BR>
+<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
+<BR>
+<BR>
+Can vary depending on the preferences of the person who builds the
+cpmtools binaries (executables) from the source code.
+<BR>
+<BR>
+<b>If it's not found the current (work) directory is then searched for a
+file called diskdefs.</b>
+<br>
+<br>
+The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
+<BR>
+<BR>
+<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
+like <b>/usr/local/share/</b> is a possible place that cpmtools will first
+look for diskdefs.
+<BR>
+<BR>
+<b>In a Win32 system</b> sometimes unix-like shells like cygwin
+are used to build and run cpmtools instead of Windows cmd. For those installations
+unix-like conventions may apply.
+<BR>
+<BR>
+
+
+<A NAME="lbAI">&nbsp;</A>
+<B>AUTHORS</B>
+<BR>
+<BR>
+This program is copyright 1997-2013 Michael Haardt &lt;<A HREF="mailto:michael@moria.de">michael@moria.de</A>&gt;.
+The Windows port is
+copyright 2000, 2001, 2011 John Elliott &lt;<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>&gt;.
+<BR><BR>
+
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<BR><BR>
+
+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
+<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
+<BR><BR>
+
+You should have received a copy of the GNU General Public License along
+with this program.  If not, write to the Free Software Foundation, Inc.,
+59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+<BR><BR>
+
+<A NAME="lbAJ">&nbsp;</A>
+<B>SEE ALSO</B><BR><BR>
+
+<I><A HREF="./fsck.cpm.htm">fsck.cpm</A></I>(1),
+
+<I><A HREF="./cpmls.htm">cpmls</A></I>(1),
+
+<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
+
+<BR><BR>
+
+<HR>
+
+<A NAME="index">&nbsp;</A><B>Index</B>
+<BR>
+<BR>
+
+<DL>
+<DT><A HREF="#lbAA">NAME mkfs.cpm - make a CP/M file system.</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
+<DT><A HREF="#lbAG">ERRORS</A><DD>
+<DT><A HREF="#lbAH">FILES</A><DD>
+</DL>
+<DT><A HREF="#lbAI">AUTHORS</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+</DL>
+
+<HR>
+<a name="disclaimer"><b>Caveat Emptor</b></a>
+<br>
+<br>
+The contents of this document
+are either part of cpmtools or provide additional information about using cmptools.
+You can redistribute it under the terms of
+the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
+published by the Free Software Foundation; either version 3 of the License, or (at your
+option) any later version.
+<br>
+<br>
+Bill Buckels has no warranty
+obligations or liability resulting from this document's use in any way whatsoever. If you don't
+agree then don't read it.
+</FONT></BODY>
+</HTML>

Tools/hex2bin/COPYING

@@ -0,0 +1,676 @@
+
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ 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.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    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 <http://www.gnu.org/licenses/>.
+
+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:
+
+    <program>  Copyright (C) <year>  <name of author>
+    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
+<http://www.gnu.org/licenses/>.
+
+  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
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
+

Tools/hex2bin/HEX2BIN.C

@@ -0,0 +1,633 @@
+/* hex2bin.c -- yet another reader and writer of Intel hex files 
+   Copyright (C) 2011 John R Coffman <johninsd@gmail.com>.
+***********************************************************************
+   When invoked as 'hex2bin' read a sequence of Intel hex files
+   and create an overlaid binary file.
+
+   When invoked as 'bin2hex' read a binary file and create an
+   Intel hex file.
+
+   All command line numeric constants may be specified in any
+   radix.
+***********************************************************************
+
+    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
+    in the file COPYING in the distribution directory along with this
+    program.  If not, see <http://www.gnu.org/licenses/>.
+
+**********************************************************************/
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+#include "mytypes.h"
+
+#define true   1
+#define false  0
+#define SEG_MASK 0x00FFFFu
+#define LBA_MASK 0x00FF0000ul
+#define MAX_MASK (LBA_MASK|SEG_MASK)
+#define ONE_MEG 0x100000ul
+
+dword upper_lba = 0;     /* upper address */
+dword address_mask = SEG_MASK;  /* address mask  */
+byte pad = 0xFF;
+byte *buffer;
+dword rom_size = 0;
+dword overwrite;     /* count of possible overwrites */
+byte h2b, verbose, segmented;
+char *outfilename = NULL;
+char *binfilename = NULL;
+dword source_address, source_limit;
+dword dest_address, dest_limit;
+FILE *infile;
+FILE *outfile;
+byte checksum;
+char line[1024];
+char *lp;
+long int lineno;
+
+
+
+dword convert_constant(char *str)
+{
+   char *final;
+   dword value = strtoul(str, &final, 0);
+
+   if (*final == 'k' || *final == 'K') value *= 1024ul;
+   else if (*final == 'M' || *final == 'm') value *= ONE_MEG;
+
+   return value;
+}
+
+void error(byte level, char *msg)
+{
+   printf("%s(%d): %s\n",
+         level>1 ? "Error" : "Warning", (int)level, msg);
+   if (level>1) exit(level);
+   else if (level==0) printf("line %ld  %s", lineno, line);
+}
+
+
+int getnibble(void)
+{
+   char ch;
+
+	ch = -1;
+   if (lp) {
+      ch = *lp++;
+      if (ch>='0' && ch<='9') ch -= '0';
+      else if (ch>='A' && ch<='F') ch -= 'A'-10;
+      else if (ch>='a' && ch<='f') ch -= 'a'-10;
+      else {
+         error(0,"Illegal hex digit");
+         ch = -1;
+      }
+   }
+   else error(0,"Line is too short");
+   return (int)ch;
+}
+
+int getbyte(void)
+{
+   int b = getnibble();
+   b <<= 4;
+   b += getnibble();
+   checksum += b;
+   return b;
+}
+
+int getword(void)
+{
+   int w = getbyte();
+   w <<= 8;
+   w += getbyte();
+   return w;
+}
+
+dword getdword(void)
+{
+   dword d = getword();
+   d <<= 16;
+   d += getword();
+   return d;
+}
+
+/* added for SREC files */
+dword get6word(void)
+{
+   dword d = getword();
+   d <<= 8;
+   d += getbyte();
+   return d;
+}
+
+
+void putbyte(dword address, byte data)
+{
+   if (address < source_address  ||  address > source_limit) return;
+   address -= source_address;
+   address += dest_address;
+   if (address > dest_limit) return;
+   if (address >= rom_size) {
+      printf("Line %ld ", lineno); error(2,"Data beyond end of ROM");
+   }
+   if (buffer[address] != pad) {
+      overwrite++;
+      if (verbose || overwrite<=100) printf("Warning(1): Overwrite at ROM address 0x%lX\n", address);
+   }
+   buffer[address] = data;
+}
+
+
+void usage(void)
+{
+   printf("hex2bin.c (bin2hex) -- " __TIMESTAMP__ ".\n"
+          "Copyright (c) 2011 John R Coffman. All rights reserved.\n"
+          "Distributed under the GNU General Public License, a copy of which\n"
+          "is contained in the file COPYING in the distribution directory.\n\n");
+   if (h2b) printf(
+   "Usage:\n"
+   "    hex2bin <options> [<flags> <filename>[/M]]+\n\n"
+   "    Options:\n"
+   "        -o <output filename>\n"
+   "        -p <pad byte>\n"
+   "        -R <ROM size> default 64K\n"
+   "        -v [<verbosity level>]\n"
+   "    Flags:\n"
+   "        -d <destination address in BIN file>\n"
+   "        -D <destination limit in BIN file>\n"
+   "        -s <source address in HEX file>\n"
+   "        -S <source limit in HEX file>\n"
+	"    Suffix:\n"
+	"        /M marks a Motorola S-record input file\n"
+   );
+   else printf(
+   "Usage:\n"
+   "    bin2hex <options> [<flags> <filename>]+\n\n"
+   "    Options:\n"
+   "        -g use Intel seGmented addressing\n"
+   "        -o <output filename>\n"
+   "        -p <pad byte>\n"
+   "        -R <ROM size> default 1024K\n"
+   "        -v [<verbosity level>]\n"
+   "    Flags:\n"
+   "        -d <destination address in HEX file>\n"
+   "        -D <destination limit in HEX file>\n"
+   "        -s <source address in BIN file>\n"
+   "        -S <source limit in BIN file>\n"
+   );
+}
+
+
+void hout_byte(byte data)
+{
+   checksum -= data;
+   fprintf(outfile, "%02X", (int)data);
+}
+void hout_word(word data)
+{
+   hout_byte(data>>8);
+   hout_byte(data);
+}
+void begin_record(byte length)
+{
+   checksum = 0;
+   fputc(':', outfile);
+   hout_byte(length);
+}
+void end_record(void)
+{
+   hout_byte(checksum);
+   fputc('\n', outfile);
+}
+
+void write_lba(dword address)
+{
+   if (verbose==5) printf("Address: %06lX\n", address);
+
+   if ((address & LBA_MASK) != upper_lba) {
+      upper_lba = address & LBA_MASK;
+      begin_record(2);
+      hout_word(0);
+      if (rom_size > ONE_MEG || !segmented) {
+         hout_byte(4);     /* linear address */
+         hout_word(upper_lba>>16);
+      }
+      else {   /* handle ROMs 1meg and smaller */
+         hout_byte(2);     /* segment address */
+         hout_word(upper_lba>>4);
+      }
+      end_record();
+   }
+}
+
+void write_data(word nbytes, byte *buf, dword address)
+{
+   /* compress from the high end */
+   while (nbytes && buf[nbytes-1]==pad) --nbytes;
+   /* compress from the low end */
+   while (nbytes && *buf==pad) {
+      ++buf;
+      ++address;
+      --nbytes;
+   }
+   if (nbytes) {
+      write_lba(address);
+      begin_record(nbytes);
+      hout_word(address & 0xFFFFu);
+      hout_byte(0);     /* data record */
+      while(nbytes--) hout_byte(*buf++);
+      end_record();
+   }
+}
+
+#define min(a,b) ((a)<(b)?(a):(b))
+#define NREC 16
+
+void write_hex_file(FILE *outfile)
+{
+   dword nbytes;
+   dword vaddr;
+   dword n;
+   byte *buf;
+
+   buf = buffer;
+   vaddr = 0;
+   nbytes = rom_size;
+   n = min(nbytes, NREC);
+   do {
+      write_data(n, buf, vaddr);
+      buf += n;
+      vaddr += n;
+      nbytes -= n;
+      n = min(nbytes, NREC);
+   } while (n);
+/* write the end-of-file record */
+   fprintf(outfile,":00000001FF\n");
+}
+
+
+void scan_bin_file(char *filename)
+{
+   dword length;
+   dword nbytes;
+   int data;
+   dword inaddr;
+
+   infile = fopen(filename, "rb");
+   if (!infile) {
+      strcpy(line,"Cannot find file: ");
+      error(5, strcat(line, filename));
+   }
+/***   length = filelength(fileno(infile));    ***/
+   fseek(infile, 0L, SEEK_END);
+   length = ftell(infile);
+/***/
+   nbytes = 0;
+   inaddr = dest_address;
+   if (source_address < length) {
+      fseek(infile, source_address, SEEK_SET);
+      while (inaddr<rom_size && inaddr<=dest_limit) {
+         data = fgetc(infile);
+         if (data == EOF) break;
+         buffer[inaddr++] = data;
+      }
+   }
+
+   fclose(infile);
+}
+
+void scan_srec_file(char *filename)
+{
+   byte ldata;
+   dword laddr;
+   byte rectype;
+   dword index;
+   byte data;
+   byte EndOfFile = 0;
+
+   infile = fopen(filename, "rt");
+   if (!infile) {
+      strcpy(line,"Cannot find file: ");
+      error(5, strcat(line, filename));
+   }
+   lineno = 0;
+	laddr = 0;
+   do {
+      lineno++;
+      lp = fgets(line, nelem(line)-1, infile);
+      if (lp == NULL) break;
+      if (*lp++ != 'S') {
+         printf("Illegal: %s",--lp);
+         continue;
+      }
+      if (verbose>=3) printf("%s", lp-1);
+      checksum = 0;
+      rectype = getnibble();
+      ldata = getbyte();
+		switch(rectype) {		/* get variable address field */
+			case 0:
+			case 1:
+			case 5:
+			case 9:
+				laddr = getword();
+				ldata -= 2;
+				break;
+			case 2:
+			case 8:
+				laddr = get6word();
+				ldata -= 3;
+				break;
+			case 3:
+			case 7:
+				laddr = getdword();
+				ldata -= 4;
+				break;
+			default:
+            error(0,"Unknown record type:");
+		}
+		if (rectype>=1 && rectype<=3) {
+         index = 0;
+         while (--ldata) {
+            data = getbyte();
+					/* no address mask used */
+            putbyte(laddr + index, data);
+            index++;
+         }
+		}
+		else if (rectype==0) {
+			printf("Comment: ");
+			while (--ldata) {
+				printf("%c", (char)getbyte());
+			}
+			printf("\n");
+		}
+	/* else  records 5,7,8,9 are ignored */
+
+      data = getbyte();           /* get final checksum */
+      if (checksum != 0xFF) {
+         error(0,"Checksum failure");
+      }
+   } while (lp && !EndOfFile);
+   fclose(infile);
+}
+
+void scan_Intel_file(char *filename)
+{
+   byte ldata;
+   dword laddr;
+   byte rectype;
+   dword value;
+   dword index;
+   byte data;
+   byte EndOfFile = 0;
+
+   infile = fopen(filename, "rt");
+   if (!infile) {
+      strcpy(line,"Cannot find file: ");
+      error(5, strcat(line, filename));
+   }
+   upper_lba = 0;
+   lineno = 0;
+   do {
+      lineno++;
+      lp = fgets(line, nelem(line)-1, infile);
+      if (lp == NULL) break;
+      if (*lp++ != ':') {
+         printf("Comment: %s",--lp);
+         continue;
+      }
+      if (verbose>=3) printf("%s", lp-1);
+      checksum = 0;
+      ldata = getbyte();
+      laddr = getword();
+      rectype = getbyte();
+      switch (rectype) {
+         case 0:                 /* data record */
+            index = 0;
+            while (ldata--) {
+               data = getbyte();
+               putbyte(upper_lba + ((laddr + index)&address_mask), data);
+               index++;
+            }
+            break;
+         case 1:                 /* end of file record */
+            EndOfFile = 1;
+            break;
+         case 2:                 /* segment address */
+            address_mask = SEG_MASK;
+            value = getword();
+            upper_lba = value<<4;   /* start of segment */
+            ldata -= 2;
+            break;
+         case 4:                 /* linear upper address */
+            address_mask = MAX_MASK;
+            value = getword();
+            upper_lba = value<<16;  /* full 32-bit address range */
+            ldata -= 2;
+            break;
+         case 3:                 /* start CS:IP */
+         case 5:                 /* linear start address */
+            value = getdword();
+            ldata -= 4;
+				break;
+         default:
+            error(0,"Unknown record type:");
+      }
+      getbyte();           /* get final checksum */
+      if ( (checksum & 0xFF) ) {
+         error(0,"Checksum failure");
+      }
+   } while (lp && !EndOfFile);
+   fclose(infile);
+}
+
+
+void scan_hex_file(char *filename)
+{
+	int i = strlen(filename);
+
+	if (i>3  &&  filename[i-2]=='/'
+			&& (filename[i-1]=='M') )   {
+		filename[i-2] = 0;		/* remove suffix */
+		scan_srec_file(filename);
+	}
+	else scan_Intel_file(filename);
+}
+
+
+void global_options(int argc, char *argv[])
+{
+   int iarg;
+   char *cp;
+   char *tp;
+   char ch;
+
+   h2b = false;
+   rom_size = ONE_MEG;     /* bin2hex default value */
+/* decide which conversion to do */
+   if (strstr(argv[0],"hex2bin")
+#ifdef   MSDOS
+         || strstr(argv[0],"HEX2BIN")
+#endif
+      ) {
+         h2b = true;
+         rom_size = 64 * 1024ul; /* default value */
+   }  /* assume 'bin2hex' otherwise */
+      
+   if (argc<2) { usage(); exit(0); }
+
+/* scan the global command line options */
+   for (iarg = 0; iarg<argc; iarg++) {
+      cp = argv[iarg];
+      if (*cp == '-'
+#ifdef   MSDOS
+                  || *cp == '/'
+#endif
+                                 ) {
+         ch = cp[1];
+         tp = cp + 2;
+         switch (ch) {
+            case 'g':
+               segmented = 1;    /* enable segmented addressing */
+               break;            /* for ROMs <= 1M in size      */
+            case 'h':
+               usage();
+               exit(0);
+            case 'o':   /* outfile name specification */
+               if (!*tp) tp = argv[++iarg];
+               outfilename = strdup(tp);
+               *cp = *tp = 0;
+               break;
+            case 'p':   /* specify the pad byte */
+               if (!*tp) tp = argv[++iarg];
+               pad = (byte)convert_constant(tp);
+               *cp = *tp = 0;
+               break;
+            case 'R':   /* ROM file size specification */
+               if (!*tp) tp = argv[++iarg];
+               rom_size = convert_constant(tp);
+               if (rom_size > MAX_MASK+1) error(5, "ROM size too big");
+               if (rom_size < 256) error(5, "ROM size too small");
+               *cp = *tp = 0;
+               break;
+            case 'v':   /* print verbose statistics */
+               verbose++;
+               if (!*tp) tp = argv[++iarg];
+               if (*tp>='1' && *tp<='5' && tp[1]==0) verbose += (*tp - '1');
+               else tp = cp;
+               *cp = *tp = 0;
+               break;
+            case 'Y': {
+                  int i;
+                  for (i=0; i<argc; i++)
+                     printf(" %s", argv[i]);
+                  printf("\n");
+                  exit(0);
+               }
+            default:
+               break;
+         }
+      }  // if '-'
+   }  // for (iarg ...
+}
+
+
+void process_cmd_input(int argc, char *argv[])
+{
+   int iarg;
+   char *cp;
+   char *tp;
+
+   source_address = dest_address = 0;
+   source_limit = dest_limit = MAX_MASK;
+
+   for (iarg=1; iarg<argc; iarg++) {
+      cp = argv[iarg];
+      if (*cp == '-'
+#ifdef   MSDOS
+                  || *cp == '/'
+#endif
+                                 ) {
+         ++cp;
+         tp = cp + 1;
+         switch (*cp) {
+            case 's':            /* source */
+               if (!*tp) tp = argv[++iarg];
+               source_address = convert_constant(tp);
+               break;
+            case 'S':            /* source limit */
+               if (!*tp) tp = argv[++iarg];
+               source_limit = convert_constant(tp);
+               break;
+            case 'd':            /* destination */
+               if (!*tp) tp = argv[++iarg];
+               dest_address = convert_constant(tp);
+               break;
+            case 'D':            /* destination limit */
+               if (!*tp) tp = argv[++iarg];
+               dest_limit = convert_constant(tp) - 1;
+               break;
+         } // switch
+      }  // if (*cp == '-' ...
+      else if (*cp) {            /* this must be a filename */
+         if (h2b) scan_hex_file(cp);
+         else scan_bin_file(cp);
+
+      /* reset the local relocation options */
+         source_address = 0;
+         dest_address = 0;
+         source_limit = MAX_MASK;
+         dest_limit = MAX_MASK;
+      }
+   } // for (iarg
+}
+
+
+
+int main(int argc, char *argv[])
+{
+   dword index;
+   byte *ptr;
+
+   verbose = 0;
+   global_options(argc, argv);
+   
+   buffer = malloc(rom_size);
+   if (!buffer) error(5,"Cannot allocate ROM buffer");
+   for (ptr=buffer, index=rom_size; index; index--) *ptr++ = pad;
+
+   process_cmd_input(argc, argv);
+
+   if (!outfilename) {
+      if (h2b) {
+         outfilename = "out.bin";
+      }
+      else {
+         outfilename = "out.hex";
+      }
+      error(1,"No output file specified");
+      printf("Using file named '%s' for output\n", outfilename);
+   }
+   outfile = fopen(outfilename, h2b ? "wb" : "wt");
+   if (!outfile) error(5,"Cannot create output file");
+
+   if (h2b) while (rom_size--) fputc(*buffer++, outfile);
+   else write_hex_file(outfile);
+
+   fclose(outfile);
+
+   return EXIT_SUCCESS;
+}
+
+

Tools/hex2bin/HEX2BIN.DOC

@@ -0,0 +1,113 @@
+Usage:
+    hex2bin <options> [<flags> <filename.hex> | <filename.s19/M>]+ 
+    bin2hex <options> <flags> <filename.bin>
+
+    Options:
+        -g  --  Use Intel seGmented addressing in hex files for
+                ROMs between 64k and 1M in size.  Normally, linear
+                addressing is used for ROMs bigger than 64k.  For
+                ROMs larger than 1M, this switch has no effect,
+                since only linear addressing is possible.
+
+        -o <output filename> -- default is 'out.bin' or 'out.hex'
+                No suffix is added to the filename, so the full
+                file name must be specified.
+
+        -p <pad byte> -- default is 0xFF, which is the erased
+                value for most ROM's.  Pad bytes are not explicitly
+                written out when 'bin2hex' is used.  This reduces
+                the size of sparse ROM images.
+
+        -R <ROM size> -- may be any value.  Normally this will be 
+                specified as '128k' or 0x10000.  The suffixes 'k'
+                and 'M' are recognized.  The default value is 64k
+                for 'hex2bin' and 1M for 'bin2hex'.
+
+        -v [<verbosity level>] -- used primarily for debugging.  A
+                verbosity level of 3 will print each line as it is
+                processed.
+
+    Options are global, and may be specified anywhere on the command
+    line.  Only 'flags', below, are position sensitive.  Flags must
+    be specified immediately before the file name they are to affect.
+    They do not affect more that a single file.  They reset to their
+    default values before the next input file, scanning left to
+    right, is processed.
+
+    Flags:
+        Flag values apply only to the following file, and are reset
+        to the default values before the next file is processed.  The
+        source and destination flags allow code to be relocated
+        within the ROM so that code may be loaded at a different
+        location than where it will ultimately be run.
+
+        -d <destination address in output file> -- default is 0.
+                data will only be loaded between the limits of
+                the -d <dest> address and the -D <limit> address 
+                minus 1.
+                
+        -D <destination limit in output file> -- default is 16M.  No data
+                will be loaded at or above this address.
+
+        -s <source address in input file> -- default is 0.  Hex input
+                is only processed if it falls at addresses in the
+                .hex input file between the -s <srs> address and the
+                -S <limit> address minus 1.  Likewise, Bin input
+                is only processed if it falls between similar limits
+                in the input ROM image.
+
+        -S <source limit in hex file> -- default is 16M.  No input
+                data at or above this address will be processed.
+
+    Suffix:
+    	For HEX to BIN conversions, a suffix may be appended to an
+	input filename to indicate that it is in Motorola S-record
+	format instead of Intel hex format.
+
+	<filename.ext>/M -- there may be no space between the file-
+		name and the /M suffix.  The foregoing file is a
+		Motorola S-record (S19) file, not an Intel hex file.
+
+    Numeric values on the command line may be specified in any C-like
+    syntax:  0x0000 is hexadecimal, 1234 is decimal, and 0177 is
+    octal.  In addition the suffixes 'k' for kilo- and 'M' for mega-
+    cause the preceding values to be multiplied by 1024 or 1048576,
+    respectively.
+
+    Examples:
+        hex2bin -p 0xFF -R32k cpm22.hex -o cpmtest.bin
+        hex2bin -o cpmtest.bin  cpm22.hex -R 0x8000 -p255
+
+        The preceding two lines have identical effects in all
+        respects.
+
+        hex2bin -R 1M  -s 0xd000 -d 0x0800 -D0x2800 image.hex \
+          pagezero.hex -oROMIMAGE.bin
+
+        The above line loads the 'pagezero.hex' file at the exact
+        addresses specified in the file; however, the 'image.hex' file
+        is assembled at 0xD000, must run at 0xD000, but is loaded
+        between 0x800 <= addr < 0x2800.  It is presumed that the 
+        code will be relocated to the correct address before it is 
+        executed.
+
+	hex2bin -R16K tutor.S68/M -o tutor.bin
+
+	The above line converts the Mororola SREC file 'tutor.S68'
+	to a flat 16K binary file named 'tutor.bin'.
+
+        bin2hex -R128k romimage.bin -o image.hex
+
+        Simple conversion from a BIN file to a HEX file.  The ROM
+        data is limited to 128k.
+
+        bin2hex -s 0x1000 -S 0x2000 -d 0x21000 romimage.bin \
+          -o Relocated.hex
+
+        Extract from a ROM image file all of the data between 0x1000
+        and 0x1FFF, inclusive, and write to an Intel hex file for
+        re-loading two 64k segments higher in a future ROM.
+
+
+(end)
+

Tools/hex2bin/MAKEFILE

@@ -0,0 +1,37 @@
+# makefile for tools
+#
+#       Uses DJGCC for Windows -- GCC v. 4.4.4 compiles it
+#
+CC = gcc
+COPT = -O2 -Wall
+RM = del >nul
+CP = copy
+
+E = .exe
+O = .o
+
+.c$E:
+        $(CC) $(COPT) -o $*$E $*.c
+
+TOOLS = hex2bin$E bin2hex$E
+HFILES = mytypes.h
+
+
+all:    $(TOOLS)
+
+bin2hex$E:      hex2bin$E
+        $(CP) hex2bin$E bin2hex$E
+
+clean:
+        $(RM) *$O
+        $(RM) hex2bin$E
+        $(RM) bin2hex$E
+        $(RM) foo*.*
+
+spotless:   clean
+        $(RM) *.bin
+        $(RM) *.hex
+
+##Dependencies
+hex2bin$E:      hex2bin.c $(HFILES)
+

Tools/hex2bin/MYTYPES.H

@@ -0,0 +1,16 @@
+#ifndef __MYTYPES_H
+#define __MYTYPES_H 1
+
+typedef unsigned char  byte;
+typedef unsigned short word;
+typedef unsigned long dword;
+
+
+#ifdef __SDCC__
+#define outp(port,byte)  port  =  (byte)
+#define inp(port)	(port)
+#endif
+
+#define nelem(x) (sizeof(x)/sizeof(x[0]))
+
+#endif  /* __MYTYPES_H */

Tools/python/s100util.py

@@ -1,56 +0,0 @@
-#!/usr/bin/python
-import serial
-
-def memcmd():
-	ser.flushInput()
-	str = "A"
-	ser.write(str)
-	print ser.read(1024)
-
-def menucmd():
-	ser.flushInput()
-	str = "k"
-	ser.write(str)
-	print ser.read(1024)
-
-def portscmd():
-	ser.flushInput()
-	str = "R"
-	ser.write(str)
-	print ser.read(1024)
-
-def dispcmd(beg,end):
-	ser.flushInput()
-	str = "D" + repr(beg) + " " + repr(end) + " "
-	ser.write(str)
-#	print ser.read(4096)
-	print ser.read( ((end+1-beg)/16*80)+100 )
-
-def reset():
-	ser.flushInput()
-	str = "GF000 "
-	ser.write(str)
-	print ser.read(256)
-
-def getpage(startaddr):
-	ser.flushInput()
-	str = "D" + repr(startaddr) + " " + repr(startaddr+255) + " "
-	print str
-	ser.write(str)
-	print ser.read(4096)
-
-
-ser = serial.Serial('/dev/cu.PL2303-0000201D', 38400, timeout=2)
-#reset()
-#menucmd()
-#portscmd()
-#dispcmd(1000,1300)
-#getpage(256)
-#dispcmd(256,256+2)
-#reset()
-#getpage(0)
-d1 = 100
-d2 = d1 + 255
-dispcmd(d1,d2)
-
-

Tools/python/sendsave.py

@@ -1,104 +0,0 @@
-#!/usr/bin/python
-
-
-# Written by Douglas Goodall 17:25 Wed, Jan 30, 2013
-
-import sys
-import os
-import serial
-
-filename = "rem.com"
-
-print "*******************************************************************"
-print "sendsave.py 1/30/2013 dwg - deliver file to cp/m using save and ddt"
-print "*******************************************************************"
-# passing in a string  either "12" or "0x12"
-# return value is string of hex digits only (no 0x)
-def safebyte(parm):
-        xyz = parm
-        myord = ord(xyz)
-        hexdata = hex(myord)
-        newstr = hexdata
-        if (hexdata[0] == '0'):
-                if(hexdata[1] == 'x'):
-                        newstr = hexdata[2]
-                        if(len(hexdata)>3):
-                                newstr = newstr + hexdata[3]
-        return newstr
-
-# passing in a string either "1234" of  "0x1234"
-# return value is string of hex digits only (1234) (no 0x)
-def safeword(parm):
-	xyz = parm
-	myint = int(xyz)
-	hexdata = hex(myint)
-	newstr = hexdata
-	if (hexdata[0] == '0'):
-		if(hexdata[1] == 'x'):
-			newstr = hexdata[2] 
-			if(len(hexdata)>3):
-				newstr = newstr + hexdata[3]
-				if(len(hexdata)>4):
-					newstr = newstr + hexdata[4]
-					if(len(hexdata)>5):
-						newstr = newstr + hexdata[5]
-	return newstr
-
-statinfo = os.stat(filename)
-filelen =  statinfo.st_size
-
-beg = 0x100
-end = beg + filelen - 1
-
-print "Target file is " + filename + " length is 0x" + hex(filelen) + "\n"
-
-infile = open(filename,'rb');
-data = infile.read()
-infile.close()
-
-ser = serial.Serial('/dev/cu.PL2303-0000201D', 19200, timeout=1)
-
-# flush input queue
-ser.read()
-
-ser.write("\n")
-print ser.read(80)
-
-ser.write("save\n")
-print ser.read(80)
-
-ser.write("ddt\n")
-print ser.read(128)
-
-ser.write("s100\n")
-print ser.read(20)
-
-for x in range(1,filelen):
-	ser.write(safebyte(data[x-1]))
-	ser.write("\n")
-	print ser.read(32)
-	
-ser.write(".\n")
-print ser.read(200)
-
-ser.write("g0\n")
-print ser.read(160)
-
-ser.write(filename)
-ser.write("\n")
-print ser.read(128)
-
-ser.write("yes\n")
-print ser.read(128)
-
-ser.write(safeword(beg))
-ser.write("\n")
-print ser.read(128)
-
-ser.write(safeword(end))
-ser.write("\n")
-print ser.read(128)
-
-ser.write("\n")
-print ser.read(128)
-

Tools/rawwritewin/COPYING

@@ -1,340 +0,0 @@
-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-                       59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-			    Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.)  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
-this service 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 make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  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.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-		    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute 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 and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-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
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the 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 a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-			    NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, 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.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE 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.
-
-		     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
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
-
-    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 2 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, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) year name of author
-    Gnomovision 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, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
-
-This 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 Library General
-Public License instead of this License.

Tools/rawwritewin/changes.txt

@@ -1,18 +0,0 @@
-Version 0.6
-Remove load time requirement for wininet.dll.
-Add extra read to Win9X to settle floppy disk into the drive
-Add absolute path to dll load to prevent conflict under ME
-Packed the exe with UPX
-Created auto install script
-
-Version 0.5
-Command line parameters
-Better error messages
-Autoupdate
-Auto download missing dll
-
-Version 0.4
-Number of copies to write
-NT does not always show floppy drives
-Better error message when diskio.dll not found
-

Tools/rawwritewin/readme.txt

@@ -1,5 +0,0 @@
-RawWrite for Windows
-====================
-95, 98, ME, NT, 2K, XP
-
-Under 95, 98 & ME you need diskio.dll.  It must be in the same directory as rawwritewin.exe