# guez Qt6 Release 2 - Release Notes

## Release Information

- **Project**: guez (formerly qatar)
- **Release Version**: 1.0
- **Release Date**: November 2025
- **Migration Phase**: Qt6 Release 2
- **Packages**: 5 DEB packages

## Executive Summary

This release delivers Qt6-migrated modules for the guez project, packaged as 5 DEB packages for Ubuntu 24.04 LTS. The migration covers AP3 (shared libraries), AP4 (DDS middleware), and AP9 (tools/translations) components, following the Release 2 structure with pre-built artifacts.

## What's New

### Qt6 Migration
- Successfully migrated LTS modules from Qt5 to Qt6
- Migrated DDS middleware components to Qt6
- Updated NGL core components for Qt6 compatibility
- Ported Grantlee templating and translation tools

### Packaging Changes
- **New DEB-only format**: Release 2 uses 5 separate DEB packages instead of monolithic delivery
- **Separation of concerns**: Runtime, sources, and test components in separate packages
- **Standard Debian format**: Compatible with standard dpkg/apt tooling
- **Pre-built artifacts**: Uses build4/ directory for reproducible builds

## Package Summary

| Package | Size | Purpose | Status |
|---------|------|---------|--------|
| qt6-release-runtime | 85M | Runtime libraries and binaries | ✓ Complete |
| qt6-release-sources | 565M | Full source code | ✓ Complete |
| qt6-release-ctest-runtime | 565M | CTest runtime | ✓ Complete |
| qt6-release-ctest-sources | 565M | CTest sources | ✓ Complete |
| qt6-release-build-pipeline | 1.1K | Build pipeline config | ⚠ Minimal |

## Migration Scope

### AP3 - Shared Libraries ✓
**Completed**:
- LTS command-line parser
- LTS coordinate transformation
- LTS plugin loader
- LTS GUI utilities
- NGL application framework
- NGL compression utilities
- NGL core application
- NGL geometry components
- NGL graphics engine
- Code generation tools

**Libraries included**:
- `libLtsCommandLineParser.so`
- `libLtsCoordTrans.so`
- `libLtsPluginLoader.so`
- `libnglapplication.so`
- `libnglcompression.so`
- `libnglcoreapplication.so`
- `libnglgeometry.so`
- `libnglgraphicsengine.so`
- `libcodegen_grantlee.a`

### AP4 - DDS Middleware ✓
**Completed**:
- DDS QoS (Quality of Service) management
- DDS connector implementation
- DDS core functionality
- DDS FTC (Fast Transport Channel)
- DDS code generator

**Libraries included**:
- `libddsQoS.so`
- `libddsconnector.so`
- `libddscore.so`
- `libddsftc.a`
- `libddsCodeGenerator.so`

**Executables**:
- `ParticipantDataGenerator`
- `tDataSampleGenerator`

### AP9 - Tools and Translations ✓
**Completed**:
- Grantlee templating engine
- Localization/translation tools
- Build utilities
- Test frameworks

## Technical Changes

### Build System
- **New build script**: `make_rpm_ubuntu26_release2.py`
  - Direct dpkg-deb packaging (no debhelper)
  - Handles broken symlinks gracefully
  - PID-based build directories to avoid conflicts
  - Automatic cleanup between builds

- **Entry point**: `new_docker_build.sh`
  - Handles configuration, build, test, install, package
  - Uses aqtinstall for Qt6 package installation
  - Creates build4/ artifacts for packaging

### Directory Structure
```
qt-migration-legatus/
└── qt6-after/
    └── qt6-migrated-legatus/
        ├── build4/              # Pre-built artifacts
        │   ├── lib/             # Libraries (.so, .a)
        │   ├── bin/             # Executables
        │   └── Lts/Tools/       # Tool executables
        ├── Lts/                 # Source code
        └── rpmbuild/            # Packaging scripts
```

### Package Installation Paths
- **Runtime**: `/usr/lib/`, `/usr/bin/`
- **Sources**: `/opt/guez/sources/`
- **CTest runtime**: `/usr/lib/`, `/usr/bin/`
- **CTest sources**: `/opt/guez/ctest-sources/`
- **Build pipeline**: `/opt/guez/build-pipeline/`

## Known Issues

### 1. Build-pipeline Package Content
**Issue**: The build-pipeline package currently contains minimal content (only root directory).

**Impact**: Users cannot access full build pipeline configuration.

**Workaround**: Access build scripts directly from source repository.

**Fix planned**: Full pipeline configuration to be added in next release.

### 2. File Permissions
**Issue**: Some files in build4/ directory are owned by root from Docker builds.

**Impact**: May cause permission errors during packaging or cleanup.

**Workaround**: Run packaging script with appropriate permissions or use temp directories.

### 3. Disk Space Requirements
**Issue**: Building all packages requires ~2GB+ free space in /tmp.

**Impact**: Build may fail with "Disk quota exceeded" on systems with limited /tmp space.

**Workaround**: Set TMPDIR environment variable to location with sufficient space.

## Installation Instructions

### Prerequisites
- Ubuntu 24.04 LTS (or compatible Debian-based distribution)
- x86_64 architecture
- 2.5GB free disk space
- sudo access for installation

### Quick Start
```bash
# Download all packages to a directory
cd /path/to/packages

# Install runtime (required first)
sudo dpkg -i qt6-release-runtime_1.0-1_amd64.deb

# Install sources (optional)
sudo dpkg -i qt6-release-sources_1.0-1_amd64.deb
sudo dpkg -i qt6-release-ctest-sources_1.0-1_amd64.deb

# Install CTest runtime
sudo dpkg -i qt6-release-ctest-runtime_1.0-1_amd64.deb

# Install build pipeline
sudo dpkg -i qt6-release-build-pipeline_1.0-1_amd64.deb

# Verify installation
dpkg -l | grep qt6-release
```

### Verification
```bash
# Check runtime libraries
ls -la /usr/lib/libLts*.so
ls -la /usr/lib/libdds*.so
ls -la /usr/lib/libngl*.so

# Check executables
ls -la /usr/bin/ParticipantDataGenerator
ls -la /usr/bin/tDataSampleGenerator

# Check sources
ls -la /opt/guez/sources/
```

## Build Instructions

### Prerequisites for Building
- Docker (for reproducible builds)
- Python 3.8+
- dpkg-deb
- Access to Qt6 packages (via aqtinstall)

### Build Process
```bash
# Navigate to packaging directory
cd rpmbuild/

# Build all packages
python3 make_rpm_ubuntu26_release2.py \
  -c LTS \
  --project_name guez \
  --version 1.0 \
  --output_dir /path/to/output \
  --source_dir /path/to/qt-migration-legatus/qt6-after/qt6-migrated-legatus
```

### Build Output
- 5 DEB packages in output directory
- Manifest files in `manifests/` subdirectory
- Build logs in console output

## Testing

### Runtime Testing
```bash
# Verify libraries load correctly
ldd /usr/lib/libLtsCommandLineParser.so

# Test executables
/usr/bin/ParticipantDataGenerator --help
```

### Source Code Testing
```bash
# Navigate to sources
cd /opt/guez/sources/

# Run CMake configuration
cmake -B build -S .

# Build (optional, for verification)
cmake --build build

# Run tests
ctest --test-dir build
```

## Migration from Previous Versions

### From Qt5 Release
If you have existing Qt5 installations:

1. **Backup existing configuration**
   ```bash
   cp -r /opt/qatar /opt/qatar.backup
   ```

2. **Remove old packages** (if applicable)
   ```bash
   sudo dpkg -r qatar-legacy
   ```

3. **Install new Qt6 packages**
   ```bash
   sudo dpkg -i qt6-release-runtime_1.0-1_amd64.deb
   # ... install other packages
   ```

4. **Update application configuration**
   - Update library paths if hardcoded
   - Rebuild applications against Qt6 libraries
   - Update CMake configuration to find Qt6

### API Compatibility
- Most APIs remain compatible between Qt5 and Qt6
- Some deprecated Qt5 APIs may have been removed
- Check application logs for deprecation warnings
- Refer to Qt6 migration guide for detailed API changes

## Documentation

### Included Documentation
- `README.md` - This installation guide
- `BUILD_STATUS_REPORT.md` - Build status and metrics
- `DDS_MIGRATION_STATUS.md` - DDS migration details
- `CTEST-INTEGRATION-STATUS.md` - Integration test status
- `INTEGRATION_TEST_REPORT.md` - Test results

### External Documentation
- Qt6 Documentation: https://doc.qt.io/qt-6/
- Debian Packaging Guide: https://www.debian.org/doc/manuals/debian-faq/

## Support and Feedback

### Reporting Issues
Please include:
- Package version: `dpkg -l | grep qt6-release`
- OS version: `lsb_release -a`
- Error messages and logs
- Steps to reproduce

### Contact
- Project repository: [Internal]
- Build system: `rpmbuild/make_rpm_ubuntu26_release2.py`
- Entry point: `new_docker_build.sh`

## Changelog

### Version 1.0 (November 2025)
**Added**:
- Initial Qt6 Release 2 packages
- 5 DEB packages: runtime, sources, ctest-runtime, ctest-sources, build-pipeline
- AP3 shared libraries migration
- AP4 DDS middleware migration
- AP9 tools and translations migration
- Standard Debian packaging format
- Reproducible Docker builds

**Changed**:
- Project name from "qatar" to "guez"
- Packaging approach from monolithic to modular
- Build system to use dpkg-deb directly

**Fixed**:
- Debhelper variable compatibility
- Broken symlink handling
- Build directory cleanup
- Working directory restoration

## License

Proprietary - All rights reserved.

---

**Release Manager**: Automated Build System  
**Build Date**: November 10, 2025  
**Project**: guez Qt6 Migration - Release 2