File CHANGELOG.md of Package kernel-source

# CHANGELOG

All notable changes to this kernel package are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project follows OSC (OpenSUSE Build Service) revision tracking.

## [Revision 11] - 2025-08-25

### Added
- **kernel-debug**: Re-enabled compile commands generation with optimized resource allocation
  - `generate_compile_commands=1` for debug kernel builds
  - Provides valuable debugging information for kernel development
  - Maintains build stability with increased memory constraints

### Technical Details
- Debug builds now generate `compile_commands.json` for IDE integration and static analysis
- Build stability ensured by previous memory allocation increases (6GB default, 8GB on x86_64/aarch64)

## [Revision 10] - 2025-08-25

### Fixed
- **kernel-debug**: Resolved build failures through resource optimization
  - Increased memory allocation for debug builds: 6GB default, 8GB on x86_64/aarch64
  - Updated `_constraints` and `constraints.in` template files
  - Temporarily disabled `generate_compile_commands` to reduce memory overhead

### Technical Details
- Debug kernel was failing during driver compilation due to memory pressure
- Memory constraints updated for all architectures with specific optimizations for x86_64/aarch64
- Build resource templates updated to persist changes across future builds

## [Revision 9] - 2025-08-25

### Added
- **Documentation**: Comprehensive kernel documentation and development tools
  - `README.md`: Primary repository documentation with navigation index
  - `KERNEL_SOURCES_README.md`: Guide for downloading and working with linux-6.11.tar.xz
  - `KMOD_REBUILD_README.md`: Kernel module rebuild compatibility guide
  - `sync-with-osc.sh`: Script for syncing between git and OSC workflows

### Enhanced
- Complete documentation coverage for kernel source management
- Module compatibility and rebuild decision guidance
- Developer experience improvements
- Reduced common support questions through comprehensive guides

## [Revision 8] - 2025-08-25

### Added
- **Documentation**: Kernel module rebuild documentation
  - `KMOD_REBUILD_README.md`: Comprehensive guide for module rebuild requirements
  - SUSE kernel versioning scheme documentation
  - ABI compatibility policy explanation
  - Practical verification steps and troubleshooting guide

### Fixed
- Addressed common questions about rebuild necessity for release number changes

## [Revision 7] - 2025-08-25

### Fixed
- **Build System**: RPM build error resolution
  - Removed quotes from `source_rel` macro definition in `kernel-spec-macros`
  - Fixed illegal character errors in RPM Requires lines
  - Resolved: `Requires: kernel-devel = 6.11.3-"10.shift5"` → `Requires: kernel-devel = 6.11.3-10.shift5`

### Technical Details
- Source release macro properly formatted for RPM dependency processing
- Build system compatibility improved across all kernel variants

## [Revision 6] - 2025-08-25

### Changed
- **Version Management**: Versioning changes testing
  - Experimental versioning modifications for system validation

## [Revision 5] - 2025-02-28

### Changed
- Undocumented changes (no commit message provided)

## [Revision 4] - 2025-02-28

### Changed
- Undocumented changes (no commit message provided)

## [Revision 3] - 2025-02-07

### Reverted
- Previous configuration changes
- Restoration of prior system state

## [Revision 2] - 2025-02-07

### Added
- **Kernel Configuration**: CONFIG_OF enabled
  - Set CONFIG_OF to yes for device tree support

## [Revision 1] - 2025-01-27

### Added
- Initial kernel package setup
- Base kernel source configuration

---

## Summary

This kernel package has evolved significantly with major improvements in:

- **Build System Stability**: Resolved critical compilation failures for debug kernels
- **Documentation**: Comprehensive guides for kernel development and module management  
- **Developer Experience**: Enhanced tooling and resource allocation for debugging
- **Resource Management**: Optimized build constraints for different architectures

### Current Status
- **Kernel Version**: 6.11.3
- **Release**: 10.shift5
- **Git Commit**: 006a2b4f54ea8081d692c34fd38bd1c2b57d8bd1
- **Last Updated**: 2025-08-25

### Key Features
- ✅ Stable debug kernel builds with compile commands generation
- ✅ Comprehensive documentation suite
- ✅ Optimized build resource allocation
- ✅ Multi-architecture support with specific optimizations
- ✅ Developer-friendly tooling and workflows