Welcome to QPM

QPM (QAC based Project Manager) is the Open Source continuation of the QAC application developed by CarozoDeQuilmes (inspired on the MPM utility designed by Roberto López, the creator of Harbour MiniGUI library).

QPM is a project manager for software applications based on Harbour and xHarbour languages and its contributions, specialy the graphic support libraries for Windows: Harbour MiniGUI, Harbour MiniGUI Extend and Object Oriented Harbour GUI (OOHG), and Borland, Pelles and MinGW C/C++ compilers.

It assists programmers in the processes of program writing, compilation, debugging and linking by offering interactive and batch tools to:

• Access external utilities to edit fonts, forms, headers and DBF files.
• Keep and recover previous versions of modified files (hot recovery function).
• View and search source files, forms, headers, and DBF files.
• Incrementally compile GUI, console, and mixed-type programs.
• View error files resulting from compilation and execution.
• View .PPO files (preprocessor output).
• Execute post-build processes.
• Create CHM and HTML help files.
• Create static libraries and DLL access interfaces.
• Show the names of the functions included in static and dynamic libraries.
• Compress EXE files with the UPX utility.

How to inform on a bug, make a request or ask for help?

See https://github.com/teamQPM/qpm/issues/new/choose

Contributing to QPM

With code:

1. Fork this repository.
2. Create a branch: git checkout -b <branch_name>.
3. Make your changes and commit them: git commit -m '<commit_message>'
4. Push to the original branch: git push origin <project_name>/<location>
5. Create a pull request.
6. See "Developers Section".

   With money:

   

Site structure

Users Section

QPM configuration for OOHG based projects

1. HM30: Harbour 3.0 + MinGW 4.5.2 - 32 bits

   Project Configuration

   Compilers = Harbour + MinGW GUI = OOHG + MT Mode FMG Editor = OOHG IDE+

   Global Configuration

   OOHG Folder = C:\OOHG_HM30 OOHG Libs Folder = C:\OOHG_HM30\lib Lib name = liboohg.a MinGW Folder = C:\OOHG_HM30\hb30\comp\mingw MinGW Libs Folder = C:\OOHG_HM30\hb30\comp\mingw\lib Harbour Folder = C:\OOHG_HM30\hb30 Harbour Libs Folder = C:\OOHG_HM30\hb30\lib\win\mingw GTGUI name = libgtgui.a

2. HM32: Harbour 3.2 + MinGW 8.1.0 - 32 bits

   Project Configuration

   Compilers = Harbour + Harbour 3.1 or later + MinGW GUI = OOHG + MT Mode FMG Editor = OOHG IDE+

   Global Configuration

   OOHG Folder = C:\OOHG_HM32 OOHG Libs Folder = C:\OOHG_HM32\lib\hb\mingw Lib name = liboohg.a MinGW Folder = C:\OOHG_HM32\hb32\comp\mingw MinGW Libs Folder = C:\OOHG_HM32\hb32\comp\mingw\i686-w64-mingw32\lib Harbour Folder = C:\OOHG_HM32\hb32 Harbour Libs Folder = C:\OOHG_HM32\hb32\lib\win\mingw GTGUI name = libgtgui.a

3. HM3264: Harbour 3.2 + MinGW 9.3.0 - 64 bits

   Project Configuration

   Compilers = Harbour + Harbour 3.1 or later + MinGW + 64 bits GUI = OOHG + MT Mode FMG Editor = OOHG IDE+

   Global Configuration

   OOHG Folder = C:\OOHG_HM3264 OOHG Libs Folder = C:\OOHG_HM3264\lib\hb\mingw64 Lib name = liboohg.a MinGW Folder = C:\OOHG_HM3264\hb3264\comp\mingw MinGW Libs Folder = C:\OOHG_HM3264\hb3264\comp\mingw\x86_64-w64-mingw32\lib Harbour Folder = C:\OOHG_HM3264\hb3264 Harbour Libs Folder = C:\OOHG_HM3264\hb3264\lib\win\mingw64 GTGUI name = libgtgui.a

4. HM34 = Harbour 3.4 + cLang/LLVM 5.0.0 - 32 bits

   Project Configuration

   Compilers = Harbour + Harbour 3.1 or later + MinGW GUI = OOHG + MT Mode FMG Editor = OOHG IDE+

   Global Configuration

   OOHG Folder = C:\OOHG_HM34 OOHG Libs Folder = C:\OOHG_HM34\lib\hb34\mingw Lib name = liboohg.a MinGW Folder = C:\OOHG_HM34\hb34\comp\mingw MinGW Libs Folder = C:\OOHG_HM34\hb34\comp\mingw\i686-w64-mingw32\lib Harbour Folder = C:\OOHG_HM34\hb34 Harbour Libs Folder = C:\OOHG_HM34\hb34\lib\win\clang GTGUI name = libgtgui.a

5. XM: XHarbour 1.2.3 build 20181212 + MinGW 7.3.0 - 32 bits

   Project Configuration

   Compilers = xHarbour + MinGW GUI = OOHG + MT Mode FMG Editor = OOHG IDE+

   Global Configuration

   OOHG Folder = C:\OOHG_XM OOHG Libs Folder = C:\OOHG_XM\lib\xhb\mingw Lib name = liboohg.a MinGW Folder = C:\OOHG_XM\xhmingw\comp\mingw MinGW Libs Folder = C:\OOHG_XM\xhmingw\comp\mingw\i686-w64-mingw32\lib xHarbour Folder = C:\OOHG_XM\xhmingw xHarbour Libs Folder = C:\OOHG_XM\xhmingw\lib GTGUI name = libgtgui.a

6. XB: XHarbour 1.2.3 build 20181212 + BCC 5.5.1 - 32 bits

   Project Configuration

   Compilers = xHarbour + BCC32 GUI = OOHG + MT Mode FMG Editor = OOHG IDE+

   Global Configuration

   OOHG Folder = C:\OOHG_XB OOHG Libs Folder = C:\OOHG_XB\lib\xhb\bcc Lib name = oohg.lib BCC Folder = C:\Borland\BCC55 BCC Libs Folder = C:\Borland\BCC55\lib xHarbour Folder = C:\OOHG_XB\xhbcc xHarbour Libs Folder = C:\OOHG_XB\xhbcc\lib GTGUI name = gtgui.lib

QPM configuration for HMG Extended based projects

1. Harbour 3.2 + MinGW 8.1 - 32-bits

   Project Configuration

   Compilers = Harbour + MinGW GUI = HMG Extended FMG Editor = HMGS-IDE

   Global Configuration

   Extended Folder = C:\minigui Extended Libs Folder = C:\minigui\lib Lib name = libminigui.a MinGW Folder = C:\minigui\mingw32 MinGW Libs Folder = C:\minigui\mingw32\i686-w64-mingw32\lib Harbour Folder = C:\minigui\harbour Harbour Libs Folder = C:\minigui\harbour\lib\win\mingw GTGUI name = libgtgui.a

2. Harbour 3.2 + MinGW 8.2 - 64-bits

   Project Configuration

   Compilers = Harbour + MinGW GUI = HMG Extended FMG Editor = HMGS-IDE

   Global Configuration

   Extended Folder = C:\minigui Extended Libs Folder = C:\minigui\lib Lib name = libminigui.a MinGW Folder = C:\minigui\mingw64 MinGW Libs Folder = C:\minigui\mingw64\x86_64-w64-mingw32\lib Harbour Folder = C:\minigui\harbour Harbour Libs Folder = C:\minigui\harbour\lib\win\mingw64 GTGUI name = libgtgui.a

3. Harbour 3.2 + BCC 5.5.1 - 32 bits

   Project Configuration

   Compilers = Harbour + BCC32 GUI = HMG Extended FMG Editor = HMGS-IDE

   Global Configuration

   Extended Folder = C:\minigui Extended Libs Folder = C:\minigui\Lib Lib name = minigui.lib BCC32 Folder = C:\Herramientas\Borland\BCC55 BCC32 Libs Folder = C:\Herramientas\Borland\BCC55\Lib Harbour Folder = C:\minigui\Harbour Harbour Libs Folder = C:\minigui\Harbour\lib GTGUI name = gtgui.lib

Developers Section

How to build QPM from scratch

1. Download the last QPM installer from https://github.com/teamQPM/qpm/releases and install to folder C:\QPMdev.
2. Install GitHub Desktop or another Git client and checkout the QPM repository.
3. An alternative is to download a zip with all the files from the aforementioned site using the green button labeled "Code".
4. Install Harbour MiniGUI Extended Edition from https://github.com/teamQPM/hmgext or, if you want to try a newer version, from https://sourceforge.net/projects/hmgs-minigui/
5. Install Borland C++ Compiler version 5.8.2 from:
   • http://www.xharbour.org/index.asp?page=download/windows/required_win
   • http://www.whosaway.com/
6. Start QPM, go to Settings/Global Options menu, select the tab labeled "Extended 1.x with Borland C", and configure all its fields.
7. If you didn´t installed at folder C:\QPMdev, you must modify, build and execute ./HelpQPM/SHG_Change.prg to change the path to the files used by QPM to build QPM.CHM help file. The building tools do not support relative paths so a full default path must be specified (C:\QPMdev). If you fail to do this, QPM will complain that it can't found the images and zips files.
8. Launch CompileAll.bat to build all the binaries.

How to build a new release

1. In QPM_version.ch set the values of this defines:

    #define QPM_VERSION_NUMBER_MAYOR   '05'
    #define QPM_VERSION_NUMBER_MINOR   '05'
    #define QPM_VERSION_NUMBER_BUILD   '00'

2. Open your working version of QPM and load ./QPM_AutoProject.qpm

3. If AUTOINC option is set to ON then change version, release and build to one less than the release to build. E.G. if you want to build 5.01.10, set QPM to 5.01.09 if you want to build 5.01.00, set QPM to 5.00.9999 If AUTOINC option is set to OFF then change version, release and build to the desired values.

4. Build the project.

5. Install INNO Setup Compiler from http://www.jrsoftware.org/

6. Open QPM.ISS and

   1. Check if all the required files are included (look for 'vExeList' at QPM_Functions.prg).
   2. Check if all the samples are incluided (look into Samples folder).
   3. Set "AppVerName" and "OutputBaseFilename" variables to reflect the new version number.
   4. Set "AppPublisher" variable to your name.
   5. Update "AppCopyright" to the current year.
   6. Hit "compile" button.

7. Upload the installer to GitHub's release page.

How to update the Internet Help site

1. QPM's Internet Help site is located at https://qpm.sourceforge.io/ and can be accessed from "Browse help file" link at https://teamqpm.github.io/
2. If you don't have one, download and install a FTP client. FileZilla is a fine choice: https://filezilla-project.org/
3. Open QPM_AutoProjectOnlyHelp.qpm and:
   1. Select SHG tab page and make all the necessary changes.
   2. Check "Add HTML Output" option.
   3. Click "Generate" button.
   4. If prompted save all unsaved topics.
   5. When prompted select folder "htmlhelp" (this folder will hold all the files generated by the build process).
   6. Wait until the process ends and close the project.
   7. Note that the html files are generated from rtf text by us_r2h.exe utility.
4. Open you FTP client and
   1. Set folder "htmlhelp" as your local site.
   2. Set "web.sourceforge.net" as the server.
   3. Set "sftp" as transfer protocol, set port to 22.
   4. Set "normal" as access mode.
   5. Use your SourceForge's username and password to connect.
   6. List "/home/project-web/qpm/htdocs" directory.
   7. Select "htdocs" folder.
   8. Upload "index.htm" from "QPM" local folder to "htdocs" folder.
   9. Select "QPM" folder.
   10. Upload files from "htmlhelp" local folder to "QPM" server folder.
5. Note that changes to "index.htm" page must be done by hand!

How to format your CHANGELOG.TXT entries

1. Always add new entries to the top of the file.
2. Add an entry header using this format:
   • YYYY-MM-DD HH:MM UTC[-|+]hhmm Your Full Name
3. Add an entry listing all the files changed, deleted or added.
4. Mention the name of the changed function or macro.
5. Describe the changes, the reasons, and other useful comments or explanations.
6. If some related work has to be done, make a clear note about it and reference the corresponding issue.
7. Group the related changes into logical sections and use the following marks to highlight them. Example:

* folder/file1.txt    
+ folder/file2.prg    
- folder/file3.ch    
  * Changed: ...    
  ! Fixed: ...    
  % Optimized: ...    
  + Added: ...    
  - Removed: ...    
  ; Note

Coding standards

Please try to follow the coding standards of "The Harbour Project": https://github.com/harbour/core/blob/master/doc/codestyl.txt