Enhancement to config

Stuff mainly to adress run regeneration of FoxBin2Prg out of itself
This commit is contained in:
Lutz
2023-08-30 22:06:51 +02:00
parent 8c9d7e37a5
commit af6db043ed
16 changed files with 807 additions and 34104 deletions

View File

@@ -1,9 +1,14 @@
# How to contribute to FoxBin2Prg
## Bug report?
- Please check [issues](https://github.com/fdbozzo/foxbin2prg/issues) if the bug is reported
- Please check [issues](https://github.com/lscheffler/foxbin2prg/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.
- Please add your current configuration creating a config file via `DO FOXBIN2PRG.PRG WITH '-C','path-to-source\FoxBin.cfg'`. **Do not include your normal config**
- Please add your current configuration creating a config file via
```
CD 'path-to-source'
DO FOXBIN2PRG.PRG WITH '-C','FoxBin.cfg'
```
**Do not include your normal config**
### Did you write a patch that fixes a bug?
- Open a new GitHub merge request with the patch.
@@ -31,46 +36,44 @@ Stuff is a bit scattered, so this is where to look up.
1. Please create a fork at github
- See this [guide](https://www.dataschool.io/how-to-contribute-on-github/) for setting up and using a fork
- If allready forked, pull the recent state, or get most recent version otherwise.
2. On top of _FoxBin2Prg.prg_ there are two version numbers:
2. clonr from https://github.com/lscheffler/foxbin2prg.
**Note: If you have cloned the project, you must run it against itself to create the binaries and exes.**
```
CD "path_to_FoxBin2Prg"
*This uses a special configuration
DO ReCreate_FoxBin2Prg.prg
```
**Note: Do not run FoxBin2Prg.prg directly.**
3. On top of _FoxBin2Prg.prg_ there are two version numbers:
`#DEFINE DN_FB2PRG_VERSION 1.20`
`#DEFINE DC_FB2PRG_VERSION_REAL '1.20.00'`
3. Please set the **minor** part of _DC_FB2PRG_VERSION_REAL_ to a new number.
4. Please set the **minor** part of _DC_FB2PRG_VERSION_REAL_ to a new number.
**Do not** alter the **1.20** part. This is written to the text files.
Alteration might force that the files must be newly commited, what is not everybodies taste.
4. Add a meaningfull description of the change in the changes list on top of _FoxBin2Prg.prg_.
5. Add a meaningfull description of the change in the changes list on top of _FoxBin2Prg.prg_.
The most recent entries for changes in the middle of this section around _* </HISTORIAL DE CAMBIOS Y NOTAS IMPORTANTES>_,
The most recent bugs are listed above _* </TESTEO Y REPORTE DE BUGS (AGRADECIMIENTOS)>_
5. Alter version in _README.md_
6. Add a description to _docs\ChangeLog.md_
7. If a change to the config files is made please add the description to the various properties (multi lang)
6. Alter version in _README.md_
7. Add a description to _docs\ChangeLog.md_
8. 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
8. If a change to the parameters is made, change _C_FOXBIN2PRG_SYNTAX_INFO_EXAMPLE_LOC_ properties.
9. For changed functionality, add descriptive text on the appropriate _.md_ file in _docs_ folder.
10. Please alter the footer of \*.md files touched to recent date.
11. Create a template _foxbin2prg.cfg.txt_ for general settings or _foxbin2prg.dbf.cfg.txt_ for the settings per table.
- Do this even if no change to the setting to change the version number inside this files.
- Or change version number in those files manually
- **Note**. If you are not on an English comp, set the value _Language: EN_ in your local _foxbin2prg.cfg_ to create English files.
- run like:
```
CD Path_Top_Project
DO FoxBin2Prg.prg WITH "-c","foxbin2prg.cfg.txt"
DO FoxBin2Prg.prg WITH "-t","foxbin2prg.dbc.txt"
```
9. If a change to the parameters is made, change _C_FOXBIN2PRG_SYNTAX_INFO_EXAMPLE_LOC_ properties.
1. For changed functionality, add descriptive text on the appropriate _.md_ file in _docs_ folder.
11. Please alter the footer of \*.md files touched to recent date.
12. Alter the version number for the EXE to the version used above.
13. Compile to EXE **in VFP9 SP2**
14. Create the text representation of the binary sources running like
13. Create the text representation of the binary sources running like
```
CD "path_to_FoxBin2Prg"
*This uses a special configuration
DO Create_FoxBin2Prg.prg
```
15. commit
16. push to your fork
17. create a pull request
```
**Note: Do not run FoxBin2Prg.prg directly.**
14. commit
15. push to your fork
16. create a pull request
Thanks
----
Last changed: _2023/08/27_
Last changed: _2023/08/30_