Skip to content

feat: add standardized file headers with descriptions and MIT license#53

Merged
davidirvine merged 1 commit intodevelopfrom
std-file-comments
Jul 25, 2025
Merged

feat: add standardized file headers with descriptions and MIT license#53
davidirvine merged 1 commit intodevelopfrom
std-file-comments

Conversation

@davidirvine
Copy link
Copy Markdown
Owner

  • Add comprehensive file header comments to all source files in src/
  • Include brief description of each file's purpose and functionality
  • Add complete MIT license text to ensure proper attribution
  • Format all files using clang-format to maintain consistency
  • Headers follow Doxygen documentation style for better tool integration

Files updated:

  • src/voice/deepnotevoice.hpp: Core voice implementation
  • src/voice/frequencytable.hpp: Frequency table management
  • src/voice/oscfrequency.hpp: Oscillator frequency utilities
  • src/ranges/range.hpp: Range constraint utilities
  • src/ranges/scaler.hpp: Value scaling and mapping
  • src/unitshapers/bezier.hpp: Bezier curve shaping
  • src/unitshapers/linear.hpp: Linear unit shaping
  • src/util/namedtype.hpp: Type-safe wrapper utilities

- Add comprehensive file header comments to all source files in src/
- Include brief description of each file's purpose and functionality
- Add complete MIT license text to ensure proper attribution
- Format all files using clang-format to maintain consistency
- Headers follow Doxygen documentation style for better tool integration

Files updated:
- src/voice/deepnotevoice.hpp: Core voice implementation
- src/voice/frequencytable.hpp: Frequency table management
- src/voice/oscfrequency.hpp: Oscillator frequency utilities
- src/ranges/range.hpp: Range constraint utilities
- src/ranges/scaler.hpp: Value scaling and mapping
- src/unitshapers/bezier.hpp: Bezier curve shaping
- src/unitshapers/linear.hpp: Linear unit shaping
- src/util/namedtype.hpp: Type-safe wrapper utilities
Copilot AI review requested due to automatic review settings July 25, 2025 21:18
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds standardized file headers with MIT license information and Doxygen-style documentation to all source files in the Deep Note synthesizer project. The changes ensure proper attribution, improve code documentation, and maintain consistency across the codebase.

  • Added comprehensive file headers with MIT license text to all source files
  • Included Doxygen-style documentation with file descriptions and author information
  • Applied consistent formatting to maintain code style uniformity

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/voice/deepnotevoice.hpp Added header with description of core voice implementation functionality
src/voice/frequencytable.hpp Added header documenting frequency table management capabilities
src/voice/oscfrequency.hpp Added header describing oscillator frequency calculation utilities
src/ranges/range.hpp Added header explaining range constraint and validation utilities
src/ranges/scaler.hpp Added header documenting value scaling and mapping functionality
src/unitshapers/bezier.hpp Added header describing Bezier curve shaping utilities
src/unitshapers/linear.hpp Added header documenting linear unit shaping capabilities
src/util/namedtype.hpp Added header explaining type-safe wrapper utilities

@github-actions
Copy link
Copy Markdown

Coverage after merging std-file-comments into develop will be

94.27%

Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
src/ranges
   range.hpp96%100%100%94.44%90
   scaler.hpp100%100%100%100%
src/unitshapers
   bezier.hpp100%100%100%100%
   linear.hpp100%100%100%100%
src/util
   namedtype.hpp100%100%100%100%
src/voice
   deepnotevoice.hpp93.53%100%96.15%93.06%111, 127, 144, 164, 168, 186, 190, 194, 198, 438
   frequencytable.hpp100%100%100%100%

@davidirvine davidirvine merged commit 6476334 into develop Jul 25, 2025
12 checks passed
@davidirvine davidirvine deleted the std-file-comments branch July 25, 2025 22:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants