How to contribute to FoxBin2Prg

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.

Did you write a patch that fixes a bug?

Open a new GitHub merge request with the patch.
Ensure the PR description clearly describes the problem and solution.
- Include the relevant version number if applicable.

Coding conventions

Start reading our code and you'll get the hang of it. We optimize for readability:

Beautification is done like:
- Keywords: Mixed case
- Symbols: First occurence
- Indentation Tabs, 1
- Indent anything then Comments
Please do not run BeautifyX with mDots insertion against the code.
We ALWAYS put spaces after list items and method parameters ([1, 2, 3], not [1,2,3]), around operators (x = 1, not x=1).
This is open source software. Consider the people who will read your code, and make it look nice for them. It's sort of like driving a car: Perhaps you love doing donuts when you're alone, but with passengers the goal is to make the ride as smooth as possible.
Please kindly add comments where and what you change

New version

Please note, there are some tasks to set up a new version. Stuff is a bit scattered, so this is where to look up.

Please create a fork at github
In FoxBin2Prg.prg there are two version numbers in properties:
n_FB2PRG_Version = 1.19
c_FB2PRG_Version_Real = '1.19.60'
Please set the minor part of c_FB2PRG_Version_Real to a new number.
Do not alter the 1.19 part. This is written to the text files. Alteration might force that the files must be newly commited, what is not everybodies taste.
Add a meaningfull description of the change in the changes list on top of FoxBin2Prg.prg.
Add a description to FoxBin2Prg_Changes.md
If a change to the config files is made please add the description to the various properties (multi lang)
- C_FOXBIN2PRG_SYNTAX_INFO_EXAMPLE_LOC_cfg: for general settings
- C_FOXBIN2PRG_SYNTAX_INFO_EXAMPLE_LOC_tab_cfg: for settings per table
- Create a template foxbin2prg.cfg.txt for general settings or foxbin2prg.dbf.cfg.txt for the settings per table.
If a change to the parameters is made, change C_FOXBIN2PRG_SYNTAX_INFO_EXAMPLE_LOC properties.
For changed functionality, add descriptive text on the appropriate .md file.
Highlight the change on README.md in projects root
Alter the version number for the EXE to the version used above.
Compile to EXE
Change Thor (see below)

Thor conventions

This project is part of VFPX and published via Thor.
There are some considerations to make to add a new version to Thor.
Please check Supporting Thor Updater In special:

Update Project.txt, in special the version number
Run the script included, or
- add files to FoxBin2Prg.zip, namly FoxBin2Prg.prg, FoxBin2Prg.exe and the config files templates
- Update the version number in FoxBin2PrgVersion.txt

Thanks

3.4 KiB Raw Blame History