Code comments were drifting into plan-internal shorthand (DI-2a, Slice B, "see plan §9") that nobody outside the cycle authors can decode. They also tended toward AI-generated paragraph blocks where a two-line WHY would have done. This commit tightens the comment surface from the v1.5.0 work: - IPluginLogProxy header lists the consumer buckets without naming the cycle items that decided them. - DalamudLogger / DalamudLoggingProvider provenance markers explain themselves in two lines each; the long EUPL-rationale paragraph moves to the commit message. - PluginHostFactory block headers shrink to one line each, ASCII dividers come out, plan-internal codes go. - Plugin.cs field doc and Phase-1 / DisposeAsync comments lose the cycle-name references; the file gains nothing from "C3 surfaced X" in code. - FontManager / GameFunctions static-method notes shrink to one sentence each. - InitHostedServices class header keeps the eager-resolve WHY in three lines, drops the constraint label. Csharpier reformatted the .csproj layout (long PackageReference multi-lined). No functional change, no behavior change.
41 lines
1.5 KiB
C#
41 lines
1.5 KiB
C#
using System;
|
|
|
|
namespace HellionChat.Util;
|
|
|
|
// Plugin.LogProxy bridge for consumers that cannot take a logger via the
|
|
// constructor: static helpers (EmoteCache et al.), Dalamud-reflected types
|
|
// (Configuration), data classes with mass instantiation (Message) and
|
|
// instance classes that only log from static methods (FontManager).
|
|
internal interface IPluginLogProxy
|
|
{
|
|
void Verbose(string message);
|
|
void Verbose(Exception exception, string message);
|
|
void Verbose(string messageTemplate, params object[] values);
|
|
|
|
void Debug(string message);
|
|
void Debug(Exception exception, string message);
|
|
void Debug(string messageTemplate, params object[] values);
|
|
|
|
void Information(string message);
|
|
void Information(Exception exception, string message);
|
|
void Information(string messageTemplate, params object[] values);
|
|
|
|
// IPluginLog exposes Info as a distinct method (short alias of
|
|
// Information) — both are present so call-sites stay drop-in.
|
|
void Info(string message);
|
|
void Info(Exception exception, string message);
|
|
void Info(string messageTemplate, params object[] values);
|
|
|
|
void Warning(string message);
|
|
void Warning(Exception exception, string message);
|
|
void Warning(string messageTemplate, params object[] values);
|
|
|
|
void Error(string message);
|
|
void Error(Exception exception, string message);
|
|
void Error(string messageTemplate, params object[] values);
|
|
|
|
void Fatal(string message);
|
|
void Fatal(Exception exception, string message);
|
|
void Fatal(string messageTemplate, params object[] values);
|
|
}
|