Skip to content

Latest commit

 

History

History
48 lines (37 loc) · 2.4 KB

CONTRIBUTING.md

File metadata and controls

48 lines (37 loc) · 2.4 KB
Raw

How to contribute to Thor

Bug report?

  • Please check issues if the bug is reported
  • If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

New version

Here are the steps to updating to a new version:

  1. Create a fork at github
    • See this guide for setting up and using a fork
  2. Make whatever changes are necessary.

Steps 3 through 10 only apply if you intend to merge your changes immediately into the master repository for Thor. This can only happen if you have access to do so and you are sure that your changes do not need any further testing by others.

If you do not intend to merge into the master repository or are in any way unsure what this means, skip directly to step 11.

If updating Thor.App

  1. Edit Installed Files\Source\ThorVersion.h and change the version constants.
  2. Update the AvailableVersion property in _ThorUpdater\ThorVersionFile.txt. Be certain that the value be identical to the value of the ccThorInternalVERSION constant in ThorVersion.h.
  3. Update the version number and date at the top of README.md
  4. Describe the changes in Change Log.md.
  5. Run BuildThor.PRG in folder "Installed Files\Source" to re-create the APP. You will need to this in an environment where Thor is no longer running:
    • Cancel()
    • Close All
    • Clear All
    • Release All
  6. Run FoxBin2Prg to create the text files in folder Installed Files
    • DO foxbin2prg.prg WITH 'BIN2PRG','*.*'

If updating version info for VFPX Projects / CFU (most projects) or creating an updater for a new projects

This applies to all updaters except those few (15 or so) where the version information is read from a separate URL (.VersionFileURL) which is normally used only for projects with continuing updates.

  1. Add / Modify the prg file in Updaters\Updates

Finally

  1. In folder ThorUpdater, right-click CreateThorUpdate.ps1 and select Run with PowerShell from the shortcut menu to re-create the installation zip files.
  2. Commit
  3. Push to your fork
  4. Create a pull request

Last changed: 2023/01/21 Picture