Binary/Text Converting program for Microsoft Visual FoxPro
This is the perpetuation of Fernando D. Bozzo foxbin2prg.
It's the main tool with some bugs fixes and some new functions. It looks like Fernando does not longer maintain FoxBin2Prg, so, with his permission, I work onto this. On my fork. updates may be faster there, because of the merge process.
The spanish documentation is not longer maintained - it would fade. For fast acces a quick run is introduced, more complex, and a large documentation exists too. Remember yourself to compile the exe first.
If you like to see Fernandos blog, or value his work:
Thank you for your support!
What is FOXBIN2PRG?
It is a program intended to be used with SCM tools (Source Code Managers, like VSS, CVS, SVN) and DVCS tools (Version Control Systems such as Git, Mercurial, Plastic, and others), or as standalone program for Diff (viewing differences) and Merge operations. Foxbin2prg can substitute for SccText/X, TwoFox and others, and enhance their functionality, generating bidirectional PRG-Style versions of Foxpro binary files that allow recreating the original binary file.
It generates "PRG" style text files from Foxpro binary files for use in SCM and VCS systems and for visual comparison.
(it's not really a prg, and can not be compiled, but it reads like one to Foxpro developers.)
It enables the change of the Text version as easy as modifying a PRG.
All the program code for any binary file (a form, a report, a class) is in just one text file, to simplify its maintainability.
You can regenerate the original binaries from the text files, so it is useful as backup
The extensions are configurable if you create a FOXBIN2PRG.CFG file
Inheritance of CFG configuration files between directories
Methods and properties of Text versions are alphabetically sorted for easy comparison
You can set the "UseClassPerFile" setting to create individual files by class or DBC member.
(Which violates number three above, but it may be what you want.)
Takes advantage of the Win32 API using foxbin2prg as an object
It has compatibility with SccText/X at the parameter level so that it can be used as substitute for SccText with SourceSafe. (Not that we recommend SourceSafe.)
Productivity: You can create a shortcut in the "SendTo" folder on your user Windows Profile, so you can "send" the selected file (pjx,pj2,etc) to Foxbin2prg.exe and make on-the-fly conversions
You can modify the TX2 Prg-Style versions of your objects with MODIFY COMMAND (without compile) to see colored syntax, or even use the Document View to navigate the procedures
Get back your SourceSafe projects (.pjx) from their .pjm file
The program supports conversions between PJX,SCX,VCX,FRX,LBX,DBC,DBF and MNX files, for which it generates TEXT versions with extension PJ2,SC2,VC2,FR2,LB2,DC2,DB2 and MN2. If you want, the created text file extensions can be reconfigured to be compatibilize with SourceSafe.
Redefine extensions of Text
Here is an example of a FOXBIN2PRG.CFG configuration file if you need to change extensions for using it with a specific VSS (SourceSafe)
extension: SC2=SCA extension: VC2=VCA extension: PJ2=PJA extension: MN2=MNA extension: FR2=FRA extension: LB2=LBA extension: DB2=DBA extension: DC2=DCA
DO FOXBIN2PRG.PRG WITH "<path>\archivo.scx" ==> Generates the TEXT version sc2 extension DO FOXBIN2PRG.PRG WITH "<path>\archivo.sc2" ==> Regenerates the binary version with scx extension DO FOXBIN2PRG.PRG WITH "-c","template.cfg" ==> Generates a template for FoxBin2Prg.cfg config file with newest settings DO FOXBIN2PRG.PRG WITH "-t","template.dbf.cfg" ==> Generates a template for table.dbf.cfg per table config file with newest settings
Use with MS Windows SendTo
You can create up to three different shortcuts pointing to FoxBin2Prg.exe and in your "SendTo" folder in your Windows profile. This allows you to "send" a selected file (pjx,pj2,etc) to the selected option, and make on-the-fly conversions. (Make sure you have the option for seeing known file extensions turned on!):
Process directories or individual files to Text
FoxBin2Prg - Binary2Text.lnk
Process directories or individual files to Binary
FoxBin2Prg - Text2Binary.lnk
Process individual files or directories asking what to convert
How to use the links
Select a file, right-click, SendTo -> FoxBin2Prg
Is automatic starting at v1.19.38 (Languages: EN,ES,FR,DE)
This program is Open Source and "libre", and I don't make any guaranties that it fulfills your expectations or that it will be free of bugs. I will try to fix bugs if my obligations let me do it.
This work is licensed under the Creative Commons Attribution 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/.
Changes to Settings
To get the new settings in config file, use the new create-a-template function:
DO FOXBIN2PRG.PRG WITH "-c","template.cfg" ==> Generates a template for FoxBin2Prg.cfg config file with newest default settings DO FOXBIN2PRG.PRG WITH "-C","template.cfg" ==> Generates a template for FoxBin2Prg.cfg config file with active settings DO FOXBIN2PRG.PRG WITH "-t","template.dbf.cfg" ==> Generates a template for table.dbf.cfg per table config file with newest settings
For usage see documentation