History / Settings Reference

Remove the duplicate H1 title from wiki pages and deep-link Settings Reference entries GitHub Wiki already renders the page name as the title, so a leading # heading made it appear twice. Home keeps its heading as it names the project rather than repeating "Home". Settings Reference rows for settings documented on a shared page now link to the relevant section.

sjh37 committed Sep 10, 2026

Remove GenerationLanguage, FileExtension, IncludeQueryTraceOn9481Flag and FilterCount The FileExtension page goes, the CommandTimeout page covers only the timeout, the trace-flag advice leaves the SQL Server page, and the upgrade guide lists thirteen assignments to delete. Settings index regenerated.

sjh37 committed Sep 8, 2026

Remove Settings.GeneratorType from every page TemplateType alone decides which generator runs in v4. The pairing tables and assignments go, the upgrade guide lists it as the tenth removed setting, and the settings index is regenerated.

sjh37 committed Sep 7, 2026

Remove the pages for features v4 dropped Multi-context generation, file-based templates and the custom generator were removed before the v4 release. Their five pages go; the upgrade page gains a Removed in v4 section saying what went, why, and that v3 stays downloadable. The page that also documented FileExtension and GenerationLanguage becomes Settings.FileExtension, and Settings-Reference is regenerated.

sjh37 committed Sep 6, 2026

Complete the per-setting pages, and turn Settings-Reference into the index Twenty more pages, covering the settings that were left. All 118 settings on Settings now have a page, and Settings-Reference.md is a generated A-Z table linking each name to it. Settings that are always set together share a page: the five class modifier settings, the two collection settings, the three connection string settings, the folder settings, the namespace settings, the enum settings, the four MultiContextAllFields callbacks, and the read-only runtime values. The index links every setting name, so the reader never needs to know which page a setting lives on. Filtering gains generated before-and-after output for IncludeViews, and RowVersion-and-TimeStamp-columns gains the generated entity, both checked by the drift test like the rest. The sidebar now points at the index rather than listing pages, and Settings-Callbacks keeps its pipeline overview above links to the individual callback pages.

sjh37 committed Aug 30, 2026

Add the first five per-setting pages One page per setting, each showing the generated code before and after. Every code block marked <!-- docsample: ... --> is generated by Generator.Tests.Unit/DocSamples in the generator repository and checked by WikiSnippetDriftTests, so it cannot quietly stop being true. New: ElementsToGenerate, UpdateColumn, UsePrivateSetterForComputedColumns, and PrependSchemaNameForTable - the last of which is in Settings.cs but in neither Database.tt nor the wiki, so nobody could have found it. OnConfiguration is rewritten to the same template. Its IConfiguration example had already drifted: the generated field is nullable. Settings-Reference and Settings-Callbacks link to the new pages and keep their existing anchors.

sjh37 committed Aug 30, 2026

Correct the wiki against the v4 codebase Removes documented APIs that do not exist, fixes behaviour described backwards, and updates pages still describing v3. Fabricated: Settings.ForeignKeyNamingStrategy and its enum, and Settings.ApplyColumnCustomizations. Neither is in either repository. Filtering: filters are OR'd via Any(), not applied in sequence, and multiple RegexIncludeFilters are merged into one alternation first. Settings.ColumnIdentity: the shipped default returns empty for MySQL because Pomelo has no UseIdentityColumn, and honours HiLoSequences; the old example broke both. Schema prefixing: the schema is prepended verbatim and the table is singularised, so billing.Orders is billing_Order, not Billing_Orders. Defaults now follow Database.tt rather than the class initialiser, which differ for DisableGeographyTypes, UseResharper and the folder settings. NullableReverseNavigationProperties was simply wrong. Also: MySQL and Oracle do read column comments through the extended property pipeline; PostgreSQL result models cover set-returning functions only; CommentsStyle is not a flags enum; GenerationLanguage has a Javascript member; sp_describe_first_result_set is never used; the DbContext is not sealed, just not partial; and there is no EnvDTE dependency left for the scripty page to object to. Fills in eleven settings that ship in Database.tt but were undocumented, and adds a per-database DefaultSchema table - SQL Server uses SCHEMA_NAME(), not a hardcoded dbo.

sjh37 committed Aug 30, 2026

Update documentation for v4 Database pages: PostgreSQL, MySQL, Oracle and SQLite were entirely GAC and machine.config setup instructions, and MySQL and Oracle still said "under development". Replaced with dialect guides covering connection strings, permissions, what the reader supports, type mapping and quirks. Each opens by telling v3 users to undo the GAC and machine.config changes. Added a SQL Server page for symmetry. ConnectionString: expanded from the environment variable note to worked examples for all five databases (Azure and Entra ID, RDS, PlanetScale, TNS and wallets, sockets), a per-database permissions table, the SET FMTONLY execute requirement, and three ways to keep the string out of source control. Home: SQL Server CE was listed as fully supported, MySQL and Oracle as under development, Plugin as available, and Settings.FileManagerType appeared in all four recommended-settings blocks. The Quick Start never mentioned installing the efrpg tool, so anyone following it on v4 failed immediately. Fixed, and added an index of the rest of the wiki. Removed the settings that no longer exist from Common Settings Types Explained and Settings Reference: DatabaseType.SqlCe, DatabaseType.Plugin, Settings.DatabaseReaderPlugin and Settings.FileManagerType. Updated stale EF.Reverse.POCO.v3.ttinclude references in five pages. Fixed pre-existing broken cross-links: three pages linked to Custom-file-based-templates when the page name contains U+2010, Migrations linked to "scripty" rather than "script", and seven links had case mismatches. Renamed Syntax-Colour-*.TT-and-*.TTINCLUDE-files to Syntax-Colour-for-T4. The asterisks are illegal in an NTFS filename, so the wiki could not be cloned or pulled on Windows without disabling core.protectNTFS. Deleted Upgrading-from-v2-to-v3, superseded by Upgrading-from-v3-to-v4. Added _Sidebar for navigation.

sjh37 committed Aug 30, 2026

Updated Settings Reference (markdown)

sjh37 committed Mar 20, 2026

Created Settings Reference (markdown)

sjh37 committed Mar 20, 2026